Codux：从 AI 终端到 AI 编程工作站的进化之路

如果你从 Codux 初始版本用到现在，最明显的变化应该不是「又多了几个按钮」，而是 Codux 的定位变了。

初始版本时，Codux 的重点是把 AI CLI 终端跑稳。

到了 0.9 最新版，Codux 已经从一个围绕终端增强的工具，成长为一个围绕项目组织的 macOS AI 编程工作站。

它仍然服务于 Claude Code、Codex、Gemini CLI、OpenCode 这些 AI CLI 工具，但不再只负责「打开一个终端」。它开始管理项目、终端、会话、AI 状态、用量、记忆、文件、Git、移动端接力、宠物和远程连接。

这篇文章不按每个版本号流水账展开，而是直接对比：从初始版本到 0.9，Codux 到底变成了什么。

初始版本解决的是 AI 终端稳定性

初始版本是 Codux 很关键的一个阶段。

当时最重要的变化，是终端后端切换到 Ghostty，并把分屏、浮窗终端、项目切换、会话恢复统一到同一套渲染链路上。

这件事看起来偏底层，但对 AI 编程非常关键。

Claude Code、Codex、Gemini CLI、OpenCode 本质上都运行在终端里。如果终端输入不稳定、项目切换会丢内容、浮窗和分屏状态不一致、恢复会话后滚动和焦点异常，那么上层再多功能都没有意义。

所以在初始阶段，Codux 主要完成了几件基础工作：

• 用 Ghostty 作为终端底座，提升终端渲染和交互稳定性。
• 让分屏、浮窗、恢复会话和项目切换走同一套终端生命周期。
• 收口 AI 运行状态和实时 token 统计，避免不同工具、不同会话之间串值。
• 建立宠物成长和 AI 统计需要的基础账本，减少历史索引和实时状态重复计数。
• 拆分应用、终端、AI 统计、Git、设置、历史索引、宠物等大模块，为后续扩展降低维护成本。

如果用一句话概括初始版本：

Codux 当时要先把「AI 终端」这件事做稳。

它已经不是普通终端，但还主要围绕终端、AI 状态和基础统计展开。

到了 0.9，Codux 变成了项目级工作站

0.9 最新版的 Codux，不再只是把 AI CLI 放进一个更好看的终端里。

它现在围绕「项目」组织工作流。

一个项目在 Codux 里有自己的终端布局、Tab、AI 工具选择、会话状态、文件浏览、Git 状态、记忆上下文、移动端接力状态和宠物成长输入。

你打开一个项目，不只是打开一个目录，而是回到一个完整工作现场。

这也是从初始版本到 0.9 最大的变化：

• 初始版本：把 AI CLI 终端跑稳。
• 0.9：把 AI 编程的完整工作流组织起来。

下面按能力来看这个变化。

一、从稳定终端，到多项目 AI 工作区

初始版本的核心是 Ghostty 终端底座。它解决了终端输入、显示、恢复、项目切换这些基础问题。

0.9 的终端能力已经进一步变成「多项目工作区」。

现在每个项目都可以保留独立布局、独立会话、独立 AI 工具选择和运行状态。你可以在一个项目里开最多 6 个分屏终端，如果 6 个不够，还可以继续开不限数量的 Tab。

这对 AI 编程很实用。

比如一个项目里，你可能同时让 Codex 修 bug，让 Claude Code 看架构，让 Gemini CLI 做资料整理，再开一个普通 shell 跑测试。它们不应该混在一起，也不应该因为切换项目就丢状态。

Codux 0.9 的目标是让每个项目像一个独立工作间：

• 终端布局可以恢复。
• Tab 和分屏有自己的状态。
• AI 运行中、等待中、完成态能被识别。
• 项目切走再回来，现场还在。
• 底部终端、分屏终端、浮窗终端都围绕同一个项目状态组织。

这和初始版本只强调「终端稳定」相比，已经是更完整的工作区能力。

二、从实时统计，到 AI 活动面板和会话恢复

初始版本已经开始处理 AI 实时统计和会话状态，重点是不要串值、不要重复统计、不要让历史索引和实时 overlay 混在一起。

0.9 里，这部分已经变成更完整的 AI 活动系统。

Codux 会识别 Claude Code、Codex、Gemini CLI、OpenCode 的运行状态，把「运行中」「等待输入」「完成」「失败」「中断」「权限请求」这些状态反馈到界面上。

你不用一直盯着终端光标看。

现在 Codux 会把 AI 活动反馈到多个地方：

• Tab 指示器。
• 项目卡片。
• macOS 系统通知。
• AI 统计面板。
• 宠物气泡。
• 每日等级。

