環境＆ログイン
緊急トラブル救急マニュアル

症状別早見表 ＋ トラブルマップ

症状別早見表：30秒で問題を特定

トラブルマップ：すべての環境問題は4つの根本原因に集約される

Claude Code と Codex の「環境問題」は多種多様に見えますが、分解すると4つの根本原因しかありません。原因を正確に把握すれば、以降の全セクションで迷わず特定・修復できます。

2大ツール共通のメンタルモデル

朗報：2つのツールの環境アーキテクチャは高度に同型です。一度メンタルモデルを理解すれば、両方にそのまま適用できます。

完全な比較対照表は第13章を参照してください。本ページのすべての結論は公式ドキュメント 2026-07 版と照合済みです。出典は各節の脚注に記載しています。

五つの診断レイヤー

実行ファイルと版、環境変数名、認証、設定層、実際の接続先を確認します。複数の導入やプロキシ変数は自動的に異常とはいえません。資格情報や変数の値は出力せず、Claude の読込元は /status で確認します。未確認の Codex /debug-config に依存しません。

codex --version
claude --version
# Variable names only (macOS / Linux / WSL)
env | cut -d= -f1 | sort | grep -iE 'anthropic|claude|codex|openai|proxy' || true

依据：Codex configuration · Claude settings

Claude Code · 認証

托管、--settings、local、共有プロジェクト、ユーザーの順です。環境変数の優先はキーごとに異なります。契約、Console、API、クラウド、企業ゲートウェイを区別します。

認証 →

依据：Official reference

Claude Code · 設定

托管、--settings、local、共有プロジェクト、ユーザーの順です。環境変数の優先はキーごとに異なります。契約、Console、API、クラウド、企業ゲートウェイを区別します。

設定 →

依据：Official reference

Claude Code · 診断

托管、--settings、local、共有プロジェクト、ユーザーの順です。環境変数の優先はキーごとに異なります。契約、Console、API、クラウド、企業ゲートウェイを区別します。

診断 →

依据：Official reference

Codex · 認証

提供元 ID、認証、URL、必須条件、排他設定、移行は専章を参照します。ChatGPT、API とゲートウェイの資格情報は同一ではありません。

認証 →

依据：Official reference

Codex · 設定

提供元 ID、認証、URL、必須条件、排他設定、移行は専章を参照します。ChatGPT、API とゲートウェイの資格情報は同一ではありません。

設定 →

依据：Official reference

Codex · 診断

提供元 ID、認証、URL、必須条件、排他設定、移行は専章を参照します。ChatGPT、API とゲートウェイの資格情報は同一ではありません。

診断 →

依据：Official reference

シナリオ A · 共用PC ／ 他人の設定を引き継いだPC

最も頻発するトラブル現場：有料会員である自分が、他人が過去に使っていたPCに座り、作業を始めた途端にエラーが多発する現象です。根本原因はほぼ常に共通しています：前任者の認証情報や環境変数が残っており、自分のログインよりも優先されていることです。

作業前の3点チェック（設定変更に着手する前に実行）

1. 環境変数と rc ファイルの残存チェック：第01章の診断スクリプトを実行し、特に L2 出力を確認——前任者の rc ファイルに残った export ANTHROPIC_API_KEY / ANTHROPIC_BASE_URL (リレー構成) / OPENAI_API_KEY は時限爆弾です。
2. 認証情報の所属確認：claude セッションに入り /status でどのアカウントでログインしているか確認；codex login status も同様に確認。他人のアカウントであればまず /logout / codex logout を実行。
3. グローバル設定の汚染確認：~/.claude/CLAUDE.md、~/.claude/settings.json、~/.codex/config.toml、~/.codex/AGENTS.md に他人の個人嗜好や独自指示が残っていないか確認——これらはすべての対話動作に直接影響します。

共用レベルに応じた対策の選択

同一 OS アカウントで複数環境を共存させる（ディレクトリ分離手法）

# ~/.zshrc —— ユーザー/アカウントごとに独立した設定ディレクトリ ＋ 専用エイリアスコマンドを定義
# Claude Code: CLAUDE_CONFIG_DIR でホーム配置先を指定
alias claude-me='CLAUDE_CONFIG_DIR="$HOME/.claude-me" claude'
alias claude-work='CLAUDE_CONFIG_DIR="$HOME/.claude-work" claude'
# Codex: CODEX_HOME で同様に指定
alias codex-me='CODEX_HOME="$HOME/.codex-me" codex'
alias codex-work='CODEX_HOME="$HOME/.codex-work" codex'

• 各ディレクトリで初回利用時に個別にログインを行うことで、認証情報、履歴、設定が完全に分離され、以後ログアウトとログインを繰り返す必要がなくなります；
• 誤操作防止テクニック：アカウントごとのセッションで /color を使って TUI テーマカラーを変更し、「今どのアカウントで操作しているか」を一目で識別できるようにする（madewithlove 方式）；
• 注意：Claude Code のグローバル状態ファイル ~/.claude.json (MCP設定等) も CLAUDE_CONFIG_DIR の指定配下に配置されます——デフォルト位置のファイルを直接触らないようにしてください。

参考：Running multiple Claude accounts without logging out (madewithlove) · Two Claude accounts on one Windows PC (Josh Grossman) · codex-multi-auth (コミュニティツール)

シナリオ B · PC移行 ／ マルチマシン同期

基本原則はシンプルです：「設定は持ち出し、認証情報はマシンごとに新規ログインし、履歴はその場に残す」。「何を持ち出し、何を持ち出さないか」を明確に理解していれば、PCの乗り換えは10分で完了します。

何を持ち出し、何を持ち出さないか（2大ツール比較対照）

新規PCセットアップの10分標準フロー

