注册账号

充值

添加令牌

前置条件

Claude Code 需要以下环境，请逐项检查：

安装 Git

Git 是 Claude Code 的必要依赖，用于分析项目历史、执行代码提交等操作。

git -v

安装 Node.js

方式一：官网下载安装包

node -v

方式二：使用 fnm 安装 推荐

fnm (Fast Node Manager) 是一个快速的 Node.js 版本管理器，支持轻松安装和切换多个 Node.js 版本。

fnm install --lts
node -v

安装 Claude Code

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

系统要求

• macOS 10.15 (Catalina) 或更高版本
• Git（macOS 通常已预装，终端运行 git -v 检查）
• Node.js 18+

安装步骤

1. 安装 Node.js

如已安装可跳过此步骤。

方式一：官网下载安装包

访问 Node.js 官网 下载 macOS 安装包，完成安装后在终端运行 node -v 验证。

方式二：使用 fnm 安装 推荐

fnm (Fast Node Manager) 是一个快速的 Node.js 版本管理器，方便切换和管理多个版本。

# 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash

# 安装最新 LTS 版本
fnm install --lts
node -v

方式三：使用 Homebrew

brew install node

2. 安装 Claude Code

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

补充：如果安装报错 error，使用管理员权限安装

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

再输入开机密码，回车，开始安装

3. 终端输入claude打开

系统要求

• Ubuntu 18.04+、CentOS 7+、Debian 9+ 等主流发行版
• Git 2.23+（运行 git -v 检查）
• Node.js 18+

安装步骤

0. 安装 Git（如未安装）

# Ubuntu / Debian
sudo apt-get update && sudo apt-get install -y git

# CentOS / RHEL
sudo yum install -y git

1. 安装 Node.js

方式一：官网下载安装包

访问 Node.js 官网 下载 Linux 安装包或二进制文件，完成安装后运行 node -v 验证。

方式二：使用 fnm 安装 推荐

fnm (Fast Node Manager) 无需 sudo，不污染系统环境。

# 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash

# 重新加载 shell 配置
source ~/.bashrc

# 安装最新 LTS 版本
fnm install --lts
node -v

方式三：使用 NodeSource（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. 终端输入claude打开

Windows 环境配置

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

macOS 环境配置

Zsh 用户（macOS 默认）：

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

Bash 用户：

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

Linux 环境配置

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

功能特点

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

下载安装

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

配置 API

安装扩展

启动方式

常用命令

基础命令

会话管理

高级选项

前置条件

• Node.js 18+（安装方式参考 安装教程）
• Git 2.23+

安装

npm install -g @openai/codex

配置

macOS / Linux

export OPENAI_API_KEY="sk-你的令牌"
export OPENAI_BASE_URL="https://tokenfree.fun/v1"

Windows (PowerShell)

$env:OPENAI_API_KEY="sk-你的令牌"
$env:OPENAI_BASE_URL="https://tokenfree.fun/v1"

配置步骤

前置条件

• Node.js 18+（安装方式参考 安装教程）

安装

npm install -g @google/gemini-cli

配置

macOS / Linux

export GEMINI_API_KEY="sk-你的令牌"
export GEMINI_BASE_URL="https://tokenfree.fun"

Windows (PowerShell)

$env:GEMINI_API_KEY="sk-你的令牌"
$env:GEMINI_BASE_URL="https://tokenfree.fun"

配置步骤

Windows 安装

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

# 方法1：用 pip 安装 uv
pip install uv

# 方法2：如果没有 pip，用 winget 安装
winget install astral-sh.uv

# 方法3：如果以上都不行，用 GitHub 镜像下载
Invoke-WebRequest -Uri "https://ghfast.top/https://github.com/astral-sh/uv/releases/latest/download/uv-x86_64-pc-windows-msvc.zip" -OutFile "$env:TEMP\uv.zip"
Expand-Archive "$env:TEMP\uv.zip" -DestinationPath "$env:LOCALAPPDATA\uv" -Force
$env:Path = "$env:LOCALAPPDATA\uv;" + $env:Path
uv --version

macOS 和 Linux 安装

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

等待安装完成

配置步骤

无法连接到服务

如果出现连接错误：

解决方案（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 Code 的配置文件中添加以下环境变量，以获得更稳定的使用体验：

打开配置文件 settings.json（位于 ~/.claude/settings.json，Windows 路径为 %userprofile%\.claude\settings.json），在 env 中添加：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://tokenfree.fun",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

常用模型推荐

分组说明

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

什么是缓存？

缓存是一种优化机制：

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

什么是上下文？

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

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