Codex CLIをClash Vergeで使う設定方法と接続のコツ

Codex CLIとClash Vergeを組み合わせる前に知っておくこと

Codex CLIは、ターミナル上でコードの読解、編集、テスト実行などを行うためのAI開発ツールです。ブラウザーでウェブサイトを開くだけの利用と異なり、ログイン処理、APIリクエスト、証明書の検証、設定ファイルの取得など、複数の通信が発生します。そのため、ブラウザーでは正常に接続できても、Codex CLIだけがログイン画面を開けない、API呼び出しがタイムアウトする、応答途中で接続が切れるといった問題が起こることがあります。

Clash Vergeは、ローカルのHTTP、SOCKS、またはmixedポートでアプリケーションの通信を受け取り、設定されたルールに従って直接接続かプロキシ接続かを選択します。Clash Vergeの画面でノードを選ぶだけでは、すべてのターミナルプログラムが自動的にClashを利用するとは限りません。Codex CLIがOSのシステムプロキシを読むのか、環境変数を参照するのか、あるいは独自のネットワーク処理を使うのかを確認する必要があります。

まず、Clash Vergeで使用中のプロファイルを読み込み、コアが正常に起動していることを確認してください。プロファイルには通常、mixed-port、port、socks-port、mode、rulesなどが含まれます。設定をインポートした後にポート番号が変わることもあるため、古いガイドにある番号をそのまま入力するのではなく、Clash Vergeの現在の設定画面または実行中の設定を基準にします。

Clash Vergeの待受ポートと接続状態を確認する

Codex CLIを設定する前に、Clash Vergeがどのポートでプロキシ接続を受け付けているかを調べます。デスクトップ環境では、HTTPプロキシ用の port、SOCKS5用の socks-port、両方に対応する mixed-port のいずれかが使われます。実際の名前や表示場所はClash Vergeのバージョン、使用するコア、読み込んだプロファイルによって異なるため、画面に表示された有効値を優先してください。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

上の例では、同じ端末から 127.0.0.1:7890 にHTTPプロキシとして接続できます。ただし、これは説明用の例であり、あなたの環境で必ず7890が使われるとは限りません。Clash Vergeのシステムプロキシを有効にした場合、OSが参照するアドレスとポートも同じ値になっているか確認します。

ポート番号が分かったら、まず外部サイトに対して明示的なプロキシテストを行います。WindowsのPowerShell、macOSやLinuxのターミナルから、次のように実行できます。

curl -I -x http://127.0.0.1:7890 https://example.com

curl -I --proxy socks5h://127.0.0.1:7890 https://example.com

-x はHTTPプロキシを指定するオプションです。SOCKSを使う場合は socks5h を指定すると、ドメイン名の解決をプロキシ側へ任せられます。最初のコマンドが成功して2つ目が失敗するなら、ポートがHTTP専用である可能性があります。逆に両方が失敗する場合は、ノード、ルール、ファイアウォール、Clashコアの状態を確認します。

Windowsでは、待受状態を次のコマンドで確認できます。macOSやLinuxでは lsof または ss が利用できます。

netstat -ano | findstr 7890

lsof -nP -iTCP:7890 -sTCP:LISTEN

ss -lntp | grep 7890

connection refused が出る場合は、指定したポートでプロセスが待ち受けていません。長時間応答がない場合は、リクエストがClashへ届いた後にノードやルールで止まっている可能性があります。Clash Vergeの接続一覧とログを開き、curlを実行した時刻に新しい接続が現れるかを見てください。

ターミナルにCodex CLI用のプロキシを設定する

Codex CLIのようなコマンドラインツールでは、デスクトップのシステムプロキシよりも、環境変数の方が確実に使われる場合があります。一般的には HTTP_PROXY、HTTPS_PROXY、ALL_PROXY と、それぞれの小文字版を設定します。ただし、すべての実装が全変数に対応しているわけではありません。HTTPSでAPIへ接続する場合でも、プロキシの指定には通常 HTTPS_PROXY を使います。

macOSとLinuxで一時的に設定する

BashやZshでは、現在開いているターミナルだけに設定できます。まずClash Vergeの実際のmixedポートへ置き換えてください。

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=http://127.0.0.1:7890

codex

SOCKSポートを使う場合は、ツールがSOCKS5環境変数に対応しているかを確認したうえで、次の形式を試します。

export ALL_PROXY=socks5h://127.0.0.1:7891
codex

