Skip to main content
設定とセキュリティ

ネットワーク、プロキシ、VPC

Qoder CLI のプロキシ、証明書、DNS、およびブラウザー動作を構成します。

Qoder CLI は、認証、モデル推論、Web検索/スクレイピングなどの操作を完了するためにネットワークアクセスを必要とします。企業内ネットワーク、プロキシ環境、または制限されたネットワークでは、プロキシ、証明書、またはカスタムDNS動作を構成する必要がある場合があります。このページでは、関連する環境変数と構成方法について説明します。 ほとんどのネットワーク設定は標準的な環境変数によって制御されるため、ターミナルで既に使用しているネットワーク構成の習慣をそのまま活用できます。

プロキシ

Qoder CLI は、標準的な HTTP/HTTPS プロキシ環境変数をサポートしています。
変数説明
HTTPS_PROXY / https_proxyHTTPS リクエストに使用するプロキシアドレス。
HTTP_PROXY / http_proxyHTTP リクエストに使用するプロキシアドレス。
NO_PROXY / no_proxyプロキシを経由しないホストのリスト（カンマ区切り）。
例： 
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,.internal.example.com
qoder
説明：
  • プロキシは起動時に読み込まれます。変更後は Qoder CLI を再起動する必要があります。
  • 大文字と小文字の両方の形式（HTTPS_PROXY と https_proxy など）が認識されますが、一部のツールでは小文字形式が要求されます。
  • サンドボックスを有効にすると、プロキシ設定がサンドボックス環境に転送され、サンドボックス内のリクエストもプロキシ経由で行われるようになります。

証明書

自己署名証明書またはエンタープライズルート証明書を使用するネットワークでは、Node.js の標準環境変数を使用して追加の信頼された証明書を指定できます。
変数説明
NODE_EXTRA_CA_CERTS追加の CA 証明書ファイル（PEM 形式）へのパス。
SSL_CERT_FILE証明書ファイルのパスを指定します。
例： 
export NODE_EXTRA_CA_CERTS=/path/to/corp-root-ca.pem
qoder
証明書の検証に失敗した場合（unable to verify the first certificate など）は、通常、上記の変数を構成して正しいルート証明書を指すようにする必要があります。

DNS

DNS 解決順序に特別な要件がある環境では、構成項目 advanced.dnsResolutionOrder を使用して解決順序（IPv4 を優先、またはシステムが返す順序など）を指定できます。この項目を変更した後は再起動が必要です。

ブラウザー動作

サインイン認証などのフローでは、デフォルトでブラウザーを開いてコールバックを完了しようとします。CLI はグラフィカルインターフェースのない環境を自動的に識別してブラウザーの起動をスキップし、代わりに手動でコピーできるリンクを出力します。以下のいずれかの条件を満たす場合、グラフィカルインターフェースのない環境と見なされます。
  • CI が設定されている
  • BROWSER=www-browser
  • DEBIAN_FRONTEND=noninteractive
  • SSH セッション内である（SSH_CONNECTION）
  • Linux で DISPLAY、WAYLAND_DISPLAY、MIR_SOCKET のいずれも設定されていない
そのため、SSH リモートセッション、コンテナ、CI 環境では追加の設定は不要です。認証に関する詳細は、サインインと認証 を参照してください。

サンドボックス内のネットワーク

サンドボックスを有効にすると、デフォルトではサンドボックスのネットワークアクセスは許可されません（tools.sandboxNetworkAccess のデフォルトは false）。サンドボックス内でネットワークにアクセスする必要がある場合は、この項目を明示的に有効にする必要があります。プロキシ関連の環境変数はサンドボックスに転送されます。

よくある問題

  • 接続タイムアウトまたはアクセス不可：プロキシ変数が正しく設定されているか、NO_PROXY に必要な内部ネットワークドメインが漏れていないかを確認してください。
  • 証明書エラー：NODE_EXTRA_CA_CERTS を構成して、エンタープライズルート証明書を指すようにします。
  • サインイン時にブラウザーが開かない：グラフィカルインターフェースのない環境では、CLI がブラウザーの起動を自動的にスキップしてサインインリンクを出力します。手動でコピーしてブラウザーで開いてください。または、Personal Access Token による認証に切り替えることもできます。
ネットワークのトラブルシューティングに関するより詳細な情報は、ネットワーク、プロキシ、および VPC の問題 を参照してください。

次のステップ

はじめに
コアコンセプト
Qoder CLI を使用する
Qoder CLI の拡張
リモートと統合
設定とセキュリティ
リファレンス
トラブルシューティング