CC-Switch & Claude 基于 Linux 服务器安装使用指南

本文面向需要在 Linux 服务器环境中部署 Claude Code 并使用 CC-Switch 管理多配置的开发者。

一、环境准备

1.1 系统要求

Linux（Ubuntu 20.04+ / Debian 11+ / CentOS 8+）
具备 sudo 或 root 权限
网络可访问外部资源

1.2 安装基础依赖

bash 复制代码

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

# CentOS / RHEL
sudo dnf install -y curl git unzip

二、Claude Code 安装

2.1 安装 Node.js 与 npm

Claude Code 基于 Node.js 运行，需先安装环境。

bash 复制代码

# 安装 Node.js 18+（使用 NodeSource 仓库）
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node --version   # 应显示 v18.x.x
npm --version    # 应显示 9.x.x

2.2 安装 Claude Code CLI

bash 复制代码

# 通过 npm 全局安装
sudo npm install -g @anthropic/claude-code

# 或使用 npx 方式直接运行（不全局安装）
npx @anthropic/claude-code --version

三、CC-Switch 安装

3.1 什么是 CC-Switch

CC-Switch（Claude Configuration Switch）是用于在多个 Claude API 配置之间快速切换的 CLI 工具，适合管理多项目、多账号、多端点的场景。

3.2 安装 CC-Switch

步骤一：下载二进制包

bash 复制代码

curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-linux-x64-musl.tar.gz

步骤二：解压压缩包

bash 复制代码

tar -xzf cc-switch-cli-linux-x64-musl.tar.gz

步骤三：添加执行权限

bash 复制代码

chmod +x cc-switch

步骤四：移动到 PATH

bash 复制代码

sudo mv cc-switch /usr/local/bin/

3.3 验证安装

bash 复制代码

cc-switch --version

四、CC-Switch CLI 详细使用

4.1 初始化配置

首次使用需初始化 CC-Switch：

bash 复制代码

# 初始化，生成配置文件
cc-switch init

# 配置文件默认位于 ~/.ccswitch/config.yaml

4.2 常用命令列表

bash 复制代码

cc-switch provider list              # 列出供应商
cc-switch provider switch <id>       # 切换供应商
cc-switch mcp sync                   # 同步 MCP 服务器

# 使用全局 `--app` 参数来指定目标应用：
cc-switch --app claude provider list    # 管理 Claude 供应商
cc-switch --app codex mcp sync          # 同步 Codex MCP 服务器
cc-switch --app gemini prompts list     # 列出 Gemini 提示词

# 支持的应用：`claude`（默认）、`codex`、`gemini`

4.3 供应商管理

bash 复制代码

cc-switch provider list              # 列出所有供应商
cc-switch provider current           # 显示当前供应商
cc-switch provider switch <id>       # 切换供应商
cc-switch provider add               # 添加新供应商
cc-switch provider edit <id>         # 编辑现有供应商
cc-switch provider duplicate <id>    # 复制供应商
cc-switch provider delete <id>       # 删除供应商
cc-switch provider speedtest <id>    # 测试 API 延迟

4.4 MCP 服务器管理

bash 复制代码

cc-switch mcp list                   # 列出所有 MCP 服务器
cc-switch mcp add                    # 添加新 MCP 服务器（交互式）
cc-switch mcp edit <id>              # 编辑 MCP 服务器
cc-switch mcp delete <id>            # 删除 MCP 服务器
cc-switch mcp enable <id> --app claude   # 为特定应用启用
cc-switch mcp disable <id> --app claude  # 为特定应用禁用
cc-switch mcp validate <command>     # 验证命令在 PATH 中
cc-switch mcp sync                   # 同步到实时文件
cc-switch mcp import --app claude    # 从实时配置导入

4.5 提示词管理

bash 复制代码

