快速开始
安装指南
官方渠道与系统要求
请只从 olenro.com、GitHub Releases 或项目源码仓库获取 Olenro。任何要求付费、充值或索取登录凭据的“Olenro”网站或客户端都不是官方渠道。
| 系统 | 最低版本 | 架构 |
|---|---|---|
| Windows | Windows 10 及以上 | x64 |
| macOS | macOS 12 (Monterey) 及以上 | Intel (x64) / Apple Silicon (arm64) |
| Linux | 见下方发行版说明 | x64 / ARM64 |
前置要求
安装 Node.js
Olenro 管理的 CLI 工具（Claude Code、Codex、Gemini CLI）需要 Node.js 环境。
推荐版本：Node.js 18 LTS 或更高版本
Windows
-
访问 Node.js 官网
-
下载 LTS 版本安装包
-
运行安装程序，按提示完成安装
-
验证安装：
node --version
npm --versionmacOS
# 使用 Homebrew 安装
brew install node
# 或使用 nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --ltsLinux
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# 或使用 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts安装 CLI 工具
Claude Code
方式一：Homebrew（macOS 推荐）
brew install claude-code方式二：npm
npm install -g @anthropic-ai/claude-code
# 国内用户如下载慢，使用镜像源
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.comCodex
方式一：Homebrew（macOS 推荐）
brew install codex方式二：npm
npm install -g @openai/codex
# 国内用户如下载慢，使用镜像源
npm install -g @openai/codex --registry=https://registry.npmmirror.comGemini CLI
方式一：Homebrew（macOS 推荐）
brew install gemini-cli方式二：npm
npm install -g @google/gemini-cli
# 国内用户如下载慢，使用镜像源
npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com💡 提示：如果经常遇到下载慢的问题，可以全局设置镜像源：
npm config set registry https://registry.npmmirror.com
Windows
安装包方式
- 访问 Releases 页面
- 下载
CC-Switch-v{版本号}-Windows.msi - 双击运行安装程序
- 按提示完成安装
注意：运行安装程序后如果没有任何反应，可以在文件上点击右键，在弹出的菜单中打开 属性，常规页中的 安全 勾选 解除锁定
绿色版（免安装）
- 下载
CC-Switch-v{版本号}-Windows-Portable.zip - 解压到任意目录
- 运行
CC-Switch.exe
macOS
方式一：Homebrew（推荐）
# 添加 tap
brew tap lianhr12/olenro
# 安装
brew install --cask olenro更新到最新版本：
brew upgrade --cask olenro方式二：手动下载
- 下载
CC-Switch-v{版本号}-macOS.dmg（推荐）或CC-Switch-v{版本号}-macOS.zip - 打开 DMG，或解压 zip 得到
Olenro.app - 拖动到「应用程序」文件夹
已签名并公证
Olenro macOS 版本已通过 Apple 代码签名和公证，可直接安装打开，无需额外操作。
Linux
ArchLinux
使用 AUR 助手安装：
# 使用 paru
paru -S olenro-bin
# 或使用 yay
yay -S olenro-binDebian / Ubuntu
- 根据架构下载
CC-Switch-v{版本号}-Linux-x86_64.deb或CC-Switch-v{版本号}-Linux-arm64.deb - 安装：
sudo dpkg -i CC-Switch-v{版本号}-Linux-*.deb
# 如果有依赖问题
sudo apt-get install -fAppImage（通用）
- 根据架构下载
CC-Switch-v{版本号}-Linux-x86_64.AppImage或CC-Switch-v{版本号}-Linux-arm64.AppImage - 添加执行权限：
chmod +x CC-Switch-v{版本号}-Linux-*.AppImage- 运行：
./CC-Switch-v{版本号}-Linux-*.AppImage验证安装
安装完成后，启动 Olenro：
- 应用窗口正常显示
- 系统托盘出现 Olenro 图标
- 应用切换器中能看到已启用的受管应用，并能切换到目标应用面板
自动更新
Olenro 内置自动更新功能：
- 启动时自动检查更新
- 有新版本时在界面显示更新提示
- 点击即可下载并安装
也可以在「设置 → 关于」中手动检查更新。
卸载
Windows
- 通过「设置 → 应用」卸载
- 或运行安装目录下的卸载程序
macOS
- 将
Olenro.app移到废纸篓 - 可选：删除配置目录
~/.olenro/
Linux
# Debian/Ubuntu
sudo apt remove olenro
# ArchLinux
paru -R olenro-bin