Claude Code 配置

新人入口注册 / 登录 / IP 加白创建 API 令牌

Base URLhttps://superapi.buzz

1. 安装依赖

建议先安装：

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

2. 安装 Claude Code

推荐使用 npm：

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

如果已经安装过，可以更新到最新版：

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

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

启动：

claude

跳过权限询问：

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. 使用环境变量配置（不使用CC Switch时）

如果只是临时验证，可以直接在当前终端里 export。

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

真正长期使用时，不要只在当前终端里临时 export。要把变量写进系统能持续读取的位置。

macOS / Linux：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://superapi.buzz"' >> ~/.zshrc
source ~/.zshrc

如果你用的是 Bash，把 ~/.zshrc 换成 ~/.bashrc。

Windows PowerShell：

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

上面的 $env: 只对当前 PowerShell 窗口有效。想永久生效用下面两种之一：

写进 PowerShell 配置文件（每次开 PowerShell 自动加载）：

Add-Content $PROFILE '$env:ANTHROPIC_AUTH_TOKEN="sk-你的令牌"'
Add-Content $PROFILE '$env:ANTHROPIC_BASE_URL="https://superapi.buzz"'
. $PROFILE

$PROFILE 就是当前用户的 Microsoft.PowerShell_profile.ps1 路径，文件不存在时会自动创建；. $PROFILE 让当前窗口立即生效。

或写成 Windows 用户环境变量（所有程序可见，需重开终端才生效）：

setx ANTHROPIC_AUTH_TOKEN "sk-你的令牌"
setx ANTHROPIC_BASE_URL "https://superapi.buzz"

Linux 上用 systemd 跑服务时，把变量写进 unit 的 [Service] 段，再 systemctl daemon-reload 并重启该服务：

[Service]
Environment="ANTHROPIC_AUTH_TOKEN=sk-你的令牌"
Environment="ANTHROPIC_BASE_URL=https://superapi.buzz"

一行临时启动只适合测试：

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

这种写法关掉终端就失效，不适合长期使用。

5. 在 settings.json 里配置（VS Code / Cursor 插件必用）

Claude Code 的 VS Code 插件、Cursor 插件不会读取上面那些 shell 环境变量（export、~/.bashrc、~/.zshrc、setx 都不管用）。它们只认 settings.json。所以想在编辑器插件里用 SuperAPI，必须把令牌和 Base URL 写进 settings.json 的 env 段。

在终端里直接敲 claude 时，第 4 节的环境变量方式有效；一旦改用 VS Code / Cursor 插件面板，就以 settings.json 为准。

配置文件位置（就近选一个即可，项目级优先于用户级）：

• 用户级（全局生效）：~/.claude/settings.json
  • Windows：C:\Users\你的用户名\.claude\settings.json（即 %USERPROFILE%\.claude\settings.json）
• 项目级（只对当前项目生效）：项目根目录下的 .claude/settings.json

最小配置——只在 env 里填 SuperAPI 的令牌和 Base URL 就能连上：

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

• ANTHROPIC_AUTH_TOKEN：填 SuperAPI 令牌。
• ANTHROPIC_BASE_URL：填 https://superapi.buzz（不带 /v1）。

如果文件里已有其他配置，只把 env 段合并进去，别整段覆盖。

下面是我们自己在用的一份完整示例（已脱敏），可直接参考，但请按自己机器和系统改。env 段两个系统完全一样，区别只在 hooks 里脚本的路径写法：

Linux / macOS

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "ANTHROPIC_BASE_URL": "https://superapi.buzz",
    "CLAUDE_CODE_ENABLE_TASKS": "1",
    "CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION": "1",
    "ENABLE_TOOL_SEARCH": "auto:10"
  },
  "model": "opus[1m]",
  "effortLevel": "xhigh",
  "statusLine": {
    "type": "command",
    "command": "npx -y ccstatusline@latest",
    "padding": 0
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "bash /home/你的用户名/.claude/skills/你的脚本/pre-edit-check.sh",
            "timeout": 5
          }
        ]
      }
    ]
  }
}

