# LobeChat 接続設定

> **最終確認**：2026-10-13 · 📄 公式ドキュメント準拠（LobeHub v2.2.19）

## 接続の要点

| 項目 | 内容 |
|---|---|
| 使えるモデル | Claude ✅（Anthropic プロバイダー + Proxy URL）· GPT ✅ · 中国系モデル ✅（OpenAI プロバイダー + Proxy URL）· Gemini ❌（QCode は Gemini 系列を提供していません。Claude・GPT・中国系モデルをご利用ください） |
| プロトコルと Proxy URL | Anthropic Messages：`https://api.qcode.cc/api` · OpenAI 互換：`https://api.qcode.cc/openai/v1` |
| 設定する場所 | App Settings → AI Providers でプロバイダーを選び、API Key・**Proxy URL**・**Check** を使います |
| セルフホストの場合 | 画面ではなく環境変数 `ANTHROPIC_PROXY_URL` と `OPENAI_PROXY_URL` で指定します |
| 公式ドキュメント | [AI Model Providers](https://lobehub.com/docs/usage/providers) |

このアプリは現在 **LobeHub** の名前で公開されています。公式の概要ページにはマルチモデルの起点として "began with LobeChat's multi-model support" と書かれており、ドキュメントサイト・デスクトップ版・`lobehub/lobehub` イメージ・オープンソースの Community Edition まで同じブランド名です。LobeChat で検索すると LobeHub にたどり着きます。

## プロトコルの選び方

| 使いたいモデル | 有効にするプロバイダー | Proxy URL |
|---|---|---|
| Claude（`claude-sonnet-5`、`claude-opus-5`、`claude-haiku-5-5`） | **Anthropic** | `https://api.qcode.cc/api` |
| GPT（`gpt-6-sol`、`gpt-5.6-terra`） | **OpenAI** | `https://api.qcode.cc/openai/v1` |
| 中国系モデル（`deepseek-v4.1-flash`、`glm-5.3`、`qwen3.8-max`、`kimi-k3`） | **OpenAI** | `https://api.qcode.cc/openai/v1` |

🔴 **OpenAI プロバイダーで Claude を呼び出さないでください。** QCode が Claude を提供するのは Anthropic エンドポイントだけです。OpenAI 互換エンドポイントに `claude-*` を指定すると拒否され、逆に `gpt-*` は Anthropic エンドポイントでは動きません。QCode のキー（`cr_` 始まり）1 本で両方の入力に対応できます。

Proxy URL は上の表どおりにそのまま入れます。**末尾にスラッシュを付けない**でください。`/v1/chat/completions` のような完全なリクエストパスもこの欄には入れません。公式はこの欄を "the provider API base URL or a compatible endpoint" と定義しています。Anthropic 側で追加のパス指定が必要かどうかは公式に記載がないため、QCode が提示したアドレスをそのまま入れます。詳細は [エンドポイントと API パス](/docs/getting-started/endpoints-and-api-paths)を参照してください。

## インストール

まず使い方の形を決めます。キーをどこに置くかもそれで決まります。

- **デスクトップ / Web** — 公式の書き方は "Download the macOS, Windows, or Linux app from the official download page"。デスクトップ版は Electron で、ブラウザでは "Open LobeHub in a modern browser" です。キーと Proxy URL は下記の画面項目に入れます。
- **セルフホスト（Docker イメージ 1 個）**（公式コマンド。環境変数は env ファイルにまとめます）：

```bash
docker run -it -d -p 3210:3210 --network pg --env-file lobehub.env --name lobehub lobehub/lobehub
```

- **セルフホスト（Docker Compose）**（公式スクリプト → compose）：

```bash
mkdir lobehub && cd lobehub
bash <(curl -fsSL https://lobe.li/setup.sh) -l en
docker compose up -d
```

自分のインスタンスにデスクトップ版を接続する場合、デスクトップ向け文書は "your self-hosted instance version is 1.83.6 or higher to support desktop" 接続機能を要求しています。右上の Wi-Fi アイコンを押し、インスタンスのアドレスを入れ、接続します。同じ文書は、接続する前にインスタンスが "correctly configured with the OIDC-related environment variables" の状態であることも求めています。本ページが確認したサーバー側のリリースは v2.2.19（2026-10-07 公開）。1.83.6 はデスクトップ文書が挙げる数値で、同じ番号ではありません。

つまり本ページには 2 本の経路があります：**クラウドとデスクトップは画面の項目**、**セルフホストは環境変数**です。

## 設定

公式は項目がプロバイダーごとに違うと明言しています："Open App Settings → AI Providers, then select the provider you want to configure. The available fields depend on the provider"。手順は "Select a provider from the list and turn on its switch"、次に "Enter the credentials shown on the page. Most cloud providers use an API key"、次に "If Proxy URL is available, enter the provider API base URL or a compatible endpoint"、次に "Select Check to test the connection"、最後に "Enable a model in the model list. You can also fetch or add models when those actions are available."。続きとして "Your changes are saved automatically. You can then select the provider and model in the Agent settings." と書かれています。

2 点をはっきり述べておきます。第一に、公式の書き方は条件形です——*If Proxy URL is available*。したがって本ページは「どのプロバイダーにもこの欄がある」とは主張しません。クラウドとデスクトップの項目対照表も公式にはありません。お使いのバージョンで Anthropic や OpenAI のカードに Proxy URL の入力が見当たらない場合、このページでは宛先を書き換えられません。第二に、クラウドとデスクトップは対義ではありません："The desktop app can use Cloud services and cloud models."

### Claude を設定（Anthropic プロバイダー）

公式の Anthropic ページの順序どおり：

1. "Open App Settings → AI Providers, select Anthropic, and enable the provider"
2. "Enter the API key. If you use a proxy, enter its proxy URL" — QCode の `cr_` キーを入れ、Proxy URL は `https://api.qcode.cc/api`
3. "Select Check to test the connection"
4. "Enable the Claude models you need, then select one in the Agent settings"

モデル ID は QCode の一覧から選びます。日常は `claude-sonnet-5`、`claude-sonnet-5-5`、重い作業は `claude-opus-5` か `claude-opus-5-5`、軽い作業は `claude-haiku-5-5`。`claude-sonnet-4-6`、`claude-haiku-4-5-20251001`、`claude-fable-5`、`claude-fable-5-1` も使えます。本ページは内蔵の Anthropic と OpenAI の 2 つだけを扱い、公式が挙げる他のメーカー向けの指針は一つずつ確認していません。

### GPT と中国系モデルを設定（OpenAI プロバイダー）

同じ形で、公式の OpenAI ページの手順：

1. "Open App Settings → AI Providers, select OpenAI, and enable the provider"
2. "Enter the API key. If you use a proxy or compatible endpoint, enter its proxy URL" — 同じ `cr_` キーで、Proxy URL は `https://api.qcode.cc/openai/v1`
3. "Select Check to test the connection"
4. "Enable the OpenAI models you need, then select one in the Agent settings"

中国系モデルの ID も同じプロバイダー・同じ Proxy URL です：`deepseek-v4.1-flash`、`deepseek-v4-pro`、`glm-5.3`、`qwen3.8-max`、`kimi-k3`。詳しくは [中国系モデル](/docs/usage/cn-models)。DeepSeek・Qwen・Moonshot 向けの個別指針を別に設定する必要はありません。OpenAI 互換の 1 本の入力で一覧全体をカバーできます。内蔵の一覧に目的の ID がなければ、公式が認める「モデルの取得・追加」で自分で足してください。

### セルフホストの環境変数

Docker や Compose での運用では、同じ 2 つの宛先をプロバイダーごとに env ファイルへ書きます。参考ページは `ANTHROPIC_PROXY_URL` を "override the default Anthropic API request base URL"、`OPENAI_PROXY_URL` を "override the default OpenAI API request base URL" のための項目として説明しており、画面の Proxy URL とちょうど対応します：

| 変数 | 公式の既定値 | 入れる値 |
|---|---|---|
| `ANTHROPIC_API_KEY` | – | QCode の `cr_` キー |
| `ANTHROPIC_PROXY_URL` | `https://api.anthropic.com` | `https://api.qcode.cc/api` |
| `OPENAI_API_KEY` | – | 同じキー |
| `OPENAI_PROXY_URL` | `https://api.openai.com/v1` | `https://api.qcode.cc/openai/v1` |
| `OPENAI_MODEL_LIST` | – | 下記参照 |
| `ANTHROPIC_CLIENT_TIMEOUT` | `295000` | 長い応答が途中で切れる場合以外はいじらない |

`OPENAI_MODEL_LIST` の公式説明は "Used to control the model list" です。`+` で追加、`-` で非表示、`-all` は内蔵の一覧をまず消します。エンドポイントが自分で名指ししたモデルだけを扱う場合に適しています：

```bash
ANTHROPIC_API_KEY=cr_your_qcode_key
ANTHROPIC_PROXY_URL=https://api.qcode.cc/api
OPENAI_API_KEY=cr_your_qcode_key
OPENAI_PROXY_URL=https://api.qcode.cc/openai/v1
OPENAI_MODEL_LIST=-all,+gpt-6-sol,+gpt-5.6-terra,+glm-5.3,+deepseek-v4.1-flash
```

値に `/v1` を入れるかどうかはエンドポイント側の性質で、公式は "check the request suffix of your proxy service provider" と促し、空の応答では `/v1` を足して再試行する方法を示しています。QCode では OpenAI 側は `/openai/v1` を保ち、Anthropic 側は `/api` で止めます。参考ページには中国系サービスそれぞれの項目（`DEEPSEEK_PROXY_URL`・`QWEN_PROXY_URL`・`MOONSHOT_PROXY_URL`）もあり、そのプロバイダーの枠に意図的に QCode を載せたい場合だけ、QCode を向けてください。

## 動作確認

画面での公式の確認方法は "Select Check to test the connection" です。**本ページはテスト用のキーを持っていないため、上記のどの設定についても HTTP の結果を主張しません。** Check が失敗したら、ほかを見る前に Proxy URL とキーを直してください。

ゲートウェイの問題かアプリの問題かを分けるには、エンドポイントを直接叩きます：

```bash
KEY="cr_your_qcode_key"

# Anthropic エンドポイント — Claude の ID だけ
curl -X POST 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","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

# OpenAI 互換エンドポイント — GPT と中国系モデルの ID。claude-* は不可
curl -X POST https://api.qcode.cc/openai/v1/chat/completions \
  -H "authorization: Bearer $KEY" -H "content-type: application/json" \
  -d '{"model":"gpt-6-sol","messages":[{"role":"user","content":"ping"}]}'
```

返った JSON に `content`（Anthropic）や `choices`（OpenAI）があれば、エンドポイント側の応答は通っており、残る問題はアプリの設定側にあります。課金はトークン単位で、モデル別の単価は [qcode.cc/models](https://qcode.cc/models) に掲載されています。

## トラブルシューティングと既知の制限

| 症状 | 公式の記述 | 対処 |
|---|---|---|
| `OPENAI_PROXY_URL` を設定すると応答が空になる | "may encounter a situation where the AI returns an empty message"。公式は変数の再確認と `/v1` の "suffix is added correctly (if required)" を求める | Proxy URL は `https://api.qcode.cc/openai/v1` を一字そのまま。末尾スラッシュなし |
| `claude-*` が拒否される | — | QCode の OpenAI 互換アドレスは Claude 系列を提供していません（`model_not_available_on_endpoint`）。Anthropic プロバイダーへ移し、Proxy URL を `https://api.qcode.cc/api` に |
| Anthropic の長い要求が途中で切れる | `ANTHROPIC_CLIENT_TIMEOUT` の既定は `295000` で、このタイムアウト "is also used by Anthropic-compatible providers that rely on the Anthropic SDK" | セルフホストで長い生成のためだけに変更 |
| Vercel にデプロイした場合 | "10-second serverless function timeout limit" がある | 本ページの読み方では、この上限を超える長い出力は Docker か別のホストで |
| プロバイダーが使えなくなった | "This does not guarantee automatic failover" | 第 2 プロバイダーを自分で用意し、手動で切り替え |
| 接続エラー、キーが無効と出る | "Check your API key for extra spaces. Check that the key type matches the provider" | `cr_` キーを貼り直し、プロバイダーの種類を確認 |
| 一覧に自分のモデル ID がない | "Your account tier can exclude a model, or the provider can retire it" | QCode では自分で追加。内蔵の一覧は QCode のモデル一覧とは別物です |
| レート制限のエラー | "You reached the provider's request rate limit" | 要求頻度を下げるか、プロバイダーを切り替える |

QCode が提供していないもの：**gpt-6-luna** と **gpt-5.6-luna** は他の GPT モデル（`gpt-6.1-sol` / `gpt-6-sol` / `gpt-5.6-terra`）をお使いください。**Gemini 系列**も現時点では未提供で、Claude・GPT・中国系モデルをご利用ください。主たる宛先がお使いの回線で通らない場合、同じキーで `https://asia.qcode.cc/api` と `https://us.qcode.cc/api` も使えます。どのバージョンで、どのプロバイダーに Proxy URL の欄が出るかは公式に記載がなく、本ページの範囲外です。

## 関連ドキュメント

- [エンドポイントと API パス](/docs/getting-started/endpoints-and-api-paths) — プロトコル × モデル群の対照
- [ツール互換性一覧](/docs/ide/tool-compatibility) — 各ツールが話すプロトコル
- [Cherry Studio 接続](/docs/ide/cherry-studio) — 同じ宛先をデスクトップ画面で設定
- [Claude Desktop のサードパーティ API 設定](/docs/ide/claude-desktop)
- [中国系モデル](/docs/usage/cn-models)
- [モデル選択ガイド](/docs/usage/model-selection)
- [トラブルシューティング](/docs/reference/troubleshooting)