Fuxi

终端里跑 AI 编程代理，自动选便宜模型省钱

FuXi 是一个运行在终端里的快速、自包含的 AI 编程代理。它让你直接在命令行中编辑代码、执行命令、调用工具，并通过成本感知的路由机制在多个 LLM 提供商之间智能切换，以平衡性能和花费。它定位为轻量级、可嵌入现有工作流的开发助手，解决开发者频繁切换上下文、手动执行重复命令、以及在不同模型间手动选择成本高的问题。核心能力包括：终端内交互式操作、代码编辑与命令执行、工具调用（支持 MCP）、多模型路由与成本优化。项目处于早期阶段，但设计上强调速度和自包含，无需复杂外部依赖，适合追求高效命令行工作流的开发者。

开源 freemium 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3365

维护状态活跃

是否开源是

定价模式 freemium

项目数据

分类编程开发

开发团队fuxicodex

所属国家

官网地址https://www.fuxicode.com

GitHubhttps://github.com/fuxicodex/Fuxi

定价模式freemium

价格说明开源基础版免费，云服务或高级功能可能付费，具体定价待确认

访问状态

是否开源是

开源协议NOASSERTION

主要语言Python

技术栈/模型agent,ai,ai-agent,ai-coding,autonomous-agent,cli,code-assistant,coding-agent,coding-assistant,developer-tool,developer-tools,go,golang,llm,mcp,openai-compatible,productivity,terminal,terminal-app,tui

GitHub 星标★ 3365

30天Star增速

HF 下载量

上线时间2026-08-04 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-13

浏览次数10

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

获取 fuxi 可执行文件（README 说明其为单个静态二进制，无运行时依赖）
一个 OpenAI 兼容的模型服务（base_url + api_key + model），或使用 FuXi 账号登录
建议安装 git 与 ripgrep，供 fuxi doctor 自检使用
可正常交互的终端环境，用于运行 TUI

安装与启动步骤

1安装 fuxi

README 的 Install 小节未给出具体安装命令，仅说明 FuXi 是单个静态二进制；请从官网或仓库获取后放到 PATH 中。
2验证版本

运行版本命令，确认 fuxi 已在 PATH 中且可执行。
```
fuxi --version
```
3环境自检

检查配置、API key、git、ripgrep 等环境项是否就绪。
```
fuxi doctor
```
4登录账号（可选）

会打开浏览器登录 FuXi 账号，自动配置官方托管模型，无需自备 API key。
```
fuxi login
```
5生成配置模板

在 ~/.fuxi/ 生成起始 config.yaml，并自动从已设置的环境变量中探测 provider。
```
fuxi init
```
6交互式向导（可选）

选择 provider、填入 base URL 与 key、选择模型并测试连接。
```
fuxi wizard
```
7启动 TUI

进入终端交互界面，首次运行会在 ~/.fuxi/ 下创建配置目录。
```
fuxi
```

关键配置

配置项	必填	说明	示例
`provider`	是	指定模型供应商标识，示例为 OpenAI 兼容类型。	`openapi`
`base_url`	是	OpenAI 兼容服务的接口地址。	`https://your-endpoint/v1`
`api_key`	是	服务密钥，也可改用环境变量 FUXI_API_KEY 提供。	`sk-xxxxxxxx`
`model`	是	要使用的模型名称。	`your-model`
`FUXI_CONFIG_DIR`	否	覆盖配置目录，默认是 ~/.fuxi。	`/your/path/.fuxi`

如何确认成功

fuxi --version 有版本输出，fuxi doctor 各检查项通过，fuxi 能进入 TUI 并正常对话。

常见问题

Q：没有 API key 能用吗？

A：可以。执行 fuxi login 打开浏览器登录 FuXi 账号，会自动provision FuXi 托管模型，无需 API key。

Q：配置文件放哪里，改完要重启吗？

A：默认在 ~/.fuxi/config.yaml，可用 FUXI_CONFIG_DIR 改目录；FuXi 运行中修改会热重载。

Q：环境变量和配置文件哪个优先？

A：优先级为：环境变量 > config.yaml > 内置默认值。

Q：想管理多个 provider 和模型怎么办？

A：使用分层写法：providers 目录加 model 选择层，可为每个模型单独设置参数。

Q：怎么切换模型和改设置？

A：在 TUI 内用 /model 切换模型，用 /config 管理权限、hooks、skills、plugins 等设置。

注意事项

README 的 Install 小节未给出具体安装命令，实际下载方式请以官网或仓库最新说明为准。
配置优先级为环境变量 > config.yaml > 内置默认值。
设置 NO_UPDATE_NOTIFIER=1 可关闭后台更新检查提示，FUXI_DEBUG=1 开启调试日志。
FuXi 为单个静态二进制、无运行时依赖，但仍需自备 OpenAI 兼容模型服务并关注用量成本。

核心亮点

内置成本感知路由，自动在多个 LLM 提供商间选择性价比最高的模型
自包含设计，无需复杂配置即可在终端内完成代码编辑和命令执行
支持 MCP，可扩展工具调用能力，提升自动化水平

不足之处

早期项目，文档和社区生态尚待完善
功能覆盖可能不如成熟 IDE 插件全面

适用场景

日常开发中快速修改代码片段，无需离开终端
自动化执行测试、构建等命令并智能分析输出
在多个 AI 模型间切换时，自动控制成本

替代项目

Aider、OpenCode、Cline

项目介绍

Fuxi 是编程开发领域的开源项目，由 fuxicodex 开发，是 2026 年新上线的项目。

在全站 13,109 个收录项目中，它的 GitHub 星标数（3,365）位列前 30%，在编程开发分类的 505 个项目里位列前 14%。

近 42 天，它的 GitHub 星标从 472 增加到 3,365，净增 2,893。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。开源基础版免费，云服务或高级功能可能付费，具体定价。从国内网络环境看，可直接访问。

它主要面向的使用场景是：日常开发中快速修改代码片段，无需离开终端。同类可对比的替代方案包括 Aider、OpenCode、Cline。

上一篇：harness-score

下一篇：it-tools