# Qoder の QCode 設定

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

## 概要

| 項目 | 内容 |
|---|---|
| どんな製品か | Qoder はコーディングエージェント製品のシリーズで、Qoder デスクトップアプリ、Qoder CLI（`qoder`）、Qoder IDE、JetBrains プラグインがあります。本記事はデスクトップアプリと CLI を扱います。グローバルサイトは qoder.com（ドキュメントは docs.qoder.com）、中国サイトは Qoder CN（ドキュメントは docs.qoder.cn）です |
| 自分の API キーを使えるか | 使えます。公式のカスタムモデルページによると、Qoder は API キーによるサードパーティプロバイダーのモデル利用に対応しており、カスタムエンドポイントも設定できます。対象プランは、CLI ページに「対象プラン：個人版」、デスクトップのリリースノートに「個人プランの BYOK」とあります |
| 設定場所 | デスクトップ：**Settings** → **Models** → **Add model** → **Provider** → **Custom**。CLI：`/model` → **Custom** タブ → **Add custom model...** |
| プロトコル | **OpenAI Compatible**（続けて **Chat Completions API** または **Responses API**）· **Anthropic Compatible** |
| QCode の値 | Anthropic Compatible：`https://api.qcode.cc/api` · OpenAI Compatible：`https://api.qcode.cc/openai/v1` |
| 使えるモデル | Claude ✅（Anthropic Compatible）· GPT ✅（OpenAI Compatible）· GLM / Kimi / DeepSeek / Qwen ✅（どちらでも可）· Gemini ❌（QCode は現時点で Gemini モデルを提供していません） |
| 公式ドキュメント | [カスタムモデル（グローバル）](https://docs.qoder.com/ja/qoder/custom-models) · [カスタムモデル（CN）](https://docs.qoder.cn/qoder/custom-models) · [CLI のカスタムモデル](https://docs.qoder.com/ja/cli/custom-models) · [更新履歴](https://changelog.qoder.com/ja/app) |

同じシリーズの 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 の種類を選びます。モデルファミリーに合う行を選んでください。

| Qoder での選択 | Base URL | モデル ID（例） |
|---|---|---|
| **Anthropic Compatible** | `https://api.qcode.cc/api` | `claude-sonnet-5-5`、`claude-opus-5-5`、`deepseek-v4.1-flash`、`glm-5.3` |
| **OpenAI Compatible** + **Chat Completions API** | `https://api.qcode.cc/openai/v1` | `gpt-6.1-sol`、`deepseek-v4.1-flash`、`glm-5.3`、`kimi-k3`、`qwen3.8-max` |
| **OpenAI Compatible** + **Responses API** | `https://api.qcode.cc/openai/v1` | `gpt-6.1-sol`、`gpt-6.1-terra` |

Claude モデルは Anthropic プロトコルでのみ動作するため、`claude-…` の ID は **Anthropic Compatible** に登録します。GPT モデルは 2 つの OpenAI プロトコルでのみ動作します。中国系の 4 ファミリーはどちらでも使えます。全体の対応表は [エンドポイントと API パス](/docs/getting-started/endpoints-and-api-paths) を参照し、モデル ID は [qcode.cc/models](https://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 のダウンロードページ](https://qoder.com/ja/download)からデスクトップアプリ（macOS 12 以上、Windows 10 以上、Linux）をダウンロードしてサインインします。CLI については、同じページに次のインストールコマンドがあります。

```sh
# 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`）：

| 項目 | Anthropic Compatible | OpenAI Compatible |
|---|---|---|
| Base URL | `https://api.qcode.cc/api` | `https://api.qcode.cc/openai/v1` |
| API の種類 | — | **Chat Completions API**（GPT の場合は **Responses API** も可） |
| API キー | `cr_xxx` | `cr_xxx` |
| Model ID | `claude-sonnet-5-5` | `gpt-6.1-sol` |

必要なプロトコルごとに 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](https://probe.qcode.cc) を開いて QCode のキーを入力し、そのモデルでリクエストが記録されていることを確認します。
3. Qoder を介さずにキーとパスを確認する場合：

```bash
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 での対応 |
|---|---|
| 「Base URL が完全で、選択した互換プロトコルと API タイプがエンドポイントに一致しているか」 | Anthropic Compatible は `https://api.qcode.cc/api`（または `https://api.qcode.cc/api/v1`、上記参照）、OpenAI Compatible は `https://api.qcode.cc/openai/v1`。末尾に `/` を付けません |
| 「API Key が正しく余分なスペースがなく、期限切れまたは無効になっていないか」 | `cr_` で始まるキーを、空白を入れずに貼り直します |
| 「Model ID が正しく、プロバイダーアカウントにそのモデルへのアクセス権があるか」 | [qcode.cc/models](https://qcode.cc/models) から ID をコピーします |
| 「プロバイダーアカウントの残高が十分か」 | QCode のダッシュボードで残高を確認します |
| 「ネットワーク接続が正常か」 | パスはそのままで `asia.qcode.cc` または `us.qcode.cc` を試します |

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 パス](/docs/getting-started/endpoints-and-api-paths) — プロトコル × モデルファミリーの対応表
- [ツール互換性一覧](/docs/ide/tool-compatibility) — 各ツールが対応するプロトコル
- [DeepSeek Harness](/docs/ide/deepseek-harness) — カスタムモデルのフォームを持つ別のツール
- [LobsterAI](/docs/ide/lobsterai) — カスタムプロバイダーで Anthropic と OpenAI の両形式を使えるデスクトップエージェント
- [中国系モデルの接続](/docs/usage/cn-models) — GLM / Kimi / DeepSeek / Qwen の ID とパス
- [qcode.cc の Qoder カスタムモデル BYOK ガイド](https://qcode.cc/ja/qoder-custom-model-byok-setup) — 日付と背景