Windows

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "ANTHROPIC_BASE_URL": "https://superapi.buzz",
    "CLAUDE_CODE_ENABLE_TASKS": "1",
    "CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION": "1",
    "ENABLE_TOOL_SEARCH": "auto:10"
  },
  "model": "opus[1m]",
  "effortLevel": "xhigh",
  "statusLine": {
    "type": "command",
    "command": "npx -y ccstatusline@latest",
    "padding": 0
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "bash \"C:\\Users\\你的用户名\\.claude\\skills\\你的脚本\\pre-edit-check.sh\"",
            "timeout": 5
          }
        ]
      }
    ]
  }
}

个性化的部分请自己改或删掉

• 必填的只有 env 里的 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL，两个系统写法一致。
• hooks（如上面的 PreToolUse）、statusLine 是个性化配置，示例里的脚本路径只是占位。你没有对应脚本就把整段删掉；有就改成你自己的真实路径——Linux/macOS 用 /home/你的用户名/...（macOS 是 /Users/你的用户名/...），Windows 用 C:\Users\你的用户名\...，别把别的系统的路径直接抄过来，否则每次工具调用会报「找不到脚本」。
• model、effortLevel、其余 CLAUDE_CODE_* 都是可选项，不需要就删。

改完 settings.json 后，完全退出并重开 VS Code / Cursor（不是只 reload 窗口），插件才会重新读取配置。

别把令牌提交进仓库

项目级 .claude/settings.json 会跟着项目走，容易连令牌一起误提交。要入 Git 的项目，建议把令牌放用户级 ~/.claude/settings.json，或写进不入库的 .claude/settings.local.json。

6. 防止跳转官方

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

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

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

常见字段类似：

{
  "hasCompletedOnboarding": true
}

7. fast 与百万上下文

快速配置：

/fast

Claude fast 本质上还是请求层的 fast 状态。常见两种写法：

• 在 Claude Code 里直接输入 /fast
• 在客户端设置里开启 fastMode

Claude 百万上下文默认支持，只要模型支持会自动打开。

在 CLI 里输入图片

把图片复制到剪贴板，然后在输入框按 Alt+V 粘贴——终端的 Ctrl+V 通常粘不了图片，所以用 Alt+V。也可以把图片文件直接拖进终端窗口，或在提示里写出图片的本地路径。

如果是在 IDE 集成终端里连接远程服务器（如 VS Code Remote-SSH），Alt+V 通常贴不了图（剪贴板在本地、终端在远程）；这种情况改用对应的 VS Code 插件贴图。

8. 推理强度和 goal 特性

推理强度

用 /effort 调推理强度，从低到高常用这几档：

• high：高强度推理，日常复杂任务够用。
• xhigh（extra high）：比 high 更深一档；可持久化，也支持 ultracode 工作流。
• max：最高强度、推理最深，但只对当前会话生效、不可持久化，且和 ultracode 工作流不兼容。只适合个别特别吃推理、又不需要多 agent 编排的单次任务。
• ultracode：多 agent 工作流模式——把大任务拆给多个子 agent 并行编排执行（基于 xhigh 推理），适合大型、可拆分的任务。日常的多 agent 协作用它（或 goal）通常就够了，一般不用专门开 teams / 团队模式。

想用 ultracode 就别开 max

ultracode 需要持久的高强度状态，和一次性的 max 不兼容。日常想要又深又能编排，用 xhigh 即可；max 只留给「单次、超吃推理、又不需要工作流」的请求。

goal 特性

Claude Code 默认就具备规划（goal / plan）能力，不用像 Codex 那样额外开启：复杂任务会自动「先规划再执行」；你也可以用 Plan 模式（连按两次 Shift+Tab）手动进入规划，确认方案后再落地。