配置模型供应商

推荐使用 CC Switch 完成配置 —— 一款开源的供应商管理工具，可视化操作，无需手动编辑 JSON 或环境变量。

1. 安装 CC Switch

macOS

Terminal

brew install --cask cc-switch

或前往 Releases 下载 .dmg 手动安装。

Windows

前往 Releases 下载 .msi 安装程序。

Linux

Terminal

# Debian / Ubuntu
sudo dpkg -i CC-Switch-*.deb

# Fedora / RHEL
sudo rpm -i CC-Switch-*.rpm

# AppImage
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

支持 macOS 12+、Windows 10+、Ubuntu 22.04+ / Debian 11+ / Fedora 34+

2. 添加 ClaudeYY 供应商

步骤一：新增供应商

打开 CC Switch，进入供应商管理页，点击右上角 + 按钮。

步骤二：填写配置

按下图标注填写，点击 + 添加 完成。

配置项	值	说明
❶ 供应商名称	`claudeyy-claude`	自定义，方便识别
❷ 官网链接	`https://claudeyy.com`	供应商官网
❸ API Key	你的 ClaudeYY API Key	在 https://claude.claudeyy.com 获取
❹ 请求地址	`https://claude.claudeyy.com/anthropic`	末尾不要加斜杠
❺ API 格式 / 认证字段	`Anthropic Messages (原生)` / `ANTHROPIC_AUTH_TOKEN（默认）`	保持默认
❻ 模型配置	留空	留空使用默认 Claude 模型
❼ 选项	勾选「隐藏 AI 署名」和「Teammates 模式」	按需勾选
❽ 写入通用配置	✅ 勾选	写入全局配置，所有项目生效

CC Switch 自动写入 ~/.claude/settings.json，无需手动编辑任何文件。

步骤三：启用供应商

添加完成后回到列表，选中 claudeyy-claude，点击使用按钮，看到「切换成功」提示即完成。

3. 验证配置

进入项目目录，启动 Claude Code：

Terminal

cd your-project
claude

首次启动按 Esc 跳过登录。启动后注意顶部信息栏，确认显示 API Usage Billing（❶）表示已通过 ClaudeYY 计费：

以上信息确认无误，即配置成功。

4. 使用其他模型

通过 ClaudeYY，你可以在 Claude Code 中使用非 Claude 模型（如 Qwen、GLM、DeepSeek 等）。只需在模型广场筛选兼容模型，然后配置模型映射即可。

步骤一：筛选兼容模型

前往 ClaudeYY 模型广场，在左侧 API 协议 中选择 Anthropic，筛选出支持 Anthropic 协议的模型。

步骤二：复制模型名称

点击目标模型卡片，模型名称旁有 复制按钮，一键复制模型 ID（如 bailian/qwen3.6-plus）。

步骤三：配置模型映射

回到 CC Switch，在供应商配置中找到 模型映射 部分。将复制的模型名称填入对应的模型槽位：

映射槽位	说明	示例
主模型	Claude Code 默认使用的模型	`z-ai/glm-5.1`
推理模型 (Thinking)	用于深度推理的模型	`z-ai/glm-5.1`
Haiku 默认模型	轻量级任务模型	`bailian/qwen3.5-flash`
Sonnet 默认模型	中等复杂度任务模型	`bailian/qwen3.6-plus`
Opus 默认模型	高复杂度任务模型	`z-ai/glm-5.1`

如果供应商原生提供 Claude 系列模型，通常无需配置模型映射。仅在需要将请求映射到不同模型名称时填写。

故障排除

遇到问题时，在 Claude Code 终端中运行 /status 检查配置：

Terminal

/status

确认以下关键字段：

❶ Anthropic base URL 为 https://claude.claudeyy.com/anthropic
❷ Model 显示当前使用的模型

Q: 提示 “Authentication error”

确认 Anthropic base URL 正确，并检查 API Key 是否有效。

Q: 连接超时

确认请求地址填写为 https://claude.claudeyy.com/anthropic，末尾不带斜杠。

Q: 流式响应卡顿

ClaudeYY 已内置全球加速，通常为本地网络问题，检查本地连接后重试。