开发者指南 · API 接入与选购

# Claude Code 中转配置：连接星火AI 网关

配置 Claude Code 的 ANTHROPIC_BASE_URL 与本站 API Key，区分命令行和编辑器环境，检查模型权限与连接状态。

星火AI 智能网关 · 更新于 2026-10-09

本文面向需要将 Claude Code 命令行接入星火网关的用户。本站提供 Messages 兼容入口；能否使用某个模型以及工具能力，仍取决于当前密钥分组、模型和客户端版本。请先查看[可用模型](https://ai.wfpromax.xyz/available-channels)，不要把接口兼容理解为官方服务背书或所有功能保证。

## 第一步：准备本站密钥

在本站注册、登录并创建 API Key，确认分组与余额。这里使用的是本站签发的密钥，ChatGPT 或 Claude 网页订阅并不等于本站 API 额度。不要填写网页登录 Cookie。

## 第二步：先在当前终端配置

macOS 或 Linux 的 Bash/Zsh 可使用以下配置。Claude Code 的 Base URL 填站点根地址，不带 `/v1/messages`，客户端会追加接口路径。

```
export ANTHROPIC_BASE_URL='https://ai.wfpromax.xyz'
export ANTHROPIC_AUTH_TOKEN='替换为本站API密钥'
claude --model '替换为当前分组支持的模型ID'
```

Windows PowerShell 使用以下形式：

```
$env:ANTHROPIC_BASE_URL = "https://ai.wfpromax.xyz"
$env:ANTHROPIC_AUTH_TOKEN = "替换为本站API密钥"
claude --model "替换为当前分组支持的模型ID"
```

## 第三步：核对真正使用的配置

启动后运行 `/status`，核对网关地址和认证来源。发送一个简短问题，再到本站用量页确认请求记录；一次成功仅说明该次请求可用。涉及工具调用或长上下文时，继续用自己的实际工作流验证。

## 终端能用，编辑器却不能用

从桌面启动的编辑器不一定继承终端变量。先检查编辑器扩展的配置与启动方式。需要持久化时，可在个人 `~/.claude/settings.json` 的 `env` 中合并下列字段；保留文件中其他已有设置，不要覆盖整个文件。

```
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.wfpromax.xyz",
    "ANTHROPIC_AUTH_TOKEN": "替换为本站API密钥"
  }
}
```

个人配置中的真实密钥不要上传到公开仓库。模型不存在时，核对分组和准确模型名；401 时核对认证来源；限流和暂不可用见[排错教程](https://ai.wfpromax.xyz/guides/api-errors.html)。

## 官方配置依据

变量和认证头的对应关系参见 [Claude Code 官方网关接入文档](https://code.claude.com/docs/en/llm-gateway-connect)。本站为独立第三方网关，与 Anthropic 不存在本文所声称的官方合作关系。

## 选好模型，把想法接入应用

查看当前模型与账户价格，注册并选择适合的额度，再按指南完成接入。

 [查看模型与价格](https://ai.wfpromax.xyz/available-channels?entry=guide_claude-code) [购买 API 额度](https://ai.wfpromax.xyz/purchase?entry=guide_claude-code) [注册账户 →](https://ai.wfpromax.xyz/register?entry=guide_claude-code)

## 继续阅读

[AI API Token 计费说明：输入、输出与缓存](https://ai.wfpromax.xyz/guides/token-billing.html)[星火AI 智能网关是什么：服务、接入方式与适用范围](https://ai.wfpromax.xyz/guides/service.html)[API 中转报错排查：401、403、404、429 与 503](https://ai.wfpromax.xyz/guides/api-errors.html)[OpenAI 兼容 API 接入教程：Base URL、密钥与模型](https://ai.wfpromax.xyz/guides/openai-compatible-api.html)[AI API 购买与充值指南：模型、价格、额度和兑换码](https://ai.wfpromax.xyz/guides/buying-guide.html)[GPT、Claude、Gemini、Kimi API 怎么选：按任务与成本选模型](https://ai.wfpromax.xyz/guides/model-selection.html)[ChatGPT／Claude 网页会员与 API 额度有什么区别？](https://ai.wfpromax.xyz/guides/api-vs-subscription.html)

<!-- public-api-endpoints:start -->

## API 接入地址 / API endpoints

- 默认 / Default — `https://ai.wfpromax.xyz`
- 8xh.pro — `https://8xh.pro`

- OpenAI-compatible Base URL — `https://ai.wfpromax.xyz/v1`
- Claude Code Base URL — `https://ai.wfpromax.xyz`

<!-- public-api-endpoints:end -->