> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hostlinku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop

> Configure Third-Party Inference を使い、追加のローカルプロキシなしで Claude Desktop を Hostlinku に接続します。

[Claude Desktop](https://claude.com/download) は、対応バージョンの **Configure Third-Party Inference** から Hostlinku に接続できます。アプリに base URL と API キーを入力し、そのキーの Service Mode で利用できるモデルを選択します。

このガイドは Desktop アプリ向けです。ターミナルや VS Code/JetBrains 拡張機能については [Claude Code](https://docs.hostlinku.com/ja/integrations/claude-code.md) を参照してください。この inference 接続に追加のローカルプロキシや MCP 設定の変更は不要です。

## 始める前に

* [公式ダウンロードページ](https://claude.com/download) から Claude Desktop をインストールします。
* [Console → API Keys](https://console.hostlinku.com/api-keys/) で、目的の Claude モデルを提供する Service Mode の Hostlinku API キーを作成します。
* USD 残高とキーの利用上限を確認します。利用料金は Hostlinku で請求されます。[課金と残高](https://docs.hostlinku.com/ja/billing.md) を参照してください。

検証範囲

以下の Windows スクリーンショットでは、モデル検出と inference テストが成功しています。Claude Desktop の **Code** モードでも、**Fable 5.2** を使った簡単な会話が成功しました。Chat、Cowork、artifacts、connector、全モデルの機能をすべて検証したものではありません。メニュー名や場所はアプリのバージョンによって異なります。

### Developer Mode を有効にする

Windows では **☰ → Help → Troubleshooting → Enable Developer Mode** を開きます。有効化後も Developer メニューが表示されない場合は、アプリを完全に終了して開き直してください。

![Windows の Claude Desktop：Help → Troubleshooting の Enable Developer Mode](https://mintcdn.com/hostlinku/D_n6COs9jkVA6WFt/images/integrations/claude-desktop-developer-mode.webp?fit=max\&auto=format\&n=D_n6COs9jkVA6WFt\&q=85\&s=8d52f77f1d224acf4278f03098e0a0ee)

### Third-party inference 設定を開く

**☰ → Developer → Configure Third-Party Inference…** を開きます。

![Windows の Claude Desktop：Developer メニューの Configure Third-Party Inference](https://mintcdn.com/hostlinku/D_n6COs9jkVA6WFt/images/integrations/claude-desktop-third-party-menu.webp?fit=max\&auto=format\&n=D_n6COs9jkVA6WFt\&q=85\&s=2b29c13ba052454fe69fabbb47bc78ac)

### Hostlinku 接続を設定する

**Connection** に次の値を設定します。

| フィールド | 値 |
| - | - |
| Provider | `Gateway` |
| Credential kind | `Static API key` |
| Gateway base URL | `https://api.hostlinku.com` |
| Gateway API key | Hostlinku API キー（例：`sk-your-api-key`） |
| Gateway auth scheme | `x-api-key` |

キーは `Bearer ` を付けずに入力してください。base URL に `/v1` や `/messages` を追加しません。Hostlinku はモデル検出用の `GET /v1/models` と Anthropic Messages inference 用の `POST /v1/messages` を提供しています。

画像のテストでは `x-api-key` を使用しています。Hostlinku は `Authorization: Bearer` も受け付けますが、その選択肢は画像では検証していません。基本設定に Custom inference headers は不要です。

![Claude Desktop の Gateway 設定：Hostlinku URL、伏せられた static key、x-api-key、成功した接続テスト](https://mintcdn.com/hostlinku/D_n6COs9jkVA6WFt/images/integrations/claude-desktop-gateway-settings.webp?fit=max\&auto=format\&n=D_n6COs9jkVA6WFt\&q=85\&s=13d5e81a7e0ccf512c2f8141d09dd096)

### 接続をテストしてモデルを検出する

**Test connection** をクリックします。成功すると **Model discovery** と **Inference** が表示されます。一覧だけを確認する場合は、**Models** に **Test model discovery** があれば使用します。

画像の **12 models** はテスト時のキーでの結果であり、全アカウント共通の固定数ではありません。一覧はキーの Service Mode と利用可能なモデルに従います。**Model list** を手動で指定する場合は、同じキーの `GET /v1/models` から Anthropic Messages 対応の slug を使用し、別のプロバイダーの一覧をコピーしないでください。

### 保存して会話を試す

**Save Changes**、続いて表示される場合は **Apply Changes** をクリックします。再起動の案内に従ってください。Desktop の **Code** セッションを開き、利用可能なモデルを選択して `hello` などの短いメッセージを送信します。

以下は **Fable 5.2** で応答した例です。**Console → Request Logs** でも API キー、モデル、状態、費用を確認してください。Test connection 自体もトークンを消費し、少額の料金が発生する場合があります。

![Claude Desktop の Code モード：HostlinkuGateway 環境で Fable 5.2 による挨拶への応答](https://mintcdn.com/hostlinku/D_n6COs9jkVA6WFt/images/integrations/claude-desktop-code-conversation.webp?fit=max\&auto=format\&n=D_n6COs9jkVA6WFt\&q=85\&s=4dca2b60c563d61ae63c22850eb8eddb)

## 機能の範囲

* **Inference と MCP は別です。** この設定はモデルリクエストを Hostlinku に送ります。connector や MCP の設定だけでは inference provider は変更されません。
* **Gateway-managed Claude Code** と **Server-side Auto mode checks** は、この static key 設定の必須条件ではありません。この接続では未検証です。
* tool calling、vision、reasoning、コンテキスト、caching はモデルとプロトコル経路に従います。[Anthropic Messages](https://docs.hostlinku.com/ja/anthropic-messages.md) と [モデルカタログ](https://docs.hostlinku.com/ja/models.md) を参照してください。
* モデル検出の成功は、一覧の全モデルが Desktop の全 agent 機能に対応することを保証しません。Claude モデルで簡単なタスクから始めてください。

## トラブルシューティング

| 症状 | 確認事項 |
| - | - |
| Developer や third-party inference メニューがない | 対応バージョンか確認し、Developer Mode を有効化して完全に再起動します。 |
| `401` | キーの正しさ、失効、有効期限、auth scheme を確認します。キー欄に `Bearer ` を付けません。 |
| モデル検出が空、またはモデルが見つからない | Test model discovery と同じキーの `GET /v1/models` を確認し、Service Mode に適した slug を使用します。 |
| `400 MODEL_NOT_IN_SERVICE_MODE` | そのモデルを提供する Service Mode のキーを使用します。 |
| `402` | 利用可能な USD 残高とキーの利用上限を確認します。 |
| `429` | `Retry-After` があれば従い、同時実行数を減らします。[使用状況と制限](https://docs.hostlinku.com/ja/usage-and-limits.md) を参照してください。 |
| 接続テストは成功するが Code セッションが失敗する | 選択したモデルと Console のリクエスト詳細を確認します。短い接続テストだけでは全 tool/agent 機能を検証できません。 |

API キーや認証情報を含む設定 export を共有しないでください。サポートにはキーを含めず、Desktop のバージョン、モデル、Service Mode、request ID を伝えてください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.