Codex 401 Unauthorized の原因と直し方

まず codex login status を実行します。公式ドキュメントによると、現在の認証方式を表示し、ログイン中なら 0 で終了します。ChatGPT と API キーのどちらかが分かったら、Codex の接続先が OpenAI かカスタムプロバイダーかを確認します。OpenAI ならサインインし直すかキーを切り替え、カスタムプロバイダーなら model_provider が指すプロバイダーの認証方式（env_key か requires_openai_auth か）と、キーがその読み取り先にあるかを確認します。

codex logout で現在の資格情報を消してから、もう一方の方法でサインインします。公式の手順では、ChatGPT は codex login を実行してブラウザーで完了し、API キーは printenv OPENAI_API_KEY | codex login --with-api-key で標準入力から渡します。IDE 拡張では未サインイン画面で Sign in with ChatGPT または Use API Key を選びます。CLI と IDE 拡張はログインキャッシュを共有します。管理者が forced_login_method を設定している場合、資格情報が制限に合わないと Codex はログアウトして終了します。

ChatGPT サインインなら、まずセッション切れとして扱い、codex logout のあと codex login をやり直してください。公式ドキュメントには、ChatGPT セッションは使用中に期限切れ前にトークンを自動更新するため、使用中のセッションは通常ブラウザーでの再ログインが不要とあります。GitHub では、ログイン状態が無効になったときに Provided authentication token is expired. Please try signing in again. や Your access token could not be refreshed because your refresh token was revoked. Please log out and sign in again. が出たという報告があります（いずれもユーザー報告）。リモートやブラウザーのない環境では codex login --device-auth を使います。

まず同じプロバイダーに requires_openai_auth = true がないか確認してください。公式ドキュメントによると、このとき Codex は env_key を無視し、OpenAI 認証（ChatGPT または API キー）を使います。ない場合は、env_key の値が export した変数名と完全に一致しているかを確認します。公式には、Codex はその設定が指す変数を読むので、変数名そのものは固定ではないとあります。GitHub では、資格情報を設定していないときに 401 Unauthorized: Missing bearer or basic authentication in header が出たという報告があります（ユーザー報告）。

プロバイダーの設定が Codex の読む場所にあるかを確認してください。公式ドキュメントには落とし穴が 3 つあります。プロジェクト内の .codex/config.toml にある model_provider・model_providers・openai_base_url は無視され起動時に警告が出ること、Codex 0.134.0 以降の --profile は config.toml の [profiles.名前] を読まないので ~/.codex/名前.config.toml を使うこと、組み込み ID の openai・ollama・lmstudio はカスタムプロバイダーに使えないので、OpenAI のアドレスだけ変えたいなら openai_base_url を使うことです。model_provider を書かなければ既定値は openai です。

QCode のドキュメントに沿って、キーが cr_ で始まるか、~/.codex/auth.json のキーが欠けておらず余分な空白や改行がないか、コンソールでキーの状態と残りのクォータを確認します。ドキュメントはサブスクリプションの期限切れも 401 の原因に挙げています。ドキュメントの代替手段（環境変数だけを設定し auth.json は null）を使っているなら、まずキーを auth.json に戻してください。設定に requires_openai_auth = true があるとき、公式には Codex は env_key を無視するとあります。環境に残った古い変数が現在の設定を上書きすることがあるので、env | grep -i openai で不要なものを消してください。そのうえで Authorization: Bearer と自分のキーを付けて https://api.qcode.cc/openai/v1/models にリクエストし、JSON の一覧が返ればアドレスとキーは正しいです。ドキュメントの見分け方は 401 がキーの問題、404 がパスのプレフィックス違いで、Codex の base_url は https://api.qcode.cc/openai です。