火豹 AI

Appearance

CC MAX 站点接入文档 ​

本站点为 Claude Code 专用中转站，仅支持通过 Claude Code 命令行工具或 VSCode 官方插件接入，不支持其他客户端（如网页版、SDK 直连、第三方聊天软件等）。

一、支持范围 ​

项目说明
接入客户端Claude Code 命令行工具 / VSCode 官方插件（Claude Code for VS Code）
已知支持版本2.1.140 ~ 2.1.160
接入协议Anthropic Messages API

版本说明

2.1.140 ~ 2.1.159 为已知可正常使用的版本区间。区间外的版本并非一定不支持，但未经验证，可能因请求头或协议差异出现兼容问题。如遇异常，建议优先切换到该区间内的版本。

检查与安装指定版本 ​

bash
# 查看当前版本
claude --version

# 安装已知支持区间内的指定版本（以 2.1.159 为例）
npm install -g @anthropic-ai/claude-code@2.1.159

二、基础信息 ​

接入前请先准备好以下信息（向站点管理员获取）：

名称说明示例
API 地址（Base URL）站点中转地址https://hboom.ai
API 令牌（API Key）站点分配的密钥sk-xxxxxxxxxxxxxxxx

三、NewAPI 接入额外配置 ​

如果本站点基于 NewAPI 搭建，需要在 NewAPI 的渠道设置中额外配置以下两项，以保证 Claude Code 的请求头能被正确透传，避免被识别拦截或协议异常。

1. 参数覆盖（Parameter Override） ​

将以下配置粘贴到渠道的参数覆盖字段中。它的作用是透传（pass_headers）Claude Code 发出的关键请求头，并保留原始值（keep_origin: true）。

json
{
  "operations": [
    {
      "mode": "pass_headers",
      "value": [
        "X-Stainless-Arch",
        "X-Stainless-Lang",
        "X-Stainless-Os",
        "X-Stainless-Package-Version",
        "X-Stainless-Retry-Count",
        "X-Stainless-Runtime",
        "X-Stainless-Runtime-Version",
        "X-Stainless-Timeout",
        "User-Agent",
        "X-App",
        "Anthropic-Beta",
        "Anthropic-Dangerous-Direct-Browser-Access",
        "Anthropic-Version"
      ],
      "keep_origin": true
    }
  ]
}

2. 请求头覆盖（Header Override） ​

将以下配置粘贴到渠道的请求头覆盖字段中。"*": false 表示不覆盖任何请求头，完全使用客户端（Claude Code）发来的原始请求头。

json
{
  "*": false
}

配置要点说明 ​

  • 参数覆盖中列出的请求头是 Claude Code（基于 Stainless SDK）发出的标识与协议头，必须原样透传，否则上游可能因请求头缺失或不一致而拒绝请求。
  • 请求头覆盖设为 {"*": false}，确保 NewAPI 不会用自身默认值替换这些关键头部。
  • 两项配置需同时生效，缺一可能导致请求失败或返回异常。

四、Claude Code 接入方式 ​

通过设置环境变量将 Claude Code 指向本站点。

方式 A：临时设置（当前终端会话有效） ​

powershell
$env:ANTHROPIC_BASE_URL = "https://hboom.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxxxxxxxx"
claude
bat
set ANTHROPIC_BASE_URL=https://hboom.ai
set ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxx
claude
bash
export ANTHROPIC_BASE_URL="https://hboom.ai"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx"
claude

方式 B：持久化设置（推荐） ​

编辑 Claude Code 配置文件 ~/.claude/settings.json（Windows 为 C:\Users\<用户名>\.claude\settings.json），加入：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://hboom.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx"
  }
}

保存后重新启动 Claude Code 即可生效。

说明

ANTHROPIC_AUTH_TOKEN 用于以 Bearer 方式携带令牌；若站点要求使用 ANTHROPIC_API_KEY，请按管理员说明替换。

验证接入 ​

bash
claude
# 进入交互界面后随意发送一条消息，能正常返回即表示接入成功

五、VSCode 官方插件接入方式 ​

VSCode 官方插件（Claude Code for VS Code）与命令行工具共用同一套配置，接入方式如下。

1. 安装插件 ​

在 VS Code 扩展市场搜索 Claude Code（发布者为 Anthropic），安装官方插件。插件依赖本地的 Claude Code，请确保已安装命令行工具且版本在已知支持区间内（见第一节）。

2. 配置站点地址与令牌（二选一） ​

方式 A：复用 settings.json（推荐）

插件会读取与命令行相同的配置文件 ~/.claude/settings.json（Windows 为 C:\Users\<用户名>\.claude\settings.json）。只要按第四节方式 B 配置过 env，插件即可直接复用，无需重复设置：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://hboom.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx"
  }
}

方式 B：通过环境变量启动 VS Code

若希望仅对某个项目生效，可在已设置环境变量的终端中启动 VS Code，插件会继承这些变量：

bash
export ANTHROPIC_BASE_URL="https://hboom.ai"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx"
code .
powershell
$env:ANTHROPIC_BASE_URL = "https://hboom.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxxxxxxxx"
code .

3. 验证接入 ​

打开 VS Code 侧边栏的 Claude Code 面板，发送一条消息，能正常返回即表示接入成功。

说明

插件底层走与命令行相同的 Anthropic Messages API，因此 NewAPI 的渠道配置（见第三节）对插件同样适用，无需额外处理。

六、常见问题（FAQ） ​

Q1：提示版本不支持 / 请求被拒绝？

本站点仅在 2.1.140 ~ 2.1.159 区间内验证过。若你使用的是区间外版本且出现异常，建议先切换到该区间内的版本；同时确认 NewAPI 渠道已正确配置上述两项覆盖。

Q2：能否用网页版、Cherry Studio、SDK 等接入？

不支持。本站点仅面向 Claude Code 命令行工具及 VSCode 官方插件。

Q3：设置了环境变量仍连接官方地址？

检查是否同时存在系统级与配置文件级的环境变量冲突；settings.json 中的 env 优先级较高，建议统一在一处配置。

如接入过程中遇到问题，请联系站点管理员，并提供 claude --version 输出及具体报错信息。

火豹 AI

Copyright © 2024-present