リリースノート
公式ドキュメント
セットアップ
前提はNode.js環境があることです。
- インストール 及び アップデート
npm install -g @openai/codex@latest
# または
brew install codex
- バージョン確認
codex --version
# codex-cli 0.125.0
起動
codex
(おまけ)承認全部スキップしたい方のための起動方法
codex --dangerously-bypass-approvals-and-sandbox
初回実行すると、自動でブラウザが起動し、OpenAIの認証画面が表示されます。
>_ Welcome to Codex, OpenAI's command-line coding agent
> Sign in with ChatGPT to use Codex as part of your paid plan
or connect an API key for usage-based billing
> 1. Sign in with ChatGPT
Usage included with Plus, Pro, and Team plans
2. Provide your own API key
Pay for what you use
Press Enter to continue
(和訳)
>_ Codexへようこそ - OpenAIが提供するコマンドライン型コーディング支援ツールです
> ChatGPTでサインインすると、有料プランの一部としてCodexをご利用いただけます
または、使用量に応じた課金方式を利用するためにAPIキーを接続してください
> 1. ChatGPTでサインインする
Plusプラン、Proプラン、Teamプランには使用権が含まれています
2. ご自身のAPIキーを入力する
実際に使用した分だけお支払いいただけます
Enterキーを押すと続行します
ChatGPT Plus/Pro/Teamアカウントをお持ちの方は、Sign in with ChatGPTを選択して認証完了しましょう。
認証完了すると以下のように聞かれます。
> 1. Allow Codex to work in this folder without asking for approval
2. Require approval of edits and commands
Press Enter to continue
(和訳)
> 1. 承認を求めずにこのフォルダで Codex を動作させる
2. 編集とコマンドに対して承認を必須とする
Enter キーを押すと続行します
承認が面倒な方は上がいいかもしれません。
"賢く"使うための設定
C:\Users\ユーザー名\.codexに、config.tomlファイルが生成されています。
これを弄ることで、デフォルトのモデルを選択できます。
CodexにはWeb検索機能が組み込まれていて、トップレベルのweb_searchで挙動を制御できます。
値はdisabled、cached、liveの3つで、デフォルトはcached(OpenAI側のキャッシュ済みインデックスを使う方式)です。
常に最新を取りに行きたいならliveを指定します。
なお旧来のfeatures.web_search_requestは非推奨になっているので、これから書く人はトップレベル一本でOKです。
既に何かしらが書かれている場合(trustedなど)は、改行してその下に追記します。
以下は私の設定です。
2026年4月時点で、私はこれが一番賢く、扱いやすいと感じています。
model = "gpt-5.5" # 最新の推奨モデル
web_search = "live" # 常に最新のWeb検索結果を取りに行く
approval_policy = "never" # 承認をスキップ(対話なしの「never」を指定。なお旧値の`on-failure`は非推奨)
model_reasoning_summary = "detailed" # 推論要約を詳細に出力させる(Codexは簡潔気味なので)
model_reasoning_effort = "xhigh" # 推論負荷最大(値は minimal | low | medium | high | xhigh)
hide_agent_reasoning = false # TUIとcodex execの出力で推論イベントを表示する
show_raw_agent_reasoning = true # アクティブなモデルが推論内容を出力した場合に、生の推論内容を表示する
windows_wsl_setup_acknowledged = true # Windowsのオンボーディング確認を追跡(Windowsユーザーのみ)
[features]
# v0.125.0時点で stable & on by default になった機能(shell_snapshot, shell_tool,
# multi_agent, fast_mode, personality, unified_exec など)はわざわざ書かなくて
# も有効になっています。明示的に切り替えたいものだけ列挙すればOKです。
undo = true # ターン単位のUndoを有効化(stable だがデフォルトはoff)
gpt-5.5が手元の/model一覧に出てこない場合は、CLIをアップデートすると現れます。Codexに最適化されたコーディング特化モデルを使いたい場合はgpt-5.3-codexという選択肢もあります。
プロジェクト単位で切り替えたい場合は、リポジトリ直下に .codex/config.toml を置くとスコープを分けられます。Codexは信頼済みプロジェクトでのみプロジェクト側の設定をロードする仕様です。
旧バージョンの記事に載っていたfeatures.apply_patch_freeform、features.remote_compaction、features.remote_models、features.powershell_utf8は現在の公式リファレンスから消えています。古い記事を見て書いたconfig.tomlがあれば、起動時に警告が出るので外しておきましょう。
MCPとの連携
MCPサーバーはC:\Users\ユーザー名\.codex\config.toml内に記述します。
例えば今話題のSerena MCPと連携してみましょう。
[mcp_servers.serena]
command = "uvx"
args = ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--context", "codex"]
とconfig.tomlに追記します。
Windows環境だとうまく動かないので、以下のようにフルパスで指定します。
[mcp_servers.serena]
command = 'C:\Users\ユーザー名\AppData\Local\Programs\Python\Python311\Scripts\uvx.exe'
args = ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--context", "codex", "--enable-web-dashboard=false"]
startup_timeout_sec = 30.0
[mcp_servers.serena.env]
SYSTEMROOT = 'C:\Windows'
初めてSerenaを使う場合は、以下のプロンプトでアクティブ化します。
Activate the current dir as project using serena
Usage
以下のページから確認できます。
設定一覧
設定の公式ドキュメントは以下です。
以下は和訳です(2026年4月時点)。
一般設定
| キー | 型・値 | 詳細 |
|---|---|---|
allow_login_shell |
ブール値 | シェル系ツールにログインシェルのセマンティクス利用を許可。デフォルトtrue
|
approval_policy |
untrusted | on-request | never | granularオブジェクト |
コマンド実行前に承認待ちにするタイミングを制御。granular形式では承認カテゴリごとの細粒度制御が可能。旧値on-failureは非推奨で、対話あり実行はon-request、非対話実行はneverを推奨 |
chatgpt_base_url |
文字列 | ChatGPTログイン時のベースURLを上書き |
check_for_update_on_startup |
ブール値 | 起動時にCodexの更新をチェック |
cli_auth_credentials_store |
file | keyring | auto
|
キャッシュ済み認証情報の保存先(auth.jsonかOSキーチェーン) |
commit_attribution |
文字列 | コミットの共著者トレーラー文字列を上書き。空文字列で自動付与を無効化 |
compact_prompt |
文字列 | 履歴圧縮プロンプトのインライン上書き |
default_permissions |
文字列 | サンドボックス内ツール呼び出しに適用するデフォルトの権限プロファイル名 |
developer_instructions |
文字列 | セッションに挿入する追加の開発者向け指示 |
disable_paste_burst |
ブール値 | TUIのバーストペースト検出を無効化 |
experimental_compact_prompt_file |
文字列(パス) | 圧縮プロンプトの上書きをファイルから読み込む(実験的) |
experimental_use_unified_exec_tool |
ブール値 | unified_execを有効にする旧式の名称。代わりに[features].unified_execまたはcodex --enable unified_execを推奨 |
file_opener |
vscode | vscode-insiders | windsurf | cursor | none
|
Codex出力からの引用を開くURIスキーム。デフォルトvscode
|
forced_chatgpt_workspace_id |
文字列(UUID) | ChatGPTログインを特定ワークスペースIDに制限 |
forced_login_method |
chatgpt | api
|
認証方法を特定の方式に固定 |
hide_agent_reasoning |
ブール値 | TUIとcodex execの出力で推論イベントを抑制 |
instructions |
文字列 | 将来予約。model_instructions_fileまたはAGENTS.mdを推奨 |
log_dir |
文字列(パス) | ログファイルの出力先。既定は$CODEX_HOME/log
|
model |
文字列 | 使用するモデル名(例: gpt-5-codex) |
notify |
文字列配列 | 通知時に呼び出されるコマンド。CodexからJSONペイロードを受け取る |
openai_base_url |
文字列 | 組み込みのopenaiプロバイダーのベースURL上書き |
oss_provider |
lmstudio | ollama
|
--oss実行時のデフォルトローカルプロバイダー |
personality |
none | friendly | pragmatic
|
パーソナリティに対応したモデルでの既定コミュニケーションスタイル。スレッド/ターン単位や/personalityで上書き可能 |
plan_mode_reasoning_effort |
none | minimal | low | medium | high | xhigh
|
プランモード固有の推論オーバーライド |
profile |
文字列 | 起動時に適用するデフォルトプロファイル(--profile相当) |
review_model |
文字列 |
/review時に使うモデル(指定なしなら現セッションのモデル) |
service_tier |
flex | fast
|
新規ターン時の優先サービスティア |
show_raw_agent_reasoning |
ブール値 | アクティブなモデルが推論内容を出した場合に生の推論を表示 |
sqlite_home |
文字列(パス) | エージェントジョブなどの永続ランタイム状態を保存するSQLite DBの置き場所 |
suppress_unstable_features_warning |
ブール値 | 開発中フラグ有効時の警告を抑制 |
tool_output_token_limit |
数値 | 個々のツール出力を履歴に格納するためのトークン予算 |
windows_wsl_setup_acknowledged |
ブール値 | Windowsのオンボーディング確認を追跡(Windows環境のみ) |
features(機能設定)
v0.125.0時点で安定版かつデフォルト有効になっている機能が増えており、明示的にfalseにしたい場合や、まだoffの実験的機能をonにしたい場合だけ書けばOKです。
| キー | 型・値 | 詳細 |
|---|---|---|
features.apps |
ブール値 | ChatGPT Apps/コネクタ統合(実験的) |
features.codex_hooks |
ブール値 |
hooks.jsonから読み込むライフサイクルフックを有効化(開発中、デフォルトoff) |
features.enable_request_compression |
ブール値 | ストリーミング送信ボディをzstd圧縮(stable、デフォルトon) |
features.fast_mode |
ブール値 | Fastモード選択とservice_tier = "fast"を有効化(stable、デフォルトon) |
features.multi_agent |
ブール値 | マルチエージェント協調ツール(spawn_agent、send_input、resume_agent、wait_agent、close_agent)を有効化(stable、デフォルトon) |
features.personality |
ブール値 | パーソナリティ選択コントロールを有効化(stable、デフォルトon) |
features.prevent_idle_sleep |
ブール値 | ターン実行中にスリープ抑止(実験的、デフォルトoff) |
features.shell_snapshot |
ブール値 | シェル環境をスナップショット化して繰り返しコマンドを高速化(stable、デフォルトon) |
features.shell_tool |
ブール値 | デフォルトのshellツールを有効化(stable、デフォルトon) |
features.skill_mcp_dependency_install |
ブール値 | スキルが必要とするMCP依存をプロンプトしてインストール(stable、デフォルトon) |
features.smart_approvals |
ブール値 | 一部の承認要求をガーディアンレビュアーサブエージェント経由でルーティング(実験的、デフォルトoff) |
features.undo |
ブール値 | Undo機能を有効化(stable、デフォルトoff) |
features.unified_exec |
ブール値 | PTYベースの統一execツールを使用(stable、Windows以外はデフォルトon) |
features.web_search |
ブール値 | 旧トグル。トップレベルweb_searchを推奨(非推奨) |
features.web_search_cached |
ブール値 | 旧トグル。web_search未設定時にtrueならweb_search = "cached"扱い(非推奨) |
features.web_search_request |
ブール値 | 旧トグル。web_search未設定時にtrueならweb_search = "live"扱い(非推奨) |
feedback(フィードバック設定)
| キー | 型・値 | 詳細 |
|---|---|---|
feedback.enabled |
ブール値 |
/feedbackによるフィードバック送信を有効化(デフォルトtrue) |
history(履歴設定)
| キー | 型・値 | 詳細 |
|---|---|---|
history.max_bytes |
数値 | 履歴ファイルのバイト数上限。古いエントリから削除される |
history.persistence |
save-all | none
|
セッショントランスクリプトをhistory.jsonlに保存するかどうか |
agents(マルチエージェント設定)
| キー | 型・値 | 詳細 |
|---|---|---|
agents.<n>.config_file |
文字列(パス) | 当該ロール用のTOML設定レイヤーへのパス |
agents.<n>.description |
文字列 | エージェントタイプ選択時にCodexへ提示するロール案内 |
agents.<n>.nickname_candidates |
文字列配列 | スポーンしたエージェントの表示用ニックネーム候補 |
agents.job_max_runtime_seconds |
数値 |
spawn_agents_on_csvジョブ1ワーカーあたりのデフォルトタイムアウト(未設定なら1800秒) |
agents.max_depth |
数値 | スポーンしたエージェントスレッドの最大ネスト深度。ルートは深さ0、デフォルト1 |
agents.max_threads |
数値 | 同時に開けるエージェントスレッド数の上限。デフォルト6 |
apps(ChatGPT Apps/コネクタ設定)
| キー | 型・値 | 詳細 |
|---|---|---|
apps._default.destructive_enabled |
ブール値 |
destructive_hint = trueなツールのデフォルト許可/拒否 |
apps._default.enabled |
ブール値 | アプリ単位の上書きがない場合のデフォルト有効状態 |
apps._default.open_world_enabled |
ブール値 |
open_world_hint = trueなツールのデフォルト許可/拒否 |
apps.<id>.default_tools_approval_mode |
auto | prompt | approve
|
アプリ内ツールに対するデフォルト承認挙動 |
apps.<id>.default_tools_enabled |
ブール値 | アプリ内ツールのデフォルト有効状態 |
apps.<id>.destructive_enabled |
ブール値 | このアプリ内のdestructive_hint = trueツールの可否 |
apps.<id>.enabled |
ブール値 | アプリ/コネクタ個別の有効/無効(デフォルトtrue) |
apps.<id>.open_world_enabled |
ブール値 | このアプリ内のopen_world_hint = trueツールの可否 |
apps.<id>.tools.<tool>.approval_mode |
auto | prompt | approve
|
個別ツールの承認挙動を上書き |
apps.<id>.tools.<tool>.enabled |
ブール値 | 個別ツールの有効/無効を上書き(例: repos/list) |
MCP(Model Context Protocol)関連
| キー | 型・値 | 詳細 |
|---|---|---|
mcp_oauth_callback_port |
整数 | MCP OAuthログイン時のローカルHTTPコールバックサーバーの固定ポート |
mcp_oauth_callback_url |
文字列 | MCP OAuthログイン時のリダイレクトURI上書き |
mcp_oauth_credentials_store |
auto | file | keyring
|
MCP OAuth認証情報の推奨保存先 |
mcp_servers(MCPサーバー設定)
| キー | 型・値 | 詳細 |
|---|---|---|
mcp_servers.<id>.args |
文字列配列 | MCP stdioサーバー起動コマンドへの引数 |
mcp_servers.<id>.bearer_token_env_var |
文字列 | MCP HTTPサーバー用ベアラートークンを取得する環境変数 |
mcp_servers.<id>.command |
文字列 | MCP stdioサーバー起動コマンド |
mcp_servers.<id>.cwd |
文字列 | MCP stdioサーバープロセスの作業ディレクトリ |
mcp_servers.<id>.disabled_tools |
文字列配列 |
enabled_toolsの後に適用される拒否リスト |
mcp_servers.<id>.enabled |
ブール値 | 設定を残したままMCPサーバーを無効化 |
mcp_servers.<id>.enabled_tools |
文字列配列 | MCPサーバーが公開するツール名の許可リスト |
mcp_servers.<id>.env |
map | MCP stdioサーバーへ渡す環境変数 |
mcp_servers.<id>.env_http_headers |
map | 環境変数経由でMCP HTTPサーバーへ付与するヘッダー |
mcp_servers.<id>.env_vars |
文字列配列 | MCP stdioサーバーでホワイトリスト化する追加環境変数 |
mcp_servers.<id>.http_headers |
map | 各MCP HTTPリクエストに付加する静的ヘッダー |
mcp_servers.<id>.oauth_resource |
文字列 | MCPログイン時のRFC 8707 OAuthリソースパラメータ |
mcp_servers.<id>.required |
ブール値 | trueの場合、有効化済みMCPサーバーが起動できないと起動/再開を失敗させる |
mcp_servers.<id>.scopes |
文字列配列 | 認証時に要求するOAuthスコープ |
mcp_servers.<id>.startup_timeout_ms |
数値 |
startup_timeout_secのミリ秒エイリアス |
mcp_servers.<id>.startup_timeout_sec |
数値 | デフォルト10秒の起動タイムアウトを上書き |
mcp_servers.<id>.tool_timeout_sec |
数値 | デフォルト60秒のツール単位タイムアウトを上書き |
mcp_servers.<id>.url |
文字列 | MCPストリーム対応HTTPサーバーのエンドポイント |
model(モデル関連設定)
| キー | 型・値 | 詳細 |
|---|---|---|
model_auto_compact_token_limit |
数値 | 履歴自動圧縮をトリガーするトークン閾値(未設定時はモデル既定) |
model_catalog_json |
文字列(パス) | 起動時に読み込むJSONモデルカタログのパス |
model_context_window |
数値 | アクティブモデルが使えるコンテキストウィンドウのトークン数 |
model_instructions_file |
文字列(パス) |
AGENTS.mdの代わりに使う指示ファイル |
model_provider |
文字列 |
model_providersで指定したプロバイダーID(デフォルトopenai) |
model_reasoning_effort |
minimal | low | medium | high | xhigh
|
推論負荷を調整(Responses API専用、xhighはモデル依存)。旧表記のminは無効 |
model_reasoning_summary |
auto | concise | detailed | none
|
推論要約の詳細度、または完全無効化 |
model_supports_reasoning_summaries |
ブール値 | 不明なモデルでも推論メタデータを送るかを強制 |
model_verbosity |
low | medium | high
|
GPT-5 Responses APIの詳細度を上書き |
model_providers(モデルプロバイダー設定)
| キー | 型・値 | 詳細 |
|---|---|---|
model_providers.<id>.base_url |
文字列 | プロバイダーAPIのベースURL |
model_providers.<id>.env_http_headers |
map | 環境変数から取得するHTTPヘッダー |
model_providers.<id>.env_key |
文字列 | APIキーを供給する環境変数 |
model_providers.<id>.env_key_instructions |
文字列 | APIキー設定に関する任意のガイダンス |
model_providers.<id>.experimental_bearer_token |
文字列 | プロバイダー直接のベアラートークン(非推奨。env_keyを使うこと) |
model_providers.<id>.http_headers |
map | プロバイダーリクエストへ付加する静的ヘッダー |
model_providers.<id>.name |
文字列 | カスタムプロバイダーの表示名 |
model_providers.<id>.query_params |
map | リクエストへ付加する追加クエリパラメータ |
model_providers.<id>.request_max_retries |
数値 | プロバイダーへのHTTPリクエストのリトライ回数(デフォルト4) |
model_providers.<id>.requires_openai_auth |
ブール値 | OpenAI認証を使うかどうか(デフォルトfalse) |
model_providers.<id>.stream_idle_timeout_ms |
数値 | SSEストリームのアイドルタイムアウト(ミリ秒、デフォルト300000) |
model_providers.<id>.stream_max_retries |
数値 | SSEストリーミング中断時のリトライ回数(デフォルト5) |
model_providers.<id>.supports_websockets |
ブール値 | プロバイダーがResponses APIのWebSocketトランスポートに対応するか |
model_providers.<id>.wire_api |
responses |
使用するプロトコル。現在はresponsesのみサポート(省略時のデフォルトもこれ。旧値chatは廃止予定) |
permissions(権限プロファイル)
v0.125.0時点で追加されている、名前付きの権限プロファイル系設定です。default_permissionsから既定プロファイル名を指定できます。
| キー | 型・値 | 詳細 |
|---|---|---|
permissions.<n>.filesystem |
テーブル | 名前付きファイルシステム権限プロファイル。各キーは絶対パス、または:minimal、:project_rootsなどの特殊トークン |
permissions.<n>.filesystem.":project_roots".<subpath> |
"read" | "write" | "none"
|
検出されたプロジェクトルート相対のスコープ付きアクセス。ルート自体は"."
|
permissions.<n>.filesystem.<path> |
"read" | "write" | "none" | テーブル |
パスや特殊トークンに対する直接アクセス、またはネスト指定 |
permissions.<n>.network.allow_local_binding |
ブール値 | プロキシ経由のローカルbind/listenを許可 |
permissions.<n>.network.allow_unix_sockets |
文字列配列 | プロキシ通過を許可するUnixソケットパス |
permissions.<n>.network.allow_upstream_proxy |
ブール値 | 別の上流プロキシへのチェーンを許可 |
permissions.<n>.network.allowed_domains |
文字列配列 | プロキシ通過を許可するドメイン |
permissions.<n>.network.dangerously_allow_all_unix_sockets |
ブール値 | 任意のUnixソケットを許可(危険) |
permissions.<n>.network.dangerously_allow_non_loopback_proxy |
ブール値 | 非ループバックバインドを許可(危険) |
permissions.<n>.network.denied_domains |
文字列配列 | プロキシでブロックするドメイン |
permissions.<n>.network.enable_socks5 |
ブール値 | SOCKS5リスナーを公開 |
permissions.<n>.network.enable_socks5_udp |
ブール値 | SOCKS5上のUDPを許可 |
permissions.<n>.network.enabled |
ブール値 | このプロファイルでネットワークアクセスを有効化 |
permissions.<n>.network.mode |
limited | full
|
サブプロセストラフィック用ネットワークプロキシモード |
permissions.<n>.network.proxy_url |
文字列 | 管理プロキシのHTTPエンドポイント |
permissions.<n>.network.socks_url |
文字列 | このプロファイルが使うSOCKS5プロキシエンドポイント |
notice(通知設定)
| キー | 型・値 | 詳細 |
|---|---|---|
notice.hide_full_access_warning |
ブール値 | フルアクセス警告の確認状態を追跡 |
notice.hide_gpt-5.1-codex-max_migration_prompt |
ブール値 | gpt-5.1-codex-max移行プロンプトの確認状態を追跡 |
notice.hide_gpt5_1_migration_prompt |
ブール値 | GPT-5.1移行プロンプトの確認状態を追跡 |
notice.hide_rate_limit_model_nudge |
ブール値 | レート制限時のモデル切替リマインダーをオプトアウト |
notice.hide_world_writable_warning |
ブール値 | Windowsのworld-writableディレクトリ警告の確認状態を追跡 |
notice.model_migrations |
map | 確認済みモデル移行を旧→新でマッピング |
otel(OpenTelemetry設定)
| キー | 型・値 | 詳細 |
|---|---|---|
otel.environment |
文字列 | OTELイベントに付与する環境タグ(デフォルトdev) |
otel.exporter |
none | otlp-http | otlp-grpc
|
OTELエクスポーター選択 |
otel.exporter.<id>.endpoint |
文字列 | OTELログのエクスポート先エンドポイント |
otel.exporter.<id>.headers |
map | OTELエクスポート要求の静的ヘッダー |
otel.exporter.<id>.protocol |
binary | json
|
OTLP/HTTPエクスポーターのプロトコル |
otel.exporter.<id>.tls.ca-certificate |
文字列 | OTELエクスポート用TLSのCA証明書パス |
otel.exporter.<id>.tls.client-certificate |
文字列 | OTELエクスポート用TLSのクライアント証明書パス |
otel.exporter.<id>.tls.client-private-key |
文字列 | OTELエクスポート用TLSのクライアント秘密鍵パス |
otel.log_user_prompt |
ブール値 | OTELログに生のユーザープロンプトをエクスポート |
otel.metrics_exporter |
none | statsig | otlp-http | otlp-grpc
|
OTELメトリクスエクスポーター(デフォルトstatsig) |
otel.trace_exporter |
none | otlp-http | otlp-grpc
|
OTELトレースエクスポーター |
otel.trace_exporter.<id>.endpoint |
文字列 | OTELトレースエンドポイント |
otel.trace_exporter.<id>.headers |
map | OTELトレース要求の静的ヘッダー |
otel.trace_exporter.<id>.protocol |
binary | json
|
OTLP/HTTPトレースエクスポーターのプロトコル |
otel.trace_exporter.<id>.tls.ca-certificate |
文字列 | OTELトレース用TLSのCA証明書パス |
otel.trace_exporter.<id>.tls.client-certificate |
文字列 | OTELトレース用TLSのクライアント証明書パス |
otel.trace_exporter.<id>.tls.client-private-key |
文字列 | OTELトレース用TLSのクライアント秘密鍵パス |
profiles(プロファイル設定)
| キー | 型・値 | 詳細 |
|---|---|---|
profiles.<n>.* |
各種 | サポート済み設定キーのプロファイル単位での上書き |
profiles.<n>.analytics.enabled |
ブール値 | プロファイル単位のアナリティクス有効化 |
profiles.<n>.experimental_use_unified_exec_tool |
ブール値 | unified_execを有効にする旧式名([features].unified_execを推奨) |
profiles.<n>.model_catalog_json |
文字列(パス) | プロファイル単位のモデルカタログJSON上書き |
profiles.<n>.model_instructions_file |
文字列(パス) | プロファイル単位の組み込み指示ファイル置換 |
profiles.<n>.oss_provider |
lmstudio | ollama
|
--ossセッションのプロファイル単位OSSプロバイダー |
profiles.<n>.personality |
none | friendly | pragmatic
|
プロファイル単位のコミュニケーションスタイル上書き |
profiles.<n>.plan_mode_reasoning_effort |
none | minimal | low | medium | high | xhigh
|
プロファイル単位のプランモード推論上書き |
profiles.<n>.service_tier |
flex | fast
|
プロファイル単位のサービスティア |
profiles.<n>.tools_view_image |
ブール値 |
view_imageツールの有効化/無効化 |
profiles.<n>.web_search |
disabled | cached | live
|
プロファイル単位のWeb検索モード上書き(デフォルトcached) |
profiles.<n>.windows.sandbox |
unelevated | elevated
|
プロファイル単位のWindowsサンドボックスモード |
project(プロジェクト設定)
| キー | 型・値 | 詳細 |
|---|---|---|
project_doc_fallback_filenames |
文字列配列 |
AGENTS.mdが無い場合に試行する追加ファイル名 |
project_doc_max_bytes |
数値 | プロジェクト指示構築時にAGENTS.mdから読み込む最大バイト数 |
project_root_markers |
文字列配列 | プロジェクトルート判定用ファイル名のリスト |
projects.<path>.trust_level |
文字列 | プロジェクトを"trusted"または"untrusted"にマーク。untrustedはプロジェクト側.codex/レイヤーをスキップ |
sandbox(サンドボックス設定)
| キー | 型・値 | 詳細 |
|---|---|---|
sandbox_mode |
read-only | workspace-write | danger-full-access
|
コマンド実行時のFS/ネットワークサンドボックスポリシー |
sandbox_workspace_write.exclude_slash_tmp |
ブール値 | workspace-writeモード時に書き込み可能ルートから/tmpを除外 |
sandbox_workspace_write.exclude_tmpdir_env_var |
ブール値 | workspace-writeモード時に書き込み可能ルートから$TMPDIRを除外 |
sandbox_workspace_write.network_access |
ブール値 | workspace-writeサンドボックス内での外部ネットワークアクセスを許可 |
sandbox_workspace_write.writable_roots |
文字列配列 |
sandbox_mode = "workspace-write"時に追加で書き込み可能なルート |
shell_environment_policy(シェル環境ポリシー)
| キー | 型・値 | 詳細 |
|---|---|---|
shell_environment_policy.exclude |
文字列配列 | デフォルトの後に環境変数を削除するグロブパターン |
shell_environment_policy.experimental_use_profile |
ブール値 | サブプロセス起動時にユーザーシェルプロファイルを使用 |
shell_environment_policy.ignore_default_excludes |
ブール値 | KEY/SECRET/TOKENを含む変数を他のフィルタ前に保持 |
shell_environment_policy.include_only |
文字列配列 | 指定パターンに一致する変数のみ保持するホワイトリスト |
shell_environment_policy.inherit |
all | core | none
|
サブプロセス起動時のベースライン環境継承 |
shell_environment_policy.set |
map | すべてのサブプロセスに明示的に注入する環境変数 |
skills(スキル設定)
| キー | 型・値 | 詳細 |
|---|---|---|
skills.config |
object配列 | 各スキルの有効化状態をconfig.tomlに保存される上書きとして記録 |
skills.config.<index>.enabled |
ブール値 | 参照スキルの有効/無効 |
skills.config.<index>.path |
文字列(パス) |
SKILL.mdを含むスキルフォルダへのパス |
tools(ツール設定)
| キー | 型・値 | 詳細 |
|---|---|---|
tools.view_image |
ブール値 | ローカル画像添付ツールview_imageを有効化 |
tools.web_search |
ブール値 | オブジェクト | Web検索ツール設定。オブジェクト形式ではcontext_size、allowed_domains、locationを指定可能 |
tui(TUI設定)
| キー | 型・値 | 詳細 |
|---|---|---|
tui |
テーブル | TUI固有のオプション |
tui.alternate_screen |
auto | always | never
|
TUIの代替画面の使用制御。autoはZellijでは自動スキップ |
tui.animations |
ブール値 | ターミナルアニメーション(ウェルカム画面、シマー、スピナー等)を有効化(デフォルトtrue) |
tui.model_availability_nux.<model> |
整数 | モデルslugで管理する起動ツールチップの内部状態 |
tui.notification_method |
auto | osc9 | bel
|
非フォーカス時のターミナル通知方式(デフォルトauto) |
tui.notifications |
ブール値 | 文字列配列 | TUI通知を有効化。イベントタイプを限定することも可能 |
tui.show_tooltips |
ブール値 | ウェルカム画面でオンボーディングツールチップを表示(デフォルトtrue) |
tui.status_line |
文字列配列 | null | TUIフッターステータスラインの並び。nullで無効化 |
tui.theme |
文字列 | シンタックスハイライトのテーマ上書き(kebab-caseのテーマ名) |
web_search(トップレベル)
| キー | 型・値 | 詳細 |
|---|---|---|
web_search |
disabled | cached | live
|
Web検索モード(デフォルトcached)。cachedはOpenAI管理インデックスを使用しライブ取得しない。--yolo等のフルアクセス時はデフォルトがliveになる |
windows(Windows固有)
| キー | 型・値 | 詳細 |
|---|---|---|
windows.sandbox |
unelevated | elevated
|
WindowsネイティブでCodexを動かす場合のサンドボックスモード |
windows.sandbox_private_desktop |
ブール値 | サンドボックス子プロセスをプライベートデスクトップで実行(デフォルトtrue)。互換性のためWinsta0\Defaultに戻す場合のみfalse |
スラッシュコマンド一覧
公式ドキュメントは以下です。
以下は和訳です。/approvalsはエイリアスとして残っているもののポップアップに出てこなくなり、現在は/permissionsが正です。/plan、/fast、/personality、/agent、/apps、/pluginsなどが新規に追加されています。
| コマンド | 目的 | 使用場面 |
|---|---|---|
/permissions |
事前確認なしで実行させたい動作を設定 | セッション中に承認要件を調整(AutoとRead Onlyの切り替えなど) |
/sandbox-add-read-dir |
サンドボックスに追加の読み取り可能ディレクトリを付与(Windows限定) | 現在の読み取り可能ルート外の絶対パスを必要とするコマンドのアンブロック |
/agent |
アクティブなエージェントスレッドを切り替え | スポーンしたサブエージェントスレッドを確認・続行 |
/apps |
アプリ(コネクタ)をブラウズしてプロンプトに挿入 | Codexに使わせたいアプリを$app-slugとしてアタッチ |
/plugins |
インストール済みおよび発見可能なプラグインをブラウズ | プラグインのツール確認、推奨プラグインのインストール、利用可否の管理 |
/clear |
ターミナルをクリアして新しいチャットを開始 | UIと会話の両方を一度にリセットしたいとき |
/compact |
会話を要約してトークンを解放 | 長時間のセッション後に、コンテキストウィンドウを圧迫せず要点を保持 |
/copy |
直近の完了した出力をコピー | 完了した応答やプラン本文を手動選択せずに取得 |
/diff |
Gitが追跡していないファイルを含む差分を表示 | コミットやテスト前にCodexの編集を確認 |
/exit |
CLIを終了(/quitと同じ) |
別表記。どちらでも終了 |
/experimental |
実験的機能のオン/オフ | サブエージェント等の任意機能を有効化 |
/feedback |
ログをCodexメンテナへ送信 | 問題報告やサポート向けの診断情報送信 |
/init |
現在のディレクトリにAGENTS.mdの雛形を生成 |
リポジトリやサブディレクトリの永続的な指示を記録 |
/logout |
Codexからログアウト | 共有マシンでローカル認証情報を消去 |
/mcp |
設定済みMCPツールの一覧を表示 | セッション中にCodexが呼び出せる外部ツールを確認 |
/mention |
ファイルを会話に添付 | Codexに次に検査させたい特定のファイルやフォルダを指定 |
/model |
アクティブなモデル(と利用可能なら推論レベル)を選択 | タスク前に汎用モデルと深い推論モデルを切り替え |
/fast |
Fastモードのトグル | Fastモードのオン/オフ切替や状態確認 |
/plan |
プランモードに切り替え、必要ならプロンプトも送信 | 実装前にCodexへ実行プランを提案させる |
/personality |
応答のコミュニケーションスタイルを選択 | 指示文を変えずに簡潔/説明的/協調的に切り替え |
/ps |
バックグラウンドターミナルとその直近出力を表示 | メイントランスクリプトを離れずに長時間コマンドの状態を確認 |
/stop |
全バックグラウンドターミナルを停止 | 現セッションで起動したバックグラウンド処理をキャンセル |
/fork |
現在の会話を新しいスレッドとして分岐 | 現セッションのトランスクリプトを失わずに別アプローチを試す |
/resume |
保存済み会話を一覧から再開 | 前回CLIセッションの中断箇所から再開 |
/new |
同じCLIセッション内で新しい会話を開始 | CLIを終了せずにチャットコンテキストをリセット |
/quit |
CLIを終了 | セッションを直ちに終了 |
/review |
Codexに作業ツリーのレビューを依頼 | 作業完了後やローカル変更を別視点で確認したいとき |
/status |
セッション設定とトークン使用状況を表示 | 現在のモデル、承認ポリシー、書き込み可能ルート、コンテキスト残量を確認 |
/debug-config |
設定レイヤーと要件の診断を表示 | 優先順位やポリシー要件のデバッグ |
/statusline |
TUIフッター項目を対話的に設定 | モデル/コンテキスト/制限/git/トークン/セッションをピックして並べ替え、config.tomlに永続化 |
/title |
ターミナルタイトル項目を対話的に設定 | プロジェクト/ステータス/スレッド/ブランチ/モデル/タスク進捗等を選んで並べ替え |
役に立ったことがあれば随時追加していきます。
これからもQiitaで発信していくので、気になったらいいね・フォローしていただけると嬉しいです。