AI 用量也不只是一个 token 总数。Codux 会按工具、模型、项目拆分统计，并提供每日视图和趋势视图。

更重要的是，会话可以恢复。

过去 AI CLI 跑完之后，很多信息只留在终端滚动历史里。现在 Codux 会把这些运行整理成可追踪的历史记录，你可以从历史会话回到原工具继续工作。

这让 AI 编程不再是一次次分散的终端交互，而更像一个可以回溯、可以恢复、可以继续推进的项目过程。

三、从没有长期上下文，到三层 AI 记忆

初始版本时，Codux 主要解决终端和实时状态问题，还没有形成完整的长期记忆系统。

0.9 最新版里，AI 记忆已经成为 Codux 的核心能力之一。

Codux 的记忆不是简单把一段文字写进项目根目录，也不是粗暴生成一个固定 prompt。

它使用本地 memory.sqlite3 保存记忆，并按三层组织：

• 用户记忆：你的长期偏好、习惯、常用技术栈、处理问题方式。
• 项目记忆：某个项目的结构、模块边界、历史决策、踩过的坑。
• 工具记忆：面向 Claude Code、Codex、Gemini CLI、OpenCode 的启动上下文和注入方式。

Codux 会从完成的 AI 会话里提取有价值的信息，归档到本地记忆库中。启动工具时，再生成应用私有的上下文文件，注入给对应 AI CLI。

重点是：不污染项目目录。

你的项目仓库里不会被悄悄写入一堆 Codux 私有记忆文件。记忆由 Codux 管理，项目目录保持干净。

0.9 还进一步增强了记忆管理：

• 支持本地 Llama 记忆提取。
• 支持模型下载线路选择，国内可优先 ModelScope，海外可优先 Hugging Face。
• 支持一键安装和移除本地模型。
• 记忆管理窗口按「摘要 / 记忆 / 历史记录」组织。
• 支持手动「立即索引」已完成 AI 会话。
• 支持手动编辑摘要，并用于后续记忆注入。
• 工作记忆、核心记忆、历史摘要的合并策略更清晰。

这解决了 AI 编程里一个非常实际的问题：

AI 工具很强，但它总是忘。

Codux 0.9 要做的是让 AI 不再每次打开项目都像第一次见到这个项目。

四、从基础宠物，到 Codex 通用宠物生态

初始版本时，Codux 已经有宠物成长和 AI 统计相关的基础账本。那时更重要的是保证宠物经验、项目 token、历史统计之间不要重复计数，不要因为项目切换或历史索引导致成长异常。

到了 0.9，宠物已经不只是一个内置小功能。

它变成了 Codux 里最有辨识度的特色之一。

首先，宠物会跟随 AI 活动变化。

AI 运行中、等待输入、完成、失败、中断、空闲、睡眠，这些状态都可以反映到标题栏宠物和桌面挂件宠物上。Codex 等工具出现权限请求或等待输入时，宠物气泡也可以作为提醒入口。

其次，宠物支持对话和提醒。

它可以显示 AI 任务完成反馈，也可以承载喝水、久坐、深夜工作等提醒。它不是强制功能，喜欢的人可以打开，不喜欢的人可以静音或关闭。

最重要的是，0.9 开始支持 Codex 通用自定义宠物包。

Codux 现在统一使用 Codex 风格宠物 atlas。一个自定义宠物包只需要两个核心文件：

• pet.json
• spritesheet.png

也就是说，Codux 支持和 Codex 自定义宠物一致的扁平包格式。

这是 0.9 里很值得单独强调的变化。

以前宠物素材更像应用内部资源，需要围绕蛋、阶段、进化、终极形态等链路组织。现在 Codux 改成单形态 atlas，不再依赖复杂进化素材链，同时兼容已有宠物进度数据。

标准 Codex 风格宠物 atlas 按固定坐标雪碧图组织，采用 8 x 9 动作布局。创作者只要准备好兼容格式，就可以生成 Codux / Codex 通用的宠物包。

在 Codux 里，你可以从领养或图鉴流程打开 Petdex 宠物市场，粘贴 Petdex 宠物页面地址，预览元数据，调整显示名称，然后安装到 Codux。

安装后的自定义宠物会和内置宠物一起出现在领养列表里，并保留同样的能力：

• 领养。
• 改名。
• 校验。
• 封存。
• 取回。
• 与当前宠物互换。
• 动画状态。
• 气泡对话。
• 成长进度。

这意味着 Codux 的宠物系统不再局限于内置形象。

你喜欢某个 Codex 通用宠物包，可以直接导入 Codux；你为 Codux 做的宠物，也可以按同样规范保持兼容。

