文档

一个住在你终端里的 AI 编程智能体。

FuXi 是一个快速、自包含的终端 AI 编程智能体:在丰富的 TUI 中读代码、改文件、运行命令、驱动工具,并在多个 LLM 提供商之间进行成本感知的路由与自动故障转移。FuXi 使用 Go 语言开发,交付为单个静态二进制文件,无运行时依赖。可以把它理解为不绑定单一提供商的 Claude Code 替代方案:接入任意 OpenAI 兼容模型,就能在其上获得 思考 → 行动 → 验证 的智能体循环。

凭借 思考 → 行动 → 验证 的智能体循环与智能路由,任意支持 OpenAPI 的模型都能发挥出高于其原生基准的表现——这一点已在可复现的任务集上与一款主流编码智能体做了对照评测(见 benchmark)。

终端优先 · 不绑定提供商 · 自带密钥 · MCP 客户端 · 自动更新

FUXI 终端演示

亮点

模型只是引擎,FuXi 才是整车。

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

FUXI 单一静态二进制架构
FUXI 请求与执行流程
兼容 OpenAI 的模型接入
  • 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. 1. 安装与自检 —— 安装后先运行 fuxi doctor 验证环境(配置、API Key、git、ripgrep),再运行 fuxi verify 确认与提供商的连接。自检通过是评估的基准线。
  2. 2. 复现一个真实任务 —— 在你自己的项目中挑一个失败的测试,让 FuXi 修复它;随后扩展模块并重新运行测试套件(上方演示动画就是这一流程)。再用日常任务重复几轮:代码审查、提交、PR、重构。
  3. 3. 同条件对比 —— 用完全相同的任务、模型与上下文,让另一款工具执行同样的工作,再比较正确性、工具覆盖、成本与迭代时间。同一起跑线上的对比才公平。

FuXi 提供了对比所需的一切手段 —— TUI 内的 /cost/usage/context/status —— 以及内置的环境自检(fuxi doctor)。未来若公布基准成绩,将在此章节附上链接。

快速上手

FUXI 是一款终端 AI 编程智能体,以单一静态二进制形式发布。无需运行时,无需 Docker,无需配置管理器。

安装

快速安装 (macOS / Linux,Windows PowerShell,Windows CMD)

macOS / Linux

Terminal
curl -fsSL https://downloads.fuxicode.com/bootstrap.sh | bash

Windows (PowerShell)

Terminal
irm https://downloads.fuxicode.com/bootstrap.ps1 / iex

Windows (CMD)

Terminal
curl -fss https://downloads.fuxicode.com/install.cmd -0 "%TEMP%\fuxi-install.cmd" && "%TEMP%\fuxi-install.cmd"

登录即用 · 无需密钥

也可以直接运行FUXI并使用 FUXI 托管路径登录——无需自备任何服务商密钥即可开始。

Terminal
# 启动并登录 / Launch and Loginfuxi

配置参考

配置文件位于 ~/.fuxi/config.yaml。首次运行时FUXI会创建默认配置。

~/.fuxi/config.yaml
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 基础 URL
providers.*.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

~/.fuxi/config.yaml
mcp:
  servers:
    browser:
      transport: stdio
      command: npx @modelcontextprotocol/server-puppeteer
    myapi:
      transport: http
      url: https://my-mcp-server.internal/mcp
      auth: oauth

模型供应商

所有 OpenAI 兼容端点均可通过 openapi 提供商类型接入。

提供商类型说明
Anthropicanthropic原生 Messages API
AWS Bedrockbedrock通过 AWS 凭证接入 Anthropic 模型
Google Vertexvertex通过 GCP 凭证接入 Anthropic 模型
OpenAIopenapi
Azure OpenAIopenapi设置 Azure 端点和部署名称
Google Geminigemini
DeepSeekopenapi
Grok (xAI)openapi
GLM 智谱openapi
Qwen 通义openapi通过阿里云 API 网关
Kimi 月之暗面openapi通过 Moonshot AI 兼容端点

会话与记忆

FUXI将每次会话以 JSONL 格式持久化到磁盘(~/.fuxi/sessions/),崩溃重启后自动恢复,一条消息也不丢失。

·检查点 & 回滚:/checkpoint 手动创建,/rewind [n] 回滚到第 n 个检查点。支持分叉。 ·梦境记忆:FUXI在空闲时跨会话整合记忆,随时间持续成长。 ·自动压缩:上下文接近限制时自动压缩,也可通过 /compact 手动触发。