動作確認後も常にプロキシを使いたい場合は、~/.zshrc、~/.bashrcなどへ追加できます。ただし、会社のネットワークや自宅の別環境で同じ設定が残っていると、Clash Vergeを起動していない時にすべての通信が失敗します。まず一時設定で確認し、必要性が明確になってから永続化する方法が安全です。

Windowsで一時的に設定する

PowerShellでは、現在のセッションに次のように設定します。

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:ALL_PROXY="http://127.0.0.1:7890"

codex

コマンドプロンプトでは set を使います。

set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890
set ALL_PROXY=http://127.0.0.1:7890

codex

設定を解除する場合、PowerShellでは Remove-Item Env:HTTP_PROXY のように削除できます。別のプロキシ製品が設定した環境変数が残っていると、Clash Vergeのポートではなく古いアドレスへ接続することがあります。接続できない場合は、まず変数の現在値を表示し、重複や誤ったポートを取り除いてください。

ログインとAPI通信を順番にテストする

Codex CLIの接続問題を調べるときは、ログインと実際のAIリクエストを分けて確認します。ログインではブラウザーを開くための認証フローやコールバックが使われることがあり、API呼び出しとは異なるプロセスが動作します。ターミナルからログインを開始してもブラウザーが直接接続し、APIだけがClashを経由する場合があります。この違いを理解せず、Clashの接続履歴に一つのドメインが表示されないだけで設定全体を変更するのは避けてください。

  1. Clash Vergeを起動する。プロファイルを選択し、コアが稼働していること、使用ノードが利用可能であることを確認します。
  2. プロキシ経路を固定する。最初は自動選択に任せず、応答の安定しているノードまたはプロキシグループを手動で選びます。
  3. curlでローカルポートをテストする。HTTPSサイトへのHEADリクエストを実行し、Clashの接続履歴に記録が出ることを確認します。
  4. 環境変数を設定する。Codex CLIを起動する同じターミナルで、HTTPとHTTPSのプロキシ変数を設定します。
  5. ログインを実行する。Codex CLIの現在の案内に従ってログインし、ブラウザーの認証完了後にターミナルへ戻ります。
  6. 小さな作業でAPIを試す。いきなり大きなリポジトリを解析せず、テキストの説明や小さなテスト生成から始め、応答が最後まで返るか確認します。

ログイン画面が開かない場合は、ターミナルの環境変数を変える前に、既定ブラウザーが起動できる状態か、認証用のローカルコールバックが別のソフトウェアに遮られていないかを確認します。ログインは成功するもののAPIリクエストだけが失敗する場合、対象APIのドメインに対するルール、選択中のノード、TLS接続、環境変数の読み取りを調べます。

Clash Vergeの接続履歴では、接続先ドメイン、使用ルール、ポリシーグループ、最終的なノードを確認します。リクエストが履歴にないなら、Codex CLIがプロキシ設定を認識していないか、別のプロセスが通信している可能性があります。履歴にあり、処理が DIRECT になっているなら、ルールが意図したグループを選んでいません。履歴にあり、プロキシノードで失敗しているなら、ノードの品質やTLS経路の問題を疑います。

env | grep -i proxy

curl -v -x http://127.0.0.1:7890 https://example.com

WindowsのPowerShellでは Get-ChildItem Env:*proxy* を使うと、現在のプロキシ変数を確認できます。デバッグ時は詳細ログを短時間だけ有効にし、認証トークンやリクエスト本文を含む出力は保存・共有しないようにします。

必要な通信だけを経由させるルール設計

すべての通信を常にプロキシへ送るグローバル運用は、原因の切り分けには便利ですが、開発環境ではパッケージレジストリ、社内Git、ローカルサービスまで同じ経路に入ることがあります。Codex CLIの利用だけを安定させたい場合は、まずルールモードで動かし、必要な宛先がどのポリシーグループへ送られているかを確認する方法が適しています。

ルールは通常、上から順に評価され、最初に一致した条件が適用されます。広い MATCH ルールを途中に置くと、その後ろの例外ルールへ到達しません。特定の開発サービスを分ける場合は、具体的なドメインルールを先に置き、最後に全体のフォールバックを配置します。

mode: rule

rules:
  - DOMAIN-SUFFIX,example-api.com,AIサービス
  - DOMAIN-SUFFIX,example-auth.com,AIサービス
  - DOMAIN-SUFFIX,会社のドメイン,DIRECT
  - MATCH,手動選択

