ChatGPT ドキュメント
日本語
お問い合わせ goolvyouyou@gmail.com

設定の基本

ローカルの Codex クライアントを設定するための基本を学びます

Codex は複数の場所から設定情報を読み取ります。個人用のデフォルト設定は ~/.codex/config.toml に保存され、.codex/config.toml ファイルを使用してプロジェクト固有の設定を追加できます。セキュリティ上の理由から、Codex はプロジェクトを信頼している場合にのみ、プロジェクトの .codex/ レイヤーを読み込みます。

Codex 設定ファイル

Codex はユーザーレベルの設定を ~/.codex/config.toml に保存します。設定を特定のプロジェクトまたはサブフォルダーに限定するには、リポジトリに .codex/config.toml ファイルを追加します。

Codex IDE 拡張機能から設定ファイルを開くには、右上隅の歯車アイコンを選択し、Codex Settings > Open config.toml を選択します。

CLI と IDE 拡張機能は同じ設定レイヤーを共有します。これらを使用して、次のことができます。

設定の優先順位

要件は動作を制約し、設定値はデフォルト値を提供します。Work Cloud でのローカルコンピューターアクセスには、次の要件が適用されます。

  • ポリシー間： 優先順位の低いポリシーのほうが具体的であっても、優先順位の高いポリシーが優先されます。
  • 1 つのポリシー内： OS 固有の環境オーバーライドが全 OS 共通の環境オーバーライドより優先され、その次に Global が適用されます。
  • ローカル実行： MDM と従来の管理対象デバイスの要件は、Agent Security より優先されます。デバイスのシステム要件ファイルの優先順位は、Agent Security より低くなります。
  • Work Cloud： Work のクラウドコンテナーには、既存の Work Cloud ポリシーが引き続き適用されます。ローカルアクセスを使用する Work と dots では、管理対象ポリシーが有効な場合、サポート対象の Global ポリシーが共有クラウドオーケストレーターを制御し、該当するローカル実行要件が接続先のコンピューターを制御します。

一部の要件には、フィールド固有のマージルールがあります。ポリシーの適用範囲とランタイムの制限については管理対象の設定、Work との互換性については設定リファレンスを参照してください。

Codex は次の順序で値を解決します（上にあるものほど優先されます）。

  1. CLI フラグと --config による上書き
  2. プロジェクト設定ファイル：.codex/config.toml。プロジェクトルートから現在の作業ディレクトリに向かう順序で適用されます（最も近いものが優先されます。信頼済みのプロジェクトのみ）
  3. --profile profile-name で選択したプロファイルファイル（~/.codex/profile-name.config.toml）
  4. ユーザー設定：~/.codex/config.toml
  5. サインイン中のワークスペースに配信されている場合は、クラウド管理の config.toml のデフォルト値
  6. システム設定（存在する場合）：Unix では /etc/codex/config.toml
  7. 組み込みのデフォルト値

この優先順位を利用して、共有のデフォルト設定を config.toml に指定し、プロファイルファイルには異なる値だけを指定します。

クラウド管理の設定とシステム設定では、プラグインマーケットプレイスの定義や、プラグインをデフォルトで有効にするかどうかを設定できます。これらは、強制適用される requirements.toml ポリシーとは別のものです。プラグインマーケットプレイスとデフォルト値の設定を参照してください。

プロジェクトを信頼されていないものとして指定すると、Codex はプロジェクトローカルの設定、フック、ルールなど、プロジェクトスコープの .codex/ レイヤーをスキップします。ユーザーおよびシステム設定は、ユーザー／グローバルのフックやルールを含めて引き続き読み込まれます。

-c/--config を使用する一時的なオーバーライド（TOML の引用符の規則を含む）については、高度な設定を参照してください。

一般的な設定オプション

よく変更されるオプションをいくつか紹介します。

デフォルトモデル

Codex が CLI と IDE でデフォルトとして使用するモデルを選択します。

model = "gpt-6.1-sol"

承認プロンプト

生成されたコマンドを実行する前に、Codex がいつ一時停止して確認を求めるかを制御します。

approval_policy = "on-request"

on-request と never の動作の違いについては、承認プロンプトなしで実行するとサンドボックスと承認の一般的な組み合わせを参照してください。既存の設定で approval_policy = "untrusted" を使用している場合は、廃止された untrusted 承認ポリシーからの移行を参照してください。

サンドボックスレベル

Codex がコマンドの実行中にアクセスできるファイルシステムとネットワークの範囲を調整します。

sandbox_mode = "workspace-write"

モードごとの動作（保護される .git、.agents、.codex、.aws のパスやネットワークのデフォルト設定など）については、サンドボックスと承認、書き込み可能なルート内の保護されたパス、ネットワークアクセスをご覧ください。

権限プロファイル

Codex は、再利用可能なファイルシステムおよびネットワークポリシー用の、名前付き権限プロファイルにも対応しています。組み込みプロファイルは :read-only、:workspace、 :danger-full-access です。カスタムプロファイルでは、[permissions.<name>] テーブルと、対応する default_permissions 値を使用します。権限を参照してください。

Windows サンドボックスモード

