CC-Switch Claude 基于 Linux 服务器安装使用指南本文面向需要在 Linux 服务器环境中部署 Claude Code 并使用 CC-Switch 管理多配置的开发者。一、环境准备1.1 系统要求LinuxUbuntu 20.04 / Debian 11 / CentOS 8具备 sudo 或 root 权限网络可访问外部资源1.2 安装基础依赖# Ubuntu / Debiansudoaptupdatesudoaptinstall-ycurlgitunzip# CentOS / RHELsudodnfinstall-ycurlgitunzip二、Claude Code 安装2.1 安装 Node.js 与 npmClaude Code 基于 Node.js 运行需先安装环境。# 安装 Node.js 18使用 NodeSource 仓库curl-fsSLhttps://deb.nodesource.com/setup_18.x|sudo-Ebash-sudoaptinstall-ynodejs# 验证安装node--version# 应显示 v18.x.xnpm--version# 应显示 9.x.x2.2 安装 Claude Code CLI# 通过 npm 全局安装sudonpminstall-ganthropic/claude-code# 或使用 npx 方式直接运行不全局安装npx anthropic/claude-code--version三、CC-Switch 安装3.1 什么是 CC-SwitchCC-SwitchClaude Configuration Switch是用于在多个 Claude API 配置之间快速切换的 CLI 工具适合管理多项目、多账号、多端点的场景。3.2 安装 CC-Switch步骤一下载二进制包curl-LOhttps://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-linux-x64-musl.tar.gz步骤二解压压缩包tar-xzfcc-switch-cli-linux-x64-musl.tar.gz步骤三添加执行权限chmodx cc-switch步骤四移动到 PATHsudomvcc-switch /usr/local/bin/3.3 验证安装cc-switch--version四、CC-Switch CLI 详细使用4.1 初始化配置首次使用需初始化 CC-Switch# 初始化生成配置文件cc-switch init# 配置文件默认位于 ~/.ccswitch/config.yaml4.2 常用命令列表cc-switch provider list# 列出供应商cc-switch provider switchid# 切换供应商cc-switch mcpsync# 同步 MCP 服务器# 使用全局 --app 参数来指定目标应用cc-switch--appclaude provider list# 管理 Claude 供应商cc-switch--appcodex mcpsync# 同步 Codex MCP 服务器cc-switch--appgemini prompts list# 列出 Gemini 提示词# 支持的应用claude默认、codex、gemini4.3 供应商管理cc-switch provider list# 列出所有供应商cc-switch provider current# 显示当前供应商cc-switch provider switchid# 切换供应商cc-switch provideradd# 添加新供应商cc-switch provider editid# 编辑现有供应商cc-switch provider duplicateid# 复制供应商cc-switch provider deleteid# 删除供应商cc-switch provider speedtestid# 测试 API 延迟4.4 MCP 服务器管理cc-switch mcp list# 列出所有 MCP 服务器cc-switch mcpadd# 添加新 MCP 服务器交互式cc-switch mcp editid# 编辑 MCP 服务器cc-switch mcp deleteid# 删除 MCP 服务器cc-switch mcpenableid--appclaude# 为特定应用启用cc-switch mcp disableid--appclaude# 为特定应用禁用cc-switch mcp validatecommand# 验证命令在 PATH 中cc-switch mcpsync# 同步到实时文件cc-switch mcpimport--appclaude# 从实时配置导入4.5 提示词管理cc-switch prompts list# 列出提示词预设cc-switch prompts current# 显示当前活动提示词cc-switch prompts activateid# 激活提示词cc-switch prompts deactivate# 停用当前激活的提示词cc-switch prompts create# 创建新提示词预设cc-switch prompts editid# 编辑提示词预设cc-switch prompts showid# 显示完整内容cc-switch prompts deleteid# 删除提示词4.6 技能管理cc-switch skills list# 列出已安装技能cc-switch skills searchquery# 搜索可用技能cc-switch skillsinstallname# 安装技能cc-switch skills uninstallname# 卸载技能cc-switch skillsenablename# 为当前应用启用配合 --appcc-switch skills disablename# 为当前应用禁用配合 --appcc-switch skills infoname# 显示技能信息cc-switch skillssync# 同步已启用技能到应用目录cc-switch skills sync-method[m]# 查看/设置同步方式auto|symlink|copycc-switch skills scan-unmanaged# 扫描未管理技能cc-switch skills import-from-apps# 导入未管理技能到 SSOTcc-switch skills repos list# 查看仓库列表cc-switch skills reposaddrepo# 添加仓库owner/name[branch] 或 GitHub URLcc-switch skills repos removerepo# 移除仓库owner/name 或 GitHub URL4.7 配置管理cc-switch config show# 显示配置cc-switch config path# 显示配置文件路径cc-switch config validate# 验证配置文件# 通用配置片段跨所有供应商共享设置cc-switch--appclaude config common show cc-switch--appclaude config commonset--json{env:{CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1},includeCoAuthoredBy:false}--applycc-switch--appclaude config commonclear--apply# 备份cc-switch config backup# 创建备份自动命名cc-switch config backup--namemy-backup# 创建备份自定义名称# 恢复cc-switch config restore# 交互式从备份列表选择cc-switch config restore--backupid# 通过 ID 恢复特定备份cc-switch config restore--filepath# 从外部文件恢复# 导入/导出cc-switch configexportpath# 导出到外部文件cc-switch configimportpath# 从外部文件导入cc-switch config reset# 重置为默认配置五、CC-Switch Claude 配置授权给普通用户5.1 一键授权方法root 用户安装并配置好 cc-switch 和 Claude 后可通过以下命令将配置授权给普通用户# 复制 root 的配置到普通用户 yourNamecp-r/root/.cc-switch /home/yourName/cp-r/root/.claude /home/yourName/# 把权限全部交给 yourName最关键chown-RyourName:yourName /home/yourName/.cc-switchchown-RyourName:yourName /home/yourName/.claude# 修复权限安全值chmod-R700/home/yourName/.cc-switchchmod-R700/home/yourName/.claude授权完成后切换到普通用户运行测试# 切换到 用户su- yourName# 验证 cc-switch 可用cc-switch--version# 验证 Claude Code 可用claude--version# 启动 Claude 会话claude5.2 原理说明问题根源root 的配置文件存放在/root/目录下普通用户无权读取解决方案将配置复制到普通用户主目录并变更所有权和权限使普通用户可以正常访问和使用六、、总结工具用途核心命令Claude CodeAI 编程助手 CLIclaude,claude --printCC-Switch多配置管理切换cc-switch add/switch/list/export通过 CC-Switch 与 Claude Code 的结合使用你可以在多项目、多账号间一键切换API 配置通过cc-switch export将配置注入 Claude Code 运行环境利用自动切换功能在不同项目目录中无需手动干预统一管理所有 Claude API 配置避免 Key 泄露和混淆注意以上 CC-Switch CLI 命令基于工具常规功能编写建议同时参考官方文档获取最新命令和用法。如有出入请以官方文档为准。