# 1. インストール（公式ネイティブチャネルを使用。npm と混在させない）
curl -fsSL https://claude.ai/install.sh | bash        # Claude Code
npm install -g @openai/codex                          # Codex (または brew install codex)

# 2. 設定の復元（dotfiles アプローチ）
git clone git@github.com:yourname/dotfiles.git ~/dotfiles
ln -s ~/dotfiles/claude ~/.claude                     # または export CLAUDE_CONFIG_DIR=~/dotfiles/claude
ln -s ~/dotfiles/codex ~/.codex                       # または export CODEX_HOME=~/dotfiles/codex

# 3. 各ツールで1回ずつログイン（認証情報は絶対にコピーしない）
claude          # ブラウザ OAuth → /status でアカウントと Login method を検証
codex login     # ブラウザ OAuth → codex login status で検証

# 4. 診断スクリプトで仕上げ確認
claude doctor && bash ai-env-check.sh

参考：公式 ~/.claude ディレクトリ完全解説 · anthropics/claude-code#36693 (マルチマシン同期議論)

シナリオ C · SSH ／ コンテナ ／ ヘッドレス機 ／ CI

ブラウザが存在しない環境では、ログインのアプローチが異なります。2つのツールの公式推奨アプローチは異なるため、混同しないようにしてください。

Claude Code：3つのアプローチ

1. SSH / WSL2 / コンテナでの対話利用：通常通り claude を実行し、ターミナルに表示された OAuth URL をローカルマシンのブラウザにコピーしてログインを完了。ブラウザに表示された code をターミナルに貼り付けます（貼り付けが動作しない環境では claude auth login を使用して stdin から読み込ませる）。
2. CI / スクリプト（サブスクリプション利用枠）：ローカル環境で claude setup-token を実行して1年間有効な OAuth トークンを生成し、CI Secret に保存。実行環境の環境変数 CLAUDE_CODE_OAUTH_TOKEN に設定します。注意：--bare モードではこの変数は読み込まれないため、bare 環境では ANTHROPIC_API_KEY または apiKeyHelper を使用してください。
3. CI（API 従量課金）：環境変数 ANTHROPIC_API_KEY を直接設定——最もシンプルですが、従量課金となります。

Codex：公式推奨の3大アプローチ（優先度順）

1. デバイスコード認証（第一推奨）：codex login --device-auth を実行し、ローカルの任意のブラウザで使い捨てワンタイムコードを入力。ワークスペース管理者が事前にデバイスコード認証権限を有効化している必要があります。
2. auth.json のコピー（公式フォールバック）：ブラウザのあるマシンでログイン後、生成された ~/.codex/auth.json を対象マシンへ安全にコピー（scp / docker cp）。ローカルマシンの保存先がキーチェーンの場合は、あらかじめ cli_auth_credentials_store を file に設定してログインし直す必要があります。
3. SSH ポートフォワーディング：ssh -L 1455:localhost:1455 user@remote で接続した上でリモート側で codex login を実行し、ローカルブラウザで標準の OAuth コールバックを完了させます。

Codex CI での長期認証（公式 auth.json 更新サイクル）

ChatGPT サブスクリプション利用枠で CI を実行する公式推奨パターン——Codex 実行時にトークンが自動更新され auth.json に書き戻される仕組みを利用します：

1. 信頼できるマシン上で codex login (file ストレージ) を実行し、生成された auth.json を CI の Secret 管理に登録；
2. 各ジョブ実行時：auth.json を復元 → Codex を実行（トークンは約8日間未使用で stale になりますが、実行中に自動更新されます） → 更新された auth.json を CI Secret に書き戻す；
3. 禁止事項：複数の並行ジョブで同一の auth.json を共有しないこと；初期の古いファイルを毎回上書きしないこと；更新チェーンが途切れた場合は信頼できるマシンで再度ログインして再シードすること。セルフホスト runner の場合は永続ボリュームに CODEX_HOME を割り当てる方がシンプルです。

社内ネットワーク（プロキシ ／ プライベート CA）設定早見表

出典：公式 Authentication (setup-token) · 公式 Codex CI/CD auth（2026-07 版）

実戦ケーススタディ：症状から根本原因への徹底追跡

高頻度で発生する4つの実戦シナリオを通じて、5層診断法の実際の適用フローを解説します。これら4つの構造を理解すれば、大半の「原因不明のトラブル」を自力で解決できるようになります——特にエラーメッセージのテキストと真の根本原因がいかに乖離しているかに注目してください。

ケース1 · 「Max 会員なのに組織が無効化されていると表示される」

ケース2 · 「VS Code 拡張機能だけ Invalid API key になり、ターミナルは正常に動く」

ケース3 · 「翌朝PCを開くと、すべての並行セッションが一斉に再ログインを要求してくる」

ケース4 · 「Codex が CI で1週間安定動作していたのに、突然すべてのパイプラインで 401 エラーが発生」

事例の根拠：公式 troubleshoot-install / authentication ドキュメント、anthropics/claude-code#12204、Codex CI/CD auth 公式ガイド（2026-07 照合済み）。マシンや人物の状況はわかりやすく再構成していますが、調査経路と根本原因はすべて実際の動作メカニズムに基づいています。

復元できる調査とリセット

エラー、版、有効設定、秘匿済みログを保存します。認証が原因と分かった場合のみ再認証します。部分バックアップでは全履歴を復元できないため、設定全体を消さないでください。

隔離が必要なら実際の保存先を確認し、日時付きで全体を複製して読めることを検証します。原本を残し、一項目ずつ変更・復元します。

2大ツール概念対照表 ＋ リソースインデックス

1つの表で2大ツールを完全対照

リソースインデックス（信頼度順）