FuXi：终端里的 AI 编程助手

项目简介

FuXi 是一款快速、自包含的终端 AI 编程助手。它可以在富文本 TUI 里阅读代码、编辑文件、执行命令并驱动工具，同时支持在多个 LLM 供应商之间进行成本感知的路由与自动故障转移。

项目使用 Go 构建，以单个静态二进制文件分发，无运行时依赖。它秉持终端优先、供应商无关、自带密钥、MCP 客户端、自动更新的设计理念。

FuXi 约 200 万行代码全部由 FuXi 自身编写。

官网：https://www.fuxicode.com

主要功能

• 终端工作流：在终端 TUI 中直接读代码、改文件、跑命令、调用工具，无需切换编辑器。
• 多模型路由：内置成本感知的模型路由与自动故障转移，可跨不同 LLM 供应商使用。
• 自带密钥：除 FuXi 托管模型外，也可通过环境变量或 ~/.fuxi/config.yaml 配置自己的供应商 API Key。
• MCP 客户端：可接入 MCP 工具生态。
• 会话与持久化：会话、检查点、记忆与审计日志均保存在本地设备上。
• 权限控制：敏感工具调用默认需要确认，可切换权限模式。
• 自更新：安装与升级使用同一条命令。

安装与使用

安装

macOS / Linux

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

Windows（PowerShell）

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

Windows（CMD）

curl -fsSL https://downloads.fuxicode.com/install.cmd -o "%TEMP%\fuxi-install.cmd" && "%TEMP%\fuxi-install.cmd"

安装后验证并启动：

fuxi --version
fuxi doctor    # 环境检查
fuxi           # 启动会话

快速开始

使用需要 FuXi 账号。运行 fuxi 后：

1. 注册并登录——fuxi login（无头/CI 环境可用 fuxi setup-token）。
2. 连接模型（可选）——登录后即可使用 FuXi 托管模型；若想使用自己的供应商，通过环境变量或 ~/.fuxi/config.yaml 设置 API Key（fuxi init 可生成模板），也可以运行 fuxi wizard。

然后输入提示词并回车，例如：

Fix the failing tests in this repository.

常用命令：/model 切换模型 · /help 查看全部命令 · /config 打开设置 · /privacy-settings 隐私控制 · /exit 退出。

权限选项

• --dangerously-skip-permissions：以 bypassPermissions 模式启动，工具调用不再弹出确认；rm -rf / 之类的极端命令仍会被拦截。仅建议在容器或虚拟机中使用，Linux 与 macOS 上会拒绝 root 和 sudo。
• --allow-dangerously-skip-permissions：保持普通模式，仅把 bypassPermissions 加入 Shift+Tab 切换循环。
• --permission-mode bypassPermissions：效果等同 --dangerously-skip-permissions；该参数也接受 default 和 plan。

注意事项

• 数据与隐私：默认情况下，代码与会话不会被 FuXi 收集、存储或保留。使用自有密钥时内容直接发送给你选择的供应商；使用 FuXi 托管模型时仅用于完成该次请求。只有在显式开启 send_conversations（默认关闭）时，会话内容才会发送给 FuXi。凭据保存在本地 ~/.fuxi/，不会上传。
• 会话、检查点、记忆与审计日志都存放在本机，删除配置目录即可清除。
• 本项目面向开发者与专业用户，不面向 14 岁以下儿童；14–17 岁用户需监护人同意。
• 产品源码为专有软件，仓库主要托管文档、安装脚本与 issue 跟踪；许可证为 Proprietary。

---

本作品整理自 GitHub 开源项目 fuxicodex/Fuxi，原作者 @fuxicodex。中文介绍由 AI 根据项目 README 整理，以原仓库为准。