seo.docs.title

· 入门

快速上手

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

安装

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

macOS / Linux

Terminal

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

Windows (PowerShell)

Terminal

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

Windows (CMD)

Terminal

curl -fss https://releases.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 手动触发。

返回首页