Codex CLIとCodex Appの違い：どちらを選ぶべきか
CLIとdesktop Appを実行環境、並行task、diff確認、custom provider認証、検証手順、よくあるerrorで比較します。
目次
結論： Terminal、SSH、container、codex execを使うscript中心の作業ならCodex CLIが向いています。複数taskの並行管理、built-in worktree、visual diffを重視するならdesktop Appが便利です。両者は別modelではなく、Codexを操作する異なるinterfaceです。Custom providerを使う場合は、clientによって認証方法も変わります。
以下の仕様は2026年8月11日にOpenAIとBetterTokenの最新documentationで確認しました。
CLIとAppの比較
| 判断基準 | Codex CLI | Desktop App |
|---|---|---|
| Interface | Terminal / TUI | Graphical desktop application |
| 得意な環境 | Local shell、SSH、container、remote machine | Local PC、projects、threads |
| 並行作業 | /agentで切り替えるbuilt-in subagents、複数process、codex exec | 複数threads、worktrees、visual result管理 |
| 変更確認 | Terminal diff、通常のGit command | Visual diff、comment、editor連携 |
| 定期作業 | Shell script、外部scheduler | Automations、確認用result queue |
OpenAIは、AppがCLIやIDE extensionのsession historyとconfigurationを引き継げると説明しています。ただし、各processの環境変数、再起動、動作確認は別です。
Custom providerを使う場所
BetterTokenはOpenAI-compatible tool向けの従量課金API serviceです。Codex client、ChatGPT account、desktop applicationそのものを置き換えるものではありません。現在のCodex設定ではcustom provider、Base URL `https://www.bettertoken.ai/v1%60%E3%80%81Responses?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-050&utm_content=codex-cli-ili-codex-app protocolを使います。
まず実行場所を確認します。
- Terminalで
codexを実行しているならCLIです。 - Desktop application内のCodex taskならAppです。
- VS Code内のCodex panelならExtensionです。
CLIとdesktop Appは同じ~/.codex/config.tomlを読みます。Windowsでは%USERPROFILE%\.codex\config.tomlです。この2つではBETTERTOKEN_API_KEYをenv_key経由でcustom providerに渡します。VS Code Extensionはofficial sign-inを維持し、別のdocumented fieldでmodel request用credentialを設定します。
同じTOMLに[model_providers.custom]を2つ作らないでください。CLI/Desktop向け手順とVS Code向け手順を分けて確認します。
Desktop AppとIDE Extensionはshell profileだけに設定した変数を継承しない場合があります。BETTERTOKEN_API_KEYが見えない場合はOpenAIの最新手順に従って~/.codex/.envへ置き、clientを完全に再起動して新しいsessionを作ります。
設定を検証する手順
- 古いCodex processを完全に終了します。
- 新しいTerminalを開くかAppを再起動します。VS Codeでは
Developer: Reload Windowを実行します。 - 新しいsessionを作り、短いtaskを送ります。
- CLIでは
/statusを確認し、どのclientでもtest requestを時刻とmodelでBetterToken Dashboardの記録と照合します。
401、403、model not foundがないことはhealth checkにすぎません。/statusまたはDashboardの一致するrequestが、実際に使われたproviderを示します。
Workflow別の選び方
CLIはTerminal、remote machine、container、scriptに向いています。Built-in subagentsと/agentで並行作業もできますが、directoryと最終変更のreviewは必要です。
Desktop Appはbug fix、feature、reviewを別threadで進める場合、built-in worktreeでconflictを減らしたい場合、visual diffで確認したい場合に向いています。
併用も可能です。CLIでremote executionやautomationを行い、Appでtask管理とreviewを行います。実行前にworking directory、permission、provider、authenticationを確認してください。
よくあるエラー
- CLIは動くがVS Codeは動かない： 認証fieldが異なります。Extension専用手順を使い、windowをreloadして新しいsessionを作ります。
- Official sign-inを再要求される： CLI/Appでは新しいprocessから
BETTERTOKEN_API_KEYが見えるか確認します。Extensionではofficial sign-inを残します。 - Providerが見つからない：
model_provider = "custom"と[model_providers.custom]を一致させ、重複sectionを削除し、wire_api = "responses"を確認します。 - 保存しても変化しない： Appがshell変数を見ない場合は
~/.codex/.envを使って再起動し、Model ID、key、Base URL、認証方法を確認します。
最終判断
Terminal、SSH、scriptならCLI、threads、worktree、visual reviewならAppを選びます。2026年8月11日時点でCodexを含む新しいChatGPT desktop AppはmacOSとWindowsに対応しています。新規導入はchatgpt.com/downloadを使います。
