Roo Code 接続
VS Code 拡張 Roo Code から QCode.cc を使う:Anthropic provider を選び、カスタム base URL を有効にすれば Claude が使える
API キーが必要ですか? 登録する →エンドポイントと Base URL →
目次
⚠️ プロジェクトはアーカイブ済み:GitHub リポジトリ RooCodeInc/Roo-Code は 2026-05-15 にアーカイブ(読み取り専用)され、以降の更新・修正は提供されていません。以下の設定手順は既存インストールでは引き続き有効で、参考にもなります。活発に保守されている同系統のツールへ移行するなら Kilo Code または Cline を推奨します。
最終確認:2026-10-15 · 📄 公式ドキュメント準拠(アーカイブ状態は GitHub API で確認。Roo Code はリリース提供済みずみなし)
概要¶
| 項目 | 内容 |
|---|---|
| 利用できるモデル | Claude ✅(Anthropic provider + カスタム base URL)· GPT ✅ · 中国系モデル ✅(OpenAI Compatible)· Gemini ❌ |
| プロトコルと Base URL | Anthropic:https://api.qcode.cc/api · OpenAI:https://api.qcode.cc/openai/v1 |
| 設定場所 | VS Code 拡張の設定パネル(API Provider / カスタム base URL チェック) |
| 公式ドキュメント | Roo Code リポジトリ |
Roo Code は VS Code 向けのオープンソース AI コーディング拡張で、Cline の fork です。さらに Kilo Code が本プロジェクトから fork しています。3 つは設定画面がほぼ同じなので、本ページの手順はそのまま流用できます。
どのプロトコルを使うか¶
| 使いたいモデル | API Provider | Base URL |
|---|---|---|
| Claude | Anthropic |
https://api.qcode.cc/api |
| GPT 系 / 中国系 4 ファミリー | OpenAI Compatible |
https://api.qcode.cc/openai/v1 |
🔴 OpenAI Compatible で Claude を呼ばないでください —— QCode の OpenAI エンドポイントは Claude を拒否し model_not_available_on_endpoint を返します。詳細は エンドポイントと API パス。
インストール¶
VS Code のマーケットプレイスで Roo Code を検索するか、プロジェクトリポジトリ の案内に従ってください。
Claude の設定(Anthropic provider)¶
- Roo Code サイドバーの設定(歯車アイコン)を開く
- API Provider を Anthropic にする
- API Key に QCode のキー(
cr_始まり)を入力 - Use custom base URL にチェックを入れ
https://api.qcode.cc/apiを入力 - モデル選択で
claude-sonnet-5(または他の販売中 id)を選ぶ - 保存してチャット欄から 1 通送り、疎通を確認
中国本土からはホストを
https://asia.qcode.cc/api(アジアノード、韓国 / 台湾 / 香港の近い方)に変更。キーは共通です。 base URL の末尾にスラッシュを付けないでください —— 拡張が/v1/messagesを連結するため、余分なスラッシュは 404 になります。
GPT と中国系モデルの設定(OpenAI Compatible)¶
- API Provider を OpenAI Compatible にする
- Base URL:
https://api.qcode.cc/openai/v1 - API Key:同じ
cr_キー - Model ID:
gpt-6-sol、gpt-5.6-terra、または 中国系 id のglm-5.2など
疎通確認¶
まず curl でエンドポイントとキーを確認し、拡張の UI を疑うべきか切り分けます:
KEY="cr_あなたのQCodeキー"
curl -X POST https://api.qcode.cc/api/v1/messages \
-H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'
content を含む JSON が返ればエンドポイント側は正常です。それでも拡張が失敗するなら設定側の問題です。
トラブルシューティング¶
| 症状 | 原因 | 対処 |
|---|---|---|
model_not_available_on_endpoint |
OpenAI Compatible で Claude を呼んでいる | Anthropic provider + /api に変更 |
Invalid API key |
キー誤りまたは空白混入 | cr_ 始まりで前後に空白がないか確認 |
| 404 | base URL 末尾のスラッシュ、パス誤り | 上表と照合 |
| 目的の id がモデル選択に無い | 拡張の内蔵リストに未収録 | カスタム model id 欄に直接入力 |
設定項目の説明¶
| 設定項目(Roo Code の画面) | 入力する値 | 補足 |
|---|---|---|
| API Provider | Anthropic(Claude)または OpenAI Compatible(GPT・中国系モデル) |
プロトコルを決める。選び間違えるとそのまま拒否される |
| API Key | cr_ で始まる QCode のキー |
同じキーが両方の provider で使える |
| Use custom base URL | チェックを入れて https://api.qcode.cc/api を入力 |
Anthropic provider のみ必要。中国本土では asia.qcode.cc |
| Base URL(OpenAI Compatible) | https://api.qcode.cc/openai/v1 |
末尾にスラッシュを付けない |
| Model / Model ID | 例:claude-sonnet-5、gpt-6-sol、glm-5.2 |
内蔵のドロップダウンにない場合はカスタム入力欄に手入力 |
追加の切り分け¶
まず問題がエンドポイント側か画面の設定かを切り分けます。「疎通確認」の curl で内容が返れば QCode 側は正常です。そのうえで次を順に見てください。
- まず小さな原因を除外する:キーの前後の空白と Base URL 末尾のスラッシュが最も多い原因です。直して保存し、テストメッセージを送ります。
- Anthropic と OpenAI Compatible の設定が混ざっている:provider を切り替えたら Base URL とキーを確認し直します。
- 使いたいモデルが拒否される:Claude は Anthropic provider のみ、GPT と中国系モデルは OpenAI Compatible のみです。接続先と API 形式の正本の表を確認してください。
- QCode 側でリクエストが確認できない:probe.qcode.cc にキーを入力して届いているか確認します。記録がなければリクエストが送られていないので、拡張機能の Base URL を見直します。
よくある質問¶
Roo Code はアーカイブされていますが、まだ使えますか?¶
使えますが、更新や修正は今後ありません。2026-10-15 時点で、GitHub API では RooCodeInc/Roo-Code リポジトリはアーカイブ(読み取り専用)で、最後のプッシュは 2026-05-15 です。既存のインストールは本ページの設定で QCode に接続できます。保守が続くツールが必要なら、設定がほぼ同じ Kilo Code か Cline への移行をおすすめします。
Roo Code で GPT は使えますか?¶
使えます。API Provider に OpenAI Compatible を選び、Base URL に https://api.qcode.cc/openai/v1、Model ID に gpt-6-sol または gpt-5.6-terra を入力します。
なぜ Claude は OpenAI Compatible で使えないのですか?¶
QCode の OpenAI エンドポイントは Claude モデルを受け付けず、model_not_available_on_endpoint を返します。この判定は認証より前に行われるため、キーの問題ではなくプロトコルの選び間違いを意味します。Claude には Anthropic provider を使ってください。
中国本土ではどのドメインを使いますか?¶
asia.qcode.cc を推奨します(Anthropic の場合は https://asia.qcode.cc/api)。不安定なときは api.qcode.cc に戻してください。3 つのドメインは同じキーで使えます。
Cline や Kilo Code と設定はどう違いますか?¶
画面はよく似ています。Roo Code は Cline から、Kilo Code は Roo Code からフォークされました。プロトコル、Base URL、キーの入力方法は同じで、メニューの文言が少し違うだけです。
関連ドキュメント¶
- エンドポイントと API パス — プロトコル × モデルファミリー対応表
- Kilo Code 接続 — 下流の fork。設定はほぼ同じ
- Cline 連携 — Roo Code の元になったプロジェクト
- 中国系モデル連携
QCode を始める
API キーひとつで Claude Code・Codex などに対応。トークン単位の課金で、各モデルの単価は qcode.cc/models に掲載