▪ claude code
接入 Claude Code
Claude Code 只需两个环境变量即可指向 11book,模型与使用习惯保持不变;全程只需一次配置。
前置条件
- 已安装 Claude Code 并可正常运行(
npm install -g @anthropic-ai/claude-code)。 - 已在 控制台创建 API Key,且账户余额充足。
第 1 步 · 设置环境变量
Claude Code 读取 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN,把它们写入你的 shell 配置(如 ~/.zshrc):
~/.zshrc
export ANTHROPIC_BASE_URL="https://api.11book.ai"
export ANTHROPIC_AUTH_TOKEN="sk-xxxx" # create one in the consoleBase URL 填网关根地址(不带
/v1)——Claude Code 会自行拼接 Anthropic 原生的 /v1/messages 路径。第 2 步 · 或通过 settings.json 配置
想让配置在后续会话中生效?编辑用户级 ~/.claude/settings.json,env 块里写同样的变量即可:
~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.11book.ai",
"ANTHROPIC_AUTH_TOKEN": "sk-xxxx"
}
}第 3 步 · 验证
重新打开终端(让环境变量生效),运行一句最简单的指令:
终端
claude "Introduce yourself in one sentence"正常返回即接入完成;用量与消费可在控制台「使用记录」查看。
模型选择建议
在模型与价格中选择可用的 Claude 系列模型,用 /model 切换(或设置 ANTHROPIC_MODEL)。GPT、Gemini、Grok 系列通过 OpenAI 兼容端点调用,见API 集成文档。
常见问题
提示 401 / 无效密钥?
检查 ANTHROPIC_AUTH_TOKEN 是否已导出(test -n "$ANTHROPIC_AUTH_TOKEN"),以及 Key 是否在控制台被停用或删除;改完环境变量需重开终端。
提示余额不足?
Key 与账户余额共用,到余额充值页充值或兑换后自动恢复。
429 / 限流?
短时间请求过于频繁会被限流保护,稍后自动恢复;生产环境建议做好退避重试。
修改配置后不生效?
Claude Code 启动时读取配置,修改 settings.json 后需退出并重新启动会话。