注册账号

充值

添加令牌

前置条件

Claude Code 需要 Node.js 18+ 环境。检查是否已安装：

node -v

安装 Node.js

安装 Claude Code

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

配置环境变量

手动配置方式：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.qianqiu.wiki/",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌"
  }
}

系统要求

• macOS 10.15 (Catalina) 或更高版本
• Node.js 18+

安装步骤

1. 安装 Node.js

如已安装可跳过此步骤。使用 Homebrew 安装：

brew install node

2. 安装 Claude Code

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

3. 配置环境变量

Zsh 用户（macOS 默认）：

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

Bash 用户：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://www.qianqiu.wiki/"' >> ~/.bash_profile
source ~/.bash_profile

系统要求

• Ubuntu 18.04+、CentOS 7+、Debian 9+ 等主流发行版
• Node.js 18+

安装步骤

1. 安装 Node.js (Ubuntu/Debian)

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

2. 安装 Claude Code

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

3. 配置环境变量

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://www.qianqiu.wiki/"' >> ~/.bashrc
source ~/.bashrc

功能特点

• 一键切换 API 配置，在多个提供商之间快速切换
• 可视化配置管理，通过图形界面轻松管理
• MCP 服务器管理
• 系统托盘快捷操作

下载安装

访问 CC-Switch 下载页面，Windows 用户推荐下载 .msi 安装包。

配置 API

安装扩展

启动方式

常用命令

基础命令

会话管理

高级选项

安装

npm install -g @openai/codex

配置

export OPENAI_API_KEY="sk-你的令牌"
export OPENAI_BASE_URL="https://www.qianqiu.wiki/v1"

安装

npm install -g @google/gemini-cli

配置

export GEMINI_API_KEY="sk-你的令牌"
export GEMINI_BASE_URL="https://www.qianqiu.wiki/"

无法连接到服务

如果出现连接错误：

解决方案（Windows）

powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"

令牌无效或余额不足

• 检查令牌是否正确复制（包含 sk- 前缀）
• 登录平台检查账户余额
• 确认令牌分组是否支持你使用的模型

响应速度慢

• 检查网络连接是否稳定
• 尝试切换到速度更快的模型（如 Gemini Flash）
• 减少单次请求的上下文长度

常用模型推荐

分组说明

• Claude Max 号池：由 Claude Max 账号组成，稳定性高
• Codex 分组：支持 OpenAI 系模型
• Gemini 分组：支持 Google 系模型
• AWS Bedrock 分组：使用 AWS 官方服务，响应快

什么是缓存？

缓存是一种优化机制：

• 首次请求：发送内容时会创建缓存（有额外费用）
• 命中缓存：后续相似请求从缓存读取，价格极低
• 缓存时长：5 分钟适合频繁切换，1 小时适合专注同一项目

什么是上下文？

上下文是模型能处理的内容长度：

• 默认上下文：200K-256K tokens
• 特价分组：上下文可能更短
• 1M 上下文：适合处理超长内容