请输入
菜单

Claude Code桌面端安装与配置

一、准备工作

开始配置前,请先确认当前网络环境可以正常访问 https://ailink.nativex.com

二、安装 Claude 桌面端

1
在浏览器中打开 Claude 官方下载页面:https://claude.com/download
2
进入页面后,根据当前系统选择版本下载,并按照系统提示完成安装。
3
安装完成后,打开 Claude 桌面端,确认应用可以正常启动。

如果此时页面提示无法连接,属于正常情况。原因是模型服务尚未完成配置,当前只需要确认软件可以正常打开。

三、安装 CC Switch

请先完成 CC Switch 安装,安装地址:https://ccswitch.io/zh/download

安装完成后,请确认 CC Switch 可以正常打开。后续需要在 CC Switch 中手动添加 Claude 供应商配置。

四、创建 Claude 专用令牌

1
打开 AiLink 官网并登录账号:https://ailink.nativex.com
2
登录后,依次点击 控制台 → 令牌管理 → 添加令牌。
3
在创建令牌页面,按需填写以下信息:
- 名称:建议填写容易识别的名称,例如 Claude令牌。
- 额度设置:按实际需求设置额度。如果不需要限制额度,可保持默认配置。
4
确认信息无误后,点击 提交。

五、复制令牌密钥并添加 Claude 配置

1
令牌创建成功后,页面会返回令牌列表。
2

在令牌列表中找到刚创建的令牌,点击该令牌所在行中间 密钥 旁边的 复制 按钮,然后选择 复制密钥。

3

打开 CC Switch,点击顶部的 Claude 桌面端 图标,然后点击右上角的 加号。

4

在添加供应商页面中,点击 自定义配置。

5

进入自定义配置页面后,按以下要求填写:
- 供应商名称:填写容易识别的名称,例如 My Claude。
- 官网链接:可填写 https://ailink.nativex.com。
- API Key:粘贴刚刚从 AiLink 令牌列表复制的密钥。
- 请求地址:填写 AiLink 的 Claude 兼容请求地址,请以页面或截图中展示的地址为准。

6

填写完成后,展开 手动指定 Claude Desktop 模型列表(高级,可选)。
- 如果可以自动获取模型列表,请点击 获取模型列表。
- 如果无法获取,点击 添加模型,手动添加需要使用的模型。

7
模型添加完成后,选择要使用的模型,例如 claude-opus-5,然后点击页面右下角的 添加。

六、添加并启用配置

1
添加成功后,CC Switch 会返回供应商列表。
2
在列表中找到刚添加的配置,例如 My Claude,点击 启用。
3
启用后,点击该配置右侧的 连通性测试 按钮。如果页面上方提示 连通正常,说明 CC Switch 配置已生效。

七、验证 Claude 桌面端

打开 Claude 桌面端,你应该可以正常进入会话窗口。新建或打开一个对话,发送一条测试消息。如果模型可以正常响应,说明 Claude 桌面端已完成配置。

八、常见问题

复制密钥后无法添加配置
请确认复制的是令牌列表中的 复制密钥,不是 复制连接信息。如果添加时提示 API Key 不正确,请重新复制密钥,并确认没有多复制空格或其他字符。

连通性测试失败
请优先检查以下内容:网络是否可以正常访问 https://ailink.nativex.com。

Claude 桌面端仍然提示连接失败
请确认 CC Switch 中当前启用的是刚添加的 Claude 配置,并重新进行 连通性测试。测试通过后,请重新打开 Claude 桌面端,或重新发送测试消息。

Claude 桌面端仍然使用默认服务
请确认 CC Switch 中 Claude 对应的供应商配置已经处于 使用中 状态。如果存在多个供应商配置,请优先启用刚添加的 AiLink Claude 配置。

最近修改: 2026-09-21