FuXi

一个住在你终端里的AI编程代理。 代号 YiHuaKaiTian ——“一画开天”。

FuXi是一个快速、自包含的AI开发者终端——一个你通过丰富的TUI驱动的编程代理。它能阅读你的代码库、编辑文件、运行命令、驱动工具，并通过成本感知路由和自动故障转移将每个请求分发到多个LLM提供商。它用Go编写，以单个静态二进制文件发布，无运行时依赖。

主页：https://www.fuxicode.com

亮点

多LLM路由 —— 一个代理，多家提供商。一流支持：
- Anthropic（原生Messages API）以及AWS Bedrock / Google Vertex上的Anthropic
- OpenAI兼容端点（OpenAI、Azure OpenAI以及任何OpenAI风格的API）
- Google Gemini
- 通过OpenAI兼容端点接入流行的开源/中国托管模型 —— GLM、DeepSeek、Qwen、Hunyuan、Doubao、Ernie、Grok (xAI) 等
智能层 —— 成本感知路由、自动故障转移到健康提供商、可选的竞赛机制（主备竞速），以及从配置解析的基于角色的模型层级（快速/主要/推理）。
深度工具套件 —— 文件读取/编辑/写入、Shell（bash/PowerShell）带安全分类器、网页抓取、代码搜索、基于LSP的诊断、Jupyter笔记本、通过MCP的计算机/浏览器使用、后台任务，以及并行的子代理。
MCP客户端 —— 连接任何Model Context Protocol服务器（stdio、HTTP或WebSocket），其工具即可供代理使用。
可扩展 —— 钩子、技能、插件和用户定义的斜杠命令。
持久会话 —— 持久化记录、检查点/恢复、空闲“梦境”记忆，以及长对话的自动上下文压缩。
自带密钥，或登录 —— 使用提供商API密钥，或通过FuXi OAuth登录。FuXi托管路径永远不需要密钥。
自我更新 —— 后台版本检查和一条命令的fuxi update保持安装最新，替换运行中二进制之前会进行校验和验证。

安装

macOS / Linux

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

Windows (PowerShell)

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

Windows (CMD)

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

这三种方式都安装到~/.local/bin（Windows上为%USERPROFILE%\.local\bin），如果尚未添加，则将其加入用户PATH。之后再次运行同样的命令即可就地升级现有安装——安装和升级是同一命令。

默认安装最新版本；可通过参数锁定特定版本，例如./bootstrap.sh 2.202.194或./bootstrap.ps1 2.202.194。

从源码构建

需要Go 1.26+：

git clone <此仓库>
cd fuxi
go build -o fuxi ./cmd/fuxi

验证安装

fuxi --version
fuxi doctor      # 环境健全性检查（配置、API密钥、git、ripgrep、...）

卸载

# macOS / Linux
rm -f "$HOME/.local/bin/fuxi"
rm -rf "$HOME/.fuxi"   # 可选：同时删除配置/状态

# Windows (PowerShell)
Remove-Item -Force "$env:USERPROFILE\.local\bin\fuxi.exe"
Remove-Item -Recurse -Force "$env:USERPROFILE\.fuxi"   # 可选

快速上手

启动TUI：

fuxi

首次运行时，FuXi会在~/.fuxi/下创建配置。你需要一个模型来对话，通过以下两种路径之一：

登录 —— fuxi login打开浏览器，通过FuXi账户认证，自动配置FuXi托管的模型。无需API密钥。
自带密钥 —— 通过环境变量设置提供商API密钥，或直接写~/.fuxi/config.yaml（fuxi init生成起始模板，并自动从已设置的环境变量中检测提供商）：
```
provider: openapi
base_url: https://your-endpoint/v1
api_key: <your-key>       # 或改用 export FUXI_API_KEY
model: glm-4.6
```
想管理多个提供商/模型而不是单个？使用分层模式——providers:目录加上model:选择层：
```
providers:
  custom:
    type: openapi
    base_url: https://your-endpoint/v1
    api_key: <your-key>
    models:
      - id: deepseek-v4-pro-260425
        model_canonical_name: deepseek-v4-pro   # 可选：用于能力查找
model:
  active: { provider: custom, id: deepseek-v4-pro-260425 }
```
完整分层模式见config.full.example.yaml（多提供商、按模型的能力覆盖、路由角色）。
或者运行fuxi wizard进行交互式设置流程（选择提供商、输入base URL/密钥、选择模型、测试连接）。

配置好模型后，随时用/model选择它，用/config管理其余设置——所有内容（权限、钩子、技能、插件）都在TUI内通过斜杠命令驱动。

使用指南

命令行标志

启动fuxi时最常用的标志：

