Claude Desktop - Hostlinku Docs

Claude Desktop 可以在提供 Configure Third-Party Inference 菜单的版本中连接 Hostlinku。在应用中输入 base URL 和 API 密钥，然后选择该密钥的 Service Mode 可用的模型。本指南适用于 Desktop 应用。终端或 VS Code/JetBrains 扩展请参阅 Claude Code。此 inference 连接无需额外的本地代理，也无需修改 MCP 配置。

开始之前

从官方下载页面安装 Claude Desktop。
在 Console → API Keys 创建 Hostlinku API 密钥，选择提供目标 Claude 模型的 Service Mode。
确保 USD 余额和密钥支出限额充足。用量由 Hostlinku 计费；请参阅计费与余额。

功能范围

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 和模型目录。
模型发现成功不保证列表中的每个模型都支持 Desktop 的所有 agent 功能。请先使用 Claude 模型执行简单任务。

故障排查

症状	检查项
缺少 Developer 或 third-party inference 菜单	确认 Desktop 版本提供该功能，启用 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`，请遵循其要求并减少并发。参阅使用与限制。
连接测试成功但 Code 会话失败	检查选中的模型与 Console 请求详情；简短的连接测试不能验证完整的 tool/agent 支持。

不要分享 API 密钥或包含凭据的配置 export。寻求帮助时，请提供 Desktop 版本、模型、Service Mode 和 request ID，不要包含密钥。