0.9 还优化了宠物 atlas 归一化。同一张 spritesheet.png 内的帧会保持统一缩放和对齐，减少动画播放时体型抖动。少帧动作和多帧动作也会根据实际帧数自适应，不会被强行加速或截断。

这让宠物从「有趣的小挂件」变成了一个可扩展的编程伙伴系统。

五、从终端旁路文件，到项目文件管理和编辑

初始版本时，Codux 的中心还是终端。文件和 Git 更多是围绕 AI 工作流的辅助状态。

0.9 最新版里，文件管理已经被放进项目工作区。

Codux 现在提供项目文件侧栏，可以浏览当前项目目录，包括隐藏目录。你可以打开文件、复制路径、在 Finder 中显示、删除、重命名，也可以把文件路径直接拖进终端。

对 AI 编程来说，「路径」就是上下文。

很多时候你不是让 AI 泛泛回答问题，而是要它准确处理某个文件、某个目录、某段代码。文件路径能直接进入终端，就减少了来回复制和描述错误。

0.9 还加入了基于 CodeMirror 的可编辑文件预览窗口。

它支持：

• 语法高亮。
• 保存。
• 复制和粘贴。
• 撤销和重做。
• 查找。
• 未保存关闭保护。
• 跟随主题的窗口样式。

对于超大文本文件，Codux 也加入了虚拟只读预览，避免一次性渲染造成卡顿。

这意味着 Codux 不再只是「打开终端，然后让你去别的地方找文件」。它可以在同一个项目工作区里完成浏览、轻量编辑、路径传递和 AI 交互。

六、从 Git 状态辅助，到内置 Git 工作流

AI 改完代码以后，下一步通常不是马上结束，而是看 diff、确认改动、补测试、提交。

0.9 的 Codux 把 Git 工作流也放进了工作区。

Codux 的 Git 面板不是简单显示一个状态图标，而是提供分支、变更、差异、提交历史、推送、拉取、同步等常见操作。

Git 双栏差异预览可以查看新旧文件内容，长行在左右栏内部滚动，不会把整个窗口撑开。文件编辑和 Git diff 能在同一套项目上下文里切换。

这对 AI 编程很重要。

因为 AI 生成的代码必须被检查。Codux 希望把「让 AI 改」和「检查 AI 改了什么」放在同一个工作流里。

七、从只能守在 Mac 前，到移动端接力

初始版本时，Codux 主要还是桌面端工作流。

0.9 最新版已经有了更完整的移动端接力能力。

Codux Mobile 可以与 Mac 主机配对，在手机上远程驱动 AI CLI 会话。真正的项目和终端始终运行在 Mac 上，手机只是远程入口。

这条链路支持端到端加密。终端输入、输出、文件内容、项目列表和 AI 统计在 macOS 与移动端之间加密传输。中继服务只能看到 host ID、device ID、配对状态、在线状态等路由元数据，看不到解密后的终端内容。

0.9 最新工作流里，移动端还可以共享 macOS 端远程终端分屏，浏览、新建、切换、调整尺寸和关闭同一套终端会话。

这让 Codux 的移动端不是一个孤立遥控器，而是 Mac 工作站的延伸。

你离开电脑后，也能继续查看 AI 是否完成、补充下一条提示、处理等待输入的问题。

八、从工具配置，到统一 AI 设置和本地模型

初始版本时，Codux 已经在处理不同 AI 工具的运行状态，但配置还更偏工具层。

0.9 最新版里，AI 相关配置已经统一到更完整的 AI 设置体系中。

你可以在 Codux 里管理 Claude Code、Codex、Gemini CLI、OpenCode 的启动方式，也可以配置 OpenAI 兼容供应商、本地 Llama、模型、Base URL、API Key 和记忆提取用途。

这让 Codux 能同时支持几种使用方式：

• 继续使用本机 AI CLI 默认模型。
• 为特定工具指定启动模型。
• 使用远程 OpenAI 兼容 API 做记忆提取。
• 使用本地 Llama 做记忆提取。
• 为宠物对话选择合适的 LLM 通道。

Codux 不是把所有人锁进某一种模型或某一个供应商，而是尽量把 AI 工具、供应商、记忆提取和本地模型放在同一个设置体系里。

九、从命令行入口，到 SSH 和 IDE 协同

0.9 还补齐了两个很实用的项目入口：SSH 和 IDE。

全局 SSH 右侧栏支持保存服务器连接、新建、编辑、删除和双击连接。保存的 SSH 连接会向终端发送 codux-ssh <profile> 命令，而不是把 expect 脚本整段粘贴进终端。

这让远程连接更像 Codux 的一等能力，而不是临时脚本。

同时，项目打开菜单和侧边栏项目右键菜单现在支持常见 IDE 和编辑器：

