Claude Code 桌面端安装与配置 koalaapi

一、准备工作

开始配置前，请先确认已具备以下条件：

已拥有可正常登录的 koalaapi 账号。

已安装或准备安装 Claude 桌面端。

已安装或准备安装 CC Switch。

当前网络环境可以正常访问 https://koalaapi.com/。

二、安装 Claude 桌面端

在浏览器中打开 Claude 官方下载页面：

https://claude.com/download

进入页面后，根据当前系统选择 Windows 版本下载，并按照系统提示完成安装。

安装完成后，打开 Claude 桌面端，确认应用可以正常启动。

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

三、安装 CC Switch

请先按照 koalaapi 官方文档完成 CC Switch 安装：

【CC Switch 安装教程】https://koalaapi.apifox.cn/8659863m0

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

四、创建 Claude 专用令牌

打开 koalaapi 官网并登录账号：

https://koalaapi.com/

登录后，依次点击 控制台 → 令牌管理 → 添加令牌。

在创建令牌页面，按需填写以下信息：

名称：建议填写容易识别的名称，例如 Claude令牌。

令牌分组：选择用于 Claude 的分组。请确保该分组中包含需要使用的 Claude 模型。

额度设置：按实际需求设置额度。如果不需要限制额度，可保持默认配置。

访问限制：如无特殊网络限制要求，可保持默认配置。

确认信息无误后，点击提交。

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

令牌创建成功后，页面会返回令牌列表。

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

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

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

进入自定义配置页面后，按以下要求填写：

供应商名称：填写容易识别的名称，例如 My Claude。

备注：可选，可填写用途说明。

官网链接：可填写 https://koalaapi.com/。

API Key：粘贴刚刚从 koalaapi 令牌列表复制的密钥。

请求地址：填写 koalaapi 的 Claude 兼容请求地址，请以页面或截图中展示的地址为准。

填写完成后，展开 手动指定 Claude Desktop 模型列表（高级，可选）。

如果可以自动获取模型列表，请点击 获取模型列表。如果无法获取，点击 添加模型，手动添加需要使用的模型。

模型添加完成后，选择要使用的模型，例如截图中的 claude-opus-4-8，然后点击页面右下角的添加。

六、添加并启用配置

添加成功后，CC Switch 会返回供应商列表。

在列表中找到刚添加的配置，例如 My Claude，点击启用。

启用后，点击该配置右侧的 连通性测试 按钮。

如果页面上方提示 连通正常，说明 CC Switch 配置已生效。

七、验证 Claude 桌面端

打开 Claude 桌面端，你应该可以正常进入会话窗口。新建或打开一个对话，发送一条测试消息。

如果模型可以正常响应，说明 Claude 桌面端已完成配置。

八、常见问题

复制密钥后无法添加配置

请确认复制的是令牌列表中的 复制密钥，不是 复制连接信息。

如果添加时提示 API Key 不正确，请重新复制密钥，并确认没有多复制空格或其他字符。

连通性测试失败

请优先检查以下内容：

koalaapi 令牌是否已启用。

令牌分组中是否包含所选 Claude 模型。

CC Switch 中是否已点击启用。

请求地址 是否填写正确。

网络是否可以正常访问 https://koalaapi.com/。

Claude 桌面端仍然提示连接失败

请确认 CC Switch 中当前启用的是刚添加的 Claude 配置，并重新进行 连通性测试。

测试通过后，请重新打开 Claude 桌面端，或重新发送测试消息。

Claude 桌面端仍然使用默认服务

请确认 CC Switch 中 Claude 对应的供应商配置已经处于 使用中 状态。

如果存在多个供应商配置，请优先启用刚添加的 koalaapi Claude 配置。

Claude Code 桌面端 安装与配置 koalaapi

一、准备工作#

二、安装 Claude 桌面端#

三、安装 CC Switch#

四、创建 Claude 专用令牌#

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

六、添加并启用配置#

七、验证 Claude 桌面端#

八、常见问题#

复制密钥后无法添加配置#

连通性测试失败#

Claude 桌面端仍然提示连接失败#

Claude 桌面端仍然使用默认服务#