上記は構造を説明するための例であり、実際のサービスドメインを推測して追加するものではありません。Codex CLIの実行ログ、Clash Vergeの接続履歴、サービスの公式案内を照合し、実際に使われた宛先だけを対象にしてください。認証用ドメインを誤って直接接続へ固定するとログインだけ失敗する場合があり、逆に社内ドメインをプロキシへ送ると開発環境へ接続できなくなることがあります。

TUNモードは、環境変数やシステムプロキシを読まないアプリケーションも仮想ネットワークインターフェース経由で取り込める可能性があります。ただし、TUNは管理者権限、DNS設定、ルーティング、他のVPNソフトとの競合に影響されます。環境変数でCodex CLIの通信を確認できた後に、必要性がある場合だけTUNを試す方が安全です。TUNを有効にした際は、同じ端末で実行しているDocker、仮想マシン、ローカル開発サーバーへの接続が変化していないかも確認してください。

  • 直接接続にする通信:社内サービス、ローカルホスト、同一LAN上の開発機器など、プロキシを必要としない宛先。
  • プロキシへ送る通信:Clashの接続履歴で失敗が確認でき、安定したノードを必要とする認証またはAPI宛先。
  • 判断を保留する通信:アップデート、パッケージ取得、分析機能など、利用状況と組織のポリシーを確認してから決める宛先。

接続できないときの症状別チェック

「ログインできない」という症状だけでは原因を特定できません。どの段階で止まったかを分けると、確認箇所を絞れます。まずClash Vergeを終了した状態で同じ操作を繰り返すのではなく、現在のプロキシ経路、ノード、ルールを記録してから一項目ずつ変更してください。

症状 確認する場所 対処の方向
connection refused ローカルポート、Clashコア ポート番号と待受状態を再確認する
長時間タイムアウト ノード、ルール、ファイアウォール 接続履歴と選択されたポリシーを確認する
ログイン画面が開かない ブラウザー、認証フロー、環境変数 既定ブラウザーと認証用通信を分けて確認する
ログイン後にAPIだけ失敗 API宛先、TLS、プロキシ変数 curlとClash履歴でAPI経路を検証する
応答途中で切断される ノード品質、接続維持、タイムアウト 別ノードで再試行し、長時間接続を確認する

プロキシ環境変数を設定した後にだけ失敗する場合は、変数名、URLのスキーム、ポート番号、末尾の空白を確認します。HTTPプロキシを指定する場面で存在しないHTTPSプロキシアドレスを設定すると、TLSの問題に見えるエラーが発生することがあります。また、NO_PROXY や no_proxy に広すぎるドメインが登録されていると、意図した宛先がClashを迂回します。

複数のClashクライアント、VPN、プロキシ拡張機能を同時に有効にすることも避けてください。各ソフトウェアが異なるポートやDNSを設定すると、ブラウザー、ターミナル、TUNの経路がそれぞれ分離します。検証中はClash Verge以外のプロキシを一時停止し、curl、Clashの履歴、Codex CLIの出力を同じ時刻で比較すると、通信経路を追いやすくなります。

Codex CLIとClash Vergeに関するFAQ

Clash Vergeのシステムプロキシを有効にするだけでCodex CLIは使えますか?

必ず使えるとは限りません。Codex CLIや基盤となるランタイムがOSのシステムプロキシを参照しない場合があるため、まずHTTP_PROXYやHTTPS_PROXYなどの環境変数を同じターミナルへ設定し、Clashの接続履歴に通信が表示されるか確認してください。

HTTPプロキシとSOCKS5プロキシのどちらを使うべきですか?

最初はmixedポートまたはHTTPポートを使う方法が分かりやすいでしょう。SOCKS5を使う場合は、Codex CLIと関連ランタイムがSOCKS5環境変数に対応しているか確認します。対応が不明なままSOCKS URLを設定すると、プロキシが動作していてもツール側で無視されることがあります。

APIキーやログイン情報をClashの設定に書いてもよいですか?

ClashのYAMLやルール設定に認証情報を直接書くことは避けてください。認証情報はCodex CLIの公式なログイン方法や環境変数の安全な管理機能を使い、設定ファイルやデバッグログに残らないようにします。

TUNモードを最初から有効にした方がよいですか?

通常は必要ありません。まず明示的なプロキシ指定と環境変数でCodex CLIの通信を確認し、それでもプロキシを読まない通信がある場合にTUNを検討します。TUNはDNS、権限、VPN、仮想マシンとの競合を増やすため、導入後はローカル開発環境への影響も確認してください。

Clashをダウンロード