客户端示例
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 ~/.zshrcbash:
echo 'export ANTHROPIC_BASE_URL="https://console.astermesh.cn"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-..."' >> ~/.bashrc
source ~/.bashrc3. 启动并验证
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 会多轮请求模型,可以换更快模型,或让它只读取必要文件。