Codexには、ChatGPTのアカウントでログインする方法と、APIキーで使う方法があります。
ログインできないときは、まず今の状態を確かめ、どこで止まっているかを切り分けます。
- 今の状態:codex login status
- ログインし直す:codex logout のあと codex login
- ブラウザーから戻らない:codex login –device-auth
- 設定ファイルのエラーで止まる:エラーの行を直すか、Codexを新しくする
この記事は、2026年9月29日時点の公式ドキュメントと、Windows上の Codex CLI で確かめた結果にもとづいています。
ChatGPTアカウントとAPIキーの違い
| ChatGPTでログイン | APIキーでログイン | |
|---|---|---|
| 料金 | ChatGPTのプランの枠で使う | APIの料金で使った分だけ払う |
| Codexのクラウド | 使える | 使えない |
| データの扱い | ChatGPTのワークスペースの設定に従う | APIの組織の設定に従う |
| 向いている使い方 | ふだんの作業 | CIなど、プログラムから動かすとき |
デスクトップアプリ、コマンド版(CLI)、IDEの拡張機能は、どちらの方法でもログインできます。
CLIとIDEの拡張機能は同じログイン情報を使うので、片方でログアウトするともう片方もログアウトします。
今のログイン状態を確かめる
codex login statusLogged in using ChatGPT当方の環境では、ChatGPTのアカウントでログインしていると表示されました。
ログイン情報は、ホームフォルダの .codex/auth.json か、OSの資格情報の保管場所に保存されます。
auth.json にはトークンがそのまま入っているので、人に見せたりGitに入れたりしないでください。
ログインのやり直し方
ChatGPTのアカウントで
codex logout
codex loginブラウザーが開くので、ChatGPTにログインすると、ログイン情報がCodexに戻されます。
APIキーで
APIキーは、標準入力から codex login に渡します。
printenv OPENAI_API_KEY | codex login --with-api-keyAPIキーで使うと、ChatGPTのプランの枠ではなく、APIの通常料金で請求されます。
ログインできないときの確認順
1. 設定ファイルのエラーで止まっていないか
当方の環境では、古いコマンド版で codex login status を実行したところ、ログインの確認より前に次のエラーで止まりました。
Error loading configuration: C:\Users\(ユーザー名)\.codex\config.toml:6:16: unknown variant `default`, expected `fast` or `flex`Codexは起動するたびに config.toml を読むので、ここに誤りがあると、ログインを含むすべての操作が止まります。
この例は、新しいデスクトップアプリが書いた値を古いコマンド版が知らなかったもので、コマンド版を新しくすると直りました。
npm install -g @openai/codex@latestconfig.toml の書き方は、Codexのconfig.tomlの場所と書き方で紹介しています。
2. ブラウザーからCodexに戻ってこない
ログインのあと、Codexはパソコンの中の localhost:1455 でログイン情報を受け取ります。
リモートのパソコンで動かしているときや、ネットワークの設定でここがふさがれていると、ブラウザーから戻れません。
その場合は、デバイスコードでログインします。
codex login --device-auth表示されたリンクをブラウザーで開き、ログインしてから、表示された使い捨てのコードを入力します。
先に、ChatGPTのセキュリティ設定(組織ならワークスペースの権限)でデバイスコードのログインを有効にしておく必要があります。
SSHで接続しているなら、ssh -L 1455:localhost:1455 でポートを転送して、ふつうのログインを使う方法もあります。
3. 会社のネットワークで証明書のエラーが出る
会社のプロキシが独自の証明書を使っていると、ログインで失敗することがあります。
その場合は、環境変数 CODEX_CA_CERTIFICATE に会社の証明書(PEM)の場所を入れてからログインします。
4. ログインしてもすぐ終了する
組織の管理者が、ログインの方法やワークスペースを決めていることがあります。
決められたものと違う方法でログインすると、Codexはログアウトして終了します。
この場合は、管理者に使うべきログインの方法を確かめます。
5. ログの記録を見る
codex login を実行すると、ログの場所に codex-login.log が書かれます。
ブラウザーのログインやデバイスコードで失敗したときは、このファイルに原因が残ります。
ログイン情報の保存先を変える
config.toml の cli_auth_credentials_store で、ログイン情報の保存先を選べます。
| 値 | 保存先 |
|---|---|
| file | ホームフォルダの .codex/auth.json |
| keyring | OSの資格情報の保管場所(使えなければ失敗する) |
| auto | 使えればOSの保管場所、だめなら auth.json |
| ephemeral | 保存しない(そのときだけ) |
cli_auth_credentials_store = "keyring"まとめ
- ChatGPTならプランの枠、APIキーならAPIの料金で使う
- 状態の確認は codex login status
- 設定ファイルの誤りがあると、ログインの前に止まる
- ブラウザーから戻らないときは codex login –device-auth
- auth.json はパスワードと同じように扱う
参考:Codex公式ドキュメント「Authentication」(2026年9月29日に確認)。
