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

# Claude Desktop 接入 APIONE

> 通过第三方推理 Gateway 配置 APIONE 的 Messages 接口。

支持第三方推理的 Claude Desktop 版本可通过 Gateway 连接 APIONE。该入口的可用性取决于客户端版本、部署方式与账户策略；它不等同于给所有桌面聊天功能更换服务商。

## 打开配置入口

1. 打开左上角菜单，选择 **Help → Troubleshooting → Enable Developer Mode**，启用开发者模式，按客户端提示完成操作。

![Claude Desktop 的 Enable Developer Mode 菜单入口](https://mintcdn.com/apione/YJqu1mI7oWawp6EB/images/integrations/screenshots/claude-desktop-enable-developer-v2.png?fit=max\&auto=format\&n=YJqu1mI7oWawp6EB\&q=85\&s=558b74998ff69b19b581c72d1b98f12d)

通过 Help 菜单开启开发者模式。

2. 打开 **Developer → Configure Third-Party Inference**，进入第三方推理配置。

![Claude Desktop 的 Configure Third-Party Inference 菜单入口](https://mintcdn.com/apione/YJqu1mI7oWawp6EB/images/integrations/screenshots/claude-desktop-inference-menu-v2.png?fit=max\&auto=format\&n=YJqu1mI7oWawp6EB\&q=85\&s=b39c7c8474d06a91fe4b9a041aacc3d0)

从 Developer 菜单进入第三方推理设置。

## 填写 APIONE 参数

在 **Connection** 中选择 **Gateway**，按下图填写连接信息。

| 字段 | 内容 |
| - | - |
| Credential kind | `Static API key` |
| Gateway base URL | `https://api.apione.ai` |
| Gateway API key | APIONE API Key |
| Gateway auth scheme | `bearer`（使用 Authorization 请求头） |

![第三方推理设置中的 APIONE 网关地址与遮盖的静态密钥](https://mintcdn.com/apione/YJqu1mI7oWawp6EB/images/integrations/screenshots/claude-desktop-apione-gateway-v2.png?fit=max\&auto=format\&n=YJqu1mI7oWawp6EB\&q=85\&s=3073b08fbda40404842ae2e1781e0cce)

Claude Desktop 的 APIONE Gateway 配置示例

Gateway base URL 填写 `https://api.apione.ai`。客户端自动拼接 `/v1/models` 和 `/v1/messages`，填写带 `/v1` 的地址会导致路径重复并返回 404。

在 **Gateway auth scheme** 中明确选择 **bearer**；截图用于定位字段，未显示选定值。APIONE 网关支持 `Authorization: Bearer YOUR_APIONE_KEY`，不要在额外请求头中重复填写密钥。点击 **Test connection** 检查连接。若提示 `API token has expired` 或其他鉴权错误，先在 APIONE 控制台核对当前 Key 的启用状态、有效期、分组权限和余额，再检查实际接口的 HTTP 状态码、错误正文与请求标识。客户端提示本身不能证明 Key 已过期；只有后台确认已过期、停用或撤销时，才更新为有效 Key。不要在日志或反馈中发送完整密钥。

在模型配置区域添加支持 Anthropic Messages 的 APIONE 模型 ID，实际 ID 以 APIONE 模型目录为准。

## 应用与验证

点击 **Save Changes** 保存配置，再点击 **Apply Changes** 应用，按客户端提示操作后选定模型，发送简单文本。基础调用成功后，再验证 Code / Cowork 所需的文件操作和工具能力。

自动发现模型时，应检查客户端请求的 `/v1/models` 返回格式是否与预期一致；列表为空可改用手动 Model List。不要把其他平台的模型发现兼容性当作 APIONE 已验证结论。认证失败时确认只发送一种鉴权头，避免额外头重复携带密钥。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


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