AnyStarX Wiki

使用 Anthropic Messages 兼容接口接入 Claude Code 以及需要 Claude 原生协议的各类客户端。

AnyStarX 提供兼容 Anthropic Messages 规范的 API 接口。如果客户端支持通用的 OpenAI 兼容协议，建议优先使用 https://console.anystarx.com/v1 端点；如果客户端（如 Claude Code）强制要求使用 Anthropic 原生通信协议，则应当接入 Messages 接口。

接口地址与协议规范

直接请求完整接口时的 Endpoint 如下：

POST https://console.anystarx.com/v1/messages

在配置各类原生客户端时，工具通常要求填入基础根地址，此时应当填入：

https://console.anystarx.com

客户端在发起调用时会自动追加 /v1/messages 路径。

命令行调用示例

调用 Messages 接口时，需要在请求头中指定 x-api-key 以及 anthropic-version 版本号：

curl https://console.anystarx.com/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "请简要说明大语言模型在软件测试用例生成中的典型应用。"
      }
    ]
  }'

如果特定客户端封装仅支持标准的 Authorization: Bearer YOUR_API_KEY 请求头格式，接口同样支持以此方式完成身份认证。

Claude Code 环境变量配置

在本地终端中使用 Claude Code 时，推荐通过配置环境变量指定代理端点与鉴权凭据：

export ANTHROPIC_BASE_URL="https://console.anystarx.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

部分衍生包装工具或扩展可能会优先读取 ANTHROPIC_API_KEY，在环境排查时可以一并进行设置：

export ANTHROPIC_API_KEY="YOUR_API_KEY"

常见接入问题

客户端基础地址中避免追加具体路由

使用 Claude Code 等工具时，基础地址只需配置为根域名 https://console.anystarx.com。如果错误地填入了完整接口地址 https://console.anystarx.com/v1/messages，客户端内部发起请求时会在此基础上再次追加路径，拼装成如下的无效地址并导致 404 错误：

https://console.anystarx.com/v1/messages/v1/messages

模型标识符选择与填写

在配置请求参数中的 model 字段时，应当登录 AnyStarX 控制台，在模型列表中查阅并复制当前开放的 Claude 完整模型 ID。根据路由策略的不同，模型 ID 可能保留原生名称（如 claude-sonnet-4-5），也可能带有提供商前缀（如 anthropic/claude-sonnet-4-5），请以控制台列表中的精确字符串为准。