Claude Code
把 Anthropic 的终端编程助手 Claude Code 指向 Athandra,使用 official 分组的 Claude 模型。
Claude Code 是 Anthropic 推出的终端编程助手,能理解代码库、跨文件编辑、运行命令。它使用 Anthropic Messages 格式,通过环境变量指向 Athandra 即可。
验证状态
接口层面已实测:official 分组的令牌,用 Authorization: Bearer 或 x-api-key 调用 POST /v1/messages 访问 claude-haiku-4-5 通过。Claude Code 客户端本身未在 Athandra 环境实机验证,配置项按其官方文档整理。
官方主页:https://www.anthropic.com/claude-code
前置条件
- 令牌所在分组必须能调用 Claude 模型(
official分组),否则会返回model_not_found。创建方法见 令牌管理,可用/v1/models确认。 - Base URL 不带
/v1,原因见 Anthropic 格式。
安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash如果安装完提示 claude 不在 PATH 中,按提示把 ~/.local/bin 加入 PATH:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc安装完成后运行 claude --version,显示版本号即成功。
配置环境变量
export ANTHROPIC_BASE_URL="https://ai.athandra.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
claude想长期生效,把前两行写进 ~/.zshrc 或 ~/.bashrc。
或者写入 settings.json
编辑 ~/.claude/settings.json,以后不用每次导出环境变量:
{
"env": {
"ANTHROPIC_BASE_URL": "https://ai.athandra.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}指定模型
默认模型不可用时,用环境变量指定令牌分组里有的模型:
export ANTHROPIC_MODEL="claude-haiku-4-5"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5"也可以在 Claude Code 里输入 /model 选择模型。
设置 ANTHROPIC_BASE_URL 后,所有模型请求(包括官方预设模型)都会发往 Athandra,并按 Athandra 的价格扣费,不再使用 Anthropic 官方账号的额度。
验证
启动 claude 后输入任意问题。如果报 model_not_found,检查模型名和令牌分组;报 401,检查 Key;排查方法见 错误排查。