FuXi - 終端裡的 AI 程式設計助手
fuxicodex/Fuxi
自包含的終端 AI 程式設計代理,支援多模型智慧路由、成本感知與自動容錯,一個二進位制檔案搞定程式碼編輯、命令執行和工具呼叫
成熟度:維護活躍,最近提交 10 天前,open issues 僅 1 個,已釋出 0.1.2 版本
项目体检
活跃 · 最新版本 0.1.2 于 2026-08-06 发布,10 天前仍有提交,3 位贡献者,活跃度良好
解決什麼
開發者在終端寫程式碼時常需 AI 輔助,但 Claude Code 等商業工具繫結單一模型且成本不透明。FuXi 提供一個終端原生的 AI 程式設計代理,支援任意 OpenAI 相容介面(包括 Gemini、Bedrock),通過"思考→行動→驗證"迴圈自動讀寫程式碼、執行命令、呼叫工具,並根據任務複雜度智慧路由到不同模型以控制成本。整個系統打包為一個 Go 靜態二進位制,無需 Python/Node 執行時,安裝即用。
為何火
- 對標 Claude Code 但更開放:不鎖定單一模型,使用者可接入自己的 API Key,成本透明可控
- 終端 TUI 互動體驗:富文本介面即時顯示思考過程、工具呼叫和成本統計,開發者無需離開命令列
- 內建 50+ 工具與安全沙箱:檔案編輯、ripgrep 搜尋、LSP 診斷、Jupyter、瀏覽器自動化、並行子代理等開箱即用,Shell 命令經 AST 安全分類器審查後執行
- 會話持久化與記憶:對話自動存檔,支援斷點恢復、回滾或分支;閒置時"做夢"壓縮長期記憶,長對話自動精簡以節省 token
- 自更新與零依賴:一條命令升級,校驗和驗證後原地替換二進位制,無需 Docker 或包管理器
核心功能
- 智慧模型路由:根據任務型別(簡單編輯/複雜重構)自動選擇低成本或高效能模型,失敗時自動切換備用 provider
- Think→Act→Verify 迴圈:先推理計劃,再呼叫工具執行,最後驗證結果(如執行測試),形成閉環迭代
- MCP 客戶端:相容 Model Context Protocol,可熱載入外部外掛、技能和 slash 命令
- 審計與許可權:細粒度工具許可權控制,所有自主操作記錄日誌,Shell 命令需通過安全檢查
- 成本監控:TUI 內即時顯示
/cost和/usage,每次呼叫的 token 消耗一目瞭然 - 跨平臺:macOS/Linux/Windows 均為單檔案安裝,Windows 支援 PowerShell 和 CMD 指令碼
安裝
macOS/Linux:
curl -fsSL https://releases.fuxicode.com/bootstrap.sh | bash
fuxi --version
fuxi doctor # 環境自檢
Windows PowerShell:
irm https://releases.fuxicode.com/bootstrap.ps1 | iex
安裝到 ~/.local/bin 並自動加入 PATH,升級時重新執行相同命令即可。首次啟動 fuxi 後需配置 API Key(支援 OpenAI/Gemini/Bedrock 等),或通過 FuXi OAuth 登入。
適合誰
- 多雲 LLM 使用者:已有多個模型 API Key,希望根據任務自動選擇最優價效比
- 終端重度使用者:習慣 Vim/Tmux 工作流,不想切到 IDE 或 Web 介面
- 成本敏感團隊:需要透明的 token 消耗統計和成本控制,避免黑盒計費
- 安全合規場景:要求程式碼不離開本地,所有 AI 互動經審計日誌可追溯
- 中國開發者注意:需自備梯子訪問 OpenAI/Anthropic API,或使用國內相容介面(如阿里雲百鍊、智譜 GLM);FuXi 本身無網路限制,純本地執行
社群評價
HN 上有一則 3 點討論提到"Fuxi: I Ching divination with GPT-4",但該討論實為同名的易經占卜專案(使用三枚硬幣生成卦象),與本程式設計工具無關。真正的 FuXi 程式設計助手尚未在 HN 獲得足量公開討論。
基於專案本身的中立評估:
- 正面:3190 stars 快速增長(僅 19 天),README 詳盡含架構圖和 benchmark 報告,自建對比測試(vs Claude Code)透明度高,Go 單檔案部署對運維友好
- 爭議點:License 標記為 NOASSERTION(未明確開源協議),README 聲稱"Free forever"但商用條款不清晰;benchmark 為自測資料非第三方權威(作者已註明"treat it as a data point, not a headline")
- 技術亮點:內建 AST 安全分類器、會話持久化、MCP 擴充套件性、成本路由等設計在同類工具中較少見
選型對比
| 維度 | FuXi | Claude Code | Cursor/Copilot |
|---|---|---|---|
| 模型繫結 | 任意 OpenAI 相容介面 | 僅 Claude 系列 | 繫結各自模型 |
| 成本透明 | TUI 即時顯示 token 消耗 | 訂閱制黑盒 | 訂閱制或按 token |
| 本地執行 | 完全本地,無需服務端 | 需聯網呼叫 API | 需聯網 |
| 工具生態 | 50+ 內建工具 + MCP 擴充套件 | 工具集較少 | IDE 外掛生態 |
| 安全審計 | Shell 命令 AST 檢查 + 日誌 | 無公開細節 | 依賴 IDE 沙箱 |
| 適用場景 | 終端重度使用者、多雲環境 | Claude 深度使用者 | IDE 內編碼輔助 |
取捨:FuXi 犧牲了 IDE 深度整合(如 Cursor 的內聯補全),換取終端原生體驗和模型靈活性;若團隊已重度依賴 Claude 且不在意成本,Claude Code 更省心;若需 IDE 內無縫協作,Cursor 更合適。
已知坑
- License 不明:NOASSERTION 狀態意味著商用風險未知,建議等待官方明確協議或聯絡作者確認
- 中國網路:所有主流 LLM API(OpenAI/Anthropic/Google)需梯子,或需自行對接國內相容介面
- Benchmark 侷限:README 中的對比測試為自測小規模任務集,非 SWE-bench 等權威基準,作者已註明"not a third-party benchmark"
- Windows 相容性:PowerShell 指令碼需執行策略允許,CMD 指令碼需手動下載;部分 Shell 工具(如 ripgrep)需單獨安裝
- MCP 生態:Model Context Protocol 仍處早期,第三方外掛數量有限,需自行開發或等待社群補充
- 記憶體佔用:會話持久化和"做夢"功能會在後臺消耗資源,長時間執行需監控磁碟和記憶體
來源: GitHub fuxicodex/Fuxi + HN 討論(注意同名專案混淆)
安装方式:curl 脚本一键安装(静态二进制)