标志	用途
`-m, --model <name>`	覆盖本次运行的模型
`-k, --api-key <key>`	覆盖本次运行的API密钥
`-b, --base-url <url>`	覆盖base URL（启用OpenAPI提供商）
`-P, --provider <type>`	提供商类型：`anthropic` \| `openapi`
`-r, --resume <sessionId>`	恢复某个过去的对话
`-c, --continue`	继续此目录中最近的对话
`-d, --dir <path>`	工作目录
`--permission-mode <mode>`	`default` \| `plan` \| `bypassPermissions`
`--auto`	自动批准安全的工具调用（分类器门控，带熔断器）
`--dangerously-skip-permissions`	跳过所有权限检查（谨慎使用）
`--worktree`	为本次会话创建git worktree
`--thinking <mode>`	`enabled` \| `adaptive` \| `disabled`
`--mcp-config <configs...>`	从JSON字符串或文件路径加载MCP服务器
`--status`	打印解析后的提供商状态并退出
`--config`	打印解析后的配置并退出
`--debug [pattern]`	启用调试日志，可按标签过滤
`-v, --version` / `-h, --help`	版本 / 完整标志与命令参考

运行fuxi --help获取完整列表（还有更多——采样控制、工具限制、系统提示覆盖、钩子触发器和swarm/代理标志）。

子命令

命令	作用
`fuxi`	启动交互式TUI（同`fuxi tui`）
`fuxi login`	登录FuXi账户并配置凭据
`fuxi setup-token`	登录并打印用于`FUXI_OAUTH_TOKEN`的令牌（无头/CI）
`fuxi wizard`	交互式设置向导：提供商、base URL、密钥、模型、连接测试
`fuxi init [--force]`	生成`~/.fuxi/config.yaml`模板
`fuxi doctor`	诊断环境（配置、密钥、git、ripgrep、环境覆盖）
`fuxi verify`	验证与已配置提供商的连接
`fuxi info`	显示解析后的提供商和模型信息
`fuxi update [version]`	下载、校验和验证并安装新版本
`fuxi agents`	列出按来源分组的已配置代理
`fuxi proxy`	启动本地Anthropic↔OpenAI智能路由代理
`fuxi launch [args]`	通过代理启动另一个工具，使用FuXi配置
`fuxi mcp serve`	将FuXi本身作为MCP stdio服务器运行
`fuxi remote-control`	作为云远程控制worker运行（`--remote-control`的别名）

TUI内斜杠命令

输入/并按Enter（或Tab自动补全）浏览所有命令。要点：

命令	作用
`/help`, `/commands`, `/menu`	显示或搜索所有命令
`/model`	切换当前模型
`/config`	打开配置
`/status`	显示提供商状态
`/context`	显示当前上下文窗口使用情况
`/cost`, `/usage`	会话成本 / 计划使用限制
`/compact`	压缩对话历史以释放上下文
`/clear`	清空对话
`/history`, `/resume`	浏览或恢复过去的会话/检查点
`/tools`	列出可用工具
`/permissions`	显示当前权限配置
`/memory`	显示项目记忆文件
`/fork`	显示子代理（fork）统计
`/commit`	创建git提交
`/review`	审查代码 / 打开PR
`/doctor`	运行诊断检查
`/copy`, `/paste`	复制上一条回复 / 将剪贴板文本作为下一条提示发送
`/exit`	退出

键盘： /然后Enter打开命令浏览器 · Tab自动补全斜杠命令 · Ctrl+R搜索提示历史 · 支持终端粘贴/括号粘贴以处理大段粘贴。

更新

FuXi在后台检查新版本，并在有可用版本时打印一行通知。就地更新：

fuxi update            # 最新
fuxi update 2.203.0    # 特定版本

fuxi update下载目标构建，对照已发布的清单验证其SHA-256，并原子替换运行中的二进制——绝不会留下部分安装的版本。用--no-update-notifier或NO_UPDATE_NOTIFIER=1禁止后台检查。

配置

配置目录： ~/.fuxi/（用FUXI_CONFIG_DIR覆盖）。
配置文件： ~/.fuxi/config.yaml —— 提供商、模型、思考/努力程度、智能路由、脱敏以及按端点的能力覆盖。FuXi运行时更改会热加载。仓库中的config.full.example.yaml包含每个可用字段及内联文档。
优先级： 环境变量 > config.yaml > 内置默认值。
项目设置： 可签入的.claude/settings.json（权限、钩子）按项目生效。
插件： 第一方市场位于fuxicode.com/plugins。

关键环境变量：

变量	用途
`ANTHROPIC_API_KEY`	Anthropic API密钥
`FUXI_BASE_URL` / `FUXI_API_KEY` / `FUXI_MODEL`	OpenAI兼容提供商配置
`ANTHROPIC_MODEL`	Anthropic提供商的模型名称
`FUXI_THINKING_MODE` / `FUXI_THINKING_EFFORT`	`auto\|enabled\|disabled` / `low\|medium\|high\|max`
`FUXI_CONFIG_DIR`	覆盖配置目录（默认`~/.fuxi`）
`FUXI_TEMPERATURE` / `FUXI_TOP_P` / `FUXI_SEED`	采样控制

运行fuxi --help获取完整的环境变量参考，包括桥接/远程控制、沙箱限制和MCP资源上限。

项目结构

FuXi是一个单一的Go模块。入口点是cmd/fuxi；系统主体位于internal/下——代理引擎、TUI、工具、提供商、MCP、会话和记忆服务、智能路由器和权限系统。

FuXi：快速、自包含的AI开发者终端