Skip to content
On this page

接入 Claude Code

Claude Code 使用 Anthropic Messages 兼容接口。配置时使用站点根地址,不要在 ANTHROPIC_BASE_URL 后添加 /v1

text
https://api.aethesauce.space

1. 安装 Claude Code

bash
npm install -g @anthropic-ai/claude-code

2. 临时配置

先在当前终端设置地址和密钥,用于快速验证。

Windows PowerShell

powershell
$env:ANTHROPIC_BASE_URL = "https://api.aethesauce.space"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
claude

macOS / Linux

bash
export ANTHROPIC_BASE_URL="https://api.aethesauce.space"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
claude

3. 写入 Claude Code 配置

确认临时配置可用后,可以在 Claude Code 的用户配置文件 ~/.claude/settings.json 中保存环境变量。Windows 中 ~ 对应当前用户目录。

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aethesauce.space",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  }
}

保护密钥

settings.json 包含明文密钥。不要将其提交到 Git、同步到公开网盘或发给他人。团队环境建议通过系统环境变量或密钥管理服务注入。

4. 选择模型与分组

可用模型名以控制台实时列表为准。Claude 相关分组:

  • Claude Kiro Pro(0.4x):全部模型,支持官方缓存,适合 Claude Code 日常开发。
  • Claude max 官转(1.5x):满血官方转换通道,非 Kiro,适合更看重通道品质的任务。

若需要指定模型,请使用控制台展示的准确模型 ID,不要根据宣传名称自行拼接。

5. 验证缓存与用量

执行一段包含上下文的连续对话后,在极智网关控制台查看请求记录和消耗。是否命中缓存应以服务端记录为准,客户端的响应速度只能作为参考。

常见问题

返回 404

优先检查 ANTHROPIC_BASE_URL。这里应填写 https://api.aethesauce.space,不要写成 https://api.aethesauce.space/v1

Claude Code 仍要求官方登录

确认启动 claude 的同一个终端中已经设置 ANTHROPIC_AUTH_TOKEN。如果使用配置文件,请检查 JSON 格式是否有效并重启终端。

极智网关 · AI API Gateway