球球Token球球Token - AI中转服务站

Claude Code

Claude Code 是在终端里使用 Claude 的入口，适合在本地项目中完成代码理解、修改和任务协作。使用 qiuqiutoken 时，优先用 CC Switch 写入配置，需要手动处理时再按下面的步骤操作。

前置条件

  • 只有手动 npm 安装时，才需要提前准备 Node.js 18+ 与 npm。

推荐路径

  1. 优先使用 CC Switch 写入 qiuqiutoken provider、Claude Code 专用分组令牌、Base URL 与模型。
  2. CC Switch 不适用时，再按平台手动安装 Claude Code CLI。
  3. 需要手动处理时，再继续看下面的 settings.json 配置。

安装与配置

先在 快速开始 准备余额和 Claude Code 对应 Base URL，再到 创建 API 令牌 创建 Claude Code 专用分组令牌。

Windows

如果 CC Switch 已经完成配置，直接进入项目目录运行 claude 验证；需要手动处理时再继续下面的流程。

手动安装 Node.js

如果你不用已有环境，可以从 Node.js 官网 下载 LTS 安装包，或在命令提示符 / Terminal 中任选一种包管理器安装。

命令提示符 / Terminal
winget install OpenJS.NodeJS.LTS
choco install nodejs-lts
scoop install nodejs-lts

检查 Node.js 和 npm

打开新的命令提示符 / Terminal，确认 Node.js 与 npm 可用。

命令提示符 / Terminal
node -v
npm -v

手动安装 Claude Code

使用 npm 全局安装 Claude Code 客户端。

命令提示符 / Terminal
npm install -g @anthropic-ai/claude-code

检查 Claude Code

确认命令可用，并检查本机环境。

命令提示符 / Terminal
claude --version
claude doctor

进入项目启动验证

写完配置后，进入你的项目目录启动 Claude Code，并发送一次简单请求验证链路。

命令提示符 / Terminal
cd your-project-folder
claude

手动配置

CC Switch 没有写入配置时，按下面步骤手动补齐。

创建配置目录

  • Windows：%USERPROFILE%\.claude
  • macOS / Linux：~/.claude

先创建并进入对应目录。

命令提示符 / Terminal
mkdir %USERPROFILE%\.claude
cd %USERPROFILE%\.claude

创建 settings.json

按 创建 API 令牌 准备好 Claude Code 专用分组令牌，并从 快速开始 复制 Claude Code 对应 Base URL 后，在配置目录中创建 settings.json。

settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "粘贴为Claude Code专用分组令牌key",
    "ANTHROPIC_BASE_URL": "https://api.qiuqiutoken.com"
  }
}

重新打开终端

关闭所有 Claude Code 相关终端窗口，再打开新的终端，确保新配置被读取。

提示

如果 claude 命令不存在，通常是 npm 全局 bin 目录未加入 PATH，或终端还没重启。先重新打开终端，再用 npm config get prefix 确认全局安装目录，并检查该目录下的 bin 路径是否已加入 PATH。

验证成功

  • 终端能识别 claude 命令，且 claude doctor 不再提示关键安装问题。
  • settings.json 包含 Claude Code 专用分组令牌和 ANTHROPIC_BASE_URL。
  • Claude Code 能在项目目录中启动并完成一次简单请求。
  • qiuqiutoken 控制台出现对应用量记录。

常见问题

  • 终端提示 claude 不存在：确认 npm 全局 bin 目录已加入 PATH，并重新打开终端。
  • claude doctor 仍报错，或 CC Switch 配置后仍失败：先检查是否存在旧的 settings.json、环境变量或其他本地配置覆盖当前设置，再重新运行 claude doctor。
  • 启动后仍连接默认服务：确认 settings.json 中的 ANTHROPIC_BASE_URL 指向 qiuqiutoken，再检查是否有其他本地配置覆盖。
  • 请求认证失败：检查 settings.json，再核对 Base URL 与 Claude Code 专用分组令牌。