Claude Code 接入

接入前准备复制章节链接

Claude Code 是 Anthropic 的终端工具。请先按 Claude Code 官方文档安装并确认本机可以运行 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 会话配置：

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

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

选择 GFW 模型复制章节链接

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

qwen3.7-max

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

验证请求路径复制章节链接

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

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 身份认证
• Anthropic 官方设置说明
• 认证
• 模型
• 调用日志