Codex config.toml 設定ファイル詳細ガイド

ユーザーレベルの ~/.codex/config.toml には、個人のデフォルトモデル、provider、操作設定を置くのに適しています。プロジェクトの .codex/config.toml は信頼されたリポジトリのチーム設定に適し、コマンドライン引数は現在の呼び出しにのみ影響する実験に適しています。

API Key と通常の設定を混在させないでください。認証データは認証メカニズムまたは Secret のストレージに入れ、config.toml には動作とリクエストルーティングのみを記述します。

デフォルトのユーザー設定は ~/.codex/config.toml にあります。Windows の ~ はユーザーのホームディレクトリに対応します。CODEX_HOME が設定されている場合は、そのディレクトリを基準とします。

診断時は ~/.codex ディレクトリ全体を再帰的に表示するのではなく、doctor と features を優先してください。auth.json にはシークレットが含まれる可能性があるため、ターミナルの共有やチケットの添付には含めないでください。

設定項目が増えるほど、アップグレード時に検証すべき動作も増えます。まず安定して説明可能なフィールドを設定し、その他のオプションは実際に必要になった時点で現在の設定リファレンスに基づいて追加してください。

モデル識別子は現在の provider で受け入れられる必要があります。以下の例は CodeNodex の現在の Codex デフォルトモデルを示しますが、provider の完全な設定はモデルと provider の専用記事で説明します。

-c key=value は value を TOML として解析し、現在の呼び出しにのみ影響します。モデル、作業ディレクトリ、サンドボックス、承認には専用のパラメータがある場合、可読性を高めるためにそちらを優先してください。

有効であることを確認してから設定に書き込めば、1回の実験で全リポジトリが恒久的に変更されるのを防げます。

手動編集の前にタイムスタンプ付きバックアップを作成し、唯一の旧コピーを上書きしないでください。CodeNodex CLI を使用する場合、setup は解析、バックアップ、アトミックな書き込み、失敗時のロールバックを備えています。

TOML のテーブル階層と重複キーは解析失敗を招きやすいです。変更後に doctor を実行し、読み取り専用タスクで最終的な有効値を検証してください。

CLI のアップグレード後、release の説明、ローカルヘルプ、doctor を確認してください。未知のフィールドを削除する前に、それがチームポリシー由来か、まだ古い環境で使用されているかを先に確認してください。

重要なデフォルト値とその理由をチームドキュメントに記録し、公式デフォルトに戻った冗長項目は定期的に削除してください。設定が簡潔なほど、マシン間の再現が容易になります。