FuXi - 终端里的 AI 编程助手

解决什么

开发者在终端写代码时常需 AI 辅助,但 Claude Code 等商业工具绑定单一模型且成本不透明。FuXi 提供一个终端原生的 AI 编程代理,支持任意 OpenAI 兼容接口(包括 Gemini、Bedrock),通过"思考→行动→验证"循环自动读写代码、执行命令、调用工具,并根据任务复杂度智能路由到不同模型以控制成本。整个系统打包为一个 Go 静态二进制,无需 Python/Node 运行时,安装即用。

为何火

1. 对标 Claude Code 但更开放:不锁定单一模型,用户可接入自己的 API Key,成本透明可控
2. 终端 TUI 交互体验:富文本界面实时显示思考过程、工具调用和成本统计,开发者无需离开命令行
3. 内置 50+ 工具与安全沙箱:文件编辑、ripgrep 搜索、LSP 诊断、Jupyter、浏览器自动化、并行子代理等开箱即用,Shell 命令经 AST 安全分类器审查后执行
4. 会话持久化与记忆:对话自动存盘,支持断点恢复、回滚或分支;闲置时"做梦"压缩长期记忆,长对话自动精简以节省 token
5. 自更新与零依赖:一条命令升级,校验和验证后原地替换二进制,无需 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 更合适。

已知坑

1. License 不明:NOASSERTION 状态意味着商用风险未知,建议等待官方明确协议或联系作者确认
2. 中国网络:所有主流 LLM API(OpenAI/Anthropic/Google)需梯子,或需自行对接国内兼容接口
3. Benchmark 局限:README 中的对比测试为自测小规模任务集,非 SWE-bench 等权威基准,作者已注明"not a third-party benchmark"
4. Windows 兼容性:PowerShell 脚本需执行策略允许,CMD 脚本需手动下载;部分 Shell 工具(如 ripgrep)需单独安装
5. MCP 生态:Model Context Protocol 仍处早期,第三方插件数量有限,需自行开发或等待社区补充
6. 内存占用:会话持久化和"做梦"功能会在后台消耗资源,长时间运行需监控磁盘和内存

来源: GitHub fuxicodex/Fuxi + HN 讨论(注意同名项目混淆)