OpusClaw 使用文档

主题

CC-Switch CLI 使用 ​

推荐在服务器环境或 macOS 系统下使用 CC-Switch CLI(命令行版本)。

简介 ​

Claude Code、Codex、Gemini CLI 的命令行管理工具

  • 版本:4.7.x(以 GitHub 最新 Release 为准)
  • 平台:macOS / Linux x64 / Linux ARM64 / Windows
  • 技术栈:Rust

可以管理供应商配置、MCP 服务器、Skills 扩展、系统提示词,功能基本与 GUI 版本对齐。

下载安装 ​

macOS ​

bash
curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-darwin-universal.tar.gz
tar -xzf cc-switch-cli-darwin-universal.tar.gz
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/
xattr -cr /usr/local/bin/cc-switch  # 如果遇到"无法验证开发者"提示

Linux x64 ​

bash
curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-linux-x64-musl.tar.gz
tar -xzf cc-switch-cli-linux-x64-musl.tar.gz
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/

Linux ARM64 ​

bash
curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-linux-arm64-musl.tar.gz
tar -xzf cc-switch-cli-linux-arm64-musl.tar.gz
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/

Windows ​

下载 .zip,把 cc-switch.exe 移动到 PATH 目录下。

命令参考 ​

常用 ​

bash
cc-switch provider list
cc-switch provider switch <id>
cc-switch mcp sync
cc-switch --app claude provider list
cc-switch --app codex mcp sync
cc-switch --app gemini prompts list

支持的 app:claude(默认)、codex、gemini。

供应商管理 ​

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>

MCP 服务器管理 ​

bash
cc-switch mcp list
cc-switch mcp add
cc-switch mcp edit <id>
cc-switch mcp delete <id>
cc-switch mcp enable <id> --app claude
cc-switch mcp disable <id> --app claude
cc-switch mcp validate <command>
cc-switch mcp sync
cc-switch mcp import --app claude

Prompts 管理 ​

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>

Skills 管理 ​

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 claude
cc-switch skills disable <name>
cc-switch skills info <name>
cc-switch skills sync
cc-switch skills sync-method [m]
cc-switch skills scan-unmanaged
cc-switch skills import-from-apps
cc-switch skills repos list
cc-switch skills repos add <repo>
cc-switch skills repos remove <repo>

配置管理 ​

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 [--backup <id> | --file <path>]
cc-switch config export <path>
cc-switch config import <path>
cc-switch config reset

在 CC-Switch CLI 中配置 OpusClaw ​

以 Claude Code 配置为例,Codex 与 Gemini 同理。

  1. 终端运行 cc-switch 进入 TUI 界面
  2. 左侧菜单选 Providers,回车,按 a 添加供应商
  3. 上方模板选 OpusClaw(若没内置就选 Custom 然后填 https://api.opusclaw.me)
  4. API Key 处填对应分组令牌(claude / chatgpt / gemini),回车,按 Ctrl+S 保存
  5. 确保选中刚配置的 Provider,退出 CC-Switch CLI

完成后再回 Shell 执行 claude / codex / gemini 即可。

OpusClaw

© 2026 OpusClaw Team