LobsterAI カスタムモデル設定

LobsterAI のカスタムモデルに QCode を追加する手順。API Format の選び方と、Claude・GPT・中国系モデルの Base URL。

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

最終確認：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 をクリックします。

概要¶

公式 FAQ によると、LobsterAI（中国語名：Youdao Lobster）は NetEase Youdao によるオープンソースのデスクトップ AI エージェントで、あらゆる業務シーンに対応するオフィスアシスタントとして作られています。オープンソースのエージェントフレームワーク OpenClaw の上に構築され、macOS（Apple Silicon と Intel）と Windows で動作し、GitHub（netease-youdao/LobsterAI）で MIT ライセンスのもとに公開されています。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 パス にあります。OpenAI Compatible (Responses) 形式は後述の任意の節で説明します。

インストール¶

公式 README はダウンロードページ（macOS Apple Silicon、macOS Intel、Windows x64）と、GitHub Releases の最新インストーラーを案内しています。モデルベンダーのアカウントは不要です。ダッシュボード で 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 の表記です）。

両方の形式を使う場合は、カスタムプロバイダーを 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 で販売中のモデルと一字一句一致させてください。例は次のとおりです。

1. 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 が返れば、パスとキーは正しい状態です）：

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 に表示されます。キーを入力すると、各呼び出しのモデルとステータスコードを確認できます。

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

公式のマニュアル、更新履歴、リポジトリのソースコードと 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 で販売中の ID だけを使ってください。
• 公式のモデル設定ガイドのエラー表には「API Key Invalid」「Insufficient Balance」「Network Error」「Service Unavailable」の 4 つがあります。QCode での対処は、cr_ キーを全体ごとコピーし直す、QCode の残高を確認する、ネットワークを確認する、サービスの状態を確認する、の順です。
• キーの保存：公式マニュアルには、API キーはローカル端末にのみ保存され、どのサーバーにもアップロードされないと書かれています。

関連ドキュメント¶

• エンドポイントと API パス — プロトコルと Base URL の入力方法
• ツール互換性一覧 — すべてのツールのプロトコル対応
• OpenClaw 接続 — LobsterAI の基盤である OpenClaw フレームワークの設定
• AutoClaw — 智譜（Zhipu）のローカル OpenClaw アプリ（カスタムモデルは OpenAI プロトコル）
• Qoder — カスタムモデルに Anthropic と OpenAI の両方のエンドポイントを設定できるデスクトップエージェント
• 中国系モデルの接続 — 販売中の GLM / Kimi / DeepSeek / Qwen の ID
• トラブルシューティングガイド

企業版 →