Ubuntu 装机页
CC Switch · Claude Code · Happy —— 安装包本站直连下载，无需访问 GitHub。适用于 Ubuntu 22.04 / 24.04 (x86_64)。按顺序执行即可。
0准备：打开终端
装好系统进入桌面后，按 Ctrl + Alt + T 打开终端。先更新一下软件索引：
# 首次使用先更新索引，并安装 curl
sudo apt update && sudo apt install -y curl wget
1CC Switch v3.17.0
Claude Code / Codex 的供应商配置切换器。推荐用 deb 包安装（自动进应用菜单）；AppImage 免安装版作备用。
# 方式一：deb 安装（推荐，或直接双击下载的文件）
wget https://setup.hirkond.online/files/CC-Switch-v3.17.0-Linux-x86_64.deb
sudo apt install -y ./CC-Switch-v3.17.0-Linux-x86_64.deb
# 装完后在应用菜单搜索 "CC Switch" 启动，或命令行运行：
cc-switch
# 方式二：AppImage 免安装（需要 libfuse2）
sudo apt install -y libfuse2
wget https://setup.hirkond.online/files/CC-Switch-v3.17.0-Linux-x86_64.AppImage
chmod +x CC-Switch-v3.17.0-Linux-x86_64.AppImage
./CC-Switch-v3.17.0-Linux-x86_64.AppImage
2Node.js 22（Happy 需要）
Claude Code 本体不需要 Node，但 Happy 通过 npm 安装。顺手把 npm 换成国内镜像，速度快很多。
# 安装 Node.js 22 LTS（NodeSource 源）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# npm 换国内镜像（阿里）
npm config set registry https://registry.npmmirror.com
# 验证
node -v && npm -v
3Claude Code
官方原生安装器，一条命令，不依赖 Node。
# 官方安装脚本
curl -fsSL https://claude.ai/install.sh | bash
# 装完重开终端（或 source ~/.bashrc），然后启动并登录：
claude
首次运行 claude 会给出登录链接，浏览器打开完成授权即可。如果要用第三方中转 API，装好后直接打开 CC Switch 配置供应商，不用手动改配置文件。
4Happy（手机远程控制 Claude Code）
Happy 是 Claude Code 的移动端遥控器：电脑上跑 happy，手机装 Happy App 扫码配对，随时随地看进度、发指令。
# 全局安装
sudo npm install -g happy-coder
# 以后用 happy 代替 claude 启动（首次会出二维码，用手机 Happy App 扫码配对）
happy
5验证清单
cc-switch --version # 或从应用菜单打开 CC Switch
claude --version
happy --version
三个都有版本号输出，装机完成。