OpenRouterでClaude Codeを使う方法

Claude Code（AnthropicのCLIツール）のスムーズなワークフローを楽しんでいる方なら、デフォルトでAnthropic APIフォーマットを期待していることをご存知でしょう。しかし、異なるモデルを使いたい場合や、Anthropicの直接APIでは利用できない新しいモデルを探索したい場合はどうでしょうか？そこで登場するのが、OpenRouterです！OpenRouterは、様々なプロバイダーから提供される何百ものモデルへの統一されたOpenAI互換APIアクセスを提供します。

この2つのシステムを橋渡しすることで、Claude Codeの開発者フレンドリーなインターフェースとOpenRouterの幅広いモデルカタログという、両方の利点を最大限に活用できます。この統合こそが、私たちが「OpenRouterと連携するClaude Code」と呼んでいるものです。

その秘訣は、2つのAPIフォーマット間で変換を行う「ルーター / プロキシ」を使用することです。一度設定してしまえば、Claude Codeを通常通り実行できますが、そのバックエンドはOpenRouterが担うことになります。

💡

美しいAPIドキュメントを生成する優れたAPIテストツールをお探しですか？

最大限の生産性で開発チームが連携して作業できる統合されたオールインワンプラットフォームが必要ですか？

Apidogはあなたのすべての要求に応え、Postmanをはるかに手頃な価格で置き換えます！

ボタン

OpenRouterと連携したClaude Codeを使用する主な利点

Claude CodeとOpenRouterを組み合わせることで、強力なメリットが数多く得られます。

400以上のモデルにアクセス — Claudeのバリアント、GPTスタイルのモデル、オープンソースのLLMなど。
Anthropicのサブスクリプションは不要 — OpenRouterの従量課金制により、使用した分だけ支払います。
柔軟なモデル切り替え — Claude Code内で/modelコマンドを使ってセッション中にモデルを切り替えたり、タスクの種類（軽量 vs 推論、コスト vs パフォーマンス）に基づいてルーティングしたりできます。
コスト最適化 — 日常的なタスクには低コストまたは無料のモデルを、強力なモデルは必要なときだけ使用することで、予算を意識する開発者に最適です。
ローカルまたはクラウドベースのルーティング — プライバシーのためにすべてをローカルで実行したり、共有チームでの使用、CI/CD、クラウド自動化のためにルーターをホストしたりできます。
ツールと柔軟性 — 一部のルーターは、ストリーミング、モデルのフォールバック、複数のプロバイダーの多重化、より広範な開発ワークフローとの統合などの高度な機能をサポートしています。

Claude Codeの詳細を見るにはここをクリック

前提条件

始める前に、以下を確認してください。

1. Claude Codeがグローバルにインストールされていること（例: npm install -g @anthropic-ai/claude-code）。

2. 有効なAPIキー（sk-or-...）を持つOpenRouterアカウント（OpenRouterでアカウントを作成してください）。

3. フォーマット変換を処理するためのルーター/プロキシツール（Dockerが最も簡単ですが、Node.jsベースのルーターも機能します）。

4. 環境変数とコマンドラインの基本的な操作に慣れていること。

この設定により、Claude Codeをルーターに向け、ルーターがOpenRouterにリクエストを転送し、レスポンスを返送できるようになります。

方法1: y-router (最もシンプルで推奨)

この設定で最も広く使用されているルーターの1つがy-routerです。Anthropicが期待するAPIフォーマットとOpenRouterのOpenAIスタイルAPI間の翻訳役を務めます（リポジトリはGitHubを参照）。y-routerを使ったステップバイステップの設定方法は次のとおりです。

1. y-routerをローカルにデプロイ（Docker推奨）：

git clone https://github.com/luohy15/y-router.git
cd y-router
docker compose up -d

これにより、ローカルのルーターサービスが（デフォルトで）http://localhost:8787でリッスンを開始します。

2. Claude CodeがAnthropicに直接ではなくy-routerにリクエストを送信するように環境変数を設定します：

export ANTHROPIC_BASE_URL="http://localhost:8787"
export ANTHROPIC_AUTH_TOKEN="sk-or-<your-openrouter-key>"
export ANTHROPIC_MODEL="z-ai/glm-4.5-air"   # 高速で軽量なモデルの場合
# または export ANTHROPIC_MODEL="z-ai/glm-4.5"   # より強力なモデルの場合

3. Claude Codeを実行します：

claude

インターフェースは通常通り起動します。/modelと入力すると、OpenRouterで動作するモデルが選択されていることがわかります。おめでとうございます — これでOpenRouterと連携したClaude Codeを使用しています。（ishan.rs）

この方法は、ルーティングをローカルでシンプルに、かつあなたの管理下に置くため、プライバシーを好み、オーバーヘッドを最小限に抑えたい開発者に最適です。

方法2: Claude Code Router (npmベース、機能豊富)

Dockerを使いたくない場合は、別の堅牢なオプションがあります：Claude Code Router — Claude Codeが外部プロバイダーにアクセスできるように設計されたNode.jsベースのルーターツールです（リポジトリはGitHubを参照）。設定方法は次のとおりです。

1. グローバルにインストール:

npm install -g @musistudio/claude-code-router

