Linux下载、安装cc-switch-v3.18.0（附安装包CC-Switch-v3.18.0-Linux-x86_64.AppImage）

1. CC Switch 简介

CC Switch 是由开发者 Jason Young（GitHub @farion1231）创建的一款免费、开源的跨平台桌面应用，基于 Tauri 2 + Rust 构建。它作为 AI 编码工具的"全能管理中枢"，为开发者解决了多工具、多供应商配置的痛点。

众所周知，现代 AI 辅助编程涉及多个命令行工具——Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes 等——每个都有自己独特的配置文件格式（JSON、TOML、.env 等）。当你想切换 API 供应商或在不同工具间共享 MCP 配置时，手动编辑这些文件既繁琐又容易出错。

CC Switch 用一个统一的桌面界面解决了这一切。它提供可视化的供应商管理、一键切换、自动配置同步，让你彻底告别手动编辑配置文件的时代。

核心亮点：

• 一个应用管理八个工具：Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes——从单一界面统一管理
• 50+ 内置供应商预设：涵盖 AWS Bedrock、NVIDIA NIM 以及众多社区中转服务（如 PackyCode、ZetaAPI、APINebula、RunAPI 等），复制密钥即可一键导入
• 统一 MCP 与 Skills 面板：跨应用管理 MCP 服务器和 Skills，支持双向同步与 Deep Link（ccswitch://）导入
• 本地转换与智能故障转移：内置转换网关，支持 Anthropic Messages ↔ OpenAI Responses 格式互转；自动故障转移、熔断器与健康监控，保障服务不中断
• 用量与成本追踪：趋势图表、详细请求日志、自定义模型定价，全面掌握 API 消耗
• 系统托盘快捷切换：从托盘菜单即时切换供应商，无需打开完整应用
• 云同步：支持 Dropbox、OneDrive、iCloud、WebDAV 跨设备同步配置
• 跨平台支持：Windows（MSI/Portable）、macOS（DMG/Homebrew）、Linux（AppImage/deb/rpm）

CC Switch 完全免费、开源（MIT 协议），不会向用户收取任何费用。项目在 GitHub 上持续活跃，拥有大量社区用户和赞助商生态支持。唯一官方网站为 ccswitch.io。

2. v3.18.0 版本亮点

该版本汇集了 8 位贡献者 的 52 条 提交，217 个文件变更，+21,452 / -6,285 行代码。

v3.18.0 于 2026-07-21 发布，是 CC Switch 的一次重大功能更新，核心围绕 xAI Grok 集成和数据正确性修复两条主线。

新功能

Grok Build 成为第八个受管应用

xAI 的 Grok CLI（Grok Build）现在与 Claude Code、Codex 等并列成为 CC Switch 的一等公民。支持供应商添加/导入/一键切换、MCP 与 Skills 双向同步、提示词自动导入、会话管理与用量看板全覆盖。转换侧提供专属的 /grokbuild/v1/responses 路由命名空间、独立的故障转移队列和按应用转换设置，与 Codex 完全隔离。

xAI Grok 账号 OAuth 登录

Claude Code 与 Claude Desktop 新增 xAI Grok 设备码 OAuth 登录方式，无需 API Key 即可直接使用 Grok 订阅。在「设置 → OAuth 授权中心」完成 xAI 账号授权后，本地转换逐请求注入访问令牌并完成 Anthropic Messages → xAI Responses API 转换。Codex 侧同时提供 OAuth 受管预设（含严格网关兼容层）和 API Key 原生直连预设。

Kimi K3 预设与定价

Codex / Hermes / OpenClaw / OpenCode 的 Kimi 开放平台预设加入 K3（100 万 token 上下文窗口），内置定价自动入库。

重要修复

Codex 用量双计根治（v3.17.0 遗留问题）

修复 fork / 子Agent场景下父对话历史被重复计入用量的问题。新解析器基于显式父身份和令牌签名对齐来剥离重放前缀，升级后自动执行一次性用量重建。

codex 0.144.5+ 启动兼容

修复新版 codex CLI 因严格解析模型目录导致的启动失败问题，生成目录自动补齐解析器必需字段。

Windows 切换体验优化

切换供应商不再闪过黑色控制台窗口，界面不再卡住约 2 秒（卡顿修复对全平台生效）。

诊断日志体系升级

日志跨重启持久保留（20 MB × 4 轮转）、所有出口统一脱敏（URL 凭据、请求响应体、敏感请求头均不落盘），界面崩溃有错误卡片和重载按钮。

其它改进

• Agent用量记录改为幂等（同一响应不再重复记录）
• 大量会话导入时用量页不再卡死
• Responses↔Chat 桥修复推理内容错挂、并行工具调用 ID 丢失/乱序、工具 schema 为 null 被拒
• 托盘首启语言跟随系统
• SudoCode.us 回归，删除的默认 Skill 仓库不再复活
• Node 经 nvm/fnm/mise 安装时工具更新可用

3. 获取安装包

如果访问 GitHub 不便，安装包及中文文档：https://hanshuixin.org/go/223G（内含 CC-Switch-v3.18.0-Linux-x86_64.AppImage、README 中英对照、发布说明中英对照和 LICENSE）。

适用于 Linux x86_64（amd64）。

Linux安装cc-switch-v3.18.0（CC-Switch-v3.18.0-Linux-x86_64）.zip
├── CC-Switch-v3.18.0-Linux-x86_64.AppImage
├── Linux安装cc-switch-v3.18.0（CC-Switch-v3.18.0-Linux-x86_64）.pdf
├── README/
│   ├── README.md
│   └── README-中文版.md
├── 发布说明/
│   ├── RELEASE-NOTES.md
│   └── RELEASE-NOTES-中文版.md
└── LICENSE

附录：快速开始

AppImage 适配性与用法说明

格式说明：AppImage 是一种通用 Linux 可执行格式，无需安装即可运行。它不依赖特定包管理器，一次下载即可在所有主流 Linux 发行版上使用，是一种便携式的软件分发方式。

适配的操作系统：

系统架构要求：本安装包适用于 x86_64（amd64） 架构的 Linux 系统。可通过 uname -m 命令确认你的系统架构，输出为 x86_64 即可使用。

基本使用步骤：

1. 赋予执行权限：

   chmod +x CC-Switch-v3.18.0-Linux-x86_64.AppImage

2. 运行应用：

   ./CC-Switch-v3.18.0-Linux-x86_64.AppImage

3. （可选）集成到桌面环境：首次运行时，AppImage 会提示是否创建桌面快捷方式和文件关联，选择"是"即可将其集成到系统菜单中。

Wayland 环境注意事项：

AppImage 默认使用 GDK_BACKEND=x11（XWayland）以避免原生 Wayland 崩溃。在 Wayland + NVIDIA 环境上如遇到点击无响应或调整窗口大小时黑屏，可使用以下方式切换到原生 Wayland：

CC_SWITCH_GDK_BACKEND=wayland ./CC-Switch-v3.18.0-Linux-x86_64.AppImage

在平铺式 Wayland 合成器（sway/Hyprland）上如点击无响应，也可尝试：

CC_SWITCH_GDK_BACKEND=x11 ./CC-Switch-v3.18.0-Linux-x86_64.AppImage

数据存储位置：

• 配置与数据库：~/.cc-switch/cc-switch.db
• 本地设置：~/.cc-switch/settings.json
• 自动备份：~/.cc-switch/backups/（保留最近 10 份）

提示：AppImage 与系统包管理器安装的 deb/rpm 版本相互独立，可并存使用。数据同样存储在 ~/.cc-switch/ 目录下，配置互通。