客户端示例

Claude Code

通过 Anthropic 兼容环境变量让 Claude Code 使用 AsterMesh。

Claude Code 走 Anthropic 兼容协议。把 Base URL 指到 AsterMesh,并把鉴权 token 换成 AsterMesh API Key。

1. 设置环境变量

临时设置:

export ANTHROPIC_BASE_URL="https://console.astermesh.cn"
export ANTHROPIC_AUTH_TOKEN="sk-..."

有些环境会读取 ANTHROPIC_API_KEY,可同时设置:

export ANTHROPIC_API_KEY="sk-..."

注意 Base URL

Anthropic 兼容地址一般填 https://console.astermesh.cn不要再拼 /v1。OpenAI 兼容客户端才用 https://console.astermesh.cn/v1

2. 写入 shell 配置(可选)

zsh:

echo 'export ANTHROPIC_BASE_URL="https://console.astermesh.cn"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-..."' >> ~/.zshrc
source ~/.zshrc

bash:

echo 'export ANTHROPIC_BASE_URL="https://console.astermesh.cn"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-..."' >> ~/.bashrc
source ~/.bashrc

3. 启动并验证

claude

进入后问一句:

请用一句话确认当前 Claude Code 已经可以访问 AsterMesh。

4. 选择模型

模型 ID 从 AsterMesh 控制台复制。如果客户端要求 Claude 原始模型名,选择控制台列表中对应的 Claude 模型。

不同版本的 Claude Code 模型选择方式不同,常见方式包括:

  • 在 Claude Code 内部选择模型。
  • 通过配置文件指定模型。
  • 通过环境变量或启动参数指定模型。

常见问题

  • 401:确认 ANTHROPIC_AUTH_TOKEN 是 AsterMesh API Key,且当前终端能读到该变量(echo "$ANTHROPIC_AUTH_TOKEN")。
  • 连到了官方 Anthropic:说明 ANTHROPIC_BASE_URL 未生效,重新打开终端后再试。
  • 404 或路径错误:检查 ANTHROPIC_BASE_URL,不要填到 /v1/messages
  • 启动后仍要求登录官方账号:确认当前 Claude Code 版本支持自定义 Base URL 和 token,部分版本或登录模式可能优先走官方账号。
  • 回复很慢:coding agent 会多轮请求模型,可以换更快模型,或让它只读取必要文件。

© AsterMesh

On this page