注册账号

充值

添加令牌

前置条件

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

node -v

安装 Node.js

安装 Claude代码

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

配置环境变量

手动配置方式：

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

系统要求

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

安装步骤

1. 安装 Node.js

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

brew install node

2. 安装 Claude代码

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

3. 配置环境变量

Zsh 用户（macOS 默认）：

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

Bash 用户：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://www.juziapi.top"' >> ~/.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代码

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

3. 配置环境变量

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://www.juziapi.top"' >> ~/.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.juziapi.top/v1"

安装

npm install -g @google/gemini-cli

配置

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

首次启动失败

如果你第一次执行 claude 就遇到连接失败，而正式的中转地址明明已经准备好，优先看首次启动探测是否绕过了现有配置。

"hasCompletedOnboarding": true

400 参数冲突

如果日志里出现 invalid beta flag 或 invalid_request_error，而且换问题也一样报错，这类 400 通常不是提问内容违规，而是实验参数与上游不兼容。

$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = "1"
claude

连接错误

如果提示就是 Connection error，优先查链路和代理模式。网页能打开，不代表 CLI 也一定能走系统代理。

• 先用 ping 检查基础连通性。
• 确认代理是否开启了系统代理或 TUN，而不只是浏览器代理。
• 换网络或换节点后，重新打开终端再验证。

请求超时

这类问题要分两类看：如果新会话也慢，偏向网络；如果只有旧会话慢，偏向上下文太重。

• 网络型超时：换网络、换代理、换节点。
• 上下文型超时：新开会话、压缩上下文、拆任务。

无法连接到服务

如果出现连接错误：

解决方案（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）
• 减少单次请求的上下文长度

npm 无法加载文件，系统禁止运行脚本

在 PowerShell 中执行 npm install 时，如果出现以下错误提示：

这是因为 Windows 默认的 PowerShell 执行策略禁止运行脚本文件。

解决方案

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

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

常用模型推荐

分组说明

• A-纯血官转-Claude / A-纯血官转-Claude-2：Claude代码 优先使用的两组，主组波动时再切备用组
• codex 1 / codex 2：Codex CLI 优先使用的两组，按当前可用性选择其一
• codex 1：如果你在 Claude代码 里调用 OAI 系模型，优先走这一组
• Gemini-直连 / 其他模型：Gemini CLI 优先用直连，其他情况再看“其他模型”

什么是缓存？

缓存是一种优化机制：

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

什么是上下文？

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

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