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"