Claude Codeの設定とプロキシ（2026）：中国国内での利用、カスタムAPIアドレス、環境変数、モデルとネットワークの設定

中国国内での利用：ゲートウェイを指定すればVPN不要

# ~/.zshrc / ~/.bashrc / PowerShell 配置文件
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=你的网关密钥
claude

Claude Codeは公式SDKと同様に、この二つの変数を読み取ります。リクエストはapi.anthropic.comではなくゲートウェイに送信されるため、中国国内のネットワークから直接接続できます。アドレスにはドメインのみを入力し、次の文字列を付けないでください： /v1。設定後はターミナルを開き直し、セッション内で次を使って /status 確認してください。VS Code拡張機能とデスクトップアプリは、起動元のシェルの環境を読み取ります。設定を変更したら、エディターを完全に終了してから、新しいターミナルで起動し直してください。

プロキシが必要になる場合

ネットワークからゲートウェイ自体への接続が不安定な場合にのみ必要です。設定方法は、ほかのコマンドラインツールと同じです。

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

もし /login のOAuthログインがタイムアウトする場合（「15000msのタイムアウトを超過」）、多くはプロキシまたはDNSの問題です。APIキーでログインすれば、OAuthを完全に回避できます。

モデルの設定

export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Claude Codeはクラス（Sonnet / Opus / Haiku）ごとにモデルを扱い、この三つの変数で各クラスに対応する具体的なモデルを決定します。Haikuクラスは見た目以上に重要です。Claude Codeは各セッション内の小さなタスクにこれを使うため、安価なモデルを指定するとかなり節約できます。ゲートウェイでは現在33個のClaudeモデルIDを提供しており、/model ですべて選択できます。

設定ファイルの場所

CLAUDE.md（プロジェクトのルートディレクトリ）— プロジェクトのメモリ：ビルド・テストのコマンド、規約など。CLAUDE.local.md は個人用メモで、リポジトリには含めません。
.claude/settings.json（プロジェクト）/ ~/.claude/settings.json（グローバル）— 権限、フック、環境変数、statusLine。
.claude/agents/ — サブエージェントの定義。.claude/skills/ と ~/.claude/skills/ — スキル。
.mcp.json — プロジェクトで共有するMCPサーバーの設定。

設定エラーのトラブルシューティング

404が発生し、ログに次が表示される場合： /v1/v1/messages → BASE_URLに余分な文字列が付いています： /v1。
401 / 無効なキー → キーとアドレスが一致していません。ゲートウェイのアドレスにはゲートウェイのキーを組み合わせてください。
Maxにログインしているのにトークン単位で課金される → 環境にANTHROPIC_API_KEYが残っています。キーはログインより優先されるため、使わない場合はunsetで解除してください。
モデルが存在しない → そのIDは、現在のエンドポイントの /v1/models 一覧に含まれていません。
settings.jsonを変更した後、起動するとすぐ終了する → JSONの構文エラーです（余分なカンマ）。検証ツールで確認してください。

料金

ゲートウェイを指定すると、課金も変わります。クレジットは額面の7.69231倍の価格で販売され、$13で$100分のクレジットを利用できます。ヘビーユーザー向けには$0.80からの無制限プランもあります。詳細は料金ページをご覧ください。

まずは無料で試す

新規アカウントでプロモーションコード CLAUDECODE を使って登録すると、 $5 分のAPI残高を獲得できます。カードの登録は不要で、Claude Codeを一晩使うのに十分な量です。同じClaudeモデルに、環境変数二行で切り替えられます。

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

プロモーションコードCLAUDECODEを使って登録

よくある質問

中国国内でClaude Codeを使えますか？

はい。Claude CodeはカスタムAPIアドレス（ANTHROPIC_BASE_URL）に対応しています。当ゲートウェイを指定すると中国国内のネットワークから直接接続でき、VPNも海外のアカウントや銀行カードも不要です。

Claude Codeでプロキシを設定するには？

HTTPS_PROXY / HTTP_PROXYの環境変数を設定するだけです。ただし、ゲートウェイを指定した場合、ほとんどのユーザーはプロキシを必要としません。

ANTHROPIC_BASE_URLに/v1を付ける必要はありますか？

いいえ。SDKが自動で/v1/messagesを付加するため、余分に付けると404が発生します。

ゲートウェイでClaude Codeを実行

同じモデルを環境変数二行で利用できます。クレジットは額面の7.69231倍の価格でチャージするか、無制限プランを選択できます。新規アカウントでプロモーションコードCLAUDECODEを使うと、$5分のAPI残高を獲得できます。

APIキーを取得プランを見る

AI Prime Techは独立したAPIゲートウェイであり、Anthropicとの提携関係はなく、同社の推奨や支援も受けていません。「Claude」と「Claude Code」はAnthropicの商標です。ここで説明するClaude Codeの機能は、執筆時点のAnthropicの公開ドキュメントに基づいており、頻繁に変更されます。このページの料金とモデル一覧は、このゲートウェイの現在の設定から取得しています。

Claude Codeの設定：中国国内での使い方、プロキシとAPIアドレス、よく使う環境変数

要点