Installation

安装

始终从 最新 Release 下载对应平台和架构的最新正式版，无需安装 Rust 或从源码编译。下表的 <版本号> 以发布页实际版本为准。

macOS

Mac	文件
Apple Silicon	codex-mixin-<版本号>-aarch64-apple-darwin.dmg
Intel	codex-mixin-<版本号>-x86_64-apple-darwin.dmg

需要 macOS 13.1 或更新版本。打开 DMG，把 Codex Mixin.app 拖进「应用程序」并启动。点击菜单栏图标 →「打开控制台…」。

发布包使用 ad-hoc 签名，未做 Apple notarization。确认下载来自本项目 Release 后，如被 Gatekeeper 拦截，可运行：

xattr -dr com.apple.quarantine "/Applications/Codex Mixin.app"

Windows

• 安装版：下载并运行 codex-mixin-<版本号>-windows-x86_64-setup.exe。
• 便携版：下载 codex-mixin-<版本号>-windows-x86_64.zip，解压后运行 codex_mixin_ui.exe，保留完整应用目录。

启动后点击系统托盘图标 →「打开控制台…」。桌面端采用原生 WinUI 3。

Linux

用 uname -m 查看架构，然后下载：

架构	二进制压缩包
x86_64	codex-mixin-cli-<版本号>-x86_64-unknown-linux-musl.tar.gz
aarch64 / ARM64	codex-mixin-cli-<版本号>-aarch64-unknown-linux-musl.tar.gz

例如 x86_64，在单独的下载目录中执行，目录中只保留本次下载的对应安装包：

tar -xzf codex-mixin-cli-*-x86_64-unknown-linux-musl.tar.gz
cd codex-mixin-cli-*-x86_64-unknown-linux-musl
./codex-mixin panel

在浏览器打开终端打印的带 Token 地址，面板进程需保持运行。直接使用默认启动方式，端口会自动分配。

Debian / Ubuntu 也可安装同一 Release 的对应 .deb，安装后运行 codex-mixin panel。macOS 和 Windows 也提供独立 CLI 包，通常直接使用桌面 App 更方便。

远程开发机

在远端下载 Linux 二进制，进入解压目录运行：

./codex-mixin panel

在本机浏览器打开远端面板的访问地址。若终端地址中的主机部分无法从本机访问，替换为开发机可访问的 IP 或域名，保留实际端口和 Token；也可在面板登录页粘贴终端输出的 Token。确认开发机对应端口可从本机访问。

默认面板和模型网关都监听所有网卡，并自动分配端口，二者的端口与访问控制相互独立。Agent 接入修改的是远端机器上的客户端配置。更多见 数据与安全。

更新

macOS 从菜单栏「关于」→「检查更新…」；Windows 可下载新版安装器或便携包。独立 CLI 使用 codex-mixin update。升级后重启网关和已打开的客户端，让新接口与配置生效。

下一步：快速开始。