文档
· 产品详情
一个住在你终端里的 AI 编程智能体。
FuXi 是一个快速、自包含的终端 AI 编程智能体:在丰富的 TUI 中读代码、改文件、运行命令、驱动工具,并在多个 LLM 提供商之间进行成本感知的路由与自动故障转移。FuXi 使用 Go 语言开发,交付为单个静态二进制文件,无运行时依赖。可以把它理解为不绑定单一提供商的 Claude Code 替代方案:接入任意 OpenAI 兼容模型,就能在其上获得 思考 → 行动 → 验证 的智能体循环。
凭借 思考 → 行动 → 验证 的智能体循环与智能路由,任意支持 OpenAPI 的模型都能发挥出高于其原生基准的表现——这一点已在可复现的任务集上与一款主流编码智能体做了对照评测(见 benchmark)。
终端优先 · 不绑定提供商 · 自带密钥 · MCP 客户端 · 自动更新

亮点
模型只是引擎,FuXi 才是整车。
模型单独只能回答问题;FuXi 让它成为真正的工人 —— 推理、在你真实的代码库上行动、验证结果,并且成本可控、尽在你掌握之中。



- 50+ 内置工具 —— 文件读/写/改、shell(
bash/ PowerShell)、ripgrep 搜索、网页抓取、LSP 诊断、Jupyter、浏览器控制、后台任务,以及并行子智能体 —— 全部装在一个二进制里。 - 安全护栏 —— shell 命令在执行前会经过 AST 安全分类器;细粒度权限和审计日志让自主执行始终处于你的掌控中。
- 持久会话与记忆 —— 会话记录持久化到磁盘;检查点支持恢复、回滚或分叉;空闲期“梦境”整理跨会话整合记忆;长对话自动压缩以节省 token。
- 自带密钥,或直接登录 —— 任意提供商 API Key(OpenAPI 兼容、Gemini、Bedrock/Vertex),或通过 FuXi OAuth 登录。
- 可扩展 —— MCP 客户端、hooks、skills、plugins 与斜杠命令,全部支持热重载。
- 永久免费 —— 单个静态二进制,无运行时依赖,个人、团队、企业均无需许可费用。
- 自动更新 —— 后台版本检查加一条
fuxi update,替换二进制前先做校验和验证。
同类产品对比
FuXi 是一个终端优先、设计上不绑定任何单一提供商的 AI 编程智能体。能力对照基于各产品官方公开定位(2026 年中);产品迭代很快,请将其作为定位参考。
实测对比

