2026 年、Codex CLI がターミナル出口に敏感な理由
OpenAI Codex CLI のようなターミナル統合型のコーディング支援は、エディタをまたがずに短いタスクを連続実行するため、わずかな TLS タイムアウトや経路の切り替わりでも体感の成功率が落ちやすいツールです。多くの処理は最終的に OpenAI API 向けの HTTPS に集約されますが、実行環境によっては システムのプロキシ設定を読まず、あるいは DIRECT と terminal proxy が混在したまま動くことがあります。
本稿では GUI クライアントとして普及している Clash Verge を前提に、Codex CLI proxy を安定させるための三層──システムプロキシ、TUN、環境変数(HTTP_PROXY/HTTPS_PROXY)──と、OpenAI API routing としてのドメイン前置きを同じ設計図で揃える方法をまとめます。ブラウザ中心の解説は ChatGPT/OpenAI API 向け分流ガイド が詳しいので、本記事はCLI とターミナルに焦点を当てて補完します。ルール列の共通理解は ルール分流の総覧 と合わせて読むと早いです。
まず押さえる通信の束とプロダクト境界
Codex CLI の実装や認証フローは更新が早いため、固定のホスト表を盲信せず、自分の環境の接続ログに出た FQDN を正にしてください。典型的には api.openai.com を中心に、認証やコンソールまわりで openai.com 配下の別名、計測や静的配信で追加ドメインが混ざることがあります。OpenAI API routing を Clash で組むときは、これらを広い GEOIP や最終 MATCH より上に前置きし、専用の策略グループへ流すのが基本形です。
macOS で Homebrew やシェル全体の挙動まで含めて見る場合は ターミナルと Homebrew の環境変数ガイド も参照してください。Windows で Verge を初めて入れる場合は Windows 11 の初回接続手順 や Windows 10 向けの導入記事 でポートと権限の確認から進めると安全です。
Clash Verge 側で決めること:ポート、モード、システムプロキシ、TUN
Clash Verge は Mihomo コアの設定を GUI で束ねますが、Codex CLI が安定するかどうかは「ローカルのどのポートに HTTPS が向かうか」と「そのポートがルール適用済みのリスナーか」でほぼ決まります。運用は mode: rule を前提に、Mixed Port または HTTP/SOCKS を明示し、システムプロキシ適用をオンにするか、プロキシ非対応のバイナリまで含めて捕まえたいときは TUN を検討します。
TUN は権限モデルやスタックが OS ごとに異なるため、詳細な型は TUN モード解説 を参照してください。Windows でシステムプロキシの書き込みが競合する場合は、OS 側の手動設定や別製品の自動切替が残っていないかもあわせて確認します。
HTTPS_PROXY の二段構えが現実的です。
環境変数:HTTP_PROXY/HTTPS_PROXY/ALL_PROXY/NO_PROXY
多くの HTTP スタックは HTTPS_PROXY と HTTP_PROXY を参照します。Clash の Mixed が http://127.0.0.1:7890 のような形で待っているなら、ターミナルでは次のような指定が互換性が高いです(ポートは環境に合わせて差し替え)。
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1,::1
ALL_PROXY=socks5://127.0.0.1:7891 のように SOCKS を明示した方が確実なクライアントもあります。Codex CLI proxy を検証するときは、同じシェルセッションで curl -I https://api.openai.com などの軽い確認を挟み、期待どおりの経路かを見ます。NO_PROXY を広げすぎると意図せず直結が残るので、社内レジストリやローカルホスト以外は慎重に限定してください。
ルールで OpenAI 系を「先に」マッチさせる
OpenAI API routing の実務では、DOMAIN,api.openai.com,AI-OPENAI のように具体的な名前から足し、ログで取りこぼしが見えたら DOMAIN-SUFFIX を段階的に広げます。DOMAIN-KEYWORD,openai は無関係ホストを巻き込みやすいため最後の手段にとどめ、国内向け GEOIP,CN,DIRECT を置いている構成では OpenAI 向けの細かい DOMAIN 行は CN 判定より上に並べます。策略グループは url-test や fallback で安定出口を組む型が扱いやすく、名称のタイポがルール不一致の典型なので GUI で改名したら YAML 側も同時更新してください。
proxy-groups:
- name: AI-OPENAI
type: url-test
url: https://www.gstatic.com/generate_204
interval: 300
tolerance: 50
proxies:
- 低遅延ノード A
- 低遅延ノード B
rules:
- DOMAIN,api.openai.com,AI-OPENAI
- DOMAIN-SUFFIX,openai.com,AI-OPENAI
- DOMAIN-SUFFIX,chatgpt.com,AI-OPENAI
- GEOIP,CN,DIRECT
- MATCH,既定の策略グループ
上記は説明用の断片です。実際のホスト名と策略名は購読やログに合わせて調整してください。enhanced-mode: fake-ip を使う場合は、DNS と実コネクションのズレで「ルールは合っているのに不通」になりがちです。切り分けの型は Fake-IP と DNS の解説 を参照してください。
確認手順:ログを正にして Codex CLI を再実行する
- Clash Verge の接続ログを開き、短い対話またはサンプルリクエストで
api.openai.comが想定策略に割り当たるか確認する。 - 同じターミナルで
HTTPS_PROXYを設定している場合、値がローカルポートを指しているか、別プロキシへ上書きされていないか確認する。 - TUN を使う場合は、CLI がプロキシ非対応でも TCP がカーネル側でキャプチャされているかをログで追う。
- ノードを一時的に地域の分かりやすい出口へ固定し、成功率やレイテンシの変化を比較する。
つまずきの読み分け
システムプロキシだけでは CLI が変わらない
CLI が独自スタックを持つ典型です。terminal proxy を環境変数で明示するか TUN に切り替えてください。
ブラウザは速いが Codex CLI だけ遅い/切れる
ブラウザ拡張や別プロファイルが別経路を使っている、CLI が DIRECT のまま長時間接続を張っている、などが考えられます。ログの FQDN と策略を突き合わせ、必要ならプロセス単位のルールも検討します(OS により可否が異なります)。
企業ネットワークでは証明書警告や切断が出る
SSL インスペクションや中間プロキシが長めの SSE を切るケースがあります。IT ポリシーの範囲で例外や経路を相談する必要があり、クライアント側だけでは完結しません。
よくある質問
システムプロキシをオンにしているのに Codex CLI がプロキシを使わないのはなぜですか?
Go や Rust 製の CLI は OS のプロキシ設定を自動では読まないことがあります。HTTPS_PROXY/HTTP_PROXY で明示するか、TUN で取り込んでください。
HTTP_PROXY に SOCKS5 を入れてよいですか?
実装依存です。ALL_PROXY=socks5://127.0.0.1:ポート の方が確実なことが多く、Mixed が HTTP のときは http://127.0.0.1:ポート が無難です。
ルールは合っているのに OpenAI API だけ失敗します
fake-ip と DNS のずれ、環境変数の取りこぼし、別プロセスによる名前解決の差分が典型です。接続ログと DNS 設定をセットで見直してください。
まとめ
OpenAI Codex CLI を快適に使うには、エディタ設定だけでなく、ターミナルの HTTPS 出口と OpenAI API routing を一致させることが重要です。Clash Verge でポートとモードを整え、ルールで OpenAI 系を前置きし、必要なら HTTP_PROXY 系か TUN で隙間を埋める──この三段がそろうと、CLI でもブラウザでも同じ設計思想で運用できます。
関連トピックは ブログ一覧 から横断検索できます。クライアントの入手は ダウンロードページ が便利です。
一方で、一部の汎用プロキシツールは Mihomo 特有のルールや GUI 運用にまで踏み込んだ説明が薄く、ターミナルとブラウザで設定が分裂しやすいという弱点があります。ClashSky はルール分流や複数プラットフォームの導線を一つのサイトで整理しており、日常的な検証やバージョン追従もしやすいです。CLI と GUI をまたいだ出口をそろえたい場合は、まず安定したクライアント選びから見直すのが近道になります。
→ 無料で Clash をダウンロードし、Codex CLI のターミナル出口と OpenAI 向け分流を自分の環境に合わせて整える