次に、設定とモデルを記述した設定ファイル（例: ~/.claude-code-router/config.json）を作成します。多くのユーザーはOpenRouterをプロバイダーとして含め、APIキーを指定し、サポートされるモデルをリストアップしています（この方法の詳細はlgallardo.comを参照）。

2. ルーターを開始:

ccr start

実行されたら、ANTHROPIC_BASE_URLをルーターのURLに設定し、通常通りclaudeを使用します。ルーターはリクエストを翻訳し、モデル間の動的な切り替えを可能にします。これには、フォールバック動作、ルーティングルールなどが含まれます。

この方法は、モデルルーティング、フォールバックポリシー、またはより大規模なツールチェーン（CI/CD、自動スクリプト、マルチモデル実験など）への統合をより詳細に制御したい場合に強力です。

方法3: 直接OpenRouterプロキシ (迅速なテストのための最小限のセットアップ)

完全なルーターを実行せずに、簡単な確認やテストをしたいだけであれば、Claude CodeをOpenRouter互換のプロキシまたは最小限のアダプターに直接向けることを試すことができます。これを容易にするためのコミュニティソリューションも存在します（リポジトリはGitHubを参照）。

たとえば、次のように設定できます。

export ANTHROPIC_BASE_URL="https://proxy-your-choice.com"
export ANTHROPIC_AUTH_TOKEN="sk-or-<your-key>"
export ANTHROPIC_MODEL="openrouter/model-name"

そしてClaude Codeを実行します。このアプローチは、一時的なテストや迅速な実験に役立ちます。ただし、プロキシの実装によっては、堅牢性（ストリーミング、ツール呼び出し、長期間のセッションなど）が不足する場合があります。

スムーズな体験のためのベストプラクティスとヒント

モデルの互換性を確認する — すべてのモデルがツール呼び出しや長文コンテキストウィンドウのような高度な機能をサポートしているわけではありません。簡単なタスクには軽量モデルを、推論やコーディングのような重いタスクにはより高性能なモデルを使用してください。
APIキーを保護する — OpenRouterのAPIキーは秘密として扱い、安全に保管し、クライアント側で決して公開しないでください。
コストを管理する — 大規模モデルを使用する際はトークン使用量を監視し、コストとパフォーマンスのバランスを最適化するためにプロンプトキャッシュ、フォールバックモデル、またはタスクベースのルーティングを検討してください。
ルーティング設定をテストする — 設定後、すべてが正しくルーティングされていることを確認するために、常に簡単なコマンド（例: claude --model <model>）でテストしてください。
信頼性のためにフォールバックルーティングを使用する — マルチモデル設定では、1つのモデルが利用できない場合にルーターが自動的に別のモデルに切り替えられるようにフォールバックオプションを設定してください。

よくある質問

Q1. OpenRouterと連携したClaude Codeを使用するために、Anthropicに料金を支払う必要がありますか？
いいえ。ルーターまたはプロキシを介してOpenRouterと設定されている場合、Claude CodeはリクエストにOpenRouterのAPIキーを使用するため、有料のAnthropicサブスクリプションは必要ありません。

Q2. 同じClaude Codeセッション内でモデルを動的に切り替えることはできますか？
はい。多くのルーター（およびClaude Code自体）では、/model <model_name>を使用してモデルを切り替えることができます。ほとんどの場合、これは会話の途中で機能します。

Q3. OpenRouter内のすべてのモデルが、ツール実行やストリーミングといったClaude Codeの機能と互換性がありますか？
常にそうではありません。一部の「テキストのみ」または軽量なモデルは、ツール呼び出し、長いコンテキスト、またはストリーミングをサポートしていない場合があります。複雑なワークフローには、それらの機能をサポートしていることが知られているモデルを使用してください。

Q4. ローカルのDockerルーターは、ホストされたルーターよりも安全ですか？
一般的にはそうです。ルーターをローカルで実行すると、完全に制御でき、APIキーを外部サービスに公開することを避けられます。ホストされたルーターは便利ですが、セキュリティや信頼性のトレードオフが生じる可能性があります。

Q5. この設定をCI/CDや自動化されたワークフローに統合できますか？
もちろんです。Claude Code Routerのようなツールは、設定ファイルや環境変数をサポートしており、自動化パイプライン（GitHub Actions、スクリプトなど）に簡単に統合できます。

結論

OpenRouterと連携したClaude Codeを使用することは、おなじみの合理化された開発者インターフェースを維持しながら、単一プロバイダーへの依存から解放されるエレガントで強力な方法です。Dockerを介してローカルルーターを実行する場合でも、Node.jsベースのルーターを使用する場合でも、最小限のプロキシを介してテストする場合でも、膨大なモデルカタログ、柔軟なコストオプション、および調整されたワークフローへの扉を開くことになります。

開発者、サイドプロジェクト、または高いオーバーヘッドなしでAIを活用したコーディングを最適化したいチームにとって、このセットアップは制御、柔軟性、拡張性の魅力的なバランスを提供します。いくつかの設定手順を実行するだけで、AIアシスタントができることを劇的に拡大し、ニーズの変化に応じて切り替えたりスケールしたりすることができます。

ぜひお試しください。次のコードセッションは、これまでは考えられなかったモデルによって強化され、すべておなじみのClaude Codeインターフェースの下で実行されるかもしれません。

💡

ボタン