Claude Code と CrazyRouter の接続ガイド：Base URL、認証、モデル設定、トラブルシューティング

Claude Code と CrazyRouter の接続ガイド：Base URL、認証、モデル設定、トラブルシューティング#

Claude を開発ワークフローに入れる時は、モデル名だけでなく、認証、base URL、予算、fallback、ログ設計まで決める必要があります。CrazyRouter は https://crazyrouter.com/v1 の OpenAI 互換エンドポイントで Claude と他のモデルを同じ運用レイヤーにまとめられます。

要点#

• API Key は環境ごとに分ける。
• 本番キーをローカル実験に使わない。
• model ID はコードではなく設定に置く。
• 401、429、5xx、timeout を別々に監視する。
• 重要な処理には fallback モデルを用意する。

実装例#

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["CRAZYROUTER_API_KEY"], base_url="https://crazyrouter.com/v1")
res = client.chat.completions.create(
    model=os.getenv("AI_MODEL", "claude-sonnet-4"),
    messages=[{"role": "user", "content": "短く要約してください"}],
)
print(res.choices[0].message.content)

まとめ#

日常の Coding Agent には Sonnet、難しい推論やレビューには Opus が向いています。支払いエラーや直接接続の問題がある場合も、CrazyRouter を使うと Claude と他モデルを一つのルーティング層で扱えます。

関連ガイド#

• Claude API の決済エラー対策
• Claude Sonnet vs Opus