claude 9routerとは?Claude Codeの設定方法・料金・注意点
「claude 9router」と検索して、Claude Codeの利用制限を避けられるのか、無料で使えるのか、設定して問題ないのかを知りたい人向けの記事です。9RouterはClaudeそのものではなく、複数のAI提供元を一つの入口にまとめる外部ソフトです。本記事では、役割、接続手順、料金の分かれ方、認証情報を預けるときの注意点を順番に整理します。
9RouterはClaude Codeなどを複数のAI提供元へつなぐ無料のローカルゲートウェイです。npm導入後、ダッシュボードで認証とモデルを設定し、Claude Codeからlocalhost:20128/v1へ接続できます。ただし料金・利用規約・認証情報の扱いを確認して使う必要があるとわかる。
目次 (9)
claude 9routerとは?Claude Codeとの関係
「claude 9router」は、Claude Codeと9Routerを組み合わせて調べる検索語です。9RouterはAnthropicが提供するClaudeの機能や料金プランではありません。開発者が公開しているローカルのAIルーターで、Claude Code、Cursor、Codex、Clineなどの開発ツールから、ひとつの接続先を経由して複数のAI提供元を使えるようにします。
仕組みは、パソコン上で9Routerを起動し、クライアントをhttp://localhost:20128/v1へ向けるというものです。9Routerがリクエスト形式を変換し、登録した提供元へ送信します。そのため、利用者が見る入口はひとつでも、裏側ではClaude系、低価格モデル、無料枠などを選択できます。公式サイトはOpenAI互換の接続先として案内し、公式リポジトリはダッシュボード付きのローカルゲートウェイとして説明しています。
なお、「Claude Code Router」という似た名前の別プロジェクトと混同しないよう注意してください。今回の対象は、npmパッケージ名が9routerで、GitHubのdecolua/9routerから公開されているソフトです。対応する提供元の数は更新で変わります。公式サイトは60以上、npmの説明は40以上の提供元・100以上のモデルと案内しているため、導入時は画面に表示される最新情報を確認しましょう。
出典:
9Routerでできること
9Routerの魅力は、Claude Codeを別の製品に置き換えることではなく、接続先を一か所で管理できる点です。公式情報から読み取れる主な機能は次のとおりです。
- 接続先の共通化:Claude Codeなどの設定を毎回変更せず、ローカルの一つのエンドポイントから複数の提供元を呼び出せます。
- 認証方法の集約:Claude CodeなどのOAuth、APIキーを使う提供元、無料枠の接続をダッシュボードで管理します。認証方式は提供元ごとに異なるため、すべてが同じ条件で使えるわけではありません。
- 自動切り替え:優先するモデルが上限に達したり一時的に失敗したりした場合、登録した次のモデルへ切り替える構成を作れます。公式サイトでは、サブスクリプション、低価格、無料という3段階のルーティングを案内しています。
- 使用量の確認:提供元ごとの利用量やリセット状況を確認できます。ただし画面の推定金額は請求額そのものではなく、実際の支払いは接続先のサービス側で発生します。
- 入力・出力の圧縮:RTKやCaveman Modeなど、送受信するトークンを減らす機能が含まれています。節約量はモデルや入力内容で変わるため、重要な回答では圧縮前後の品質を確認してください。
一方、9Routerを入れればClaudeの有料プランが無料になるわけではありません。9Routerは通信を中継するソフトで、Claudeのモデルを無料で新規提供するサービスではない点が、検索時に最も誤解されやすいポイントです。
出典:
Claude Codeに接続する手順
9Router公式のクイックスタートでは、Node.jsを用意してからnpmでインストールし、ダッシュボードで提供元を接続します。Claude Code側の設定項目はバージョンで変わる可能性があるため、以下は公式例を基にした確認手順です。
-
Node.jsを確認する:9RouterのクイックスタートはNode.js 20以上を前提にしています。Claude Code単体の要件とは異なる場合があるため、
node --versionで確認してください。 -
9Routerをインストールして起動する:ターミナルで次を実行します。
npm install -g 9router 9router起動すると、通常は
http://localhost:20128でダッシュボードが開きます。開かない場合はブラウザーでURLを入力します。 -
初回設定を済ませる:ダッシュボードにログインし、生成された9RouterのAPIキーを控えます。公式クイックスタートには初期パスワードとして
123456が記載されているため、最初のログイン直後に必ず変更してください。ポートを外部公開する前提で初期パスワードを残すのは危険です。 -
Claudeの接続先を追加する:ダッシュボードのProvidersからClaude Codeを選び、案内に従ってOAuthで接続します。APIキーを利用する構成では、接続先側で発行したキーをダッシュボードへ登録します。ログインできない、または認証が切れる場合は、提供元をいったん切断して再接続します。
-
Claude Codeの接続先を変更する:9Routerの公式クイックスタートに掲載されている設定例は次の形です。
your-9router-api-keyは実際のキーに置き換え、キーを公開リポジトリへ保存しないでください。{ "anthropic_api_base": "http://localhost:20128/v1", "anthropic_api_key": "your-9router-api-key" }公式例では
~/.claude/config.jsonを編集します。現行のClaude Codeで設定項目が認識されない場合は、9Routerの対応バージョンとセットアップ画面を確認し、Anthropic公式のゲートウェイ設定にあるANTHROPIC_BASE_URLやANTHROPIC_AUTH_TOKENの扱いも照合してください。製品の更新で設定方法が変わるため、古い記事の値をそのまま使わないことが重要です。 -
小さな処理で接続をテストする:Claude Codeを再起動し、読み取りだけの質問やテスト用プロジェクトで動作を確認します。いきなり本番ファイルの編集や機密情報を含む処理を実行せず、モデル名、応答、使用量がダッシュボードに反映されるかを確認してください。
出典:
- https://github.com/decolua/9router/blob/master/gitbook/content/en/getting-started/quick-start.md
- https://docs.anthropic.com/ja/docs/claude-code/llm-gateway
料金は無料?実際にかかる費用
9Router自体は無料のオープンソースソフトとして配布されています。npmからインストールする料金や、ローカルでダッシュボードを起動する利用料はありません。しかし、接続先のモデルまで無料になるわけではありません。
費用は大きく3つに分けて考えると分かりやすくなります。第一に、Claude ProやMaxなど既存のサブスクリプションをOAuthで接続する場合は、その契約料金です。第二に、APIキーで接続するモデルを選べば、各提供元の入力・出力トークン料金がかかります。第三に、無料枠を使う場合でも、提供元側の利用上限、本人確認、地域条件、突然の仕様変更は残ります。
また、9Routerのダッシュボードに表示される「節約額」や推定コストは、直接APIを使った場合との比較値です。クレジットカードの請求を9Routerがまとめて行う仕組みではありません。公式リポジトリも、支払いは各提供元へ直接行い、9Router自体は課金しないと説明しています。
「Claudeを無料で使える」という宣伝だけで導入するのは避けましょう。無料モデルへ切り替えると、回答品質、コンテキスト長、速度、利用回数がClaude Codeで直接使う場合と異なることがあります。Anthropicの利用規約や契約条件に抵触しないかも、OAuthとAPIキーのどちらを使うかにかかわらず、利用者自身で確認してください。
出典:
- https://github.com/decolua/9router/blob/master/README.md
- https://docs.anthropic.com/ja/docs/claude-code/legal-and-compliance
モデル切り替えとフォールバックの考え方
9Routerのフォールバックは、あらかじめ複数のモデルを順番に登録しておくことで機能します。たとえば、最初にClaude系モデル、次に低価格モデル、最後に無料枠を指定する構成です。上限到達時に作業を止めにくくなる一方、切り替え後も同じ品質が保たれるとは限りません。
モデル名は提供元の接頭辞を含めて指定します。公式クイックスタートでは、Claude Codeの例としてcc/、低価格モデルの例としてglm/、無料枠の例としてkr/などが紹介されています。実際に使えるモデルIDは更新されるので、ダッシュボードまたは/v1/modelsの一覧を基準にしてください。
おすすめは、用途別に組み合わせを分ける方法です。コードの設計、認証、データベース変更など失敗コストの高い処理は、品質を確認した主モデルに固定します。ドキュメントの要約、定型的な変換、テストデータの作成などは低価格・無料枠へ回します。切り替えが起きたことを利用量画面で確認できるようにしておくと、いつの間にか別モデルで処理していたという事故を減らせます。
自動切り替えは「無制限」を意味しません。提供元の規約、レート制限、無料枠の停止、認証トークンの期限切れが起きれば、すべての経路が止まることがあります。重要な処理では、切り替え先とそのモデル名をログに残す運用が安全です。
使う前に確認したい安全性と規約
9Routerを経由すると、入力したプロンプト、プロジェクトの一部、モデルからの応答、APIキーやOAuthトークンが、9Routerの管理対象になります。ローカルで動くことは、通信や保存が自動的に安全であることを意味しません。特にオプションのトンネルやMITM機能を有効にすると、パソコンの外へ公開する範囲と証明書の扱いが変わります。
最低限、次の方針で始めてください。
- 初期パスワード
123456を変更する。 - ダッシュボードとAPIを
localhostに限定し、ルーターのポート開放や公開トンネルを使わない。 - 本番用のAPIキー、共有アカウント、顧客データを最初から登録しない。
- 使わないOAuth接続、クラウド同期、リクエストログ、MITM機能を無効にする。
- パスワードや秘密鍵をプロンプト、設定ファイル、ログに残さない。
- npmパッケージ、GitHubの変更履歴、セキュリティ勧告を導入前と更新前に確認する。
2026年7月の特定コミットを対象にしたStationXの静的監査では、トークンの保存、TLS証明書検証、初期パスワード、公開時の認証などについて複数の問題が指摘されました。これは現行版すべてにそのまま当てはまると断定する情報ではなく、調査時点のスナップショットです。ただし、認証情報を中継するソフトを評価する材料としては重く受け止めるべきです。自社コードや顧客情報を扱う場合は、現在のソースと勧告を確認できない限り導入を見送る判断も合理的です。
Anthropic公式のゲートウェイ資料も、第三者の中継サービスはAnthropicが安全性や機能を監査・保証するものではないと説明しています。9RouterはClaudeの公式アプリではないため、「Claude Codeと接続できる」ことと「Anthropicが推奨している」ことを同じ意味で扱わないようにしましょう。
出典:
- https://app.stationx.net/articles/9router-review
- https://docs.anthropic.com/ja/docs/claude-code/llm-gateway
- https://9router.com/
接続できないときの確認ポイント
エラーが出た場合は、モデルを次々に変える前に、次の順番で切り分けます。
9routerのプロセスが動いているか、ブラウザーでhttp://localhost:20128を開けるか確認する。- Claude Code側の接続先が
localhost:20128または公式設定例のlocalhost:20128/v1になっているか、余分な空白や古いポート番号がないか確認する。 - APIキーを再発行または再コピーし、
/v1/modelsの一覧が返るか確認する。401ならキー、空の一覧なら提供元接続を疑います。 - ダッシュボードでClaudeのOAuthやAPIキーが有効か、モデルIDの接頭辞が現在の一覧と一致しているか確認する。
- 429や上限エラーなら、提供元の制限とフォールバック設定を確認する。認証失敗や接続先変更後はClaude Codeを再起動し、必要なら
claude doctorで環境を診断する。
確認用のリクエスト例は次のとおりです。キーは画面共有やログに残さないでください。
curl http://localhost:20128/v1/models \
-H "Authorization: Bearer <9RouterのAPIキー>"
この応答でモデル一覧を取得できても、Claude Codeの通信形式やストリーミングがすべて正常とは限りません。まず読み取り専用の小さな処理で確認し、失敗したモデルをフォールバックから外すなど、段階的に運用しましょう。
claude 9routerが向いている人・向いていない人
向いているのは、Claude Codeや複数の開発ツールを使い分け、接続先・利用量・費用を自分で管理できる人です。ローカル環境で試しながら、主モデルと予備モデルの挙動を比較したい場合にも候補になります。特に、特定のサービスが上限に達したときに手動で設定を変える手間を減らしたい人には、フォールバックの考え方が合います。
反対に、Anthropic公式のサポートだけで安定運用したい人、機密性の高いコードを扱う組織、外部公開が前提の環境、無料でClaudeの有料枠を使えると期待している人には向きません。まずClaude Codeを公式の手順で直接使い、必要性が明確になってから、隔離したテスト環境で9Routerを評価する方が安全です。
結局のところ、claude 9routerは「Claudeの代替サービス」ではなく、「Claude Codeを含む複数の開発ツールとAI提供元をつなぐ中継ソフト」です。便利さはありますが、認証情報とコードが通過する境界を増やします。料金、規約、公開範囲、現在のセキュリティ状況を確認し、用途に見合うと判断できた場合だけ小さく導入してください。
公式情報・出典
- 9Router公式サイト:https://9router.com/
- 9Router検索上位の公式トンネルページ:https://tunnel.9router.com/
- npmパッケージ:https://www.npmjs.com/package/9router
- 公式クイックスタート:https://github.com/decolua/9router/blob/master/gitbook/content/en/getting-started/quick-start.md
- 公式リポジトリ:https://github.com/decolua/9router
- Anthropic公式・LLMゲートウェイ設定:https://docs.anthropic.com/ja/docs/claude-code/llm-gateway
- Anthropic公式・法務とコンプライアンス:https://docs.anthropic.com/ja/docs/claude-code/legal-and-compliance
- StationXによる2026年7月時点の静的監査:https://app.stationx.net/articles/9router-review