两个系统各自通过原生客户端、在相同 baseline 与相同客观评分工具(pytest + coverage)下,于 15 个微观维度与 4 个大型项目维度上进行对比。完整方法、原始数据、环境版本、具体命令与已知局限都记录在 benchmark/REPORT.zh-CN.md,可供核实或自行复现。
坦率说明:这是一套自测的小规模任务集,并非第三方基准,且衡量的是智能体循环而非模型裸分。请把它当作一个参考数据点,而非结论性标题。
评估与基准
FuXi 以可复现、可自行验证的评估为原则。目前它尚未在第三方基准(如 SWE-bench、Terminal-Bench、Aider polyglot 等)上公布官方分数;我们更愿意提供可自行操作的评估方法,而不是一个孤立的数字。下面是在你自己的项目上评估 FuXi 的方法:
一份可操作的评估清单
- 1. 安装与自检 —— 安装后先运行
fuxi doctor验证环境(配置、API Key、git、ripgrep),再运行fuxi verify确认与提供商的连接。自检通过是评估的基准线。 - 2. 复现一个真实任务 —— 在你自己的项目中挑一个失败的测试,让 FuXi 修复它;随后扩展模块并重新运行测试套件(上方演示动画就是这一流程)。再用日常任务重复几轮:代码审查、提交、PR、重构。
- 3. 同条件对比 —— 用完全相同的任务、模型与上下文,让另一款工具执行同样的工作,再比较正确性、工具覆盖、成本与迭代时间。同一起跑线上的对比才公平。
FuXi 提供了对比所需的一切手段 —— TUI 内的 /cost、/usage、/context、/status —— 以及内置的环境自检(fuxi doctor)。未来若公布基准成绩,将在此章节附上链接。
· 入门
快速上手
FUXI 是一款终端 AI 编程智能体,以单一静态二进制形式发布。无需运行时,无需 Docker,无需配置管理器。
安装
快速安装 (macOS / Linux,Windows PowerShell,Windows CMD)
macOS / Linux
curl -fsSL https://downloads.fuxicode.com/bootstrap.sh | bashWindows (PowerShell)
irm https://downloads.fuxicode.com/bootstrap.ps1 / iexWindows (CMD)
curl -fss https://downloads.fuxicode.com/install.cmd -0 "%TEMP%\fuxi-install.cmd" && "%TEMP%\fuxi-install.cmd"登录即用 · 无需密钥
也可以直接运行FUXI并使用 FUXI 托管路径登录——无需自备任何服务商密钥即可开始。
# 启动并登录 / Launch and Loginfuxi配置参考
配置文件位于 ~/.fuxi/config.yaml。首次运行时FUXI会创建默认配置。
provider: openapi
providers:
openapi:
base_url: https://your-endpoint/v1
api_key: <your-key>
models:
- glm-4.6
# Optional: cost-aware routing tiers
routing:
fast: glm-4-flash
primary: glm-4.6
reason: deepseek-r1配置字段参考
providerstring默认提供商 ID(须在 providers 中定义)providers.*.base_urlstringOpenAI 兼容 API 基础 URLproviders.*.api_keystringAPI 密钥(也可通过环境变量设置)providers.*.models[]string此提供商可用的模型列表routing.faststringFree/Cheap 分级使用的快速模型routing.primarystringStandard 分级的主要模型routing.reasonstringPremium/推理分级的推理模型启动与 TUI
直接运行 fuxi 进入交互式 TUI(基于 charm/bubbletea 构建)。FUXI为纯 TUI 模式——无 CLI 子命令,所有操作通过斜杠命令完成。
·配置目录:~/.fuxi/
·会话转录:~/.fuxi/sessions/
·插件目录:~/.fuxi/plugins/
·主配置:~/.fuxi/config.yaml
· 参考
斜杠命令
在 TUI 中输入 / 触发命令。以下为内置斜杠命令;可在配置中自定义添加。
/model [name]在会话中切换模型或提供商,无需重启。省略参数时列出可用模型。/config [key] [val]查看或修改运行时配置。省略 val 以读取当前值。/compact压缩当前上下文,保留关键信息,大幅降低 token 成本。/checkpoint手动创建会话检查点。/rewind [n]回滚到第 n 个检查点(默认:上一个)。/resume [id]恢复之前的会话。省略 id 时列出可用会话。/team [n]启动 n 个协调并行子智能体(蜂群模式)。/tools列出当前会话可用的所有工具(含 MCP 工具)。/mcp [server]连接或断开 MCP 服务器。省略参数时列出已连接服务器。工具参考
FUXI内置 50+ 工具,以下为核心工具列表。MCP 工具在连接后动态加入。
read_file文件系统读取文件内容,支持行范围、偏移参数。write_file文件系统写入文件(新建或覆盖)。edit_file文件系统对文件应用精确的字符串替换补丁。bashShell执行 Bash 命令,经 27 条规则 + AST 安全分类器过滤。powershellShell在 Windows 上执行 PowerShell 命令。web_fetch网络抓取 URL 内容,含 SSRF 防护(屏蔽私有地址段)。web_search网络执行网络搜索并返回摘要结果。ripgrep_search搜索使用 ripgrep 在代码库中进行正则搜索。lsp_diagnostics代码获取文件的 LSP 错误和警告诊断信息。jupyter_run高级在 Jupyter 内核中执行代码单元格并返回输出。spawn_subagent高级在独立上下文中启动子智能体,用于并行执行任务。mcp_callMCP调用已连接 MCP 服务器上的工具。生命周期钩子
FUXI提供 27 个生命周期钩子,可在会话、工具调用、模型路由等精确时机注入自定义逻辑。钩子在 ~/.fuxi/hooks/ 目录下以 YAML 定义。
session.start新会话启动时session.end会话正常结束时session.resume从检查点恢复会话时tool.before任意工具调用执行前tool.after工具调用成功完成后tool.error工具调用抛出错误时model.switch路由切换到不同模型时model.failover触发故障转移时context.compact上下文压缩完成后memory.dream梦境记忆整合完成后……共 27 个钩子事件,详见 GitHub 文档
· 集成
MCP 服务器
FUXI是完整的 MCP 客户端,支持 stdio、HTTP 和 WebSocket 传输,以及 OAuth 认证。连接后,MCP 服务器的工具立即在当前会话中可用。
在 config.yaml 中配置 MCP
mcp:
servers:
browser:
transport: stdio
command: npx @modelcontextprotocol/server-puppeteer
myapi:
transport: http
url: https://my-mcp-server.internal/mcp
auth: oauth模型供应商
所有 OpenAI 兼容端点均可通过 openapi 提供商类型接入。
会话与记忆
FUXI将每次会话以 JSONL 格式持久化到磁盘(~/.fuxi/sessions/),崩溃重启后自动恢复,一条消息也不丢失。
·检查点 & 回滚:/checkpoint 手动创建,/rewind [n] 回滚到第 n 个检查点。支持分叉。 ·梦境记忆:FUXI在空闲时跨会话整合记忆,随时间持续成长。 ·自动压缩:上下文接近限制时自动压缩,也可通过 /compact 手动触发。
