外观
Claude Code 配置
Claude Code 应通过本站的 Anthropic Messages 兼容接口接入。本站示例统一采用 Bearer 认证,设置 ANTHROPIC_AUTH_TOKEN。ANTHROPIC_API_KEY 使用 x-api-key 请求头;网关在 Messages 路由也兼容该方式,但配置时应选定一种认证来源,避免两种变量同时设置。
模型范围
Anthropic 官方支持 Claude Code 通过兼容网关调用 Claude 模型,不支持把任意非 Claude 模型伪装为 Claude。模型出现在本站 /v1/models 中,不代表它一定适合 Claude Code。
协议参考
本页保留 Claude Code 的配置方法。当前对外模型目录不列 Claude 模型,不把 GPT 模型替换进 Messages 配置;接入前先确认模型目录实际提供匹配模型。
1. 设置环境变量
推荐先按用户环境变量配置保存 FQHX_API_KEY,再从新终端读取并设置客户端变量:
powershell
$env:FQHX_API_KEY = [Environment]::GetEnvironmentVariable("FQHX_API_KEY", "User")
$env:ANTHROPIC_BASE_URL = "https://newapi.fq-hx.com"
$env:ANTHROPIC_AUTH_TOKEN = $env:FQHX_API_KEY
$env:ANTHROPIC_MODEL = "YOUR_CLAUDE_MODEL"bash
export FQHX_API_KEY="sk-替换为你的令牌"
export ANTHROPIC_BASE_URL="https://newapi.fq-hx.com"
export ANTHROPIC_AUTH_TOKEN="$FQHX_API_KEY"
export ANTHROPIC_MODEL="YOUR_CLAUDE_MODEL"ANTHROPIC_BASE_URL 不要追加 /v1,Claude Code 会请求 ${ANTHROPIC_BASE_URL}/v1/messages。
如果网关没有提供 Claude Code 内置的默认 Opus、Sonnet、Haiku 名称,可按实际可用模型设置映射:
powershell
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = $env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = $env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = $env:ANTHROPIC_MODELbash
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"这里将三类请求都路由到同一模型,不表示本站提供 Haiku 模型。
2. 启动与使用
保存配置后,从同一终端启动:
text
claude基础接口排查统一查看首页 HTTP 验证模块。当前对外目录未提供 Claude 模型,首页不把 GPT 请求套入 Messages;本页仅保留兼容配置参考。
在 Claude Code 中运行 /status,确认 Anthropic base URL 为本站地址,认证来源为 ANTHROPIC_AUTH_TOKEN。
3. 可选的持久配置
用户配置文件:%USERPROFILE%\.claude\settings.json。
用户配置文件:~/.claude/settings.json。
可在配置文件的 env 保存变量,但这会把令牌以明文写入本机文件。更推荐通过 shell、密码管理器或凭据辅助程序注入。
json
{
"env": {
"ANTHROPIC_BASE_URL": "https://newapi.fq-hx.com",
"ANTHROPIC_AUTH_TOKEN": "sk-替换为你的令牌",
"ANTHROPIC_MODEL": "YOUR_CLAUDE_MODEL"
}
}常见问题
遇到问题时展开
| 现象 | 优先检查 |
|---|---|
返回 401 | 是否使用 ANTHROPIC_AUTH_TOKEN,令牌是否有效 |
| 请求路径错误 | ANTHROPIC_BASE_URL 是否误加 /v1 |
| 找不到模型 | ANTHROPIC_MODEL 是否为当前可调用的 Claude 兼容模型 |
| 对话正常但工具失败 | 模型、网关和渠道是否兼容 Claude Code 的工具调用 |