安装指引

要装两样东西:电脑上一份开发机端(跑着 Claude Code / Codex 的那台),手机上一个 App。 电脑这头装完会给你一个二维码,手机扫一下就连上了——不用填地址、不用开端口。

STEP 1
电脑:装开发机端
按下面你电脑的系统选一种,装完右下角/菜单栏会出现 CodeBoss 图标。
STEP 2
手机:扫码接入
装好 App → 点「扫码接入」→ 对着电脑上的二维码扫一下,完成。
macOS
菜单栏 App
Apple Silicon / Intel 都行
  1. 下载安装包:点「下载 macOS 版(DMG)」,双击打开 DMG,把里面的 CodeBoss.app 拖进「应用程序」文件夹。 一定要拖进「应用程序」:App 以后靠自动更新原地替换自己。留在 DMG 或下载目录里直接运行, 更新时没法原地替换,每次都得重新下载、重新授权;App 还留在 DMG 里的话,推出 DMG 或重启电脑后就找不到了。
    忘了拖也没关系:从下载目录直接双击 App,会弹「把 CodeBoss 移到「应用程序」」,点它就自动搬好。
  2. 打开 App:双击 CodeBoss.app 就能直接打开——安装包已通过 Apple 公证,系统不会拦截。 若双击后"没反应",看屏幕右上角菜单栏——它是菜单栏程序,图标就在那里。 极少数老版本安装包可能提示「无法验证」:右键(Control + 单击)CodeBoss.app →「打开」→ 弹窗里再点「打开」即可; 或者直接重新下载最新版(已公证,双击即开)。
  3. 装服务、配对:第一次打开时主窗口会自己弹出来,上面就是「三步接入」。 点窗口里的大按钮「安装 CodeBoss 服务」——自动装依赖、注册开机自启,首次约半分钟(可能输一次开机密码)。 装好后同一个按钮变成「显示配对二维码」,点它,屏幕上出现二维码(15 分钟内有效),手机扫这个就行。 之后随时要从菜单栏图标进:点图标 →「扫这个码接上…」就是二维码; 「查看会话列表…」「套餐与续费…」「检查更新…」「打开主窗口」都在这一个菜单里。
macOS 菜单栏 App 的配对二维码窗口
配对二维码
手机扫这张就行,过期了点「刷新」
macOS 主窗口:服务状态、会话数、一键配对
主窗口
服务状态、会话数、一键打开二维码
Windows
托盘客户端
Windows 10 / 11
  1. 下载安装包:点「下载 Windows 版(安装包)」,双击 CodeBoss-Setup.exe,一路下一步。 不需要管理员权限,装到当前用户目录;重复运行就是升级,数据都保留。
    浏览器提示「不常用的下载」或「已保护你的电脑」时:点「更多信息」→「仍要运行」。
  2. 等它自己装完:会弹出一个装依赖的进度窗口(找 Python、建环境、注册计划任务),首次一两分钟。 装完右下角通知区出现 CodeBoss 图标;第一次安装末尾还会自动弹出配对二维码窗口,手机直接扫即可。
  3. 没看到二维码?双击那个图标(可能在 ^ 展开区里)打开主窗口,点绿色的「显示配对二维码」;右键菜单里的「扫这个码接上…」也是打开同一个窗口。 托盘菜单和 mac 一模一样:查看会话列表、启动/停止服务、重新安装、卸载、套餐与续费、检查更新,都在右键里。
Windows 托盘客户端主窗口:服务状态、显示配对二维码
托盘客户端主窗口
点「显示配对二维码」就出码,手机直接扫
Linux
命令行客户端
x86_64 / arm64,Ubuntu、Debian、CentOS、docker、云主机都行
  1. 一条命令装好:登录服务器,直接粘这一条(Docker / WSL / 云主机都行):
    curl -fsSL /codeboss-linux.tar.gz | tar xz
    它会下载安装包、解压到临时目录并运行 install-linux.sh:建环境、注册 systemd 用户服务、装好 codeboss 命令,最后终端里直接打出二维码。重跑同一条命令就是升级,数据都保留。
  2. 或者手动装:把 tar.gz 传上去,tar xzf codeboss-linux.tar.gz,进目录运行 bash install-linux.sh。 安装包自带 x86_64 的 Python,机器上没装也能用。
  3. 扫码接入:安装最后直接显示二维码,手机扫就行。以后想再扫码:终端输入 codeboss → 选 1「扫这个码接上…」;无头服务器就把终端里的配对码,粘到手机 App 的「或粘贴配对码」里。
  4. 之后每次:codeboss 打开菜单(配对、会话、启停、更新、日志、卸载都在里面),codeboss status 看服务状态。
手机上看终端画面并语音输入
接上之后
全彩终端,按住就能说
手机上的会话列表
会话列表
点一下进去接着干
iPhone
TestFlight 内测
iOS 15 及以上
  1. 先装 TestFlight:App Store 搜「TestFlight」装上。这是 Apple 官方的内测工具,免费。 iOS 不能像安卓那样直接装安装包;官网不放 .ipa,放了未登记的设备也装不上。
  2. 用邀请链接接内测:打开 iOS 安装页 点按钮,或者点交流群里发的 testflight.apple.com/join/… 链接,在 TestFlight 里点「接受」。 公开邀请链接还没生成时,先在群里说一声,我们登记你的 Apple ID 邮箱。
  3. 装 CodeBoss 扫码:TestFlight 里点「安装」;装好打开,扫电脑上的配对二维码,和安卓版一样。 每个内测包 90 天有效,到期前来群里拿新包;在 TestFlight 里点「更新」覆盖安装,配对和设置都保留。

装好怎么用:三个实体按键全搞定

上键说话、下键发送、长按切静音——按键用法示意图和逐条说明已挪到独立的「怎么用」页:怎么用 →

卡在这些地方,多半是这几种情况

二维码过期了
15 分钟有效。回到电脑再打开一次「显示配对二维码」/「扫这个码接上…」,刷新一下。
Windows 找不到托盘图标
在右下角 ^ 展开区里,拖到任务栏外侧下次就常驻了。
提示没装 Python
Windows 不用自己装:安装脚本会先找,找不到就用 uv / winget 自动装一个(需联网)。 Linux 安装包自带 x86_64 的 Python;arm64 等架构需要机器上已有 python3(sudo apt install python3 python3-venv)。
手机和电脑不在同一个 Wi-Fi
没关系,走中继也能连;同网时直连更快。
iPhone 一直装不上
iOS 版只走 TestFlight:先装 TestFlight,再用邀请链接装 CodeBoss,步骤见上面的 iPhone 一节。iOS 安装页 →
装完了想升级
macOS 点菜单栏图标 →「检查更新…」;Windows 右键托盘图标 →「检查更新…」;Linux 终端 codeboss update(菜单第 5 项),或重跑一遍安装包。数据都保留。
↓ 去下载页