# Claude Code 接入

使用 Anthropic 官方 Claude Code，通过 GFW 的 Anthropic Messages 兼容入口调用模型。

## 接入前准备 [#接入前准备]

Claude Code 是 Anthropic 的终端工具。请先按 [Claude Code 官方文档](https://docs.anthropic.com/en/docs/claude-code/overview)安装并确认本机可以运行 `claude`。你还需要：

- 在 GFW 控制台 **使用 → API 密钥** 创建一个 API Key。
- 选择目录中 `model_type` 为 `llm` 的可用 `model_code`，例如 `qwen3.7-max`。
- 确保账户有足够 元，并理解模型价格、用户组折扣和阶梯规则以实际目录及流水为准。

Claude Code 的自定义地址使用根地址 `https://api.gfw.net`，工具会请求根地址下的 `/v1/messages`。

## 配置环境变量 [#配置环境变量]

Claude Code 官方支持通过环境变量指定凭据和自定义 API 地址。用当前 shell 会话配置：

```bash
export GFW_API_KEY='your-api-key'
export ANTHROPIC_API_KEY="${GFW_API_KEY}"
export ANTHROPIC_BASE_URL="https://api.gfw.net"
```

不要在命令行历史、项目 `.env`、截图或日志中写入真实 Key。更稳妥的做法是使用操作系统的密钥存储或由进程管理器注入环境变量。


**提示**

`ANTHROPIC_BASE_URL` 应为 `https://api.gfw.net`，不要填 `https://api.gfw.net/v1`。Anthropic SDK/Claude Code 会自行拼接 `/v1/messages`。


## 选择 GFW 模型 [#选择-gfw-模型]

通过 Claude Code 的模型设置选择 GFW 目录中的 `model_code`。具体设置入口可能随 Claude Code 版本变化，请以工具自身帮助和官方设置文档为准；核心是让请求携带下面这个模型名称，而不是供应商的上游模型标识：

```text
qwen3.7-max
```

如果工具支持在启动时指定模型，可以使用官方版本对应的 `--model` 选项；如果使用配置文件或会话设置，则填入同一个 `model_code`。不要把示例中的模型名称当成永久可用承诺，先检查[模型库](/models)。

## 验证请求路径 [#验证请求路径]

在让 Claude Code 执行较长任务前，可以用一个最小的 Anthropic 请求验证环境变量和 Key：

```bash
curl -sS https://api.gfw.net/v1/messages \
  -H "x-api-key: ${ANTHROPIC_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.7-max",
    "max_tokens": 128,
    "messages": [{"role": "user", "content": "只回复：连接正常"}]
  }'
```

该命令只验证 GFW Anthropic 入口；响应中的文本、Token 和 ID 是**示意以外的实际接口返回**，不要在自动化脚本中依赖固定内容。若请求成功，再在一个非敏感目录中启动 Claude Code。

## 常见问题 [#常见问题]

- **401 或认证失败**：确认 `ANTHROPIC_API_KEY` 非空，且它是 API Key，不是控制台 JWT；检查 Key 是否启用。
- **404 或模型不存在**：使用 GFW `model_code`，例如 `qwen3.7-max`，不要使用供应商内部 ID。
- **路径重复 `/v1/v1/messages`**：把 `ANTHROPIC_BASE_URL` 改为 `https://api.gfw.net`，不要带 `/v1`。
- **模型类型错误**：Claude Code 需要对话模型；图片、视频模型应使用各自的模型接口。
- **余额/限额错误**：在控制台的 **财务**、**用量**、**调用日志** 和 API Key 状态页交叉核对。

## 相关链接 [#相关链接]

- [Anthropic 官方 Claude Code 身份认证](https://docs.anthropic.com/en/docs/claude-code/iam)
- [Anthropic 官方设置说明](https://docs.anthropic.com/en/docs/claude-code/settings)
- [认证](/docs/authentication)
- [模型](/models)
- [调用日志](/docs/usage-logs)