# Coze（扣子）と QCode の接続チュートリアル

以下の 7 ステップに沿って進めれば、お使いの Coze アカウントの種類に合った経路を選び、QCode の Claude・GPT・中国製モデルを Coze のエージェントやワークフローに接続し、管理画面でリクエスト履歴を確認できます。


**一言で言うと**：Coze には個人アカウント向けの「グローバルなカスタムモデル Base URL」スイッチはありません。**個人・チームアカウント**は「カスタムプラグイン」または「ワークフロー HTTP リクエストノード」から QCode の API に直接接続してください。`claude-opus-5-5`（Anthropic API）と `gpt-6.2-sol`（OpenAI 互換 API）を同時に呼び出せます。**企業フラッグシップ版の管理者**は「Coze Programming（`code.coze.cn`）→ 企業組織管理 → モデル接続 → カスタムモデル」から `gpt-6.2-sol` と中国製モデルをネイティブに接続できますが、この入口のプロトコルは OpenAI Chat Completions に固定されており、**Claude には対応していません**。

| 接続経路 | 対象アカウント | 利用できる QCode モデル | 接続先 URL | 認証方式 |
|---|---|---|---|---|
| カスタムプラグイン / ワークフロー HTTP（Claude） | すべての Coze アカウント | `claude-opus-5-5` など Claude シリーズ | `https://api.qcode.cc/api/v1/messages` | リクエストヘッダー `x-api-key: cr_xxxxxxxx` と `anthropic-version: 2023-06-01` |
| カスタムプラグイン / ワークフロー HTTP（GPT / 中国製） | すべての Coze アカウント | `gpt-6.2-sol`、中国製モデル | `https://api.qcode.cc/openai/v1/chat/completions` | リクエストヘッダー `Authorization: Bearer cr_xxxxxxxx` |
| ネイティブのカスタムモデル（Coze Programming 管理画面） | 企業フラッグシップ版の組織管理者のみ | `gpt-6.2-sol`、中国製モデル（**Claude 非対応**） | `https://api.qcode.cc/openai/v1`（`/chat/completions` は自動で付加） | 認証は `Authorization` を選び `cr_xxxxxxxx` を入力（代替は Header） |

2026-11-22 時点で確認 · Coze（coze.cn）と Coze Programming（code.coze.cn）· テキストのみの構造化ガイド


