Qoder の QCode 設定

Qoder のカスタムモデルに QCode を追加：GPT・中国系モデルは OpenAI Compatible、Claude は Anthropic Compatible。

API キーが必要ですか？ 登録する →·エンドポイントと Base URL →

最終確認: 2026-11-10 · 📄 公式ドキュメント準拠（Qoder 0.5.7 と Qoder CLI 1.1.86、いずれも 2026-11-09 リリース。ドキュメントは 2026-11-10 に確認）

概要¶

同じシリーズの Qoder IDE は別製品で、そのカスタムモデルページ（docs.qoder.com/user-guide/chat/custom-models）にはプリセットプロバイダーだけが載っています。カスタム Base URL は Qoder デスクトップアプリ（0.1.8 以降、2026-09-05）と Qoder CLI（個人版ユーザーは 1.1.50 以降、/model の Custom ページで設定、2026-09-11）で使えます。本記事はこの 2 つを扱います。

どのプロトコルを使うか¶

カスタムエンドポイントのプロバイダー種別は 2 つあり、OpenAI Compatible ではさらに API の種類を選びます。モデルファミリーに合う行を選んでください。

Claude モデルは Anthropic プロトコルでのみ動作するため、claude-… の ID は Anthropic Compatible に登録します。GPT モデルは 2 つの OpenAI プロトコルでのみ動作します。中国系の 4 ファミリーはどちらでも使えます。全体の対応表は エンドポイントと API パス を参照し、モデル ID は qcode.cc/models の表記を一字一句そのままコピーしてください。

Base URL の書き方。 公式ドキュメントには「カスタムプロバイダーでは、モデルサービスが提供する正確な Base URL を入力してください。Qoder には形式例として https://api.example.com/v1 が表示されます。」とあります。例が /v1 で終わっているので、OpenAI の 2 つの選択肢には /v1 で終わる QCode の URL を入力します。Responses API を選ぶ場合も同じ URL で動作します。QCode では /openai/responses と /openai/v1/responses が同じものとして提供されているためです。Anthropic Compatible で Qoder がどのパスを付け足すかは、Qoder のドキュメントに書かれていません。まず QCode の Anthropic 用アドレス https://api.qcode.cc/api（末尾のスラッシュなし）を入力し、Validate and add model が通らない場合は https://api.qcode.cc/api/v1 に変えてもう一度検証してください。どちらも QCode の同じエンドポイント /api/v1/messages に届き、違いは Qoder が自分で付け足すパスの数だけです。

アジアや北米では、ドメインを asia.qcode.cc または us.qcode.cc に置き換えられます。パスは変わりません。

インストール¶

Qoder のダウンロードページからデスクトップアプリ（macOS 12 以上、Windows 10 以上、Linux）をダウンロードしてサインインします。CLI については、同じページに次のインストールコマンドがあります。

# macOS / Linux
curl -fsSL https://qoder.com/install | bash

# Windows PowerShell
irm https://qoder.com/install.ps1 | iex

Qoder CN には独自のアプリとドキュメント（docs.qoder.cn）があります。お使いのバージョンを上記のバージョンと照らし合わせてください。

設定¶

デスクトップ：Settings → Models¶

公式のカスタムモデルページの手順です。画面の表記は公式ドキュメントどおり英語のままにしています。

1. Settings を開き、左側のナビゲーションで Models を選択します。
2. Add model をクリックします。カスタムエンドポイントを使う場合は Provider を開き、Custom で OpenAI Compatible または Anthropic Compatible を選択します。
3. OpenAI Compatible を選んだ場合は、Chat Completions API または Responses API を選択します。
4. Base URL、API キー、1 つ以上の Model ID を入力します。同じエンドポイントに複数のモデルを設定する場合は Add Model ID をクリックします。
5. ページに表示される機能を設定します。Display name、Context window（対応する値を選び、その中から Default context window を設定）、Vision（モデルが画像入力に対応している場合に有効化）、Thinking（モデルが推論に対応している場合に有効化し、推論強度を選択）です。
6. Validate and add model をクリックします。公式の説明は「Qoder が接続を検証し、成功するとモデルを保存します。」です。
7. チャット画面で追加したモデルを選択します。

QCode 用に入力する値（キーのプレースホルダーは cr_xxx）：

必要なプロトコルごとに 1 件ずつ登録し、それぞれに対応する Base URL を入力します。

