Skip to content

Claude Code 配置

1. 安装依赖

建议先安装:

  • Node.js 18+,推荐 Node.js 22 LTS 或更高稳定版。
  • Git。
  • 可选:CC Switch,用于管理不同中转配置。

2. 安装 Claude Code

推荐使用 npm:

bash
npm install -g @anthropic-ai/claude-code

如果已经安装过,可以更新到最新版:

bash
npm install -g @anthropic-ai/claude-code@latest
claude --version

如果 npm 安装失败,先看 网络与代理,确认命令行能访问 npm 源。

启动:

bash
claude

跳过权限询问:

bash
claude --dangerously-skip-permissions

3. 推荐使用 CC Switch

打开 CC Switch,新建配置:

  • Token:填写 SuperAPI 令牌。
  • Base URL:填写 https://superapi.buzz
  • 保存后切换配置。
  • 重启 Claude Code。

这类图形化配置适合长期使用。多个中转或多个令牌之间切换时,不建议反复手改环境变量。

如果要配置 fast 或百万上下文,先看 fast 与百万上下文。当前 fast 不再要求单独 fast 分组;Claude Code 里用 /fast,GPT / Codex 侧对应 service_tier

4. 使用环境变量配置

macOS / Linux:

bash
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
export ANTHROPIC_BASE_URL="https://superapi.buzz"
claude

一行临时启动:

bash
ANTHROPIC_AUTH_TOKEN="sk-你的令牌" ANTHROPIC_BASE_URL="https://superapi.buzz" claude

Windows PowerShell:

powershell
$env:ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
$env:ANTHROPIC_BASE_URL="https://superapi.buzz"
claude

5. 防止跳转官方

如果 Claude Code 没走中转,通常是配置未生效。可以检查:

  • CC Switch 当前配置是否启用。
  • 环境变量是否在启动 Claude Code 的同一个终端里设置。
  • ANTHROPIC_BASE_URL 是否为 https://superapi.buzz

必要时检查用户目录下的 .claude.json,确保已经完成 onboarding 状态。

常见字段类似:

json
{
  "hasCompletedOnboarding": true
}

6. 推荐配置文件思路

如果你习惯把环境变量写入 Claude Code 配置,重点是把 SuperAPI 地址和令牌写对:

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "ANTHROPIC_BASE_URL": "https://superapi.buzz",
    "DISABLE_TELEMETRY": "1",
    "DISABLE_COST_WARNINGS": "1"
  }
}

不要把令牌提交到 Git 仓库。共享截图、日志、配置文件前先打码。

7. 启动建议

正常启动:

bash
claude

可信目录下跳过权限确认:

bash
claude --dangerously-skip-permissions

生产机器慎用

跳过权限确认会让模型更容易直接执行命令。线上服务器、有密钥的目录、数据库机器上不要随便开启。

8. fast 与百万上下文

快速配置:

text
/fast

Claude 百万上下文优先选择原生支持的模型。旧 beta 路径才需要:

bash
export ANTHROPIC_BETAS="context-1m-2025-08-07"

截至 2026-05-07,Claude 4.6 系列的 1M 上下文通常不需要这个 beta。CC Switch 或环境变量里已经填过时,遇到 beta 相关报错应先删除。

GPT 百万上下文超过 272k 的部分会额外计费。详细说明见 fast 与百万上下文

SuperAPI 文档仅用于帮助用户正确配置客户端。