AI 编程 / Claude Code

Claude Code 用 CC Switch 接入 NewBee

Claude Code 的配置优先交给 CC Switch 管理。NewBeeAPI 负责 API 密钥和模型，CC Switch 负责导入、保存和切换 Claude Provider。

下载 CC Switch开始配置
推荐链路

NewBeeAPI API 密钥 → CC Switch → Claude Code

Windows、macOS、Linux 均可使用。

先理解三者分工

NewBeeAPI创建 API 密钥 / 提供模型
→
CC Switch导入 / 保存 / 切换 Provider
→
Claude Code终端里的 AI 编程工作流

不要把 OpenAI-compatible 的 https://api.newbeeapi.com/v1 直接当成 Anthropic 端点填入 Claude Code。Claude Code 应按当前 NewBeeAPI / CC Switch 的 Claude Provider 配置完成接入。

安装

先安装 Claude Code，再安装 CC Switch。CC Switch 的官方下载入口由官网统一提供，Windows、macOS、Linux 按系统选择对应版本。

打开 CC Switch 官方下载查看 NewAPI 参考文档
系统安装建议
Windows下载安装包或 ZIP 版本，首次运行时允许系统注册 ccswitch:// 协议。
macOS使用官方发行包；也可按官方说明使用 Homebrew 安装。
Linux使用官方 Releases 提供的 .deb 或 .AppImage；Arch 用户可使用官方说明中的 AUR 包。
macOS / Homebrew
brew tap farion1231/ccswitch
brew install --cask cc-switch

通过 NewBeeAPI 导入 Claude Provider

  1. 登录 NewBeeAPI 控制台，进入左侧“API 密钥”，点击“新建 API 密钥”。
  2. 名称按用途填写；分组选择 default 默认分组即可，按需要设置有效期和额度，数量保持为 1，然后提交。
  3. 创建完成后复制 API 密钥，只在自己的设备上安全保存。
  4. 回到左侧“API 密钥”列表，找到刚创建的密钥，打开右侧操作菜单并点击“CC Switch”。
  5. 浏览器提示打开本地应用时，允许使用 ccswitch:// 唤起 CC Switch。
  6. 在“应用”中选择 Claude，填写配置名称。
  7. 填写“主模型”；Haiku、Sonnet、Opus 根据你的路由需要选择或填写。
  8. 点击“打开 CC Switch”，回到 CC Switch 检查 Provider 是否已保存。
NewBeeAPI 创建 API 密钥窗口，使用 default 默认分组
先在 NewBeeAPI 创建 API 密钥，分组选择 default 默认分组。
NewBeeAPI 左侧导航中的 API 密钥入口
从 NewBeeAPI 左侧导航进入 API 密钥。
NewBeeAPI API 密钥操作菜单中的 CC Switch
在刚创建的 API 密钥右侧操作菜单中选择 CC Switch。
NewBeeAPI 填入 CC Switch 弹窗中的 Claude 配置
选择 Claude，填写主模型和可选的 Haiku、Sonnet、Opus 分层模型。
模型怎么填？
模型名称必须以 NewBeeAPI 当前模型列表和 CC Switch 下拉选项为准，不要照抄旧文章中的模型名。

启动并验证 Claude Code

  1. 在 CC Switch 中确认 Claude Provider 已启用。
  2. 打开新的终端窗口，进入你的项目目录。
  3. 运行 claude，按 Claude Code 的提示选择或确认当前 Provider。
  4. 先发送一个只读、低风险任务，例如让它总结目录结构。
  5. 确认返回成功，再逐步启用文件编辑、命令执行等高权限操作。
  6. 回到 NewAPI 使用日志，核对请求是否来自刚才创建的令牌。
遇到 401 / 404 时
先在 CC Switch 里确认 Provider 的 Base URL、API Key 和模型；不要把 Codex++ 的配置截图或 TOML 原样套给 Claude Code。

备用：手工环境变量

只有在你明确知道当前 NewBee 提供 Anthropic-compatible 接口，并且需要绕过 CC Switch 时，才使用手工方式。端点和变量名以当前服务端说明为准。

仅作示例，不要盲抄端点
# 端点、变量名和模型请以当前 Anthropic-compatible 配置为准
export ANTHROPIC_API_KEY="sk-your-newbee-api-key"
export ANTHROPIC_BASE_URL="https://your-anthropic-compatible-endpoint"

Windows PowerShell 可使用 $env:ANTHROPIC_API_KEY="sk-your-newbee-api-key" 设置当前终端会话。手工配置与 CC Switch 同时存在时，优先检查当前终端环境变量是否覆盖了 CC Switch 的配置。

常见问题

NewBeeAPI API 密钥菜单没有 CC Switch

确认已进入左侧“API 密钥”，并在目标密钥右侧操作菜单中查找 CC Switch。

点击后没有打开 CC Switch

确认桌面版已安装，并允许浏览器打开 ccswitch:// 链接；也可以直接打开 CC Switch 手动创建 Claude Provider。

Claude Code 报 401

检查 CC Switch 中的 API Key、密钥状态和模型权限，泄露的 Key 立即在 NewBeeAPI 撤销并重建。

Claude Code 报 404 或协议错误

确认使用的是 Anthropic-compatible Provider 配置，不要把 OpenAI /v1 地址当成 Claude Code 的 Anthropic 端点。

Linux 上命令找不到

确认 Claude Code 已安装且命令已加入 PATH；重新打开终端后运行 claude --version 验证。