CC-Switch 接入 Claude Code 指南

CC-Switch 是一个 AI 中转代理工具，配合「六哥API」中转站，让你在 Claude Code 中以统一接口使用多种 AI 模型。国内网络直连，无需代理。

目录

• 1. 前置准备
• 2. 注册六哥API并获取API Key
• 3. 下载 CC-Switch
• 4. 安装与启动 CC-Switch
• 5. 在 CC-Switch 中配置中转站
• 6. 安装 Claude Code
• 7. 启动 Claude Code 并验证连接
• 8. 常见问题

1. 前置准备

在开始之前，请确认以下事项：

• 操作系统：Windows 10+ / macOS 12+ / Linux (x86_64 / arm64)
• 网络：能够正常访问 GitHub 及 i.crisxie.top（国内网络直连，无需代理）
• 磁盘空间：至少 100MB 可用空间

2. 注册六哥API并获取API Key

在使用 CC-Switch 之前，你需要先注册六哥API账号并获取 API Key。

2.1 注册账号

打开浏览器，访问：

复制codehttps://i.crisxie.top

点击页面上的「注册」按钮，填写信息完成注册。

2.2 获取 API Key

注册并登录后，访问 Token 管理页面：

复制codehttps://i.crisxie.top/console/token

在页面中创建一个新的 API Key，并将其复制保存好，后续配置需要使用。

3. 下载 CC-Switch

3.1 访问下载页面

打开浏览器，访问：

复制codehttps://github.com/farion1231/cc-switch/releases

3.2 选择对应版本

当前最新版本为 v3.15.0（文件名中的版本号可能随更新变化，请以页面显示为准）。根据你的操作系统选择对应文件：

Windows：

macOS：

Linux：

提示：.sig 文件为签名校验文件，普通用户无需下载。

3.3 下载并验证（可选）

点击对应文件即可下载。如需验证文件完整性，可在下载后使用 SHA256 校验：

复制bash# Windows (PowerShell)
Get-FileHash .\CC-Switch-v3.15.0-Windows-Portable.zip -Algorithm SHA256

# macOS / Linux
shasum -a 256 CC-Switch-v3.15.0-macOS.dmg

将输出的哈希值与 Releases 页面标注的 sha256 值对比，一致即表示文件完整。

4. 安装与启动 CC-Switch

4.1 Windows 安装

便携版（推荐）：

1. 解压 CC-Switch-v3.15.0-Windows-Portable.zip
2. 进入解压后的文件夹
3. 双击 CC-Switch.exe 启动

安装版：

1. 双击 CC-Switch-v3.15.0-Windows.msi
2. 按安装向导完成安装
3. 从开始菜单或桌面快捷方式启动

4.2 macOS 安装

DMG 安装包（推荐）：

1. 双击 CC-Switch-v3.15.0-macOS.dmg 挂载
2. 将 CC-Switch 拖入 Applications 文件夹
3. 从启动台或应用程序文件夹打开

ZIP / tar.gz：

1. 解压压缩包
2. 将解压出的 CC-Switch.app 拖入 Applications 文件夹
3. 首次打开时，如提示「无法验证开发者」，前往 系统设置 → 隐私与安全性 点击「仍要打开」

4.3 Linux 安装

AppImage（推荐）：

复制bashchmod +x CC-Switch-v3.15.0-Linux-x86_64.AppImage
./CC-Switch-v3.15.0-Linux-x86_64.AppImage

Debian / Ubuntu（.deb）：

复制bashsudo dpkg -i CC-Switch-v3.15.0-Linux-x86_64.deb

Fedora / RHEL（.rpm）：

复制bashsudo rpm -ivh CC-Switch-v3.15.0-Linux-x86_64.rpm

4.4 启动后的界面

启动成功后，你将看到 CC-Switch 的主界面。

5. 在 CC-Switch 中配置中转站

5.1 添加供应商

1. 在 CC-Switch 主界面，点击右上角的「+」按钮
2. 在弹出的选项中，选择「自定义供应商」

5.2 填写供应商信息

在弹出的表单中填写以下内容：

5.3 确认并启用

1. 向下滑动，点击「确认」按钮
2. 系统会自动返回主页面
3. 在主页面找到「六哥API」，点击其右侧的「启动」按钮

启动成功后，六哥API 旁边的状态指示灯会变为绿色，表示代理已就绪。

6. 安装 Claude Code

CC-Switch 配置完成后，接下来安装 Claude Code。

提示：CC-Switch 启动后会自动接管本地代理，Claude Code 无需额外配置环境变量，安装后直接使用即可。国内网络直连 i.crisxie.top，无需代理。

6.1 安装 Claude Code CLI（命令行版本）

Claude Code CLI 是 Anthropic 官方提供的命令行工具。

方式一：npm 全局安装（推荐，全平台通用）

复制bashnpm install -g @anthropic-ai/claude-code

需要先安装 Node.js（推荐 v18+），前往 https://nodejs.org 下载安装。

方式二：直接下载二进制文件

访问 Anthropic 官方下载页面：

复制codehttps://claude.ai/download

选择对应操作系统的安装包下载安装。

6.2 安装 VS Code 扩展（可选）

如果你更习惯在 VS Code 中使用 Claude Code：

1. 打开 VS Code
2. 点击左侧扩展图标（或按 Ctrl+Shift+X）
3. 搜索 Claude Code
4. 点击「安装」

7. 启动 Claude Code 并验证连接

7.1 启动 Claude Code

在终端中运行：

复制bashclaude

首次启动可能需要登录或进行初始设置，按提示操作即可。

7.2 发送测试消息

在 Claude Code 中输入：

"你好，请确认我们之间的连接正常工作。"

如果收到正常回复，说明 CC-Switch → 六哥API 整条链路已打通。

8. 常见问题

Q1：启动 CC-Switch 后，六哥API 状态灯不亮

排查步骤：

1. 确认 API Key 填写正确（无多余空格）
2. 确认网络能正常访问 i.crisxie.top
3. 重启 CC-Switch 后再试

Q2：Claude Code 命令无法识别（command not found）

解决：

• 确认 Node.js 和 npm 已正确安装：node -v、npm -v
• 确认 @anthropic-ai/claude-code 已全局安装：npm list -g @anthropic-ai/claude-code
• 检查 npm 全局安装路径是否在 PATH 环境变量中

Q3：Claude Code 连接超时 / 无响应

排查步骤：

1. 确认 CC-Switch 已启动且六哥API 状态为绿色
2. 确认网络可以正常访问 i.crisxie.top
3. 确认端口 8080 未被其他程序占用

Q4：CC-Switch 版本更新

1. 前往 https://github.com/farion1231/cc-switch/releases 查看最新版本
2. 下载新版本安装包
3. 关闭正在运行的 CC-Switch
4. 安装新版本（覆盖安装即可，配置会自动保留）
5. 重新启动

附录：整体架构

复制code┌──────────────┐                     ┌──────────────┐     远程转发       ┌──────────────┐
│              │                     │              │  ◄──────────────►  │              │
│  Claude Code │  ──── 直连 ────►   │  CC-Switch   │   API 调用        │  六哥API后端  │
│              │                     │  (本地代理)    │  OpenAI兼容格式   │  i.crisxie.top│
└──────────────┘                     └──────────────┘                    └──────────────┘

Claude Code 直接连接本地 CC-Switch，CC-Switch 将请求转发到六哥API后端。国内网络直连，全程无需代理。

获取帮助：如遇到文档未覆盖的问题，请联系六哥API管理员。

文档版本：v1.0 | 适用 CC-Switch v3.15.0 | 最后更新：2026-05-17