Roo Code 接続

VS Code 拡張 Roo Code から QCode.cc を使う：Anthropic provider を選び、カスタム base URL を有効にすれば Claude が使える

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-5.5、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 欄に直接入力