在 Claude Code 和 Claude Desktop 中使用 AIGOKEY

准备配置参数

在 AIGOKEY 后台创建 API 密钥，并准备以下信息。请将示例密钥替换为真实密钥。

显示名称AIGOKEY供应商列表中显示的名称。

API 地址https://llm.aigokey.cn填写基础地址，不要自行追加 /v1。

API 密钥sk-你的API密钥替换为真实密钥，前后不要加空格或引号。

安全提示

不要把真实 API 密钥发布到文章、截图、GitHub 仓库或聊天记录中。

安装 CC Switch

从 CC Switch 官网或 GitHub Releases 下载对应系统版本并安装。Claude Desktop 的第三方 3P Profile 目前主要支持 Windows 和 macOS。

官方资源

CC Switch 官网 GitHub Releases

安装完成后

启动 CC Switch，后续 Claude Code 与 Claude Desktop 都在同一个左侧应用切换器中分别配置。

在 Claude Code 中配置 AIGOKEY

Claude Code 在 CC Switch 中显示为“Claude”。它使用自己的配置文件，与 Claude Desktop 的 3P Profile 相互独立。

打开 Claude 供应商面板

在左侧应用切换器选择“Claude”，它对应 Claude Code。点击右上角“+”，建议选择“应用专属供应商”。

添加自定义供应商

选择“自定义”或 Custom，填入 AIGOKEY 的显示名称、API 地址和 API 密钥。

选择 API 格式

AIGOKEY 提供 Anthropic Messages 兼容接口时选择该格式。若客服明确要求 OpenAI Chat Completions 或 Responses API，再按要求切换。

获取或填写模型

点击模型输入框旁的“获取模型”。失败时手动填写 AIGOKEY 后台或客服提供的真实模型 ID。

启用供应商

在供应商列表找到 AIGOKEY 并点击“启用”。Claude Code 支持热加载，但已打开的终端建议重新打开。

供应商参数

显示名称：AIGOKEY
API 地址：https://llm.aigokey.cn
API 密钥：sk-你的API密钥
API 格式：Anthropic Messages

验证 Claude Code

配置启用后，重新打开终端或重启 Claude Code。

claude 启动 Claude Code
发送“请简单介绍一下你自己。”
输入 /model 查看模型菜单

在 Claude Desktop 中配置 AIGOKEY

Claude Desktop 需要单独配置，不能直接沿用 Claude Code 当前启用的供应商。

在 CC Switch 左侧应用切换器中选择“Claude Desktop”，点击右上角“+”添加自定义供应商。
若看不到入口，前往“设置 → 通用 → 应用可见性”，确认 Claude Desktop 没有被隐藏。
填写 AIGOKEY 参数，API 格式按实际支持协议选择；Anthropic Messages 是常用默认格式。
点击“获取模型”自动读取模型，或手动填入 AIGOKEY 后台提供的真实模型 ID。
在供应商卡片上点击“启用”，然后完全退出并重新打开 Claude Desktop。

Claude Desktop 参数

显示名称：AIGOKEY
API 地址：https://llm.aigokey.cn
API 密钥：sk-你的API密钥
API 格式：Anthropic Messages

直连模式

当返回模型名属于 claude-sonnet-*、claude-opus-* 或 claude-haiku-*，且接口原生支持 Anthropic Messages API 时，关闭“需要模型映射”后直接添加。

模型映射模式

当返回的是 GPT、DeepSeek、Kimi 或其他非 Claude 模型名时，开启“需要模型映射”，将 Sonnet / Opus / Haiku 角色映射到 AIGOKEY 的真实模型 ID。

模型角色菜单显示名实际请求模型

SonnetAIGOKEYAIGOKEY 实际模型 ID

Opus / Haiku按需命名对应的真实模型 ID

模型映射需要本地路由

进入“设置 → 路由 → 本地路由”，开启“在主页面显示本地路由开关”，回到 Claude Desktop 面板后开启“Claude Desktop 本地路由”。使用期间保持 CC Switch 运行。

两种模式的区别

模式本地路由是否需要重启 Claude Desktop

直连模式不需要需要

模型映射模式需要，并保持 CC Switch 运行需要

常见问题

返回 401 或 INVALID_API_KEY 怎么办？

通常是 API 密钥错误、复制不完整或已经失效。重新复制 sk-你的API密钥，确认没有多余空格、换行或引号。

返回 404 怎么办？

优先确认 API 地址为 https://llm.aigokey.cn，不要自行添加 /v1，除非 AIGOKEY 官方文档明确要求。

Claude Desktop 没有变化？

确认在 Claude Desktop 面板启用了 AIGOKEY，完全退出并重启 Claude Desktop；模型映射模式还要确认 CC Switch 与本地路由仍在运行。

模型名称不被 Claude Desktop 接受？

Claude Desktop 只接受 Sonnet、Opus、Haiku 三类角色模型。非 claude-* 模型请开启“需要模型映射”，填入真实模型 ID。

获取模型列表失败？

可能是 AIGOKEY 暂未开放模型列表接口，或地址与协议不一致。可以手动填写模型 ID，并联系 AIGOKEY 获取可用模型名称和接口协议。

配置完成后的使用方式

完成配置后，按使用场景选择对应面板。API 密钥由 CC Switch 保存和管理，不建议手动修改 Claude 或 Claude Desktop 配置文件。

Claude Code：在 CC Switch 的“Claude”面板中启用 AIGOKEY。
Claude Desktop：在“Claude Desktop”面板中启用 AIGOKEY。
直连模式：重启 Claude Desktop 后即可使用。
模型映射模式：保持 CC Switch 和本地路由运行。
API 密钥交由 CC Switch 保存和管理，不手动修改配置文件。

参考文档CC Switch 添加供应商 Claude Desktop 配置