Codex CLI 0.171.0:GPT-6.2 Sol既定化、TUIワークスペースとリモート実行
Codex CLI 0.171.0ではGPT-6.2 Solがモデルカタログの既定になり、分割ペインのTUIワークスペースも標準で有効化されました。さらにcodex exec --remote <ADDR>と/rcが追加され、ディレクトリ変更時もpermission profilesが保持されます。有効なモデルIDの確認、GPT-6.2 AstraやBetterTokenなどカスタムAPIへの切り替え、ワークスペースの無効化、リモート実行の前提条件をまとめて解説します。
目次

Codex CLI 0.171.0(2026年11月20日公開)へ更新すると、gpt-6.2-sol がカタログの既定モデルに追加され、分割ペインのTUIワークスペースが標準で有効になります。この変更は、config.toml で model を固定せずに codex を起動する開発者、codex exec をスクリプト化するチーム、CodexをカスタムAPIプロバイダーに接続している利用者に影響します。Astraを使い続けるには config.toml に model = "gpt-6.2-astra" を指定し、従来の単一ペイン表示に戻すには codex features disable tui_workspace を実行してください。従量課金のGPT-6.2 APIを使う設定手順も以下で確認できます。
Codex CLI 0.171.0でGPT-6.2 SolとAstraを使うルート比較
設定を変更する前に、Codexの認証方式とGPT-6.2の課金ルートを決めておきます。選択した認証ルートによって、利用できるモデルIDと、Codex cloudや /rc リモート操作といったChatGPT限定機能の可否が変わります。
| ルート | アカウントと認証 | 課金単位 | Codex 0.171.0の対応と制限 | 向いているケース |
|---|---|---|---|---|
ChatGPTサブスクリプション(codex login) | ブラウザー認証によるChatGPTアカウント | プランの使用枠(ローカルメッセージとクラウドチャットで共有) | Codex cloudと /rc リモート操作に対応。ChatGPT Pro 200ではSolでUltrafastを利用可能 | 対象のChatGPTプランを契約済みで、クラウド機能やリモート操作を使いたい場合 |
| OpenAI API直接利用 | OpenAI Platformアカウント+APIキー | 1Mトークン単位(USD) | gpt-6.2-sol と gpt-6.2-astra を利用可能。クラウド機能はなく、APIキー認証では /rc リモート操作も利用不可 | OpenAIから直接請求を受け、API組織のデータ管理ポリシーを使いたい場合 |
| BetterToken APIゲートウェイ | BetterTokenアカウント+APIキー | 各モデルの課金単位に応じて残高から差し引く従量課金 | OpenAI Responses(https://www.bettertoken.ai/v1)経由で gpt-6.2-sol と gpt-6.2-astra に対応。購入した有料残高は毎月リセットされない | ChatGPTサブスクリプションなしで、複数モデルを従量課金APIで使いたい場合 |
Codex CLI 0.171.0をBetterTokenで設定する
BetterTokenは従量課金で複数モデルを利用できるAPIアクセス基盤であり、OpenAIの公式製品ではありません。2026-11-21時点で、BetterTokenはOpenAI Responsesプロトコル(https://www.bettertoken.ai/v1)経由で gpt-6.2-sol と gpt-6.2-astra の両方を現在の料金ページに掲載しています。Codex対応の全体像はCodex APIの概要で確認できます。
まずBetterTokenアカウントを登録し、BetterTokenコンソールでAPIキーを作成します。auth.json によるファイルベースのAPIキー認証を使うと公式のChatGPTログインが置き換わるため、このモードでは /rc リモート操作やChatGPT Pro 200のUltrafastといったChatGPT限定機能は使えません。公式のChatGPTログインを維持したままサードパーティープロバイダーを併用したい場合は、auth.json を直接編集せず、BetterTokenの公式ログイン保持ガイドに従ってください。
設定ファイルを編集する前に、Codex CLIとCodex Appを完全に終了します。両クライアントは同じCodexディレクトリ($CODEX_HOME を設定していればそのパス、未設定ならmacOS/Linuxでは ~/.codex、Windowsでは %USERPROFILE%\.codex)内の config.toml と auth.json を共有します(詳細はCodex CLI・Codex App・VS Code拡張の違いを参照してください)。作業対象ディレクトリにある config.toml と auth.json を安全な場所へバックアップし、config.toml が存在しない場合は新規作成します。
config.toml では、既存のルートキー model_provider、model、cli_auth_credentials_store をその場で更新し、不足しているキーだけを [tables] より前の先頭領域に追加します。[model_providers.bettertoken] がすでにある場合はテーブルヘッダーを重複させず既存テーブルへ項目を統合し、未定義なら下記のテーブルを追記してください。BetterTokenのCodex設定ガイドに従い、無関係な既存設定はそのまま残します。
model_provider = "bettertoken"
model = "gpt-6.2-sol"
cli_auth_credentials_store = "file"
[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false
Astraを既定にしたい場合は model を "gpt-6.2-astra" に書き換えます。ファイル認証を使うときは、[model_providers.bettertoken] から env_key と experimental_bearer_token を削除してください。
次に、同じCodexディレクトリへ auth.json を書き込みます。BashとPython 3が使えるmacOSまたはLinuxでは、次のコマンドを実行してキーを画面表示せずに入力してください。入力がキャンセルまたは空の場合は auth.json を変更せずに終了し、書き込む際は所有者専用権限(0600)で一時ファイルを作成してから置換します。ネイティブのWindows環境では、BetterTokenのCodex設定ガイドにあるファイル認証手順に従い、使用中のCodexディレクトリ($CODEX_HOME または %USERPROFILE%\.codex)で auth_mode を "apikey"、OPENAI_API_KEY に自分のキーを設定します。
CODEX_DIR="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_DIR"
if IFS= read -rs BETTERTOKEN_API_KEY && [ -n "$BETTERTOKEN_API_KEY" ]; then
export BETTERTOKEN_API_KEY CODEX_DIR
python3 -c 'import json, os, pathlib, tempfile
dir_path = pathlib.Path(os.environ["CODEX_DIR"])
fd, tmp_name = tempfile.mkstemp(prefix=".auth.", dir=dir_path)
try:
os.fchmod(fd, 0o600)
with os.fdopen(fd, "w", encoding="utf-8") as fh:
json.dump({"auth_mode": "apikey", "OPENAI_API_KEY": os.environ["BETTERTOKEN_API_KEY"]}, fh, indent=2)
fh.write("\n")
os.replace(tmp_name, dir_path / "auth.json")
except Exception:
os.unlink(tmp_name)
raise'
unset BETTERTOKEN_API_KEY
else
echo "API key entry cancelled or empty; auth.json was not changed." >&2
fi
Node.jsが導入済みで自動設定を使いたい場合、BetterTokenのCodexドキュメントにはmacOS/Linux向けの curl -fsSL "https://www.bettertoken.ai/install-codex-provider.sh" | bash と、Windows向けのPowerShellインストーラー(install-codex-provider.ps1)も用意されています。Codexを起動する前に、生成された config.toml と auth.json が上記の手動設定と一致しているか確認してください。
動作確認として新しい codex セッションを起動し、/status で Model(gpt-6.2-sol)と Model provider の行を確認してから短いプロンプトを送信します。通常の応答が返ればResponses接続は成功です。
OpenAIの公式ルートを使う場合は、npm install -g @openai/codex@0.171.0 で0.171.0をインストールまたは更新し(すでに0.171.0を導入済みならそのまま利用できます)、codex --version の出力に 0.171.0 が含まれることを確認します。そのうえで、ChatGPTサブスクリプションを使うなら codex login を実行し、OpenAI APIキーでログインする場合はOpenAIのCodex認証リファレンスに従ってください。サブスクリプション枠とAPI課金のどちらを選ぶか検討しているチームは、ChatGPTとCodexの共有利用枠の計画方法も参考になります。
GPT-6.2 Sol既定化の確認とAstraや別モデルへの切り替え
PR #62106により、Codex CLI 0.171.0は同梱カタログ、Amazon Bedrockカタログ、Vertexカタログへ gpt-6.2-sol と gpt-6.2-astra を追加し、gpt-6.2-sol を既定のカタログ選択(priority: 1)にしました。あわせて、gpt-6.1-sol のカタログ上のコンテキストウィンドウは 500,000 トークンへ拡大されています。
0.171.0の同梱カタログ(codex-rs/models-manager/models.json)では、gpt-6.2-sol のコンテキストウィンドウは 500,000 トークン、gpt-6.2-astra は 272,000 トークンと定義されており、どちらも default_reasoning_level は "low" です。一方、2026-11-21時点のOpenAI公式APIドキュメントでは、GPT-6.2 SolとGPT-6.2 Astraはいずれも 1,050,000 トークンのコンテキストウィンドウ(最大入力 922,000、最大出力 128,000)に対応し、推論強度 none は拒否されます。
更新によって現在使われるモデルが変わるかどうかは、設定内容と有効なカタログ次第です(codex-rs/models-manager/src/manager.rs)。
config.tomlでmodelが未設定の場合、get_default_modelが有効カタログの既定値(default_model_from_available)を選びます。0.171.0の同梱カタログを使うセッションではgpt-6.2-solが選択されます。- ユーザーの
config.toml(または信頼済みプロジェクトの.codex/config.toml)でmodelを明示指定している場合、プロバイダーのフォールバックが有効で利用不可モデルを置き換えない限り、Codexはその指定モデルを維持します。
導入済みバイナリに同梱されているカタログを確認するには、次を実行します。
codex debug models --bundled
対話型TUIセッション内では /status を実行して Model 行(および設定されている場合は Model provider 行)を確認してください。config.toml を書き換えずにモデルを切り替えるには、TUI内で /model を実行するか、起動時に --model / -m を渡します。
codex -m gpt-6.2-astra
codex exec -m gpt-6.2-astra "Audit the auth middleware for race conditions"
gpt-6.2-astra(または gpt-6.1-sol のような旧モデル)を恒久的な既定値にするには、$CODEX_HOME/config.toml(既定は ~/.codex/config.toml)のルート領域(すべての [tables] より上)に model = "gpt-6.2-astra" を追記または更新し、Codexを再起動します。
2026-11-21時点で、入力トークンが 272K 以下のリクエストに対するOpenAIのStandard APIテキストトークン公開価格は、GPT-6.2 Solが1Mトークンあたり入力 $2 / 出力 $10、GPT-6.2 Astraが1Mトークンあたり入力 $8 / 出力 $40 です。どちらのモデルでも入力が 272K トークンを超えるリクエストでは、リクエスト全体に対して入力とキャッシュの単価が2倍になり、出力は短コンテキスト単価の1.5倍になります。日常的な実装作業はSolから始め、複数ファイルにまたがる深い推論が必要なときにAstraへ切り替えるのが基本です。詳しい選定基準はGPT-6 Astra・Sol・Lunaの使い分けガイドをご覧ください。なお、SolのUltrafastモードはChatGPT Pro 200サブスクリプション向けの機能であり(OpenAI API上では2027年2月28日までStandard料金の3倍)、カスタムゲートウェイの既定設定ではありません。
カスタムプロバイダーでカタログ名と実際のモデルIDを対応付ける
Codexのモデル選択画面には GPT-6.2-Sol や GPT-6.2-Astra のような見やすい表示名が並びますが、実際にAPIへ送信するモデルIDはプロバイダーごとに異なります。
| プロバイダー | GPT-6.2 Sol ID | GPT-6.2 Astra ID | 補足 |
|---|---|---|---|
| OpenAI API(直接) | gpt-6.2-sol | gpt-6.2-astra | Codex同梱カタログのスラッグと一致 |
BetterToken(https://www.bettertoken.ai/v1) | gpt-6.2-sol | gpt-6.2-astra | 2026-11-21時点でBetterToken上のOpenAI Responses(openai-response)、openai、anthropic 各エンドポイント形式で確認済み |
| Amazon Bedrock | openai.gpt-6.2-sol | openai.gpt-6.2-astra | カタログ正規化ではBedrock RuntimeのクロスリージョンID global.openai.gpt-6.2-astra と us.openai.gpt-6.2-astra も認識 |
| Google Vertex AI | gpt-6.2-sol | gpt-6.2-astra | PR #62106で組み込みGCPカタログに追加 |
その他のカスタム model_provider | プロバイダー定義 | プロバイダー定義 | config.toml で正確な model = "..." を固定 |
config.toml で model を省略すると、Codexはカスタムゲートウェイ側の命名規則を推測せず、有効カタログから既定値を解決します。利用中のカスタム model_provider が同梱カタログのスラッグと異なるベンダー接頭辞や別名を使っている場合、ゲートウェイが期待する正確な model = "..." を config.toml のルートに固定するまでリクエストが失敗する可能性があります(プロジェクトの trust_level を格納する [projects."<path>"] の内側には書かないでください)。
既定で有効になったTUIワークスペースの変更点と無効化手順
PR #61352によって tui_workspace 機能が Stable に昇格し、default_enabled: true になりました。更新すると、ターミナルのメイン会話の横に次のビューが開くようになります。
- ドキュメントプレビュー(PR #61888、PR #61889):会話ログ内のファイルリンクを開くと、サイドバーに読み取り専用のMarkdownタブが表示されます。検索、キーボードやマウスによる選択、オフラインでのMarkdownコピー、
Tab/Shift+TabとEnterによるリンク移動に対応しています。 - 画像プレビュー(PR #61919):PNG、JPEG、GIF、WebPのリンクを形式と解像度ラベル付きのサイドバー画像プレビューとして開き、ターミナルの画像表示が使えない環境ではテキスト表示にフォールバックします。生成・保存が完了した画像はアシスタントの回答直後にクリック可能な
Generated imageラベル付きで表示されます。 - サブエージェント履歴(PR #62157):サイドバーからサブエージェントを選ぶと、現在のチャットを置き換えるのではなく、親会話の横に閲覧専用タブとして開きます。
サイドバーの表示を閉じる操作はフォーカス中のパネルによって異なります。
- ドキュメントプレビューでは
Escキーでプレビューを閉じます。 - サブエージェント履歴ビューアーでは
Escキーで同じエージェントを選択したままサブエージェント一覧へ戻り、タブ自体を閉じるにはサイドバーの閉じるボタンまたは閉じるショートカットを使います。
1セッションだけTUIワークスペースをオフにするには、--disable を付けて起動します。
codex --disable tui_workspace
$CODEX_HOME/config.toml で tui_workspace を恒久的に無効化するには、次のコマンドを実行します。
codex features disable tui_workspace
または $CODEX_HOME/config.toml に手動でフラグを設定します。
[features]
tui_workspace = false
新しい codex セッションを起動し、ワークスペースのサイドバーが表示されないことを確認してください。tui_workspace を無効化すると、サイドバーと各プレビュータブがまとめてオフになります。
リモート実行:codex exec --remote とTUIの /rc・/remote の違い
Codex CLI 0.171.0では、目的の異なる2種類のリモート機能が追加されました。
codex exec --remote <ADDR>は、すでに起動中のcodex app-serverに対して非対話ターンを実行します。/rc(別名/remote)は、TUI内からローカルのバックグラウンドサーバーに対するデバイスリモート操作を管理します。
codex exec --remote <ADDR> の構文、トランスポート、制約
PR #61707により、codex exec は ws://host:port、wss://host:port、unix://(既定のUnixソケット)、または unix://PATH を使って既存のapp-serverへ接続できるようになりました。
同一ホストまたはSSHポートフォワードの例(ループバック): ws://127.0.0.1:PORT 上の平文WebSocketリスナーは、ローカルホストまたはSSHポートフォワード経由のトンネルのみに適しています。対象ホスト側でサーバーを起動します。
codex app-server --listen ws://127.0.0.1:4500
続いて同じホスト(またはポート 4500 を転送したSSHトンネル越し)で codex exec を実行します。
codex exec --remote ws://127.0.0.1:4500 "Run the test suite and summarize failures"
別ホストまたはCIランナー(認証付き wss://): ロールアウト期間中、非ループバックのWebSocketリスナーは既定で未認証接続を許可しており、codex app-server 自体は ws:// で待ち受けます(OpenAIのapp-serverドキュメントを参照)。別マシンやCIランナーから接続できるように公開する前に、サーバー側でWebSocket認証を有効にし(コマンドラインに生のトークンを渡すのではなく --ws-token-file の利用を推奨)、前面にTLS終端を置いてクライアントが wss:// で接続する構成にしてください。
# On the app-server host (behind a TLS reverse proxy exposing wss://remote-host:4500)
codex app-server --listen ws://127.0.0.1:4500 \
--ws-auth capability-token \
--ws-token-file /absolute/path/to/app-server-token
クライアント側またはCIランナー側では、--remote-auth-token-env に環境変数名を指定して一致するBearerトークンを渡します。通常出力では codex exec --remote が標準エラー出力に thread id: <UUID> を出力し、--json 指定時は thread_id を含む thread.started JSONLイベント("type": "thread.started")を出力します。スレッドを再開する際は、初回実行で返されたUUIDを指定してください。
if IFS= read -rs CODEX_REMOTE_TOKEN && [ -n "$CODEX_REMOTE_TOKEN" ]; then
export CODEX_REMOTE_TOKEN
# Start a new noninteractive turn (capture thread_id from the thread.started JSONL event)
codex exec --remote wss://remote-host:4500 \
--remote-auth-token-env CODEX_REMOTE_TOKEN \
--json "Run the test suite and summarize failures"
# Resume syntax example: replace <THREAD_UUID> with the thread_id returned above
codex exec --remote wss://remote-host:4500 \
--remote-auth-token-env CODEX_REMOTE_TOKEN \
resume <THREAD_UUID> "Fix the failing parser test"
unset CODEX_REMOTE_TOKEN
else
echo "Remote token entry cancelled or empty." >&2
fi
--remote と --remote-auth-token-env は exec の前後どちらにも置けますが、両方に異なるエンドポイントを指定すると `codex exec` received conflicting remote server endpoints で失敗します。0.171.0(codex-rs/exec/src/remote.rs)では、さらに次の3つの厳格な制約があります。
- エージェント設定はサーバー側が保持する: クライアント側から
-m/--model、-s/--sandbox、-C/--cd、-c上書き、-i/--image、-p/--profile、--add-dir、--output-schema、--ephemeral、--worktreeなどのエージェント設定上書きを渡すと、"--remote currently supports only prompt, resume by UUID, and output options; configure the agent on the server"で失敗します。 - 再開はUUID指定のみ:
exec --remote resumeで--last、--all、--image、またはUUID以外の対象を渡すと、"remote resume requires a thread UUID"で拒否されます。 - 同時ターン実行は不可: すでにアクティブなターンが走っているスレッドを指定すると、
"remote thread already has an active turn"で失敗します。
TUI内の /rc と /remote
PR #62121は、管理下のローカルバックグラウンドサーバーに対するリモート操作をTUI内から有効・無効にする /rc(および /remote)を追加しました。有効化すると、メニューは次回再起動用に app-server-daemon/settings.json へ remoteControlEnabled が保存されたかを確認し、保存に失敗した場合はその旨を通知します。Add device を選ぶと手動ペアリングコードが表示されます。クラウドセッション閲覧中でも /rc を開けますが、設定変更はローカルセッションにのみ適用されます。
/rc を使う前に、次の3つの前提条件を確認してください。
- 管理下のローカルバックグラウンドサーバーが稼働していること。未起動の場合、リモート操作は
"Remote control requires the local background server."で失敗します。 - ChatGPTアカウントでサインインしていること。APIキー認証では
"Sign in with ChatGPT to manage remote control."となり拒否されます。 - 企業の管理者が管理対象
requirements.tomlでallow_remote_control = falseを設定していないこと。無効化されている場合は"Remote control is disabled by managed requirements."が表示されます。
TUIの外(SSH接続先など)から管理する場合は、OpenAIのCLIリファレンスに記載の codex remote-control start、codex remote-control stop、codex remote-control pair を使用します。
ディレクトリ変更時のpermission profiles維持と0.171.0の主な修正
0.171.0では、作業ディレクトリを変更しても現在有効なpermission profileがそのまま維持されます。rust-v0.170.0 では、再バインド可能なプロジェクトルート書き込みポリシーを持つ環境でディレクトリのみを更新すると、レガシーのサンドボックスポリシーから旧形式のpermission profileが再生成されてしまう場合がありました(codex-rs/core/src/session/session.rs)。
PR #61195はこのレガシー再構築分岐を削除し、実行時のワークスペースルートを新しいディレクトリへ更新しつつ、有効なpermission profile、選択状態、およびプロファイルのワークスペースルートを保持するように修正しました。PR内のワークスペース書き込み回帰テストでは、新しいワークスペース内の通常ファイルは引き続き書き込み可能である一方、.git/config や以前のワークスペースへの書き込みは拒否されたままとなり、カスタムの名前付きプロファイルも独自に設定したルートとルールを引き続き適用します。パッケージ導入向けにネットワークやファイルシステムの制限プロファイルを運用している場合は、Codexのサンドボックスとpermission profiles設定でドメイン制限と書き込みルールを再確認してください。
rust-v0.171.0 には、日々のCLI作業での煩わしさを減らす3つの修正も含まれています。
- セッション切り替え時に未送信入力を保持(PR #61216):セッションを切り替えたり再開したりしても、下書き、キュー済みの追加入力、中断された入力が元のスレッドに紐付いたまま残ります。
- リフレッシュトークンなしの企業MCPログイン修正(PR #62129):IDトークンを発行する一方、リフレッシュトークンを発行しない企業向けIdPでのMCP認証を修正しました。
- 実行中ターンの誘導と承認の修正(PR #61820、PR #61801):実行中ターンへ追加指示を出した際にそれ以前の編集が集計diffに保持されるようになり、遅延して届いた完了イベントが新しいターンの承認を取り消す問題も解消されました。