信息卡

一句话定位

一个开箱即用的终端 AI 编码代理（TUI），把任意 OpenAI 兼容模型变成会读代码、改文件、跑命令的全能工人，自称 Claude Code 的供应商无关替代品。

走红原因分析

它踩中了"不想被单一模型厂商锁定"的痛点：靠 API Key 或 OAuth 接入任意 OpenAI 兼容端点、Gemini、Bedrock/Vertex，并内置成本感知路由与跨提供商故障转移。单静态二进制、零运行时依赖、一条 curl 命令安装，把上手门槛压到最低，因此上架三周即破两千星。

核心功能拆解

• 50+ 内置工具：文件读/写/编辑、bash 与 PowerShell、ripgrep 搜索、网页抓取、LSP 诊断、Jupyter、浏览器操作、后台任务与并行子代理。
• Think → Act → Verify 循环：让非前沿模型也能稳定执行多步任务。
• 安全护栏：shell 命令先过 AST 安全分类器，配合细粒度权限与审计日志。
• 持久会话：磁盘化转录、checkpoint 支持恢复/回滚/分叉，空闲期"dreaming"做记忆整合，长对话自动压缩。
• 可扩展：MCP 客户端，hooks/skills/plugins/斜杠命令全部热重载。
• 自更新：下载前校验 SHA-256，原子替换二进制。

架构与技术栈浅析

README 明确整个产品用 Go 编写，发布为单个静态二进制；但仓库本身只承载文档、安装脚本和 issue 追踪——"product source is proprietary and is not published here"，属于"开源发行、闭源源码"形态。调度层是各提供商之上的成本感知智能路由，配置存于 `~/.fuxi/config.yaml` 并支持热重载。

安装与环境要求

curl -fsSL https://releases.fuxicode.com/bootstrap.sh | bash
# Windows PowerShell：
irm https://releases.fuxicode.com/bootstrap.ps1 | iex

安装到 `~/.local/bin`，重复执行即原地升级。验证：`fuxi --version && fuxi doctor`（doctor 会检查配置、API Key、git 与 ripgrep）。卸载删除二进制与 `~/.fuxi` 即可。

快速上手示例

两种接入方式：其一 `fuxi login` 走 OAuth 托管模型；其二自带密钥，编辑 `~/.fuxi/config.yaml`：

provider: openapi
base_url: https://your-endpoint/v1
api_key: <your-key>   # 或 export FUXI_API_KEY
model: your-model

随后直接运行 `fuxi` 进入 TUI，交互式配置可用 `fuxi wizard`。

进阶使用要点

• 权限模式 `--permission-mode default|plan|bypassPermissions`，无人值守时慎用 skip-permissions。
• 用 `--thinking adaptive` 与 `--effort max` 控制推理强度。
• 会话管理：`-r/--resume`、`-c/--continue`、`--fork-session` 分叉续跑。
• TUI 内 `/context`、`/cost`、`/usage`、`/compact` 观察成本与上下文。
• `fuxi mcp serve` 可把 FuXi 自身暴露为一个 stdio MCP server 供他人调用。

典型应用场景

• 企业内网用自己的模型网关替代官方订阅式编码助手；
• 多供应商混合调度，按价格自动 failover；
• 需要审计日志与命令安全分类器的合规开发环境；
• 断点续跑/回滚的长任务修复场景。

同类生态位对比

对标 Claude Code 的体验与工具面，但支持自由换模型；与 OpenCode 相比 FuXi 发行更"一体化"（单二进制+托管登录），代价是完全闭源、无第三方基准成绩（README 只给了一个自查对比测试并坦承局限）。

资源导航

• 安装引导页：https://releases.fuxicode.com/bootstrap.sh
• 配置目录说明见 README 的 Configuration 小节
• 问题反馈走仓库 Issues（文档与安装器问题）