# LobsterAI カスタムモデル設定

> **最終確認**：2026-11-10 · 📄 公式ドキュメント準拠（LobsterAI 2026.11.6、2026-11-06 公開：README、ユーザーマニュアル、リポジトリのソースコード）

LobsterAI で自分の API キーを使えますか？ はい、使えます。2026-11-10 時点の公式 README、リポジトリのソースコード、メンテナーの返信によると、**Settings → Custom Model** を開き、プロバイダー一覧の下にある **+ Add Custom** をクリックします。**API Format** で **Anthropic Compatible (Messages)** または **OpenAI Compatible (Chat Completions)** を選び、QCode の Base URL と `cr_` キーを入力し、モデル ID を追加してから **Test Connection** をクリックします。

## 概要

| 項目 | 内容 |
|---|---|
| 使えるモデル | Claude ✅（Anthropic Compatible）· GPT ✅（OpenAI Compatible）· GLM / Kimi / DeepSeek / Qwen ✅（どちらでも可）· Gemini ❌（QCode は現時点で提供していません） |
| Base URL | Anthropic Compatible (Messages)：`https://api.qcode.cc/api` · OpenAI Compatible (Chat Completions)：`https://api.qcode.cc/openai/v1` |
| 設定場所 | アプリ内：**Settings → Custom Model → + Add Custom** |
| 公式ドキュメント | [Model configuration guide](https://lobsterai.youdao.com/en/docs/lobsterai_model_config_guide) · [User manual](https://lobsterai.youdao.com/en/docs/lobsterai_user_manual) · [GitHub リポジトリ](https://github.com/netease-youdao/LobsterAI) |

公式 FAQ によると、LobsterAI（中国語名：Youdao Lobster）は NetEase Youdao によるオープンソースのデスクトップ AI エージェントで、あらゆる業務シーンに対応するオフィスアシスタントとして作られています。オープンソースのエージェントフレームワーク OpenClaw の上に構築され、macOS（Apple Silicon と Intel）と Windows で動作し、GitHub（netease-youdao/LobsterAI）で MIT ライセンスのもとに公開されています。[OpenClaw](/docs/ide/openclaw) とは別の製品で、OpenClaw はランタイムのフレームワーク、LobsterAI は独自の UI を持つデスクトップクライアントです。

バージョン：2026-11-10 時点で GitHub Releases が **Latest** としているのは `LobsterAI 2026.11.6`（2026-11-06 公開）です。同日の公式サイトのトップページには、最新版として 2026.10.30 が表示されています。以下の UI 表記は 2026.11.6 のソースコードで確認しました。

## 使うプロトコル

カスタムプロバイダーにはいくつかの API 形式があり、QCode で普段使うのはそのうち 2 つです。

- **Anthropic Compatible (Messages)** + `https://api.qcode.cc/api`：Claude モデルに加え、GLM / Kimi / DeepSeek / Qwen も使えます。
- **OpenAI Compatible (Chat Completions)** + `https://api.qcode.cc/openai/v1`：GPT モデルに加え、GLM / Kimi / DeepSeek / Qwen も使えます。

1 つの `cr_` キーで両方を使えます。Claude モデルは Anthropic エンドポイントでのみ、GPT モデルは OpenAI エンドポイントでのみ提供されます。全体の対応表は [エンドポイントと API パス](/docs/getting-started/endpoints-and-api-paths) にあります。**OpenAI Compatible (Responses)** 形式は後述の任意の節で説明します。

## インストール

公式 README は[ダウンロードページ](https://lobsterai.youdao.com/#/download-list)（macOS Apple Silicon、macOS Intel、Windows x64）と、GitHub Releases の最新インストーラーを案内しています。モデルベンダーのアカウントは不要です。[ダッシュボード](https://qcode.cc/dashboard) で `cr_` キーを作成し、手元に用意しておいてください。

## 設定

公式の情報源では、メニューの場所の書き方が少しずつ異なります。

- README：**Settings → Custom Model** で自分の API キーを追加します。
- Issue #362（2026-10-06）へのリポジトリのメンテナーの返信：「add a custom provider under Settings → Custom Models … choose OpenAI-compatible with base URL … and the … key, add a model ID … and run Test Connection」。同じ返信によると、テストに成功するとプロバイダーは自動的に有効になり、入力欄のモデル選択から選べます。もう一方の選択肢は Anthropic 互換の形式です。
- ユーザーマニュアルとモデル設定ガイドでは、内蔵プロバイダー（DeepSeek、Moonshot、Zhipu、MiniMax、Qwen など）は **Settings → Models** で設定します。QCode は **Custom Model** に追加します。

### 手順 1：カスタムプロバイダーを追加する

1. Settings を開き、**Custom Model** に移動します。
2. プロバイダー一覧の下にある **+ Add Custom** をクリックします。
3. 次の項目を入力します（項目名は 2026.11.6 のソースコードにある英語 UI の表記です）。

| 項目 | Claude と中国系モデル | GPT と中国系モデル |
|---|---|---|
| Display Name | `QCode`（任意） | `QCode OpenAI`（任意） |
| API Format | `Anthropic Compatible (Messages)` | `OpenAI Compatible (Chat Completions)` |
| API Base URL | `https://api.qcode.cc/api` | `https://api.qcode.cc/openai/v1` |
| API Key | `cr_xxx` | `cr_xxx` |

両方の形式を使う場合は、カスタムプロバイダーを 2 つ追加します。公式の更新履歴によると、複数のカスタムプロバイダーを同時に接続でき、上限は 30 件です。

### 手順 2：Base URL に `/v1` は必要ですか？

次の 3 つの公式情報で判断できます。

1. **API Format** の下に表示されるヒント：「Must match the protocol behind your Base URL; OpenAI-compatible URLs usually end with /v1」。
2. Base URL 欄の下の例（「Examples (SiliconFlow, click to fill)」）では、**OpenAI Compatible** に `https://api.siliconflow.cn/v1`、**Anthropic Compatible** に `/v1` なしの `https://api.siliconflow.cn` が対応しています（リポジトリのソースコード）。
3. **Test Connection** はリクエストのパスを自分で組み立てます（リポジトリのソースコード、2026.11.6）。Anthropic 形式は Base URL + `/v1/messages` に送信し、Base URL がすでに `/v1` で終わる場合は `/messages` だけを付けます。OpenAI Chat Completions 形式は、Base URL が `/v1` などのバージョンで終わる場合は `/chat/completions` を付け、そうでなければ先に `/v1` を補います。Responses 形式は Base URL + `/responses` に送信し、`/v1` がなければ同じく先に補います。

したがって Anthropic Compatible には `https://api.qcode.cc/api`（テストは `/api/v1/messages` を呼び出します）、OpenAI Compatible には `https://api.qcode.cc/openai/v1`（テストは `/openai/v1/chat/completions` を呼び出します）を入力します。`/v1/messages` や `/chat/completions` を自分で付け足さないでください。この手順は当社の LobsterAI 環境では実機テストしていないため、最終的には **Test Connection** の結果に従ってください。ネットワークが不安定な場合は、ホストを `asia.qcode.cc`（アジア）または `us.qcode.cc`（北米）に置き換えられます。パスは変わりません。

### 手順 3：モデルを追加して接続テストする

1. 新しいプロバイダーで **Add Model** をクリックし、**Model Name**（一覧に表示される名前）と **Model ID** を入力します。
2. **Model ID** は [qcode.cc/models](https://qcode.cc/models) で販売中のモデルと一字一句一致させてください。例は次のとおりです。

| API Format | Model ID の例 |
|---|---|
| Anthropic Compatible (Messages) | `claude-sonnet-5-5`、`claude-opus-5-5`、`claude-haiku-5-5`、`glm-5.3`、`deepseek-v4.1-flash`、`kimi-k3`、`qwen3.8-max` |
| OpenAI Compatible (Chat Completions) | `gpt-6.1-sol`、`gpt-6.1-terra`、`glm-5.3`、`deepseek-v4.1-flash`、`kimi-k3`、`qwen3.8-max` |

3. **Test Connection** をクリックします。Issue #362 のメンテナーの返信によると、成功するとプロバイダーは自動的に有効になり、入力欄のモデル選択から選べるようになります。モデルごとの単価は https://qcode.cc/models で確認できます。

### 任意：OpenAI Compatible (Responses)

公式の 2026.10.23 のリリースノートには「Custom providers now support OpenAI Responses and Gemini native APIs.」とあります。選択肢は **OpenAI Compatible (Responses)** で、ヒントは「Requires the provider to support the OpenAI Responses API. Requests go to Base URL + /responses.」です。QCode の Responses は GPT モデルを提供します。Base URL を `https://api.qcode.cc/openai/v1` にするとリクエストは `/openai/v1/responses` に届き、エンドポイントのページではこれが `/openai/responses` と同等とされています。普段の利用には **OpenAI Compatible (Chat Completions)** で十分です。QCode は現時点で Gemini モデルを提供していないため、**Gemini (generateContent)** は使いません。

## 動作確認

1. **Test Connection** をクリックします。「Connection successful」と表示されれば、パスとキーの両方が正しく届いています。
2. 入力欄に戻り、モデル選択で新しいモデルを選んで `ping` を送信します。
3. 先にターミナルからネットワークとキーを確認する場合（空のボディで 400 が返れば、パスとキーは正しい状態です）：

```bash
KEY="cr_your_key"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/api/v1/messages -H "x-api-key: $KEY"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# 400 = path and key fine; 401 = bad key; 404 = wrong path prefix
```

すべてのリクエストは [probe.qcode.cc](https://probe.qcode.cc) に表示されます。キーを入力すると、各呼び出しのモデルとステータスコードを確認できます。

## 既知の制限とよくあるエラー

公式のマニュアル、更新履歴、リポジトリのソースコードと Issue に基づきます。

- **カスタムプロバイダーと Responses（Issue #185）**：Issue #185（2026-02-28 起票）は、カスタムプロバイダーで OpenAI の新しい API 形式を使いたいという要望でした。当時のメンテナーの返信は、アプリの言語を英語に切り替えて内蔵の OpenAI プロバイダーを使うというものでした。現状：2026.10.23 以降、カスタムプロバイダーは OpenAI Responses に対応しています（上記の任意の節を参照）。
- **アプリの言語で内蔵プロバイダーの一覧が変わる**：Issue #87 と #185 でメンテナーは、英語 UI では OpenAI や Gemini などの内蔵プロバイダーが追加で表示されると説明しています。現状：2026.11.6 のソースコードでも内蔵の一覧は UI 言語で決まり、カスタムプロバイダーはどちらの言語でも表示されます。そのため QCode の設定手順は中国語 UI でも英語 UI でも同じです。
- **Claude の ID を OpenAI 形式に追加した**：QCode は `model_not_available_on_endpoint` を返します。そのプロバイダーの **API Format** を **Anthropic Compatible (Messages)** に、アドレスを `https://api.qcode.cc/api` に変えてください。キーの問題ではなく、プロトコルの不一致です。
- **モデル ID が認識されない**：Issue #87 では、別のサービスがその ID を知らなかったため `invalid param model:claude-haiku-4-5-20251001`（400）を返しています。QCode では [qcode.cc/models](https://qcode.cc/models) で販売中の ID だけを使ってください。
- 公式のモデル設定ガイドのエラー表には「API Key Invalid」「Insufficient Balance」「Network Error」「Service Unavailable」の 4 つがあります。QCode での対処は、`cr_` キーを全体ごとコピーし直す、QCode の残高を確認する、ネットワークを確認する、サービスの状態を確認する、の順です。
- キーの保存：公式マニュアルには、API キーはローカル端末にのみ保存され、どのサーバーにもアップロードされないと書かれています。

## 関連ドキュメント

- [エンドポイントと API パス](/docs/getting-started/endpoints-and-api-paths) — プロトコルと Base URL の入力方法
- [ツール互換性一覧](/docs/ide/tool-compatibility) — すべてのツールのプロトコル対応
- [OpenClaw 接続](/docs/ide/openclaw) — LobsterAI の基盤である OpenClaw フレームワークの設定
- [AutoClaw](/docs/ide/autoclaw) — 智譜（Zhipu）のローカル OpenClaw アプリ（カスタムモデルは OpenAI プロトコル）
- [Qoder](/docs/ide/qoder) — カスタムモデルに Anthropic と OpenAI の両方のエンドポイントを設定できるデスクトップエージェント
- [中国系モデルの接続](/docs/usage/cn-models) — 販売中の GLM / Kimi / DeepSeek / Qwen の ID
- [トラブルシューティングガイド](/docs/reference/troubleshooting)