このページは、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 で使用するものを選択してください。
サンドボックスと承認のキー（approval_policy、sandbox_mode、sandbox_workspace_write.*）については、このリファレンスと併せてサンドボックスと承認、書き込み可能なルート内の保護されたパス、ネットワークアクセスを参照してください。ベータ版の権限プロファイルについては、権限を参照してください。
<ConfigTable
options={[
{
key: "model",
type: "string",
description: "使用するモデル（例: 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 elicitation プロンプトを自動拒否せずに表示できます。",
},
{
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:
"シェルベースのツールがログインシェルのセマンティクスを使用できるようにします。デフォルトは 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:
"新しいターンで優先するサービス階層。fast、またはアクティブなモデルが提供する別の階層を使用してください。fast はリクエスト値 priority に対応します。",
},
{
key: "experimental_compact_prompt_file",
type: "string (path)",
description:
"圧縮プロンプトの上書き設定をファイルから読み込みます（試験的機能）。",
},
{
key: "skills.config",
type: "array
