CodeNomad：OpenCode AI 编程驾驶舱

项目简介

CodeNomad 是面向 OpenCode V2 的桌面与浏览器工作区，适合同时处理多个项目、长对话和 Git worktree 的开发者。它连接 OpenCode 的共享后台服务，让会话可在 CodeNomad 和兼容终端客户端中访问。

主要功能

• 多项目窗口：同时打开多个项目，按窗口保留标签、草稿、附件和视图。
• 会话导航：浏览嵌套会话、分叉对话，搜索未加载消息，并用时间线跳转长历史。
• Git worktree：创建和选择 worktree，移动会话及其子会话，查看 Git 变更。
• 对话与文件：支持 Markdown、代码、diff、工具结果图片；可粘贴或拖入文件，用 @ 引用项目文件。
• 远程访问：浏览器或桌面客户端可连接服务器，支持密码认证和 HTTPS；Remote Control 可通过 OpenTunnel 中继配对设备，无需开放端口。
• 工具与预览：管理 MCP 连接和插件，监控后台 shell，将 Web 工具作为 SideCars 打开；Electron 和 Windows Tauri 支持 Agent 驱动的浏览器预览。
• 易用界面：命令面板、通知、可定制面板、独立明暗配色、多语言，以及语音输入和朗读。

安装与使用

桌面版提供 Electron 和 Tauri 构建，可从下载页或 Releases 获取。macOS 提供 Intel 与 Apple Silicon 的 ZIP；Windows 提供 Electron ZIP 和 Tauri 安装程序；Linux 提供 deb 和 AppImage（均为 x64）。

Linux 示例：

sudo apt install ./CodeNomad-Electron-linux-x64-<version>.deb
chmod +x CodeNomad-Tauri-linux-x64-<version>.AppImage
./CodeNomad-Tauri-linux-x64-<version>.AppImage

桌面版内置 Node.js 和 npm。首次启动时选择已有的兼容 OpenCode 可执行文件，或通过设置界面安装。之后打开项目文件夹、连接模型提供商并开始会话。

也可在本机运行服务器并通过浏览器访问：

npx @neuralnomads/codenomad --password "your-password" --launch

服务器默认绑定 127.0.0.1；远程访问需加 --host 0.0.0.0 并连接输出的 HTTPS 地址。首次使用 HTTPS 会生成自签名证书，浏览器警告属于预期；仅本地使用可加 --https=false --http=true。

注意事项

• 需要 OpenCode V2，最低 2.2.3，推荐 2.2.5；不支持 OpenCode V1 和旧版 V2 beta 协议。
• Git 是仓库操作和 worktree 的前提，必须位于 CodeNomad 后端的 PATH；没有 Git 时仍可以目录模式打开文件夹并与代理对话。
• 独立服务器需要 Node.js/npm 和 OpenCode V2，推荐 Node.js 24 LTS。Linux 构建目前在 Ubuntu 24.04 上测试，旧发行版兼容性未保证。
• 会话由共享 OpenCode 服务管理，关闭 CodeNomad 标签、窗口或后端不会停止该服务；更新 CLI 与重启服务是两个独立操作。
• SideCar 拥有与 CodeNomad 相同的访问权限，只应添加可信服务。

---

本作品整理自 GitHub 开源项目 NeuralNomadsAI/CodeNomad，原作者 @NeuralNomadsAI，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。