CherryINNew API 使用指南
Claude Code 配置教程
在 Claude Code 中使用 CherryIN API 的完整指南
什么是 Claude Code？
Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手。它可以直接在终端中帮助您编写代码、调试问题、执行命令等。
通过配置 CherryIN API，您可以在 Claude Code 中使用我们提供的 Claude 模型服务。
开始之前
请确保您已经：
- 完成了 快速上手 中的步骤，获取到了您的 API Key
- 已安装 Claude Code
配置步骤
设置环境变量
根据您使用的操作系统和 Shell，选择对应的配置方式：
编辑 ~/.zshrc 文件：
nano ~/.zshrc在文件末尾添加以下内容：
# CherryIN API 配置
export ANTHROPIC_BASE_URL='https://open.cherryin.cc'
export ANTHROPIC_AUTH_TOKEN='sk-xxxxx' # 替换为您的 API Key
# 模型配置（可选，用于指定默认模型）
export ANTHROPIC_DEFAULT_OPUS_MODEL='anthropic/claude-sonnet-4.5'
export ANTHROPIC_DEFAULT_SONNET_MODEL='anthropic/claude-sonnet-4.5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='anthropic/claude-haiku-4.5'
export CLAUDE_CODE_SUBAGENT_MODEL='anthropic/claude-sonnet-4.5'保存后，执行以下命令使配置生效：
source ~/.zshrc编辑 ~/.bashrc 文件：
nano ~/.bashrc在文件末尾添加以下内容：
# CherryIN API 配置
export ANTHROPIC_BASE_URL='https://open.cherryin.cc'
export ANTHROPIC_AUTH_TOKEN='sk-xxxxx' # 替换为您的 API Key
# 模型配置（可选，用于指定默认模型）
export ANTHROPIC_DEFAULT_OPUS_MODEL='anthropic/claude-sonnet-4.5'
export ANTHROPIC_DEFAULT_SONNET_MODEL='anthropic/claude-sonnet-4.5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='anthropic/claude-haiku-4.5'
export CLAUDE_CODE_SUBAGENT_MODEL='anthropic/claude-sonnet-4.5'保存后，执行以下命令使配置生效：
source ~/.bashrc以管理员身份打开 PowerShell，执行以下命令：
# CherryIN API 配置
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://open.cherryin.cc", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxx", "User") # 替换为您的 API Key
# 模型配置（可选，用于指定默认模型）
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "anthropic/claude-sonnet-4.5", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "anthropic/claude-sonnet-4.5", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "anthropic/claude-haiku-4.5", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_SUBAGENT_MODEL", "anthropic/claude-sonnet-4.5", "User")配置完成后，重新打开一个新的 PowerShell 窗口使配置生效。
请替换 API Key
请将 sk-xxxxx 替换为您在 CherryIN 控制台获取的真实 API Key。
验证配置
启动 Claude Code 后，可以通过以下方式验证配置是否成功：
- 使用
/model命令查看当前模型 - 发送一条消息测试是否正常响应
模型 ID 格式
CherryIN 的模型名称格式为 厂商/模型名，例如 anthropic/claude-sonnet-4.5。使用 /model 命令时，请输入完整的模型 ID。
切换模型
在 Claude Code 中，您可以使用 /model 命令切换不同的模型：
/model anthropic/claude-sonnet-4.5
可用模型
| 模型 ID | 说明 |
|---|---|
anthropic/claude-opus-4 | Claude Opus 4，最强大的模型 |
anthropic/claude-sonnet-4.5 | Claude Sonnet 4.5，平衡性能与成本 |
anthropic/claude-haiku-4.5 | Claude Haiku 4.5，快速响应 |
查看更多模型
登录 CherryIN 控制台 查看所有可用的 Claude 模型。
环境变量说明
| 环境变量 | 必填 | 说明 |
|---|---|---|
ANTHROPIC_BASE_URL | 是 | CherryIN API 地址 |
ANTHROPIC_AUTH_TOKEN | 是 | 您的 API Key |
ANTHROPIC_DEFAULT_OPUS_MODEL | 否 | 默认 Opus 模型 |
ANTHROPIC_DEFAULT_SONNET_MODEL | 否 | 默认 Sonnet 模型 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | 否 | 默认 Haiku 模型 |
CLAUDE_CODE_SUBAGENT_MODEL | 否 | 子代理使用的模型 |
常见问题
配置后仍然无法使用？
- 确认环境变量已生效：运行
echo $ANTHROPIC_BASE_URL检查是否正确设置 - 完全重启 Claude Code：确保关闭所有 Claude Code 进程后重新启动
- 检查 API Key：确认 API Key 正确且账户余额充足
报错：Authentication failed
原因：API Key 无效或未正确配置
解决：
- 检查
ANTHROPIC_AUTH_TOKEN环境变量是否正确设置 - 确认 API Key 没有多余的空格或换行
- 在控制台验证 API Key 是否有效
如何临时使用不同的 API Key？
可以在启动 Claude Code 时临时指定环境变量：
ANTHROPIC_AUTH_TOKEN='sk-your-other-key' claude