Claude CodeをサードパーティのAPIゲートウェイ経由で使うとき、いちばん間違いやすいのはBase URLです。
OpenAI互換SDKではよく次のようなURLを使います。
https://example.com/v1
しかしClaude CodeはAnthropic API互換の設定になるため、/v1 を付けないルートURLを指定するケースがあります。
Crazyrouterを例にすると：
ANTHROPIC_BASE_URL=https://crazyrouter.com
ANTHROPIC_API_KEY=sk-your-key
ドキュメント入口：
Claude Code設定ページ：
前提
- Node.js 18以上
- Claude Code CLI
- APIキー
- ターミナルで環境変数を設定できること
macOS / Linuxでの設定
export ANTHROPIC_BASE_URL="https://crazyrouter.com"
export ANTHROPIC_API_KEY="sk-your-key"
中国向けルートを使う場合：
export ANTHROPIC_BASE_URL="https://cn.crazyrouter.com"
export ANTHROPIC_API_KEY="sk-your-key"
重要：ANTHROPIC_BASE_URL の末尾に /v1 を付けません。
永続化する
毎回exportするのが面倒な場合は、シェル設定に追加します。
zshの場合：
echo 'export ANTHROPIC_BASE_URL="https://crazyrouter.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-your-key"' >> ~/.zshrc
source ~/.zshrc
bashの場合：
echo 'export ANTHROPIC_BASE_URL="https://crazyrouter.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-your-key"' >> ~/.bashrc
source ~/.bashrc
Windows PowerShell
setx ANTHROPIC_BASE_URL "https://crazyrouter.com"
setx ANTHROPIC_API_KEY "sk-your-key"
新しいPowerShellを開いて反映を確認します。
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY
動作確認
プロジェクトディレクトリでClaude Codeを起動します。
cd your-project
claude
最初は小さな質問で確認するのがおすすめです。
このリポジトリの構成を簡単に説明してください。
いきなり大きな編集を頼むより、まずAPI接続とモデル応答を確認します。
よくあるエラー
1. 404 または endpoint not found
Base URLに /v1 を付けている可能性があります。
NG：
ANTHROPIC_BASE_URL=https://crazyrouter.com/v1
OK：
ANTHROPIC_BASE_URL=https://crazyrouter.com
2. Unauthorized
APIキーが違う、期限切れ、または環境変数が反映されていない可能性があります。
echo $ANTHROPIC_API_KEY
キーをログやGitに残さないよう注意してください。
3. 以前の設定が残っている
複数の設定ファイルやシェルに別の環境変数が残っていると、意図しない接続先に飛ぶことがあります。
env | grep -i anthropic
で確認できます。
OpenAI互換SDKとの違い
同じCrazyrouterでも、OpenAI互換SDKでは通常：
https://crazyrouter.com/v1
Claude Codeでは：
https://crazyrouter.com
この違いを覚えておくだけで、かなりの設定ミスを避けられます。
まとめ
Claude CodeでサードパーティAPIを使う場合は、通常のOpenAI SDK設定をそのまま流用しないほうが安全です。
チェックポイント：
-
ANTHROPIC_BASE_URLはルートURL -
/v1を付けない - APIキーは環境変数で管理
- まず小さい質問で動作確認
- ツール別ドキュメントを読む
CrazyrouterのClaude Code設定はこちら：