直接回答
Codex 設定エラーは version 付き schema の問題です。項目を移動・削除する前に binary と有効な config location を確認します。
このガイドで解決できること
TOML 構文、未知項目、誤った table 階層、値型、古い Codex 設定を修正する。
Codex CLIconfig.tomlCODEX_HOMEcustom model provider / MCP server
01
症状
Codex が起動しない、provider を無視する、unknown field・invalid type・TOML parse location を報告します。
コピーした config が別 Codex version・CODEX_HOME では動作しても、現在の binary は別 schema・file を読みます。
02
主な原因
- TOML の quote、array、duplicate key、table header が不正。
- 有効な field が誤った table にあり、または値型が違う。
- 旧 version で削除・改名された option が残っている。
- process が想定外の CODEX_HOME、profile、config file を解決している。
03
診断手順
- 01境界を確定正確な Codex version と解決後の CODEX_HOME を記録します。
- 02基準を作成編集前に config.toml と関連 auth directory を backup します。
- 03一項目を比較strict config 診断で最初の unknown field・type error を保存します。
- 04決定的な証拠を記録一時 CODEX_HOME で user config と binary・environment を分離します。
最小診断コマンド言語：bash
CODEX_DIR="${CODEX_HOME:-$HOME/.codex}"
printf 'CODEX_HOME=%s\n' "$CODEX_DIR"
codex --version
cp "$CODEX_DIR/config.toml" "$CODEX_DIR/config.toml.bak.$(date -u +%Y%m%dT%H%M%SZ)"
codex exec --strict-config --ephemeral -s read-only -a never '現在のモデルとサンドボックスモードだけを報告してください。'
codex exec --ignore-user-config --ephemeral -s read-only -a never 'リポジトリの入口だけを確認してください。'
04
修正
- 01障害レイヤーを修正導入済み version の文書に合わせ構文、型、table 階層を修正します。
- 02必要な動作を復元profile、MCP、安全設定を維持し、確認済み obsolete key だけを除去します。
- 03一時回避策を除去transactional に merge し完全な rollback copy を残します。
修正例言語：bash
codex exec --strict-config --ephemeral -s read-only -a never \
'現在の provider、モデル、承認ポリシー、サンドボックスモードを報告してください。コマンド実行やファイル変更は行わないでください。'
codex doctor --summary05
検証
- strict doctor が unknown field・type error を報告しない。
- 対象 provider と model が正しく解決される。
- project・外部 state を変更しない最小 read-only task が成功する。
- backup が完全で auth data が上書きされていない。
06
機密情報の扱い
- auth.json・secret value を config 診断へ貼らない。
- 一つの key 修正のため config 全体を置き換えない。
- migration 中も sandbox、approval、trusted-project 設定を維持する。
- Codex version、機密除去した fragment、path、正確な error text で共有する。
公式情報と検証範囲
本ガイドはプロトコル仕様とクライアント公式文書を根拠にしています。エラー文、再試行ヘッダー、設定項目はサービスやバージョンで変わるため、参照元を確認し、ログとリクエスト例を秘匿してから共有してください。
ドキュメントの適用範囲を見る