[Coze（扣子）](https://www.coze.cn) はエージェントとワークフローの構築に特化したクラウドプラットフォームで、メイン製品の「Coze」（`www.coze.cn`）と、企業・ローコード管理向けの「Coze Programming」（`code.coze.cn`）という 2 つの画面があります。作業を始める前に、実際の製品上の制限を 4 つ確認しておきましょう。存在しないオプションを画面の中で探し続ける手間を省けます：

> **実際の対応範囲と制限の境界**：
> 1. **Coze アカウントへのログインが必須**：Web 版でもデスクトップ版でも、電話番号・メール・QR コードのいずれかで Coze プラットフォームのアカウントにログインする必要があり、プラットフォームのアカウントなしでオフライン利用することはできません。
> 2. **ネイティブの「モデル接続」は企業フラッグシップ版の管理者専用**：Coze の公式ドキュメントによると、ネイティブの「モデル接続 → カスタムモデル」の入口は**企業フラッグシップ版にのみ開放され、組織のスーパー管理者または管理者だけが表示・設定できます**。通常の個人アカウントや通常のワークスペースではこの入口は表示されません。
> 3. **ネイティブのカスタムモデルは Claude 非対応**：Coze のネイティブなカスタムモデルの API プロトコルは OpenAI Chat/completions に固定され、上流のストリーミング応答（`stream=true`）が必須で、Anthropic Messages プロトコルの選択肢はありません。QCode の OpenAI 互換エンドポイントは Claude モデルを受け付けないため、`claude-opus-5-5` は**カスタムプラグインまたはワークフローの HTTP リクエストからしか呼び出せません**。
> 4. **HTTP プラグイン / ワークフロー方式の能力上の境界**：個人・チームアカウントが HTTP リクエストで QCode を呼び出す場合、QCode はエージェントの外部ツールまたはワークフローの処理ノードとして動作するため、エージェント既定のメインスケジューリングモデルを置き換えることはできず、完全な JSON の返却を待ってから結果を表示します（ネイティブの逐次ストリーミング出力ではありません）。


- **対象プラットフォーム**：ブラウザの Web 版（`www.coze.cn` / `code.coze.cn`）。任意で Windows / macOS デスクトップ版も可
- **接続経路**：カスタムプラグイン / ワークフロー HTTP リクエスト（すべてのアカウント）。ネイティブのカスタムモデル（企業フラッグシップ版の管理者のみ）
- **内容の確認日**：2026-11-22
- **所要時間の目安**：10〜15 分
- **用意するもの**：ログイン済みの Coze アカウント。`cr_` で始まる QCode の API キー 1 本



- Coze（[www.coze.cn](https://www.coze.cn)）に登録済みで正常にログインできること。ネイティブのカスタムモデルを使う場合は、所属組織が**企業フラッグシップ版**で、現在のアカウントが**組織のスーパー管理者または管理者**であり、Coze Programming（[code.coze.cn](https://code.coze.cn)）にアクセスできることを確認してください
- QCode.cc に登録済みで、[ダッシュボード](https://qcode.cc/ja/dashboard)で `cr_` で始まる API キーをコピーしてあること。アカウントがまだない場合は、先に[QCode に登録](https://qcode.cc/ja/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-coze-before)し、[料金ページ](https://qcode.cc/ja/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-coze-before)でプランを選び、[ダッシュボード](https://qcode.cc/ja/dashboard)でキーを作成してください
- 呼び出すモデルを決めておくこと：`claude-opus-5-5` が必要なら**経路 A（HTTP プラグイン / ワークフロー）**を使ってください。`gpt-6.2-sol` や中国製モデルを使う場合、個人アカウントは**経路 A**、企業フラッグシップ版の管理者は**経路 B（ネイティブのカスタムモデル）**を選べます
- 現在のネットワークから `www.coze.cn`、`code.coze.cn`、`api.qcode.cc`、`probe.qcode.cc` に正常にアクセスできること


**API キーが必要ですか？**

まだ QCode のアカウントがない場合は、先に[QCode に登録](https://qcode.cc/ja/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-coze-key)してください。実際の利用量に応じて支払う場合は、先に[クォータパック](https://qcode.cc/ja/pay-as-you-go?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-coze-key)を購入し、[ダッシュボード](https://qcode.cc/ja/dashboard)で `cr_` で始まる API キーを作成して丸ごとコピーしてください。クレジットカード / デビットカード（Visa / Mastercard）、Apple Pay / Google Pay、暗号資産で支払えます。詳しくは[支払い方法](/docs/reference/payment-methods)をご覧ください。


## 準備：入口の確認と接続経路の選択

Coze の設定はすべてブラウザ上で完了でき、デスクトップクライアントをわざわざインストールする必要はありません。デスクトップ版を使いたい場合は、[Coze 公式サイト](https://www.coze.cn)のトップページで「下载桌面端」（デスクトップ版をダウンロード）にマウスを合わせ、Windows または macOS のインストーラーをダウンロードする方法だけが用意されています（Coze はオープンソースのデスクトップソフトではなく、GitHub Releases・winget・Microsoft Store のインストーラーはありません。インストール後は既定で Coze のエージェントワークベンチが開きますが、企業向けカスタムモデルの設定には引き続きブラウザで `code.coze.cn` を開く必要があります）。

アカウントの種類と目的のモデルに応じて、下から該当する経路を選んでください：

**経路 A：個人 / チームアカウント（カスタムプラグイン / HTTP リクエスト）**

- **対象となる方**：すべての Coze アカウント（通常の個人アカウント、チームワークスペース、`claude-opus-5-5` の呼び出しが必要な企業ユーザーを含む）。
- **対応モデル**：`claude-opus-5-5`（Anthropic エンドポイント `https://api.qcode.cc/api/v1/messages`）と、`gpt-6.2-sol`・中国製モデル（OpenAI 互換エンドポイント `https://api.qcode.cc/openai/v1/chat/completions`）の両方に対応します。
- **操作手順**：下の **ステップ 1 → ステップ 2 → ステップ 3 → ステップ 4 → ステップ 7** を完了してください（企業管理者専用のステップ 5・6 は飛ばします）。


**経路 B：企業フラッグシップ版の管理者（ネイティブのカスタムモデル）**

- **対象となる方**：Coze の**企業フラッグシップ版**を契約済みで、現在のアカウントが**組織のスーパー管理者または管理者**であるユーザー。
- **対応モデル**：`gpt-6.2-sol` と中国製モデルに対応（`https://api.qcode.cc/openai/v1` を使用）。**Claude シリーズは非対応**です（Coze のネイティブ入口には Anthropic プロトコルがありません）。
- **主な利点**：接続してワークスペースを認可すると、メンバーはエージェント編成画面のモデル選択肢から組み込みモデルと同じように切り替えられ、ストリーミング応答にもネイティブで対応します。
- **操作手順**：下の **ステップ 1 → ステップ 5 → ステップ 6 → ステップ 7** を完了してください（ステップ 2〜4 の HTTP プラグイン設定は不要です）。


## ステップごとの設定ガイド



### まずローカルで QCode のキーとエンドポイントの疎通を確認する

Coze の管理画面に入る前に、ローカルのターミナル（Windows PowerShell、macOS のターミナル、Linux のシェル）で最小限のテストリクエストを 1 回送り、`cr_` キーと目的のモデルが正常に使えることを確認します。こうしておけば、後で Coze 側でエラーが出たときに、原因が Coze のフォーム設定にあるのかキー自体にあるのかをすぐに判断できます。

呼び出すモデルファミリーに合わせてタブを切り替え、`cr_xxxxxxxx` を実際のキーに置き換えて実行してください：

**Claude の確認（claude-opus-5-5）**

```bash
curl -sS https://api.qcode.cc/api/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: cr_xxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "こんにちは、一文で自己紹介してください"}
    ]
  }'
```


**GPT の確認（gpt-6.2-sol）**

```bash
curl -sS https://api.qcode.cc/openai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer cr_xxxxxxxx" \
  -d '{
    "model": "gpt-6.2-sol",
    "stream": false,
    "messages": [
      {"role": "user", "content": "こんにちは、一文で自己紹介してください"}
    ]
  }'
```



うまくいけば：ターミナルに完全な JSON が返ります。Claude の応答では `content[0].text` フィールド、GPT の応答では `choices[0].message.content` フィールドに日本語の自己紹介が含まれ、`error` オブジェクトはありません。


**困ったとき：ローカルのテストが 401 または model_not_available_on_endpoint を返す**

次の 3 点を順に確認してください。1）キーは `cr_` で始まる完全な形で、引用符やコロンの後に余計な改行や空白を貼り付けていないこと。2）`claude-opus-5-5` は必ず `https://api.qcode.cc/api/v1/messages` に `x-api-key` ヘッダー付きで送り、`/openai/v1` には送らないこと。3）`gpt-6.2-sol` は必ず `https://api.qcode.cc/openai/v1/chat/completions` に `Authorization: Bearer cr_xxxxxxxx` 付きで送ること。Windows PowerShell で単一引用符のエスケープに問題がある場合は、`curl.exe` に切り替えるか、Coze ワークフローの HTTP ノードのテスト機能で直接確認してください。




### 経路 A：ワークフローの HTTP ノードまたはカスタムプラグインに QCode の API を入力する

[Coze メインサイト](https://www.coze.cn)にログインして目的のワークスペースに入り、使い方に応じてどちらかを選んでください：

- **ワークフローの HTTP リクエストノード（最短で始められる）**：ワークフローを新規作成するか開き、キャンバスに「HTTP リクエスト」ノードを追加し、リクエストメソッドを `POST` に設定します。
- **カスタムプラグイン（複数のエージェントで再利用しやすい）**：ワークスペースのプラグイン / リソースライブラリ画面で、既存の HTTP サービスを基にカスタムプラグインを作成し、`POST` メソッドのツールを追加します。

呼び出すモデルファミリーに応じて、下の該当するタブどおりに URL・リクエストヘッダー（Headers）・JSON リクエストボディ（Body）を入力してください。`{{user_prompt}}` は、Coze ワークフローの入力ノードやプラグインの入力パラメーターで定義したテキスト変数を表します。実際の設定では、Coze 画面の変数セレクターから挿入してください：

**Claude（Anthropic プロトコル · claude-opus-5-5）**

| 設定項目 | 入力内容 |
|---|---|
| リクエストメソッド | `POST` |
| 完全なリクエスト URL | `https://api.qcode.cc/api/v1/messages`（プラグインでベース URL とパスを分けて入力する場合：ベース URL に `https://api.qcode.cc/api`、パスに `/v1/messages`） |
| Header 1 | `Content-Type`: `application/json` |
| Header 2 | `x-api-key`: `cr_xxxxxxxx`（自分のキーに置き換えてください。`Bearer ` プレフィックスは**付けません**） |
| Header 3 | `anthropic-version`: `2023-06-01` |

Body の種類は `JSON` を選び、次のように入力します：

```json
{
  "model": "claude-opus-5-5",
  "max_tokens": 2048,
  "messages": [
    {
      "role": "user",
      "content": "{{user_prompt}}"
    }
  ]
}
```


**GPT / 中国製モデル（OpenAI 互換 · gpt-6.2-sol）**

| 設定項目 | 入力内容 |
|---|---|
| リクエストメソッド | `POST` |
| 完全なリクエスト URL | `https://api.qcode.cc/openai/v1/chat/completions`（プラグインでベース URL とパスを分けて入力する場合：ベース URL に `https://api.qcode.cc/openai/v1`、パスに `/chat/completions`） |
| Header 1 | `Content-Type`: `application/json` |
| Header 2 | `Authorization`: `Bearer cr_xxxxxxxx`（`Bearer` とキーの間には半角スペースを 1 つ入れます） |

Body の種類は `JSON` を選び、次のように入力します：

```json
{
  "model": "gpt-6.2-sol",
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": "{{user_prompt}}"
    }
  ]
}
```

中国製モデルに切り替えたい場合は、`"model"` を `glm-5.3`、`kimi-k3`、`deepseek-v4-pro`、`qwen3.8-max` など、OpenAI 互換エンドポイントが対応するモデル ID に変えるだけです。



うまくいけば：リクエストメソッドが `POST` で、URL がモデルファミリーのプロトコルと厳密に一致し、Headers にキーとバージョンのヘッダーがそろっており、JSON 編集エリアに構文エラーの赤線が出ていません。


**困ったとき：JSON の形式エラーが出る、または複数ターンの履歴メッセージの入れ方がわからない**

まず、すべての引用符が半角の二重引用符 `"` になっていること、最後のフィールドの後に余計なカンマがないこと、`"stream"` が `false` のままであることを確認してください（ワークフローの HTTP ノードとプラグインは既定で単発の JSON 応答として解析するため、ストリーミングを有効にすると返却 body が複数行の `data:` 断片になり解析できません）。ユーザー入力に二重引用符や改行が含まれる可能性がある場合は、Coze ワークフローやプラグインの「JSON パラメーター連結 / 構造化入力」から渡すことをおすすめします。エスケープしていない長いテキストを JSON 文字列に直接連結しないでください。




### 経路 A：レスポンスのフィールド抽出を設定して試運転する

HTTP リクエストが通ったら、返却された JSON から本文を取り出し、後続のワークフロー出力ノードやエージェントが読めるようにする必要があります。2 つのプロトコルでは返却パスが異なるため、設定した API に合わせて出力パラメーターのマッピングを入力してください：

**Claude の応答を抽出する（Anthropic 形式）**

典型的な応答構造：

```json
{
  "id": "msg_01...",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5-5",
  "content": [
    {
      "type": "text",
      "text": "こんにちは、Claude です。推論・執筆・コーディングのタスクをお手伝いできます。"
    }
  ],
  "usage": {
    "input_tokens": 18,
    "output_tokens": 32
  }
}
```

- **本文の抽出パス**：`content[0].text`（ワークフローでは「コードノード」や出力パラメーターの設定と組み合わせて `body.content[0].text` を直接読めます）。


**GPT / 中国製モデルの応答を抽出する（OpenAI 互換形式）**

典型的な応答構造：

```json
{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "gpt-6.2-sol",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "こんにちは。質問応答・分析・コード作成をお手伝いできます。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 24,
    "total_tokens": 42
  }
}
```

- **本文の抽出パス**：`choices[0].message.content`（`body.choices[0].message.content` を読めばプレーンテキストの回答が得られます）。


出力パラメーターを設定したら、ワークフローまたはプラグインツールの「試運転 / デバッグ」をクリックし、`user_prompt` に「こんにちは、一文で自己紹介してください」と渡して、返却されたステータスコードと抽出されたテキスト結果を確認します。


うまくいけば：デバッグが HTTP ステータスコード `200` を返し、出力パネルに外側の JSON 構造を含まないプレーンテキストの日本語の回答が抽出されています。


**困ったとき：試運転がタイムアウトする、または出力フィールドの抽出結果が空になる**

1）リクエストがタイムアウトする場合は、まず `max_tokens` を小さめ（例えば `1024`）にして短い応答で試し、URL のドメインを `api.qcode.cc` からアジアノードの `asia.qcode.cc` に変えてください（例えば `https://asia.qcode.cc/api/v1/messages` または `https://asia.qcode.cc/openai/v1/chat/completions`）。2）ステータスコードが `200` なのに抽出したフィールドが空の場合は、元のレスポンス body を展開し、`content[0].text` と `choices[0].message.content` を逆に設定していないか、レスポンス body の文字列を先に JSON オブジェクトへ解析するのを忘れていないかを確認してください。




### 経路 A：公開して Coze エージェントにバインドする

デバッグが通ったら、作成したカスタムプラグインまたはワークフローを現在のワークスペースに公開し、目的のエージェントの編成画面を開きます：

1. 編成画面の「技能」（スキル）エリアで、いま公開したプラグインまたはワークフローをエージェントに追加します。
2. 「人设与回复逻辑」（ペルソナ設定と応答ロジック / システムプロンプト）に発動条件を明記し、Coze の既定モデルがプラグインを飛ばして自分で回答してしまうのを防ぎます。例えば：

```text
ユーザーが複雑なコード作成、深い分析、または QCode モデルでの回答を明示的に求めた場合は、必ずバインド済みの QCode プラグイン / ワークフローを呼び出し、ユーザーの完全な質問を `user_prompt` パラメーターに渡し、ツールが返したテキスト結果を正確にユーザーへ提示してください。代わりの回答を自分で作らないでください。
```

保存したら、右側の「プレビューとデバッグ」ダイアログで上記の条件を満たすメッセージ（例えば「QCode ツールを呼び出して、一文で自己紹介してください」）を送り、デバッグ過程で実際にプラグインまたはワークフローの呼び出しが発動しているかを確認します。


うまくいけば：プレビューエリアの呼び出し過程に、いまバインドしたプラグインまたはワークフローの実行記録が表示され、ステータスが成功で、会話バブルに QCode が返した回答が出力されています。


**困ったとき：エージェントがプラグインを呼ばず、自分で回答してしまう**

次の 3 点を優先的に確認してください。1）プラグインまたはワークフローは必ず「公開」をクリック済みであること（下書き保存だけではエージェントから安定して呼び出せません）。2）プラグインツールの説明（英語 / 中国語）と `user_prompt` パラメーターの説明に用途を明確に書き、スケジューリングを担うモデルが認識しやすいようにすること。3）**ユーザー入力のたびに必ず QCode を通し、既定モデルに発動可否を決めさせたくない**場合は、エージェントをワークフロー駆動モードに切り替え、ユーザー入力がそのまま QCode の HTTP ノードを含むワークフローに入るようにしてください。




### 経路 B（企業フラッグシップ版の管理者のみ）：Coze Programming の管理画面でネイティブのカスタムモデルを接続する

> このステップとステップ 6 は、**Coze 企業フラッグシップ版の組織スーパー管理者または管理者のみ**が対象です。通常の個人アカウントの場合は、ステップ 7 に進んでリクエスト履歴を確認してください。

1. ブラウザで Coze Programming の [code.coze.cn](https://code.coze.cn) を開き、企業の管理者アカウントでログインします。
2. 画面左下の個人アバターをクリックし、所属する**企業アカウント**を選んでから、その企業組織の「設定」アイコンをクリックして「企業組織管理」に入ります。
3. 「企業組織管理」で **「模型接入 → 自定义模型」**（モデル接続 → カスタムモデル）の順に進み、**「接入模型」**（モデルを接続）をクリックします。
4. ダイアログで下の表のとおりにパラメーターを入力し、完了したら必要に応じてモデル能力（ツール呼び出し、深い思考など）とコンテキスト長をチェックして保存します：

| フォーム項目 | 入力内容 | 説明 |
|---|---|---|
| モデル表示名（模型展示名称） | `QCode GPT 6.2 Sol`（変更可） | メンバーが画面で見る名前にだけ影響します |
| モデル一意識別子（模型唯一标识） | `gpt-6.2-sol` | リクエストの `model` フィールドに直接書き込まれます。`glm-5.3` などの中国製モデル ID も入力できますが、**Claude のモデルは絶対に入力しないでください** |
| モデル API URL | `https://api.qcode.cc/openai/v1` | Coze が `/chat/completions` を自動で付加するため、**手動で** `/chat/completions` を書かないでください |
| API プロトコル | `OpenAI Chat/completions` | プラットフォーム固定の選択肢で、変更できません |
| 認証方式 | `Authorization` | 代替として `Header` 方式もあります（下の折りたたみヒントを参照） |
| 認証キー | `cr_xxxxxxxx` | QCode のキーを入力します。保存方式は平文で問題なく、Volcano KMS に接続する必要はありません |


うまくいけば：保存に成功すると「カスタムモデル」一覧に戻り、いま接続した `QCode GPT 6.2 Sol` が一覧に正常に表示され、停止や異常の表示がありません。


**困ったとき：「モデル接続」が見つからない、または接続テストが 401 / 404 を返す**

- **「モデル接続」がまったく表示されない**：現在選択しているのが個人アカウントではなく企業アカウントであること、その企業組織が**企業フラッグシップ版**を契約済みであること、あなたの役割が組織のスーパー管理者または管理者であることを確認してください。条件を満たさない場合この入口は表示されないため、経路 A に切り替えてください。
- **<code>404</code> が表示される**：「モデル API URL」が `/openai/v1` までになっているか確認し、末尾に `/chat/completions` や余計なスラッシュを書かないでください。
- **<code>401</code> / 認証失敗が表示される**：まずキーが `cr_` で始まり、余計な空白がないことを確認してください。`Authorization` を選んでも `401` になる場合は、認証方式を `Header` に切り替え、Header Key に `Authorization`、Header Value に `Bearer cr_xxxxxxxx` を入力して保存し直し、テストしてください。




### 経路 B（企業フラッグシップ版の管理者のみ）：利用可能なワークスペースを認可し、エージェントで選択する

Coze でカスタムモデルを接続した後、**既定ではすべてのワークスペースで利用できません**。管理者が手動で認可をオンにしないと、メンバーには表示されません：

1. 「企業組織管理 → モデル接続 → カスタムモデル」一覧に留まり、いま接続したモデルを見つけて、その行の右側にある **「… → 修改可用空间」**（利用可能なスペースを変更）をクリックします。
2. ダイアログで目的のワークスペースの有効スイッチをオンにして保存します。
3. Coze のエージェント編成画面に戻る（または目的のワークスペースのメンバーに編成画面を開いてもらう）と、モデル選択肢を開き、**「自定义模型」**（カスタムモデル）グループでいま接続した `QCode GPT 6.2 Sol` を選びます。
4. 右側のダイアログに「こんにちは、一文で自己紹介してください」と入力して送信し、ストリーミング応答が正常に逐次出力されるか確認します。


うまくいけば：目的のワークスペースの利用可能スイッチがオンになっており、エージェントのモデル一覧の「カスタムモデル」グループでこのモデルを選択でき、メッセージ送信後に正常にストリーミング応答が返り、`401`・`404`・`model not found` のエラーが出ません。


**困ったとき：メンバーにモデルが表示されない、または送信後ずっと読み込み中のまま応答がない**

- **メンバーにモデルが表示されない**：「修改可用空间」（利用可能なスペースを変更）に戻り、選択したのがメンバーが現在いるワークスペースであることを確認し、メンバーに編成画面を再読み込みしてもらってください。
- **モデルが存在しないと表示される**：「モデル一意識別子」に誤って表示名（例えば `QCode GPT 6.2 Sol`）を入力していないか確認してください。QCode が実際に対応するモデル ID（`gpt-6.2-sol` など）である必要があります。
- **メッセージがずっと読み込み中のまま**：Coze のネイティブなカスタムモデルは常にストリーミングモード（`stream=true`）で上流にリクエストします。URL が `https://api.qcode.cc/openai/v1`（中国本土の環境では `https://asia.qcode.cc/openai/v1` も可）になっており、企業の外向き通信ポリシーで遮断されていないことを確認してください。




### probe.qcode.cc でリクエスト履歴を確認する

経路 A でも経路 B でも、最後に実際のゲートウェイログを一度確認し、応答が確かに QCode から来ていて Coze の組み込みモデルが代わりに答えていないことを確かめることをおすすめします：

1. ブラウザで [probe.qcode.cc](https://probe.qcode.cc/) を開きます。
2. Coze で使ったのと同じ `cr_` API キーを貼り付け、「クエリ」をクリックします。
3. リクエスト一覧までスクロールし、最新のレコードのリクエスト時刻が先ほど Coze 内でデバッグまたは対話した時刻と一致し、ステータスコード列が `200` になっていることを確認します。


うまくいけば：リクエスト一覧の先頭に、先ほどテストした時刻と一致するレコードが表示され、ステータスが `200` で、対応する最初のトークンまでの時間と合計時間のデータがあります。




## 動作確認

以下を照合し、すべて一致すれば Coze が QCode に安定して接続できています：

- ローカルのテストコマンドが `claude-opus-5-5` と `gpt-6.2-sol` のいずれでも `200` と有効なテキストを返す。
- **経路 A**：Coze ワークフローの HTTP ノードまたはカスタムプラグインの試運転が `200` を返し、`content[0].text`（Claude）または `choices[0].message.content`（GPT / 中国製）を正常に抽出でき、エージェントのプレビューエリアでツール呼び出しの成功が確認できる。
- **経路 B**：企業フラッグシップ版の「カスタムモデル」の状態が正常で、目的のワークスペースのスイッチがオンになっており、メンバーがエージェントの「カスタムモデル」グループで `gpt-6.2-sol` を選ぶとストリーミング応答を受け取れる。
- [probe.qcode.cc](https://probe.qcode.cc/) で同じキーを使い、該当する時刻・ステータスコード `200` のリクエスト履歴を確認できる。


### すべて完了

QCode を Coze に接続し、カスタムプラグイン / HTTP リクエストと企業のネイティブなカスタムモデルという 2 つの経路の境界も把握できました。次はこちらへ：

- [接続ポイントと API 形式](/docs/getting-started/endpoints-and-api-paths)
- [中国製モデルの接続](/docs/usage/cn-models)
- [課金の説明](/docs/reference/billing)
- [トラブルシューティング](/docs/reference/troubleshooting)
- 次に：[料金ページ](https://qcode.cc/ja/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-coze-done)で各プランを比較する
- [ダッシュボード](https://qcode.cc/ja/dashboard)に戻って使用量と残高を確認する


## よくあるエラー

| エラー現象 / 原文 | 原因 | 対処 |
|---|---|---|
| 「模型接入 → 自定义模型」（モデル接続 → カスタムモデル）の入口が見つからない | ネイティブのカスタムモデルは企業フラッグシップ版の組織スーパー管理者または管理者にのみ開放されており、通常の個人アカウントにはこのメニューがない | 企業アカウントに切り替え、企業フラッグシップ版を契約済みか確認してください。個人または通常のチームアカウントは、このチュートリアルの**経路 A（カスタムプラグイン / ワークフロー HTTP リクエスト）**をそのまま使ってください |
| `model_not_available_on_endpoint` | `claude-opus-5-5` を OpenAI 互換エンドポイント（`/openai/v1`）や Coze のネイティブなカスタムモデルに入力している | QCode の OpenAI 互換エンドポイントは Claude を受け付けません。`claude-opus-5-5` を呼ぶには HTTP リクエストで Anthropic エンドポイント `https://api.qcode.cc/api/v1/messages` に直接接続する必要があります。Coze のネイティブなカスタムモデルには `gpt-6.2-sol` または中国製モデルしか入力できません |
| `404 Not Found` | URL パスの綴りが一致していない：ネイティブのカスタムモデルに `/chat/completions` を余計に書いている、または HTTP プラグインでパスの接尾辞が抜けている | ネイティブのカスタムモデルの「モデル API URL」は `https://api.qcode.cc/openai/v1` までにしてください（Coze が `/chat/completions` を自動で付加します）。HTTP リクエストノードでは完全なアドレス（`/api/v1/messages` または `/openai/v1/chat/completions`）を入力する必要があります |
| `401 Unauthorized` / 認証失敗 | キーが不完全、前後に空白がある、または認証ヘッダーの形式が API プロトコルと一致していない | キーが `cr_` で始まる完全な形か確認してください。Anthropic API は `x-api-key: cr_...` + `anthropic-version: 2023-06-01`、OpenAI 互換 HTTP API は `Authorization: Bearer cr_...` を使います。ネイティブのカスタムモデルで `Authorization` でも 401 になる場合は、`Header` 認証に切り替えて `Bearer cr_...` を手入力してください |
| `Model not found` / モデルが存在しない | カスタムの表示名をモデル ID に入力している、またはモデル名の綴りが誤っている | 「モデル一意識別子」または JSON の `"model"` フィールドを確認し、QCode が実際に対応するモデル ID（`claude-opus-5-5`、`gpt-6.2-sol`、`glm-5.3` など）を入力してください |
| HTTP ノードの JSON 解析に失敗する、またはネイティブ対話がずっと読み込み中のまま | ストリーミング設定が場面と逆になっている：HTTP ノードが受け取った SSE ストリームを通常の JSON として解析できない、または企業のネイティブ経路がネットワークで遮断されている | HTTP プラグイン / ワークフローのリクエスト body には必ず `"stream": false` を明示してください。企業のネイティブなカスタムモデルは `stream=true` 固定なので、`api.qcode.cc` に安定して接続できるか確認するか、`asia.qcode.cc` を試してください |
| メンバーのエージェントのモデル一覧に、接続したばかりのカスタムモデルが表示されない | 企業管理画面で新たに接続したモデルは、既定ですべてのワークスペースで無効になっている | 管理者は「カスタムモデル」一覧に戻り、そのモデルの右側の「… → 利用可能なスペースを変更」をクリックして、目的のワークスペースのスイッチを手動でオンにしてください |

## よくある質問

### キーの有効期限が切れたらどうなりますか？

2 つの場合に分けて対応します：

- **個人プラン**のキーは、期限が切れると更新できません。プランを契約し直して新しいキーに切り替える必要があります。
- **クォータパック**のキーは、期限が切れた後にもう一度新しいパックを購入すると、同じキーが自動的に復活し、Coze 側の設定を変更する必要はありません。

新しいキーに切り替えた場合は、Coze のカスタムプラグイン / ワークフロー HTTP ノードのリクエストヘッダーのキー（経路 A）、または「Coze Programming → 企業組織管理 → モデル接続 → カスタムモデル」で該当モデルの認証キー（経路 B）も合わせて更新してください。

### なぜ通常の個人アカウントは Coze エージェントの既定モデルを直接置き換えられないのですか？

これは Coze プラットフォーム自体の権限と製品設計上の制限です。ネイティブの「カスタムモデル」の入口は現在、企業フラッグシップ版組織のスーパー管理者と管理者にのみ開放されており、個人アカウントの管理画面にはカスタムモデル Base URL の設定項目がありません。個人アカウントで Coze から QCode を使いたい場合は、カスタムプラグインまたはワークフロー HTTP リクエストノードから QCode をツールまたは処理ノードとして接続できます。

### なぜ企業フラッグシップ版の「カスタムモデル」に `claude-opus-5-5` を接続できないのですか？

Coze のネイティブな「カスタムモデル」の API プロトコルは OpenAI Chat/completions に固定されており、プラットフォームは Anthropic Messages プロトコルの選択肢を提供していません。一方、QCode の OpenAI 互換エンドポイントは GPT と中国製モデルのみを提供し、Claude のリクエストは受け付けません。そのため、企業ユーザーが Coze で `claude-opus-5-5` を呼び出す場合も、カスタムプラグインまたはワークフロー HTTP リクエストノードから `https://api.qcode.cc/api/v1/messages` に直接接続する必要があります。

### ワークフロー HTTP リクエストがときどきタイムアウトする場合は？

3 つの面から確認できます。1）リクエストのドメインをグローバルノードの `api.qcode.cc` からアジアノードの `asia.qcode.cc` に切り替える（経路が近く、同じキーがそのまま使えます）。2）リクエスト body の `max_tokens` を適切に抑え（例えば `1024`〜`2048`）、プロンプトを簡潔にして 1 回の生成時間を短くする。3）ワークフロー HTTP ノードのタイムアウト設定を適度に大きくし、長い応答が Coze ノードで途中で打ち切られないようにする。

### Coze はデスクトップ版のダウンロードが必要ですか？オープンソースのインストーラーはありますか？

必要ありません。カスタムプラグインの設定、ワークフローの構築、`code.coze.cn` での企業カスタムモデルの管理のいずれも、ブラウザの Web 版だけで完了できます。Coze には Windows と macOS のデスクトップ版がありますが、オープンソースソフトではなく、GitHub Releases・winget・Microsoft Store のインストーラーはなく、[www.coze.cn](https://www.coze.cn) 公式サイトの「下载桌面端」（デスクトップ版をダウンロード）からしか入手できません。

## 接続の概要と利用可能なモデル

### QCode のノードとプロトコル別アドレス

3 つの接続ドメインは業務上の能力が同じで、同じ `cr_` キーが共通で使えます。Coze があるネットワーク環境に応じてどれか 1 つを選べば十分です：

| ノード | Anthropic API（経路 A の HTTP リクエストのみ） | OpenAI 互換 Base URL（経路 A は `/chat/completions` を追加。経路 B はここまで入力） |
|---|---|---|
| グローバル | `https://api.qcode.cc/api/v1/messages` | `https://api.qcode.cc/openai/v1` |
| アジア（中国本土で第一選択） | `https://asia.qcode.cc/api/v1/messages` | `https://asia.qcode.cc/openai/v1` |
| 北米 / ヨーロッパ | `https://us.qcode.cc/api/v1/messages` | `https://us.qcode.cc/openai/v1` |

### 推奨モデルと Coze 経路の対応

| モデル | モデル ID | 対応経路 | プロトコルエンドポイント |
|---|---|---|---|
| Claude Opus 5.5 | `claude-opus-5-5` | 経路 A のみ（カスタムプラグイン / ワークフロー HTTP） | Anthropic（`/api/v1/messages`） |
| GPT 6.2 Sol | `gpt-6.2-sol` | 経路 A と経路 B（企業のネイティブなカスタムモデル）の両方 | OpenAI 互換（`/openai/v1`） |
| 中国製の主力モデル | `glm-5.3`、`kimi-k3`、`deepseek-v4-pro`、`qwen3.8-max` など | 経路 A と経路 B の両方 | OpenAI 互換（`/openai/v1`） |

> QCode は Gemini シリーズのモデルを提供していません。Coze では Claude・GPT・中国製モデルから選んでください。中国製モデル ID の完全な一覧は[中国製モデルの接続](/docs/usage/cn-models)、販売中のモデルの最新情報は [qcode.cc/models](https://qcode.cc/ja/models) をご覧ください。

## 関連ドキュメント

- [接続ポイントと API 形式](/docs/getting-started/endpoints-and-api-paths) — プロトコル × モデルファミリーの正式な対応表
- [中国製モデルの接続](/docs/usage/cn-models) — OpenAI 互換エンドポイントで使える中国製モデルの一覧
- [課金の説明](/docs/reference/billing) — プランとクォータパックの課金ルール
- [トラブルシューティング](/docs/reference/troubleshooting) — 一般的なステータスコードとネットワーク疎通の確認
- [Coze 公式のカスタムモデル接続ドキュメント](https://docs.coze.cn/guides/deploy_custom_model) — 企業フラッグシップ版のネイティブ接続に関する公式説明