Windows では、デバイスとポリシーが対応している場合は MXC を優先して使用してください。フォールバック用に従来の実装を設定します。

[windows]
sandbox = "elevated" # Legacy fallback

[features]
prefer_mxc = true

unelevated は、昇格権限でのセットアップが利用できず、組織のポリシーで許可されている場合にのみ使用してください。互換性の制限と展開の制御については、Windows サンドボックスガイドをご覧ください。

ウェブ検索モード

Codex は、ローカルチャットでデフォルトでウェブ検索を有効にし、ウェブ検索キャッシュから結果を提供します。このキャッシュは OpenAI が管理するウェブ検索結果のインデックスであるため、キャッシュモードではライブページを取得せず、事前にインデックス化された結果を返します。これにより、任意のライブコンテンツからのプロンプトインジェクションにさらされるリスクを軽減します。ウェブ検索結果は信頼できないものとして扱ってください。--yolo または別のフルアクセスのサンドボックス設定を使用している場合、ウェブ検索はデフォルトでライブの結果を使用します。web_search でモードを選択してください。

  • "cached"（デフォルト）は、ウェブ検索キャッシュから結果を提供します。
  • "indexed" は、検索インデックスがリクエストを許可した場合にのみ外部ウェブアクセスを許可します。
  • "live" は、ウェブから最新のデータを取得します（--search と同じです）。
  • "disabled" は、ウェブ検索ツールを無効にします。
web_search = "cached"  # default; serves results from the web search cache
# web_search = "indexed" # gate external web access through the search index
# web_search = "live"  # fetch the most recent data from the web (same as --search)
# web_search = "disabled"

推論の労力

対応している場合に、モデルが適用する推論の労力を調整します。

model_reasoning_effort = "medium"

コミュニケーションスタイル

組み込みのパーソナリティに関する指示を省くには、次のように設定します。

personality = "none"

これにより、モデルの組み込み指示から Personality セクションが削除されます。 明示的に指定されたカスタムの基本指示は変更されません。従来の friendly と pragmatic の値では、スタイルを選択できなくなりました。Codex では現在、 /personality コマンドは提供されていません。

TUI キーマップ

tui.keymap でターミナルのショートカットをカスタマイズします。選択されたコンポーザーアクションは、一致する tui.keymap.global バインドにフォールバックします。対応している場合、コンテキスト固有のバインドが優先されます。空のリストを指定すると、アクションのバインドが解除されます。

[tui.keymap.global]
open_transcript = "ctrl-t"

[tui.keymap.composer]
submit = ["enter", "ctrl-m"]

[tui.keymap.chat]
interrupt_turn = "f12"

コマンド環境

Codex が生成したコマンドに転送する環境変数を制御します。必要な変数だけを保持するには、キー指定のフィルターを使用します。

[shell_environment_policy]
ignore_default_excludes = false

[shell_environment_policy.filters]
"PATH" = "include"
"HOME" = "include"

ignore_default_excludes のデフォルトは true で、変数名に KEY、SECRET、TOKEN が含まれる場合の自動フィルタリングをスキップします。この自動フィルタリングを使用する場合は、false に設定します。除外ルール、優先順位、従来の設定については、シェル環境ポリシーを参照してください。

ログディレクトリ

Codex がローカルログファイルを書き込む場所を変更します。log_dir を明示的に設定すると、そのディレクトリでオプトイン式のプレーンテキスト TUI ログ codex-tui.log も有効になります。

log_dir = "/absolute/path/to/codex-logs"

一時的な実行では、CLI から設定することもできます。

codex -c log_dir=./.codex-log

機能フラグ

config.toml の [features] テーブルを使用して、オプション機能や実験的機能を切り替えます。

一般的な機能フラグ

キー デフォルト 成熟度 説明
apps true 安定版 アプリ（コネクター）連携を有効にする
goals true 安定版 永続化された目標と自動継続を有効にする
hooks true 安定版 hooks.json またはインラインの [hooks] からライフサイクルフックを有効にする。フックを参照してください。
fast_mode true 安定版 Fast mode の選択と service_tier = "fast" パスを有効にする
memories false 実験的 メモリを有効にする
multi_agent true 安定版 サブエージェントのコラボレーションツールを有効にする
remote_plugin true 安定版 リモートプラグインカタログを有効にする
shell_snapshot true 安定版 シェル環境のスナップショットを作成し、コマンドの反復実行を高速化する
shell_tool true 安定版 コマンド実行ツールを有効にします
unified_exec true 安定版 再開可能なコマンド実行を有効にします。無効にできるのは管理対象の要件のみです
web_search true 非推奨 従来の切り替え。トップレベルの web_search 設定を推奨
web_search_cached false 非推奨 未設定の場合に web_search = "cached" に対応付けられる従来の切り替え
web_search_request false 非推奨 未設定の場合に web_search = "live" に対応付けられる従来の切り替え

ライフサイクルフックの設定については、フックを参照してください。

機能を有効にする

  • config.toml で、[features] の下に feature_name = true を追加します。
  • CLI から codex --enable feature_name を実行します。
  • 複数の機能を有効にするには、codex --enable feature_a --enable feature_b を実行します。
  • 機能を無効にするには、config.toml でキーを false に設定します。