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;排查方法见 错误排查。

本页目录