Claude Code 中配置卡皮巴拉 API

这篇教程会带你把卡皮巴拉 API 接入 Claude Code。整个流程只需要做三件事：

1. 在卡皮巴拉 API 后台复制请求地址。
2. 创建并复制你的 API Key。
3. 在 CC Switch 里添加供应商并填写模型映射。

跟着下面的截图一步一步操作即可。

一、复制 API 请求地址

先进入卡皮巴拉 API 控制台首页。

在“概览”页面找到“API 信息”卡片，点击主域名右侧的复制按钮。

这里复制的是请求地址，也就是后面 CC Switch 里的“请求地址”。

复制到的地址类似下面这样：

https://kapibala.asia

WARNING

复制后不要在末尾额外添加 /。

二、创建 Claude Code 使用的 API Key

在左侧菜单点击“API 密钥”。

进入 API 密钥页面后，点击右上角“创建 API 密钥”。

在创建窗口里按截图填写。填好后，点击右下角“保存更改”。

三、复制刚创建的 API Key

保存后回到“API 密钥”列表。

找到刚刚创建的密钥，点击密钥右侧的复制按钮。

这里复制的是 API Key，后面要粘贴到 CC Switch 的“API Key”输入框。

复制到的内容一般类似：

sk-...

WARNING

请不要把这个 Key 发给别人，也不要公开放到截图、文章或代码仓库里。

四、在 CC Switch 里添加新供应商

打开 CC Switch。

点击右上角的加号按钮，进入“添加新供应商”页面。

五、填写供应商名称、API Key 和请求地址

进入“添加新供应商”页面后，先填写基础信息。

也就是：

• “API Key”粘贴刚才从卡皮巴拉 API 后台复制的 sk-...。
• “请求地址”粘贴刚才从“概览”页复制的 https://kapibala.asia。

WARNING

再次提醒：请求地址末尾不要带 /。

六、设置认证字段和模型映射

继续往下找到“认证字段”。

认证字段保持默认即可：

ANTHROPIC_AUTH_TOKEN

然后在“模型映射”里填写 Claude Code 要使用的模型。

如果只想先跑通 Claude Code，建议先只配置 Sonnet 这一行。

这里要注意两列的区别：

• “显示名称”：只影响 Claude Code 里 /model 菜单看到的名字。
• “实际请求模型”：真正发给卡皮巴拉 API 的模型名称。

如果不知道该填哪个模型，可以点击右侧“获取模型列表”，从列表里选择可用模型。

如果模型支持 1M 上下文，可以勾选右侧的 1M。

七、保存并在 Claude Code 中使用

确认下面几项都已经填好：

• API Key 已填写。
• 请求地址已填写，且末尾没有 /。
• 认证字段是 ANTHROPIC_AUTH_TOKEN。
• Sonnet 至少配置了一个可用模型。

确认无误后，点击右下角“添加”保存。

保存完成后，在 CC Switch 中启用这个供应商，然后打开 Claude Code，在 /model 里选择刚刚配置的模型即可。

如果 Claude Code 可以正常回复，就说明已经接入成功。

推荐最小配置

如果只是想最快完成接入，可以直接按下面这套配置填写：

供应商名称：卡皮巴拉API
API Key：粘贴你在卡皮巴拉 API 后台复制的 sk-...
请求地址：粘贴概览页复制的请求地址，例如 https://kapibala.asia
认证字段：ANTHROPIC_AUTH_TOKEN
Sonnet 显示名称：gpt-5.4-mini
Sonnet 实际请求模型：gpt-5.4-mini

常见问题

Claude Code 请求失败怎么办？

优先检查这几项：

• API Key 是否复制完整。
• 请求地址是否复制正确。
• 请求地址末尾是否多了 /。
• 卡皮巴拉 API 账户余额是否充足。
• 模型名称是否是平台支持的模型。

CC Switch 里应该填 API Key 还是请求地址？

两个都要填，但位置不同：

• sk-... 填到“API Key”。
• https://kapibala.asia 这类地址填到“请求地址”。

不要把 API Key 填进请求地址，也不要把请求地址填进 API Key。

/model 里看不到我想用的模型？

检查“模型映射”里的“显示名称”是否填写。

Claude Code 里显示的是“显示名称”，真正调用的是“实际请求模型”。

实际请求模型应该填什么？

以卡皮巴拉 API 当前支持的模型名为准。

你可以在 CC Switch 里点击“获取模型列表”，选择列表里能用的模型，然后填到“实际请求模型”里。

为什么请求地址不能带 /？

部分工具会自己拼接后续路径。如果请求地址末尾多了 /，可能会导致最终请求地址异常。

所以建议统一填写：

https://kapibala.asia

不要填写：

https://kapibala.asia/

配置完成以后可以测试一下。后续可以继续关注原链接和群聊，后续会更新各种 skill、MCP 以及 CLI 的安装与使用。

如果有任何问题和建议，欢迎私聊或者群聊提出。