tidemeet

OpenAI Codex CLIの使い方：インストール、ログイン、最初の作業

Codex CLIを入れ、ChatGPTかAPIキーでログインし、実リポジトリで最初のタスクを完了する。

欲しいのは、手元のリポジトリを読み、ファイルを直し、ローカルツールを回すコーディングエージェントだ。しかもループはターミナルに残したい。

本稿は OpenAI Codex CLIのインストールと使い方 を公式手順で辿る。インストーラ、ChatGPTまたはAPIキーのログイン、実リポジトリでの最初のタスク。根拠は developers.openai.com/codex/cli と developers.openai.com/codex/auth。

インストール ログイン 最初のリポジトリ作業

向いている人

Codex CLI はローカルリポジトリに対して動く。ファイルを見て、直し、既に入れたツールを実行する。対話は codex、繰り返しのパイプラインは codex exec。ChatGPTのウェブタブではなく、IDE拡張を先に入れる必要もない。

01

実リポジトリで始める

起動前にプロジェクトへ cd する。公式の入りは “Tell me about this project” と尋ね、続けて焦点の絞れた変更を一つ頼むこと。

02

ログインは二つ、請求も二つ

ChatGPTログインは Plus / Pro / Business / Edu / Enterprise の枠を使う。APIキーは Platform 料金で、私有CI向き。ワークスペースのクラウド機能は一部制限される。

03

先に権限を見る

/permissions でサンドボックスと書き込み可能なルートを確認する。公式はタスクの前後にGitチェックポイントを残し、戻せるようにとも書いている。

インストール、ログイン、最初のタスク

  1. 1

    CLIを入れる

    macOS / Linux：curl -fsSL https://chatgpt.com/codex/install.sh | sh。Windowsは公式のPowerShellインストーラ。npm install -g @openai/codex または brew install --cask codex でもよい。同じコマンドで更新できる。

  2. 2

    ログインする

    プロジェクトディレクトリで codex または codex login を実行し、Sign in with ChatGPT を選んでブラウザを完了する。ヘッドレス、またはlocalhostコールバックが塞がれているなら codex login --device-auth（ChatGPTのセキュリティ設定でデバイスコードを有効化）。自動化は printenv OPENAI_API_KEY | codex login --with-api-key。確認は codex login status、ログアウトは codex logout。

  3. 3

    最初のリポジトリ作業

    リポジトリに入り codex を実行する。構成を説明させ、テスト追加や明確なエラー修正など一点に絞った変更を頼む。コミット前に /review。チーム用の常設指示が必要なら /init で AGENTS.md を書ける。

0
追加のIDE依存
2
ログイン方法
1
最初のプロンプト
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Windows: irm https://chatgpt.com/codex/install.ps1 | iex
# npm install -g @openai/codex
# brew install --cask codex

codex login
# printenv OPENAI_API_KEY | codex login --with-api-key
# codex login --device-auth

cd ~/code/your-repo
codex
# Tell me about this project

初回で止まりやすい点

方法 請求 向いている用途
ChatGPTログイン プラン枠 日常のローカル作業
APIキー Platform料金 私有CI / スクリプト
デバイスコード ChatGPTと同じ ヘッドレスまたはSSH
auth.jsonはパスワード
ログインは ~/.codex/auth.json かOSのキーリングにキャッシュされる。コミットもチケット貼り付けもしない。CLIとIDE拡張はキャッシュを共有し、一方でログアウトすれば他方も再ログインが必要になる。
ヘッドレスは別経路
リモートがlocalhostコールバックを塞ぐならデバイスコードを優先。代替はブラウザ付きマシンでログインしてキャッシュを安全にコピーするか、localhost:1455 をSSH転送する。
社内プロキシにはCA
TLSプロキシや私有ルートがあるなら、CODEX_CA_CERTIFICATE を設定してから codex login。未設定時は SSL_CERT_FILE に戻る。

API / CI向けの公式注意：信頼できない公開環境でCodexの実行を晒さない。

差分を人と見るとき

エージェントが直したあと、何が変わり、なぜマージできるかの一枚が足りないことが多い。会議スイートは不要。tidemeetで短い空間を開くか、空間の作り方を見る。キャンバスは共有ホワイトボード基礎。同サイトのOpenAI評価事故メモはMETR報告。

質問

IDE拡張は必須か。

不要。CLI単体で動く。拡張はログインキャッシュを共有するが、最初のリポジトリ作業はターミナルだけで足りる。

ChatGPTログインとAPIキーは併用できるか。

セッションごとに有効な方法は一つ。ChatGPTはワークスペース権限とプラン枠、APIキーはPlatformの組織設定と従量課金。Codex cloudはChatGPTログインが必要。

最初から大きなリファクタを頼むべきか。

いいえ。公式の入りはリポジトリを理解し、一点に絞った変更。先に /permissions を見、Gitチェックポイントで戻せるようにする。

一時的な会議ツールと何の関係か。

製品の結びつきはない。差分を短く話すだけなら、一時会議ツール比較が短いブラウザ空間で足りる場合を示す。

スペースを無料で作る