WorkBuddy カスタムモデル設定

WorkBuddy のカスタムモデルに QCode.cc を追加する手順。中国版・国際版の入口、models.json のパス、エラー 4100、GPT と中国系モデル ID。

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

最終確認：2026-11-10 · 📄 公式ドキュメント準拠（中国本土サイト workbuddy.cn の更新履歴の最新項目は 5.11.0（2026-11-03、段階配信中）、国際サイト workbuddy.ai の更新履歴の最新項目は 5.9.4）

概要¶

WorkBuddy（国際サイト：workbuddy.ai）は Tencent Cloud の CodeBuddy チームによるデスクトップ AI エージェントで、議事録・表・スライド・軽いコードなどオフィス成果物向けです。Claude Code の代替ではありません。公式の llms.txt には、コーディング向け製品 CodeBuddy と同じ基盤を共有すると書かれています。CodeBuddy については CodeBuddy カスタムモデル を参照してください。QCode.cc を WorkBuddy に接続するには、設定 → モデルを開いてカスタムモデルを追加し、エンドポイント https://api.qcode.cc/openai/v1/chat/completions、cr_ キー、gpt-6.1-sol などの実在モデル ID を入力して、モデルを選び ping を送ります。WorkBuddy のカスタムモデルは OpenAI Chat Completions を使い、QCode ではこのプロトコルで GPT と中国系モデルを利用できます。Claude モデルは Anthropic エンドポイントで提供され、Claude Code などのクライアントがこれを使います。

このページで扱うのは一点だけです。QCode.cc を WorkBuddy のカスタムモデルとして追加し、同じ cr_ キーで在庫の GPT / GLM / Kimi / DeepSeek / Qwen を WorkBuddy から呼ぶことです。

QCode では GPT と中国系モデルを利用できます。 WorkBuddy のカスタムモデルは OpenAI Chat Completions プロトコルを使い、QCode ではこのプロトコルで GPT と 中国系モデルのファミリー（DeepSeek / GLM / Kimi / Qwen）を利用できます。 Claude モデルは QCode の Anthropic エンドポイント（https://api.qcode.cc/api）で提供され、 WorkBuddy のカスタムモデルはこのプロトコルを使いません。 OpenAI エンドポイントで claude-… を指定すると model_not_available_on_endpoint が返ります。 Claude を使う場合は、Anthropic エンドポイントに対応したツール （Claude Code、ZCode、 Qoder など）をご利用ください。詳細は エンドポイントと API パス。

QCode.cc は Tencent・WorkBuddy・CodeBuddy と資本関係はありません。画面上の文言はインストールした WorkBuddy の版に従い、フィールドの意味は公式のモデル設定（中国版 · 国際版）に従います。国際版のページには "Custom model integration currently uses the OpenAI-compatible Chat Completions API." と書かれています。

前提条件¶

• デスクトップ版 WorkBuddy をインストール済み（中国版 workbuddy.cn、国際版 workbuddy.ai。手順は公式の Mac / Windows ガイド）。モバイルアプリにはカスタムモデルの入口がないため、下の FAQ を参照してください
• QCode.cc API キー（cr_ で始まる）。ダッシュボードで発行
• 同じキーは 3 プロトコルで使えます。WorkBuddy のカスタムモデルは OpenAI Chat Completions で、QCode の /openai/v1/chat/completions に対応します。プロトコルと BASE_URL は接続先と API フォーマットを見てください

UI で追加する（推奨）¶

公式のモデルページは、カスタムモデルを視覚的なインターフェースで追加・編集・削除すると書いており、設定ファイルを手編集しないことを前提としています。中国版のページでは、サービスがプリセット一覧にない場合は「Custom」を選び、URL、API Key、モデル名を手で入力するとあります。Tencent Cloud TokenHub の WorkBuddy 手順も同じ経路です。

1. 中国版：WorkBuddy を起動 → 左下のアカウント → 設定 → モデル。国際版：Avatar > System Settings > Models
2. カスタムモデルの下で モデルを追加
3. プロバイダー：カスタム
4. 下表を埋めて保存し、会話画面のモデル選択で今追加した行を選ぶ
5. 国際版には Test Connection（"Checks whether the API can respond"）もあります。その行を使う前に実行してください。公式ドキュメントによると、設定を保存しても接続が成功したとは限りません

同じ URL とキーで、モデル名だけ変えた行を複数作れます。例: glm-5.3 と deepseek-v4-pro。

URL の書き方（カスタムプロトコル）¶