グローバル版と CN 版の違い。 グローバル版の英語ページに載っているプリセットプロバイダーは Alibaba Cloud Model Studio、DeepSeek、Z.ai、Kimi、MiniMax、Xiaomi MIMO、OpenAI、Google、OpenRouter です。CN 版のページは Alibaba Cloud Model Studio、DeepSeek、Zhipu、Kimi、MiniMax、Xiaomi MIMO で、OpenAI、Google、OpenRouter はありません。カスタムプロバイダーはどちらも OpenAI Compatible と Anthropic Compatible の 2 つで、手順も同じです。

後からキーを変更するには Models パネルの Edit を使います。Delete はモデルを削除します。

CLI：/model → Custom¶

1. Qoder CLI を起動して /model と入力します。
2. Custom タブに切り替えます。
3. Add custom model... を選択して Enter を押します。
4. ウィザードに従い「Provider → モデルタイプ → モデル」の順に選択し、API キーなどウィザードで求められる情報を入力します。
5. 検証が成功すると構成が自動保存され、すぐにそのモデルを選択できます。Custom タブでモデルを選んで Enter で使用し、d で削除します。

公式ページには「BYOK は /model の Custom ウィザードから構成してください。settings.json で BYOK を手動構成しないでください。利用可能なプロバイダー、モデル、認証情報の項目は、現在のアカウントで利用できる BYOK カタログによって決まります。」ともあります。CLI ページにはウィザードの各項目は載っていません。CLI 1.1.50 の更新履歴には「個人版ユーザーは /model の Custom ページで、カスタム URL エンドポイントの BYOK モデルを一括して設定・管理できるようになりました」とあり、Qoder の公式 X アカウントは Base URL、Model ID、API キーを入力する形だと説明しています。これらの項目には上の表の QCode の値を使ってください。

疎通確認¶

1. 追加したモデルを選択し、ping などの短いメッセージを送ります。
2. probe.qcode.cc を開いて QCode のキーを入力し、そのモデルでリクエストが記録されていることを確認します。
3. Qoder を介さずにキーとパスを確認する場合：

KEY="cr_your_key"

# OpenAI Compatible, Chat Completions API
curl -sS https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "content-type: application/json" \
  -d '{"model":"gpt-6.1-sol","max_tokens":32,
       "messages":[{"role":"user","content":"ping"}]}'

# Anthropic Compatible
curl -sS 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-5","max_tokens":32,
       "messages":[{"role":"user","content":"ping"}]}'

トラブルシューティング¶

公式 FAQ「モデルの追加に失敗した場合の対処法は?」には 5 つの確認項目があります。QCode での対応は次のとおりです。

QCode 側のメッセージが 2 つあります。model_not_available_on_endpoint は claude-… の ID を OpenAI の選択肢に登録したという意味なので、Anthropic Compatible に登録し直してください。キーではなくプロトコルの選択の問題です。Invalid API key はキーの問題です。

CLI については、公式ページに「Custom タブまたは追加項目が表示されない：現在のアカウントとプランで BYOK が利用できることを確認してください。」「プロバイダーまたはモデルが見つからない：Custom ウィザードに表示される選択肢が、現在利用可能なカタログです。」とあります。

既知の制限¶

• 公式：「独自の API キー（BYOK）で接続したモデルでは、現在、画像・動画の生成を利用できません。」
• 公式：「カスタムモデルの費用は、プロバイダーのAPIアカウントで直接決済され、Qoder Creditsは使用されません。」ただし Repo Wiki は固定モデルを使い、Qoder Credits を消費します。
• Qoder が表示する https://api.example.com/v1 は形式の例にすぎません。各プロトコルで Qoder がどのパスを付け足すかはドキュメントに書かれていないため、最終的には Validate and add model の結果に従ってください。
• QoderWork は別の製品です。そのモデルページに載っているのは Premium、Advanced、Standard の 3 つのティアと Qwen3.7-Max、Qwen3.7-Plus で、2026-11-10 時点でカスタムモデルの項目はありません。Qoder のダウンロードページには、QoderWork が 2027 年 9 月 5 日に運営を終了すること、データインポートツールを備えた Qoder デスクトップ版への移行を勧めることが書かれています。
• 公式の告知によると、Lite モデルティアは 2026 年 9 月 18 日 14:00（シンガポール時間、UTC+8）にモデルセレクターから削除されました。

関連ドキュメント¶

• エンドポイントと API パス — プロトコル × モデルファミリーの対応表
• ツール互換性一覧 — 各ツールが対応するプロトコル
• DeepSeek Harness — カスタムモデルのフォームを持つ別のツール
• LobsterAI — カスタムプロバイダーで Anthropic と OpenAI の両形式を使えるデスクトップエージェント
• 中国系モデルの接続 — GLM / Kimi / DeepSeek / Qwen の ID とパス
• qcode.cc の Qoder カスタムモデル BYOK ガイド — 日付と背景

企業版 →