Codex-X

Codex-X 快速入门

Rust 构建的高性能 Codex 桌面管理器——多 Codex 实例切换，指令式 Agent 交互，开源免费。

这是什么？适合谁？

Codex-X 是一个用 Rust 构建的 Codex 桌面客户端，专注于 Codex 生态的 Switch 和 Instruct 功能管理。它让你可以在桌面端流畅地管理多个 Codex 实例，在它们之间切换，并通过指令式交互与 Codex Agent 协作。

如果你是 Codex 的重度用户，需要同时管理多个 Codex 实例（如开发环境、测试环境、生产环境），Codex-X 提供了统一的桌面管理界面。Rust 构建保证了高性能和低资源占用。

适合：Codex 生态的重度用户、需要多实例管理的开发者、偏好桌面 GUI 而非终端 CLI 的 AI 编码用户、Rust 生态爱好者。

准备工作

• 系统：macOS / Windows / Linux 均有支持
• 已安装 Codex CLI（Codex-X 是 Codex 的管理器，依赖 Codex 环境）
• 从 GitHub Releases 下载最新版本
• Rust 环境（如需从源码编译）

3 步快速上手

第 1 步：安装

从 GitHub Releases 下载对应平台的二进制文件：

# macOS
brew install yynxxxxx/tap/codex-x

# 或直接下载二进制
chmod +x codex-x
sudo mv codex-x /usr/local/bin/

第 2 步：配置 Codex 实例

首次启动 Codex-X 后，在设置中添加你的 Codex 实例：

codex-x instance add --name dev --path /path/to/codex-project
codex-x instance add --name test --path /path/to/another-project

第 3 步：切换和交互

# 列出所有实例
codex-x instance list

# 切换到指定实例
codex-x switch dev

# 发送指令给当前实例
codex-x instruct "帮我重构 src/auth.py 模块"

进阶用法

多实例管理

Codex-X 的核心价值在于多实例管理。典型场景：

• 开发环境实例：日常编码，使用 Codex 的快速模式
• 审查环境实例：代码审查，使用 Codex 的深度推理模式
• 实验环境实例：新技术探索，独立配置不同的模型参数

codex-x instance add --name review --path /path/to/review --mode deep
codex-x instance add --name experiment --path /path/to/experiment --model claude-sonnet

指令式 Agent 交互

Codex-X 的 Instruct 模式让你可以用自然语言驱动 Codex Agent：

codex-x instruct --project-wide "找出项目中所有未处理的异常，并添加适当的错误处理"

快捷键

• Ctrl+1/2/3 — 快速切换到实例 1/2/3
• Ctrl+Shift+I — 打开 Instruct 面板
• Ctrl+Shift+S — 查看实例状态

常见问题 FAQ

Q1：Codex-X 和 ZCode 有什么区别？

A：Codex-X 是 Codex 生态的桌面管理器，专注于 Codex 实例的管理和切换。ZCode 是独立的 AI 编码 IDE，使用 GLM-5.2 模型。如果你已经使用 Codex，Codex-X 是增强工具；如果你想换一个完整的 AI IDE，ZCode 是替代方案。

Q2：Codex-X 需要 Codex 账号吗？

A：是的。Codex-X 是 Codex 的桌面管理工具，依赖 Codex CLI 环境。你需要先安装并配置 Codex。

Q3：Rust 构建有什么优势？

A：Rust 构建的桌面应用内存占用低（通常 <100MB），启动速度快，原生性能。相比 Electron 应用（如 VSCode），Codex-X 更轻量。

参考链接

• Codex-X GitHub 仓库
• Codex 官方文档