• IntelliJ IDEA。
• WebStorm。
• PhpStorm。
• PyCharm。
• GoLand。
• CLion。
• Rider。
• Android Studio。
• Cursor。
• Zed。
• Sublime Text。
• Windsurf。

Codux 不要求你放弃自己习惯的 IDE。

它更像一个项目控制台：你可以在 Codux 里管理 AI 终端、状态、记忆、文件、Git 和远程连接；需要深度编辑时，也可以一键跳到熟悉的 IDE。

初始版本和 0.9 的直接对比

如果把初始版本和 0.9 最新版放在一起看，变化会更直观。

方向	初始版本的 Codux	0.9 最新版的 Codux
产品定位	AI CLI 终端增强工具	围绕项目组织的 AI 编程工作站
终端能力	Ghostty 终端底座，重点解决分屏、浮窗、恢复和切换稳定性	多项目工作区，最多 6 个分屏终端 + 不限 Tab，项目布局和会话状态可恢复
AI 状态	收口实时状态和 token 统计，避免串值和重复计数	运行、等待、完成、失败、权限请求等状态贯穿 Tab、项目、通知、统计和宠物
AI 记忆	还没有完整长期记忆系统	本地 memory.sqlite3，用户 / 项目 / 工具三层记忆，应用私有注入，支持本地 Llama
文件能力	主要围绕终端工作流	项目文件侧栏、CodeMirror 编辑窗口、图片预览、路径拖入终端
Git 能力	基础状态和模块收口	原生 Git 面板、差异预览、提交历史、推送 / 拉取 / 同步
宠物	有成长账本和基础状态，重点保证统计正确	支持 Codex 通用宠物包、Petdex 导入、封存取回、气泡对话、AI 状态联动
移动端	主要是桌面端工作流	Codux Mobile 远程驱动 Mac 端 AI CLI，会话和 payload 端到端加密
远程连接	依赖终端命令	全局 SSH 侧栏，保存连接，双击进入
IDE 协同	主要在 Codux 内部工作	可从项目菜单直接打开 IDEA、WebStorm、Cursor、Zed、Windsurf 等 IDE

这就是 0.9 的核心意义：

Codux 不再只是把 AI CLI 放进一个稳定终端里，而是在围绕项目管理整个 AI 编程过程。

Codux 0.9 的一句话介绍

Codux 是为 AI 编程而生的 macOS 原生工作站。

它基于 SwiftUI + AppKit 构建，集成 Ghostty GPU 终端引擎，专为 Claude Code、Codex、Gemini CLI、OpenCode 等 AI CLI 工具设计。

它提供多项目终端工作区、实时 AI 活动、Token 用量统计、会话恢复、三层 AI 记忆、项目文件管理、内置 Git、移动端接力、SSH 连接、IDE 协同，以及支持 Codex 通用自定义包的编程伙伴。

如果说初始版本的 Codux 是在回答：

「怎样把 AI CLI 终端跑稳？」

那么 0.9 的 Codux 回答的是：

「怎样长期、稳定、可恢复地用 AI 写真实项目？」

为什么这很重要

AI 编程不是一次聊天。

真实项目里，你会反复经历这些动作：

1. 打开项目。
2. 找到相关文件。
3. 让 AI 阅读或修改。
4. 等待 AI 运行。
5. 处理权限或输入请求。
6. 查看 diff。
7. 补测试。
8. 继续追问。
9. 提交代码。
10. 过几天再回来，让 AI 记得之前发生过什么。

如果每一步都散在不同工具里，AI 编程就会变成很多碎片。

Codux 0.9 想做的是把这些碎片收回到项目工作站里。

终端不是孤立的，Git 不是孤立的，文件不是孤立的，宠物也不是孤立的。它们都围绕同一个项目、同一批 AI 会话和同一套长期上下文工作。

接下来

0.9 不是终点，而是 Codux 工作站形态成型的开始。

接下来，Codux 会继续围绕几个方向打磨：

• 更稳定的 AI 运行状态识别。
• 更可控的记忆提取、编辑和注入。
• 更完整的移动端接力体验。
• 更顺手的文件、Git、IDE 协同。
• 更开放的 Codex 通用宠物生态。
• 更低打扰、更有帮助的状态提醒。

如果你已经在用 Claude Code、Codex、Gemini CLI 或 OpenCode 写代码，Codux 0.9 值得重新试一次。

它不是另一个聊天窗口。

它是为 AI 编程准备的 macOS 工作站。

---

官网：codux.dux.cn

GitHub：github.com/duxweb/codu…

下载：github.com/duxweb/codu…

移动端：github.com/duxweb/codu…