Clodex IDE - 本地优先的零信任 AI 代理开发环境

解决什么

传统 AI 编码工具(如 Cursor、GitHub Copilot)将对话视为一次性交互,每次重启都需重建上下文。Clodex IDE 重新定义 AI 辅助开发流程:将"理解代码库 → 规划变更 → 多文件编辑 → 执行命令 → 检查应用 → 审查差异 → 从失败恢复 → 明天继续"这一完整工程周期视为持久化任务(durable task),而非抛弃式聊天记录。所有代码、Git 操作、终端会话、浏览器状态和 AI 模型交互都保留在同一工作空间中,支持跨会话恢复和审计。

为何火

项目在 18 天内获得 862 stars,核心吸引力在于三点:1) 零信任架构 - 敏感操作(如文件修改、Git 提交)需显式审批,模型输出被视为"输入而非权威";2) 本地优先 - 支持完全离线使用 Ollama 本地模型,数据不强制上云;3) 工具整合 - 将 VSCode 式编辑器、终端、浏览器、Git 客户端和 MCP(Model Context Protocol)工具链融入单一 Electron 桌面应用,避免工具切换割裂。HN 社区讨论虽少(2 点赞 1 评论),但已有用户关注其 Community Observed 21 技术预览版的发布和 issue 追踪。

核心功能

• 持久化任务工作空间:保留任务历史、待处理编辑(Pending Edits)、行级差异对比和跨会话恢复能力
• 多模型接入:支持 Clodex 账户、自带 API Key、OpenAI 兼容端点或本地 Ollama
• MCP 工具生态:用户可配置 stdio/远程 MCP 服务器,支持 HTTP/SSE 传输、OAuth 流程和工具审批
• 内置开发环境:持久化本地 Shell 会话、端口监听、嵌入式浏览器(含控制台检查和截图)
• Git 深度集成:支持 worktree、本地提交和 Pull Request 审查工作流
• 审批机制:敏感操作(如文件写入、命令执行)需用户显式确认,所有历史可追溯

安装

预编译版本(当前为 v1.16.0-communityobserved21 技术预览):

• 从 GitHub Releases 下载对应平台包(macOS/Windows/Linux)
• ⚠️ 当前版本未签名/未公证,macOS 需右键打开或执行 xattr -cr 命令

源码构建:

# 需 Node.js 22.23.1 + pnpm 10.30.3
git clone https://github.com/mereyabdenbekuly-ctrl/clodex-ide.git
cd clodex-ide
pnpm install
pnpm run dev  # 开发模式
pnpm run package  # 打包桌面应用

配置 .env 文件可自定义认证端点、API 地址和模型中继服务。

适合谁

• 需长周期 AI 协作的工程师:适合跨天迭代的复杂任务(如重构、多模块变更),而非快速一次性代码生成
• 隐私敏感用户:可完全使用本地 Ollama 模型,无需将代码上传云端
• 工具整合需求者:希望在单一界面完成编码、测试、Git 操作和浏览器调试的开发者
• 开源贡献者:AGPL-3.0 协议要求衍生项目开源,适合构建社区驱动的 AI 开发工具生态

不适合:轻度代码补全需求(VSCode Copilot 更轻量)、需商业闭源集成(协议限制)、追求极简体验的用户(Electron 应用体积较大)。

社区评价

HN 讨论热度较低(2 点赞 1 评论),唯一评论指向 Community Observed 21 版本发布和 GitHub issues,显示项目仍处早期推广阶段。基于项目本身的中立评估:

正面:

• 技术架构清晰,公开了构建流水线(Actions run 30483341383)和源码提交哈希,符合"可验证构建"承诺
• 文档详尽,包含俄语版说明和安全数据处理文档
• 支持多种模型接入方式,避免供应商锁定

争议点:

• 默认依赖 clodex.xyz 云服务(认证、模型中继),虽可自托管但配置门槛较高
• 未签名/未公证的桌面应用在 macOS/Windows 上需手动绕过安全警告
• 18 天仓龄且无正式 release,生产稳定性待验证

选型对比

维度	Clodex IDE	Cursor	GitHub Copilot Workspace
开源性	AGPL-3.0 全开源	闭源商业	闭源商业
本地模型	支持 Ollama	不支持	不支持
持久化任务	原生支持跨会话恢复	依赖聊天历史	依赖云端 Workspace
审批机制	内置敏感操作审批	无	无
工具整合	终端+浏览器+Git 一体	主要为编辑器	主要为代码生成
商业支持	社区驱动	企业级 SLA	GitHub 官方支持

取舍:Clodex 适合需完全控制数据流和工具链的团队,但牺牲了商业工具的开箱即用体验和云端协作能力;Cursor/Copilot Workspace 更适合快速迭代和团队协作,但无法离线或自托管。

已知坑

1. 未签名应用:macOS 需执行 sudo xattr -cr /Applications/Clodex.app,Windows 可能触发 SmartScreen 警告
2. 网络依赖:默认配置需访问 clodex.xyz(认证和模型中继),中国大陆用户可能需配置代理或完全切换到本地 Ollama
3. AGPL 协议限制:若基于 Clodex 开发闭源 SaaS 服务,需联系作者获取商业授权或开源衍生代码
4. 技术预览阶段:Community Observed 21 版本仍标注为"Technical Preview",可能存在稳定性问题和 API 变更
5. Electron 体积:桌面应用安装包通常超过 200MB,不适合资源受限环境
6. MCP 工具配置:需手动编写 JSON 配置文件连接外部 MCP 服务器,无图形化配置界面

数据来源: GitHub 仓库 + HN 讨论 "Clodex – Open-source agentic IDE with governed execution and graph memory"