構成リファレンス
このページは、Codex の構成ファイルを検索できるリファレンスとして使用してください。概念的なガイダンスと例については、まず 構成の基本 と 高度な構成 を参照してください。
config.toml
ユーザーレベルの構成は ~/.codex/config.toml にあります。.codex/config.toml ファイルにプロジェクトスコープのオーバーライドを追加することもできます。Codex は、プロジェクトを信頼している場合にのみ、プロジェクトスコープの構成ファイルを読み込みます。
プロジェクトスコープの構成でオーバーライドできないのは、マシンローカルのプロバイダー、認証、ホスト所有アプリのリクエストメタデータ、通知、構成プロファイルの選択、テレメトリルーティングキーです。プロジェクトローカルの .codex/config.toml に openai_base_url、chatgpt_base_url、apps_mcp_product_sku、model_provider、model_providers、notify、profile、profiles、experimental_realtime_ws_base_url、otel が記述されている場合、Codex はそれらを無視します。プロバイダー、通知、テレメトリのキーは、代わりにユーザーレベルの構成に記述してください。構成の プロファイルファイル は、config.toml の隣に $CODEX_HOME/profile-name.config.toml として配置されます。--profile profile-name で 1 つを選択します。
サンドボックスと承認のキー（approval_policy、sandbox_mode、sandbox_workspace_write.*）については、このリファレンスと サンドボックスと承認、書き込み可能なルート内の保護パス、ネットワークアクセス を併せて参照してください。ベータ版の権限プロファイルについては、権限 を参照してください。
gpt-5.5）。",
},
{
key: "review_model",
type: "string",
description:
"/review が使用するオプションのモデルオーバーライド（デフォルトは現在のセッションモデル）。",
},
{
key: "model_provider",
type: "string",
description: "model_providers のプロバイダー ID（デフォルト: openai）。",
},
{
key: "openai_base_url",
type: "string",
description:
"組み込みの openai モデルプロバイダーに対するベース URL のオーバーライド。",
},
{
key: "model_context_window",
type: "number",
description: "アクティブなモデルで利用できるコンテキストウィンドウのトークン数。",
},
{
key: "model_auto_compact_token_limit",
type: "number",
description:
"履歴の自動圧縮を開始するトークンのしきい値（未設定の場合はモデルのデフォルト値を使用）。",
},
{
key: "model_auto_compact_token_limit_scope",
type: "total | body_after_prefix",
description:
"自動圧縮のしきい値で、アクティブなコンテキスト全体（total、デフォルト）を数えるか、引き継がれた圧縮ウィンドウのプレフィックス（body_after_prefix）以降の増加分だけを数えるかを制御します。",
},
{
key: "model_catalog_json",
type: "string (path)",
description:
"起動時に読み込む JSON モデルカタログへのオプションのパス。選択した $CODEX_HOME/profile-name.config.toml プロファイルファイルで、プロファイルごとにこの設定をオーバーライドできます。",
},
{
key: "oss_provider",
type: "lmstudio | ollama",
description:
"--oss で実行するときに使用するデフォルトのローカルプロバイダー（未設定の場合は入力を求めます）。",
},
{
key: "approval_policy",
type: "untrusted | on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }",
description:
"コマンド実行前に Codex が承認のため一時停止するタイミングを制御します。approval_policy = { granular = { ... } } を使用すると、他のプロンプトを対話式のまま、特定のプロンプトカテゴリを許可または自動拒否することもできます。on-failure は非推奨です。対話的な実行には on-request、非対話的な実行には never を使用してください。",
},
{
key: "approval_policy.granular.sandbox_approval",
type: "boolean",
description:
"true の場合、サンドボックスの権限昇格に関する承認プロンプトを表示できます。",
},
{
key: "approval_policy.granular.rules",
type: "boolean",
description:
"true の場合、execpolicy の prompt ルールによって発生した承認を表示できます。",
},
{
key: "approval_policy.granular.mcp_elicitations",
type: "boolean",
description:
"true の場合、MCP の入力要求プロンプトを自動拒否せずに表示できます。",
},
{
key: "approval_policy.granular.request_permissions",
type: "boolean",
description:
"true の場合、request_permissions ツールからのプロンプトを表示できます。",
},
{
key: "approval_policy.granular.skill_approval",
type: "boolean",
description:
"true の場合、スキルスクリプトの承認プロンプトを表示できます。",
},
{
key: "approvals_reviewer",
type: "user | auto_review",
description:
"on-request または詳細な承認ポリシーの対象となる承認プロンプトをレビューする担当者。デフォルトは user です。auto_review ではレビュアーのサブエージェントを使用します。この設定は、サンドボックス内ですでに許可されているサンドボックス化やレビューアクションを変更しません。",
},
{
key: "auto_review.policy",
type: "string",
description:
"自動レビュー用のローカル Markdown ポリシー指示。管理対象の guardian_policy_config が優先されます。空白の値は無視されます。",
},
{
key: "allow_login_shell",
type: "boolean",
description:
"シェルベースのツールで login-shell のセマンティクスを使用できるようにします。デフォルトは true です。false の場合、login = true リクエストは拒否され、省略された login は非ログインシェルをデフォルトとして使用します。",
},
{
key: "sandbox_mode",
type: "read-only | workspace-write | danger-full-access",
description:
"コマンド実行中のファイルシステムとネットワークアクセスに対するサンドボックスポリシー。",
},
{
key: "sandbox_workspace_write.writable_roots",
type: "array\",
description:
"sandbox_mode = "workspace-write" の場合に追加される書き込み可能なルート。",
},
{
key: "sandbox_workspace_write.network_access",
type: "boolean",
description:
"workspace-write サンドボックス内で外向きのネットワークアクセスを許可します。",
},
{
key: "sandbox_workspace_write.exclude_tmpdir_env_var",
type: "boolean",
description:
"workspace-write モードで、$TMPDIR を書き込み可能なルートから除外します。",
},
{
key: "sandbox_workspace_write.exclude_slash_tmp",
type: "boolean",
description:
"workspace-write モードで、/tmp を書き込み可能なルートから除外します。",
},
{
key: "windows.sandbox",
type: "unelevated | elevated",
description:
"Windows 上で Codex をネイティブに実行するときの、Windows 専用のネイティブサンドボックスモード。",
},
{
key: "windows.sandbox_private_desktop",
type: "boolean",
description:
"ネイティブ Windows で、最終的なサンドボックス化された子プロセスをデフォルトでプライベートデスクトップ上で実行します。以前の Winsta0\\\\Default の動作との互換性が必要な場合にのみ false を設定してください。",
},
{
key: "computer_use.windows.always_allowed_app_ids",
type: "array\",
description:
"Computer Use がプロンプトなしで開ける Windows アプリ識別子。リストにないアプリには承認が必要です。保存されたエントリは ChatGPT デスクトップアプリの Computer Use 設定から削除してください。",
},
{
key: "notify",
type: "array\",
description:
"通知に使用するコマンド。Codex から JSON ペイロードを受け取ります。",
},
{
key: "check_for_update_on_startup",
type: "boolean",
description:
"起動時に Codex の更新を確認します（更新を一元管理している場合にのみ false に設定してください）。",
},
{
key: "feedback.enabled",
type: "boolean",
description:
"/feedback を介したローカルクライアント全体でのフィードバック送信を有効にします（デフォルト: true）。",
},
{
key: "analytics.enabled",
type: "boolean",
description:
"このマシンまたはプロファイルの分析を有効または無効にします。未設定の場合はクライアントのデフォルトが適用されます。",
},
{
key: "instructions",
type: "string",
description:
"将来の使用のために予約されています。model_instructions_file または AGENTS.md を優先してください。",
},
{
key: "developer_instructions",
type: "string",
description:
"セッションに挿入する追加の開発者指示（オプション）。",
},
{
key: "log_dir",
type: "string (path)",
description:
"Codex がログファイルを書き込むディレクトリ。デフォルトは $CODEX_HOME/log です。この値を明示的に設定すると、そのディレクトリでオプトインのプレーンテキスト TUI ログ codex-tui.log も有効になります。",
},
{
key: "sqlite_home",
type: "string (path)",
description:
"エージェントジョブやその他の再開可能なランタイム状態で使用する SQLite ベースの状態 DB を Codex が保存するディレクトリ。",
},
{
key: "compact_prompt",
type: "string",
description: "履歴圧縮プロンプトのインラインオーバーライド。",
},
{
key: "model_instructions_file",
type: "string (path)",
description:
"AGENTS.md の代わりに組み込み指示を置き換えるファイル。",
},
{
key: "personality",
type: "none | friendly | pragmatic",
description:
"supportsPersonality を宣言するモデルのデフォルトのコミュニケーションスタイル。スレッドまたはターンごと、あるいは /personality でオーバーライドできます。",
},
{
key: "service_tier",
type: "string",
description:
"新しいターンで優先するサービス階層。組み込み値には flex と fast が含まれます。従来の fast 構成はリクエスト値 priority にマッピングされ、カタログが提供する階層 ID も保存できます。",
},
{
key: "experimental_compact_prompt_file",
type: "string (path)",
description:
"圧縮プロンプトのオーバーライドをファイルから読み込みます（実験的機能）。",
},
{
key: "skills.config",
type: "array\