公式の「カスタムプロトコル」スイッチの動作は次のとおりです（詳細設定内）。

国際版のページには、さらに 3 点が書かれています。スイッチがオフのときは、末尾が /chat/completions になるようアドレスを正規化し、サービス側が求めるそれ以外のパスは自動では付けません。オフのときは /v1 を含むベース URL と完全な URL のどちらも入力できます（"you can enter the base URL containing /v1 or the full URL when the toggle is disabled"）。そして、ほとんどの場合スイッチをオンにする必要はありません。このスイッチはアドレスの処理方法を変えるだけで、汎用の API プロトコル変換ではありません。

QCode では完全なパス https://api.qcode.cc/openai/v1/chat/completions を入力してください。スイッチがオフなら末尾がすでに /chat/completions なのでそのまま使われ、オンなら入力どおりに送られるため、どちらの状態でも正しく動きます。models.json を手で書くときの url と同じ値でもあり（後述）、Tencent Cloud TokenHub の WorkBuddy 手順でも /v1/chat/completions で終わる完全な URL を入力しています。WorkBuddy デスクトップ版では、最終的に接続テストの結果に従ってください。

• スイッチがオフなら https://api.qcode.cc/openai/v1 でも動きます（環境変数の OpenAI 互換ツール向け OPENAI_BASE_URL と同じ値）。/chat/completions は WorkBuddy が付けます
• /v1 は省略しないでください。WorkBuddy が補うのは /chat/completions だけで、それ以外のパスは付けません。QCode の Chat のパスは /openai/v1/chat/completions です
• QCode は標準のパスなので、カスタムプロトコルはオフのままで構いません。オンにした場合は完全なパスだけが動きます
• 末尾に / を付けない。余分なスラッシュは //chat/completions になります

3 つの接続ドメインは機能は同じで、経路だけ違います。キーは共通です。

設定の保存場所¶

中国版と国際版では設定ファイルの場所が異なるため、2 つの公式ページからの引用として、それぞれ別々に確認してください。

国際版のページには、ユーザー設定ディレクトリを変えた場合はモデル設定画面に表示されるパスを使うこと、また API Key を含む設定ファイルを公開リポジトリにアップロードしてはならないことも書かれています。中国版の公式ページは workbuddy/models.json とだけ書いており、置かれているフォルダーは示していません。手元の実際のファイルで確認するか、UI で管理してください。

あわせて:

• 公式のクレジット消費に関する説明には、カスタムモデルで発生する費用はすべて第三者に支払うとあります（ここでは QCode.cc、トークン単位の課金）
• 公式の更新履歴によると、models.json のホットリロードは 5.1.1 で導入され、再起動なしで変更が反映されます

日常の変更は UI で行ってください。どうしても models.json を手編集する場合、フィールドの表と url のルールは CodeBuddy カスタムモデルにあります。公式の CodeBuddy ドキュメントには "url field must be the complete interface path, typically ending with /chat/completions" とあり（https://api.openai.com/v1 は誤った例として挙げられています）、QCode の url は https://api.qcode.cc/openai/v1/chat/completions になります。同じ基盤の CodeBuddy Code CLI では、models.json の url にこの完全なパスを指定して接続できることを実測済みです（CodeBuddy Code 2.182.0、2026-11-10）。WorkBuddy にはこのファイル専用のフィールド表がないため、まず UI で 1 行追加してローカルファイルを確認してください。サードパーティのブログからスキーマをコピーしないでください。

最初に入れるモデル¶

下の ID はすべて 2026-11-10 時点で qcode.cc/models の一覧と照合済みです。単価はこのページに記載せず、qcode.cc/models の最新表示を正とします（管理側で料率変更あり）。

同系列の軽量枠 glm-5.3-flash、deepseek-v4-flash、deepseek-v4.1-flash、qwen3.8-flash、qwen3.7-plus はいずれも販売中。前世代の glm-5.1 と kimi-k2.6 は販売終了のため、入れるとエラーになります。選び方はモデル選択ガイド。qcode.cc/models に無い名前を「モデル名」に入れないでください。

この経路は OpenAI Chat Completions です。エンドポイントに ANTHROPIC_BASE_URL（https://api.qcode.cc/api）を入れないでください。それは Claude Code / Anthropic SDK 用の接頭辞です。

動作確認¶

先に、自分のネットワークから QCode の OpenAI パスが届くか確認します（接続先と API フォーマット 第 4 節と同じプローブです）。

KEY="cr_あなたのキー"

curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# → 400 = パスもキーも OK（ボディ未指定は想定内）
# → 401 = キー無効；404 = パスのプレフィックスが誤り

中国本土ではホストを asia.qcode.cc に変えてもう一度。その後 WorkBuddy で今のモデルを選び ping を送ってください。返信があれば接続できています。

パスプローブは通るのに WorkBuddy だけ失敗する場合は、前節を再確認してください。URL に /v1 が残っていて末尾に / がないか、カスタムプロトコルがオンなら /chat/completions まで含む完全なパスか、モデル ID が一字一句一致しているかです。

よくある質問¶

保存したのにモデル一覧に出ない¶

5.1.1 以降、公式の更新履歴では models.json のホットリロードが説明されており、通常は保存するだけで反映されます。それでも表示されない場合は WorkBuddy を完全終了して開き直し（トレイ残留は不可）、設定 → モデル に行が残っているか確認してください。

エラーコード 4100（カスタムモデルにエンドポイントまたは API Key がない）¶

中国版サイトの公式エラーコードページには（翻訳すると）次のとおりあります。選択したカスタムモデルにエンドポイント URL または API Key が設定されていないため、リクエストは送信されません。対処法は、エラーカードの「go to configuration」をクリックし、そのモデルのエンドポイント URL と API Key を入力することです。該当モデルはモデル選択で灰色表示され、警告アイコンが付きます。保存すれば再起動なしで再び使えます。公式のモデルページには、ローカルマシン向け（例：ローカルの Ollama）のモデルは API Key が不要で、この影響を受けないとも書かれています。

スマホでカスタムモデルが見つからない¶

公式のモバイル版モデルページには（翻訳すると）次のとおりあります。モバイルアプリにはカスタムモデルを設定する入口がなく、一覧には利用可能なモデルだけが表示されます。デスクトップで設定してください。

中国版と国際版で設定を分ける必要はありますか？¶

公式ドキュメントによると、両版は設定を別々のファイルに保存します（中国版は workbuddy/models.json、国際版は ~/.workbuddy-ai/models.json）。インストールした版で設定してください。QCode の URL と API Key は両方とも同じ手順で入力します。

HTTP 404¶

1. エンドポイントは https://api.qcode.cc/openai/v1/chat/completions（カスタムプロトコルオフなら https://api.qcode.cc/openai/v1 でも可）
2. カスタムプロトコルオンでは完全なパスだけが動きます。…/openai/v1 までだと入力どおりに送られ、/chat/completions が付きません
3. /v1 を残し、末尾 / は付けない
4. https://api.qcode.cc/api は使わない（Anthropic Messages の接頭辞）

HTTP 401¶

キーは cr_ で始まり、空白を含みません。qcode.cc/dashboard で有効か確認してください。WorkBuddy はキーをローカル保存するので、ローテーションしたらこのカスタムモデル行を編集します。

モデル名を入れたのに返答がおかしい / 失敗する¶

モデル名は gpt-5.6-terra のようなこのエンドポイントの実在 ID です。表示名 "GPT 5.6 Terra" や他社の別名ではありません。一覧は qcode.cc/models、またはキー付き GET https://api.qcode.cc/openai/v1/models（この一覧が WorkBuddy で指定できる集合で、Claude は含まれません）。

会話は Tencent に上がるか¶

公式の書き方では、カスタムモデル経路の WorkBuddy は通信路であり、入力は設定した第三者へ転送され、API Key はローカルに留まります。正本は公式モデルページと Tencent の利用規約です。QCode に届いたリクエストは同じキーで probe.qcode.cc から見られます。

WorkBuddy は Claude Code の代わりになるか¶

なりません。WorkBuddy はオフィス向けマルチエージェント、Claude Code / Codex はリポジトリ内のコーディング循環です。併用してください。成果物は WorkBuddy、コード変更は CC Switch で切った Claude Code。QCode のキーは 1 本、クォータも共通です。請求について。

次のステップ¶

• 接続先と API フォーマット — 3 プロトコル、3 ドメイン、BASE_URL 対照
• CodeBuddy カスタムモデル — 同じチームのコーディング製品。models.json のフィールドと Responses の設定
• CC Switch 設定 — 同じキーを Claude Code と Codex で切替
• モデル選択ガイド — 日常はどの枠か
• 請求について — プランとクォータ
• 現行 ID と単価: qcode.cc/models

まだ QCode.cc API キーが無い場合は qcode.cc/pricing でプランを選んでください。

企業版 →