Claude Code 接入教程

本文档将带你完成在 Claude Code CLI 中接入 镜芯 API 的全流程，大约需要 5 分钟。

一、注册账户

打开镜芯 API 控制台，首次使用请在登录页底部点击 "注册" 进入注册页面。

填写邮箱、密码，如有优惠码可一并填写，点击 "继续" 完成注册。

密码要求

密码至少 6 个字符，建议使用字母 + 数字组合以保障账户安全。

二、充值与兑换

注册成功后进入控制台，可在首页查看 当前余额 和 开发数(请求次数)。

如果你拿到了兑换码，在 兑换码 输入框中粘贴并点击 "兑换" 即可为账户充值。

注意

• 每个兑换码只能使用一次
• 兑换码可叠加余额，开发数也将累计
• 如兑换失败，请联系客服并提供兑换码
• 余额和开发数实时更新

三、创建 API 密钥

点击左侧菜单 API 密钥，然后点击右上角 "创建密钥" 按钮。

在弹窗中填写名称，并选择 分组(模型供应渠道):

分组	倍率	适用场景
Claude-余额扣费	1x	Claude 系列模型，标准计费
OpenAi-余额扣费	1x	GPT 系列模型，标准计费
OpenAi-逆传	5x	OpenAI 反向通道，稳定性更高
Claude高质量分组(强命中率高支持逆传)	50x	企业级高质量通道，缓存命中率更高

选择建议

• 个人开发 / 测试:推荐 Claude-余额扣费
• 生产环境 / 高频调用:推荐 Claude高质量分组，稳定性和命中率更佳

可按需开启 密钥有效期 限制，完成后点击 "创建"。

四、安装 Claude Code

镜芯 API 完全兼容 Anthropic 官方 Claude Code CLI。在终端(CMD / PowerShell)中执行:

npm install -g @anthropic-ai/claude-code

安装成功后会显示 added 2 packages in 3s:

前置依赖

请先安装 Node.js (建议 LTS 18+ 版本)，否则 npm 命令无法识别。

随后在任意目录运行 claude 命令，首次启动会询问是否信任当前工作目录，选择 "1. Yes, I trust this folder" 并回车。

五、配置 API 转发

5.1 找到 settings.json

在文件管理器地址栏输入以下路径并回车，进入 Claude Code 配置目录:

C:\Users\Administrator\.claude

TIP

• Windows:%userprofile%\.claude\settings.json
• macOS / Linux:~/.claude/settings.json

如果目录或 settings.json 文件不存在，请手动新建一个空白的 settings.json 文本文件。

5.2 获取密钥配置

回到镜芯 API 控制台 API 密钥 页面，找到刚创建的密钥，点击该行操作栏的 "使用密钥" 图标。

在弹窗中切换到 Claude Code Tab，选择 Windows CMD 平台，可看到两块内容:

• 上方:命令行临时环境变量(仅当前终端会话生效)
• 下方:%userprofile%\.claude\settings.json 永久配置(推荐)

点击下方配置块右上角的 "复制" 按钮。

5.3 写入 settings.json

用记事本或任意文本编辑器打开第 5.1 步定位到的 settings.json 文件，粘贴刚才复制的内容，保存(UTF-8 编码)。

最终文件内容大致如下:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://code.wer.plus",
    "ANTHROPIC_AUTH_TOKEN": "sk-ad486aed89b8e479a1a208afc4843faa0c538906889f8c6d5aaf0abdd5b83d6f",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

字段	说明
ANTHROPIC_BASE_URL	中转站地址，固定为 https://code.wer.plus
ANTHROPIC_AUTH_TOKEN	第三步创建的 API 密钥，请勿泄露
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC	关闭非必要流量上报，节省额度
CLAUDE_CODE_ATTRIBUTION_HEADER	关闭归因头，提升请求兼容性

安全提醒

ANTHROPIC_AUTH_TOKEN 等同于你的账户凭证，切勿提交到 Git 仓库或公开分享。如发生泄露请立即在控制台 删除并重建密钥。

六、开始使用

关闭并重新打开终端(让环境变量生效)，进入任意工作目录后运行:

claude

看到对话提示符即表示接入成功，现在可以直接对话或交给 Claude Code 完成编码任务了 🎉

常见问题

Q1:claude 命令无响应或报 401 错误?

检查 settings.json 中的 ANTHROPIC_AUTH_TOKEN 是否正确、未过期，且终端已重新打开。

Q2:提示 npm: command not found?

请先安装 Node.js 并重启终端。

Q3:如何切换分组(渠道)?

不同分组对应不同密钥。在控制台创建对应分组的新密钥，替换 settings.json 里的 ANTHROPIC_AUTH_TOKEN 即可。

Q4:余额扣费规则?

按 分组倍率 × 实际 token 用量 扣费，详情可在 API 密钥 列表的 "用量" 列查看每日消耗。

需要帮助?

如果按以上步骤仍无法接入成功，欢迎通过以下方式联系我们:

• 企业微信群:扫描首页二维码加入官方交流群,入群即可领取免费额度
• 官方 QQ 群:376957298 (入群即可领取免费额度)
• 客服 QQ:3061928404 (工作日 9:00 - 22:00 在线)