cc-switch prompts list               # 列出提示词预设
cc-switch prompts current            # 显示当前活动提示词
cc-switch prompts activate <id>      # 激活提示词
cc-switch prompts deactivate         # 停用当前激活的提示词
cc-switch prompts create             # 创建新提示词预设
cc-switch prompts edit <id>          # 编辑提示词预设
cc-switch prompts show <id>          # 显示完整内容
cc-switch prompts delete <id>        # 删除提示词

4.6 技能管理

bash 复制代码

cc-switch skills list                # 列出已安装技能
cc-switch skills search <query>      # 搜索可用技能
cc-switch skills install <name>      # 安装技能
cc-switch skills uninstall <name>    # 卸载技能
cc-switch skills enable <name>       # 为当前应用启用（配合 --app）
cc-switch skills disable <name>      # 为当前应用禁用（配合 --app）
cc-switch skills info <name>         # 显示技能信息
cc-switch skills sync                # 同步已启用技能到应用目录
cc-switch skills sync-method [m]     # 查看/设置同步方式（auto|symlink|copy）
cc-switch skills scan-unmanaged      # 扫描未管理技能
cc-switch skills import-from-apps    # 导入未管理技能到 SSOT
cc-switch skills repos list          # 查看仓库列表
cc-switch skills repos add <repo>    # 添加仓库（owner/name[@branch] 或 GitHub URL）
cc-switch skills repos remove <repo> # 移除仓库（owner/name 或 GitHub URL）

4.7 配置管理

bash 复制代码

cc-switch config show                # 显示配置
cc-switch config path                # 显示配置文件路径
cc-switch config validate            # 验证配置文件

# 通用配置片段（跨所有供应商共享设置）
cc-switch --app claude config common show
cc-switch --app claude config common set --json '{"env":{"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":1},"includeCoAuthoredBy":false}' --apply
cc-switch --app claude config common clear --apply

# 备份
cc-switch config backup              # 创建备份（自动命名）
cc-switch config backup --name my-backup  # 创建备份（自定义名称）

# 恢复
cc-switch config restore             # 交互式：从备份列表选择
cc-switch config restore --backup <id>    # 通过 ID 恢复特定备份
cc-switch config restore --file <path>    # 从外部文件恢复

# 导入/导出
cc-switch config export <path>       # 导出到外部文件
cc-switch config import <path>       # 从外部文件导入

cc-switch config reset               # 重置为默认配置

五、CC-Switch & Claude 配置授权给普通用户

5.1 一键授权方法

root 用户安装并配置好 cc-switch 和 Claude 后，可通过以下命令将配置授权给普通用户：

bash 复制代码

# 复制 root 的配置到普通用户 yourName
cp -r /root/.cc-switch /home/yourName/
cp -r /root/.claude /home/yourName/

# 把权限全部交给 yourName（最关键）
chown -R yourName:yourName /home/yourName/.cc-switch
chown -R yourName:yourName /home/yourName/.claude

# 修复权限安全值
chmod -R 700 /home/yourName/.cc-switch
chmod -R 700 /home/yourName/.claude

授权完成后，切换到普通用户运行测试：

bash 复制代码

# 切换到 用户
su - yourName

# 验证 cc-switch 可用
cc-switch --version

# 验证 Claude Code 可用
claude --version

# 启动 Claude 会话
claude

5.2 原理说明

问题根源 ：root 的配置文件存放在 /root/ 目录下，普通用户无权读取
解决方案：将配置复制到普通用户主目录，并变更所有权和权限，使普通用户可以正常访问和使用

六、、总结

工具	用途	核心命令
Claude Code	AI 编程助手 CLI	`claude`, `claude --print`
CC-Switch	多配置管理切换	`cc-switch add/switch/list/export`

通过 CC-Switch 与 Claude Code 的结合使用，你可以：

在多项目、多账号间一键切换 API 配置
通过 cc-switch export 将配置注入 Claude Code 运行环境
利用自动切换功能，在不同项目目录中无需手动干预
统一管理所有 Claude API 配置，避免 Key 泄露和混淆

注意：以上 CC-Switch CLI 命令基于工具常规功能编写，建议同时参考官方文档获取最新命令和用法。如有出入请以官方文档为准。