集成

Claude Code

将 Claude Code CLI 通过环境变量接入平台，无需登录 Anthropic 账号，即可使用统一的 API Key 管理计费与调用。

为什么通过平台使用 Claude Code？

稳定访问

国内直连，无需额外网络配置，请求不中断。

统一计费

与其他模型调用共用同一个 API Key，在控制台集中管理用量与余额。

多模型支持

除 Claude 全系外，还可在 Claude Code 中调用 GPT、Gemini 等模型。

快速开始

安装 Claude Code

Claude Code 支持 macOS / Linux / WSL 和 Windows PowerShell。

curl -fsSL https://claude.ai/install.sh | bash

配置环境变量

将以下三行写入 Shell 配置文件（~/.zshrc、~/.bashrc 或 ~/.config/fish/config.fish）。

~/.zshrc

export HYPERSHUB_API_KEY="hy-..."        # 替换为你的平台 API Key
export ANTHROPIC_BASE_URL="https://apiclaw.cc"
export ANTHROPIC_AUTH_TOKEN="$HYPERSHUB_API_KEY"
export ANTHROPIC_API_KEY=""                  # 必须显式置空，避免冲突

注意：不要把这些变量写进项目目录下的 .env 文件——Claude Code CLI 默认不读取该文件。修改后执行 source ~/.zshrc（或重启终端）使配置生效。

曾登录过 Anthropic？在 Claude Code 会话中执行 /logout 清除缓存凭证，再重启终端，确保新配置生效。

启动会话

终端

cd /path/to/your/project
claude

验证连接

在 Claude Code 会话中运行 /status，确认 Anthropic base URL 显示为平台地址：

Claude Code 会话

> /status
Auth token:        ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://apiclaw.cc

同时可以在控制台的用量记录中看到本次请求，确认计费正常。

配置模型

Claude Code 为不同任务类型（主模型、子 Agent、快速补全）提供独立的模型环境变量。可按需覆盖：

~/.zshrc（可选）

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-7"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-opus-4-7"

环境变量	作用
ANTHROPIC_DEFAULT_OPUS_MODEL	高复杂度推理任务（默认使用 Opus 级别模型）
ANTHROPIC_DEFAULT_SONNET_MODEL	通用编码任务（默认使用 Sonnet 级别模型）
ANTHROPIC_DEFAULT_HAIKU_MODEL	快速补全任务（默认使用 Haiku 级别模型）
CLAUDE_CODE_SUBAGENT_MODEL	子 Agent 调用所用模型

Claude Code 针对 Anthropic 模型优化，使用其他供应商模型时可能出现兼容性问题。

GitHub Action

在官方 claude-code-action 中接入平台只需两步：将 API Key 存为 GitHub Secret，并覆盖 ANTHROPIC_BASE_URL。

.github/workflows/claude.yml

- name: Run Claude Code
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.HYPERSHUB_API_KEY }}
  env:
    ANTHROPIC_BASE_URL: https://apiclaw.cc

常见问题

认证失败 / Auth Error

确认 ANTHROPIC_API_KEY 已显式设为空字符串（""）。若未设置（null），Claude Code 会尝试向 Anthropic 服务器认证而非走平台。

配置不生效

检查变量是否写入 Shell 配置文件并已执行 source，或重启终端。不要写进项目 .env 文件。

Context Length 超限

将任务拆分为更小的片段，或在 Claude Code 中开启新会话。