需要 FuXi 账号,先运行 fuxi login 登录(无头/CI 用 fuxi setup-token);默认使用 FuXi 托管模型,想用自有提供商需另设 API key 或改 ~/.fuxi/config.yaml;--dangerously-skip-permissions 会跳过工具调用确认,只应在容器或虚拟机中使用。
Fuxi
fuxicodex活跃维护装在终端里的自主 AI 编程助手,能直接改代码、跑命令、调用工具,并按成本自动在多家大模型之间路由,省下调用开销。
FuXi is a fast, self-contained AI coding agent that lives in your terminal — edit code, run commands, and drive tools, with cost-aware routing across LLM providers.
curl -fsSL https://downloads.fuxicode.com/bootstrap.sh | bash
fuxi --versionREADME 未说明硬件要求;仅说明为 Go 编写的单静态二进制、无运行时依赖,未提及 GPU、显存或 CPU 限制。
终端里的 AI 编程代理,能读写代码、跑命令、调工具,并按成本在多家 LLM 间路由
装在终端里的自主 AI 编程助手,能直接改代码、跑命令、调用工具,并按成本自动在多家大模型之间路由,省下调用开销。
核心能力
- 在终端 TUI 中直接读代码、改文件、执行命令
- 按成本感知在多个 LLM 提供商间路由并自动故障转移
- 作为 MCP 客户端接入外部工具
- 用 Go 编译成单个静态二进制,无运行时依赖
- 内置自更新,安装与升级用同一条命令
容易踩的坑
- v0.1.8最新正式版2026-09-22 · 2026-09-22 11:59 UTC
FuXi 0.1.8 Release Announcement
Release Date: September 22, 2026
We are pleased to announce the release of FuXi 0.1.8, a major update following 0.1.7. This release introduces rate-limit banners and an official plugin marketplace mirror, and delivers systematic stabilization and refinement across session storage, the engine, permissions, Windows compatibility, and the user interface.
New Features
- Rate-limit banners: unified rate-limit data now feeds subscription banners; usage beyond the limit is silently rolled into additional usage with clear notification.
- Official plugin marketplace mirror: the plugin marketplace is now served from an official GCS mirror, making plugin installs more stable and reliable.
Performance
- Smoother long-session interactions: estimated scroll offsets and zero render-time filesystem syscalls reduce a cold first frame from ~1.6s (1000 lines) to ~160ms; scrolling performance is now independent of line count.
- Faster resume & reads: a resume reads the transcript only once (34MB: 4.6s → 0.8s); sessions larger than 5MiB are read through a precompacted fast path in 1MB sequential chunks (~4.9× on a 30MB transcript); write-side 100ms batching keeps the disk format unchanged.
- Streaming render fix: the
linkifyO(n²) full-render issue is resolved (20KB single line: 278ms → 2.9ms); streaming output no longer appears non-streaming.
Sessions & Messages
- Session storage-chain optimization: a precompact read fast path, write-side batching, and live-cache re-append are introduced (metadata such as titles and tags flush synchronously, and external SDK writes are absorbed via a 64KB tail window).
- Message-chain integrity: parentUuid chains now fully link every participant, with automatic re-linking after forks; switching sessions no longer loses in-flight messages; a unified session UUID registry fixes the
/clearcache invalidation issue.
Permissions & Security
- Dialog & rules: the permission dialog now uses a numbered Select list; "Always Allow" clearly displays the exact rule to be persisted; low-risk file commands (mkdir/cp/mv/touch/rmdir) are relaxed to command-name prefix rules.
- Stability & Bash safety: the whole-UI freeze caused by permission dialogs is resolved (approval sends are now non-blocking); the Bash read-only gate is hardened (backticks and newlines can no longer bypass auto-approval); permission suggestions are built once per request and differentiated by reason.
Windows Compatibility
- Startup & rendering: when Git for Windows is missing, startup now provides installation guidance directly (no longer stuck behind the login flow); CJK console glyphs and borders adapt to terminal capabilities, resolving mojibake, tofu, and input-box jitter; subprocess output is decoded strictly as UTF-8.
Engine & Tools
- Non-streaming fallback: on empty or interrupted streams, the current turn is automatically retried via a non-streaming request.
- Tool-execution dedup: a tool state machine and tracker form a dedup closed loop, eliminating duplicate tool cards.
- Tool behavior unification: Read, Write, Edit, Notebook, and PDF tools now share consistent behavior and error messages; non-standard error prefixes are removed.
UI / MCP / Misc
- UI: the task list is deduplicated (the right sidebar is the single task surface); the plan-approval dialog fits exactly, with buttons remaining visible on long plans.
- MCP: the command allowlist is re-seeded after configuration reloads (servers added at runtime are no longer blocked);
~/.fuxi.jsonglobal configuration is unified.
Installation & Upgrade
Installation scripts automatically fetch the latest version with integrity verification.
macOS / Linux
curl -fsSL https://downloads.fuxicode.com/bootstrap.sh | bashWindows (PowerShell)
irm https://downloads.fuxicode.com/bo - 0.1.6v0.1.62026-09-07 · 2026-09-07 10:22 UTC
查看更新说明
FuXi 0.1.6 Release Announcement
Release Date: September 7, 2026
FuXi 0.1.6 is now available. This release focuses on core experience consistency and stability: unified session and message handling, hardened login flow, cross-platform compatibility improvements, and a number of stability fixes.
New Features
- Unified session & message handling: chat messages are consolidated into a single message model, removing inconsistencies between multiple handling paths; message parent-child chains are preserved more completely, and partially-compacted history survives session resume.
- Hardened login flow: cross-process token refresh is serialized to prevent token-chain failure; tokens are refreshed proactively before expiry to avoid forced re-login; login no longer times out — it waits until the user cancels.
- Model selection validation: the
/modelcommand now validates that the selected model is supported by the current endpoint, giving clear feedback when an invalid model name is entered.
Improvements & Fixes
- Engine: empty responses automatically retry via non-streaming requests; fixed repeated injection of external file changes and conditional memory; coordinator queue drained before every request; gateway length errors correctly recognized as context-window overflows.
- Bash / Windows: unified command-line parsing reduces misclassification; strict UTF-8 subprocess output on Windows avoids garbled text; nested-heredoc crash fixed; startup git-bash check and working-directory exclusion added.
- UI & Rendering: markdown rendering improvements, box-drawing table format, sidebar reasoning state and session cost, and chat lag fixed on huge content; CJK character-width handling now applies only to legacy Windows consoles.
- Tasks / Agent: standardized task IDs and output paths; notification queue priorities (immediate / later / next); stricter stop-task conditions;
agent_busyclaim check. - Files & Search: more accurate search timeouts; staged protection for very large file reads; Grep content checks and UNC path handling fixed.
- MCP:
/mcptoggle persisted per-project; improved port allocation and lock-backoff; staged truncation for tool output. - Permission & Sandbox: static directory rules support subtree matching; sandbox configuration now takes effect with settings; unified session grant logic.
- Context compaction: staged decision for file restore after compaction; improved shared-cache partial compaction.
- Image recognition: recognition configuration is endpoint-scoped and no longer affects the main model's vision judgment; recognition-model refusals are never cached.
Installation / Upgrade
Installation scripts fetch the latest version automatically with integrity verification.
Windows (PowerShell)
irm https://fuxicode.com/install.ps1 | iexWindows (CMD)
curl -fsSL https://fuxicode.com/install.cmd -o %TEMP%\install.cmd && %TEMP%\install.cmdmacOS (x64 / ARM64)
curl -fsSL https://fuxicode.com/install.sh | bashLinux (x64 / ARM64)
curl -fsSL https://fuxicode.com/install.sh | bashExisting users can upgrade by re-running the corresponding command. For issues, please report them at https://github.com/fuxicodex/Fuxi/issues.
- 0.1.2v0.1.22026-08-06 · 2026-08-06 15:18 UTC
查看更新说明
FuXi 0.1.2 Release Announcement
Release Date: August 6, 2026
FuXi 0.1.2 is now available, with major improvements across multi-window coordination, image capabilities, and the plugin ecosystem.
New Features
- Multi-window coordination: switch seamlessly between concurrent sessions without interrupting your current work.
- Image captioning: non-vision models can now generate image descriptions automatically, enabled by default.
- Vision capability is automatically detected from known provider capabilities, with no manual configuration required.
- Thinking mode now adapts to the task type for smarter responses.
- Tool-level thinking has been refined, and status blink for collapsed groups in the TUI is restored.
- Voice capture and browser tools are now integrated through the native extension bridge.
Improvements & Fixes
- Unified MCP plugin lifecycle: plugins from manifest, channel declarations, session plugins, and other sources all load under one consistent contract.
- Multiple security hardening improvements: plaintext MCP tokens removed, OAuth credentials scoped to their trust domains, plugin secrets kept out of prompts, and plugin reloads no longer expose stale state.
- Path traversal is blocked before normalization, preventing path escape risks.
- Memory extraction now runs asynchronously, with an optimized memory_saved card.
- Model cache isolation stays stable across sessions, and compacted context remains consistent across TUI turns.
- Each model gets a stable user identity, and long prompts are preserved intact across the OpenAPI boundary.
- Plugin LSP lifecycle options are supported, and usable LSP plugins are recommended after real file edits.
- Fixed empty tool results being lost before transcript replay.
Installation / Upgrade
Installation scripts fetch the latest version automatically with integrity verification.
Windows (PowerShell)
irm https://releases.fuxicode.com/bootstrap.ps1 | iexWindows (CMD)
curl -fsSL https://releases.fuxicode.com/install.cmd -o %TEMP%\install.cmd && %TEMP%\install.cmdmacOS (Intel / Apple Silicon)
curl -fsSL https://releases.fuxicode.com/bootstrap.sh | bashLinux (x64 / ARM64)
curl -fsSL https://releases.fuxicode.com/bootstrap.sh | bashExisting users can upgrade by re-running the corresponding command. For issues, please report them at https://github.com/fuxicodex/Fuxi/issues.
- 0.1.1v0.1.12026-08-05 · 2026-08-05 18:54 UTC
查看更新说明
FuXi 0.1.1 Release Announcement
Release Date: August 6, 2026
FuXi 0.1.1 has been released. This release includes the following changes.
New Features
- Remote Control: support for CCR v2 sessions with secure worker credential exchange and real-time event streaming, synchronized with the local TUI
- Remote input integrated with the local session; slash commands and prompts processed under unified security policies
- Image preprocessing upgraded: automatic resizing and compression before upload, using the Lanczos3 scaling kernel
- Built-in file search tools (bfs/ugrep) with no additional dependencies, available on Windows, macOS, and Linux
- Chrome integration dialog, enabled by default
- @mention content delivered directly to the model
- Bash cards expanded by default
- Exit-word routing and automatic detection of long-running task keywords
Improvements & Fixes
- Optimized context compaction and tool result budgeting for more stable long-conversation streaming
- Fixed Windows path conversion, snapshot, hooks, and permission rule issues
- Fixed deepseek-v4 output limits and API request parameters (top_p)
- Token refresh interval extended to 6 hours
- Fixed attachment ordering, message boundaries, and hook completion order
- Improved WebSocket 401 auto-recovery mechanism
Installation / Upgrade
Installation scripts fetch the latest version automatically with integrity verification.
Windows (PowerShell)
irm https://releases.fuxicode.com/bootstrap.ps1 | iexWindows (CMD)
curl -fsSL https://releases.fuxicode.com/install.cmd -o %TEMP%\install.cmd && %TEMP%\install.cmdmacOS (Intel / Apple Silicon)
curl -fsSL https://releases.fuxicode.com/bootstrap.sh | bashLinux (x64 / ARM64)
curl -fsSL https://releases.fuxicode.com/bootstrap.sh | bashExisting users can upgrade by re-running the corresponding command. For issues, please report at: https://github.com/fuxicodex/Fuxi/issues
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
FuXi
FuXi is a fast, self-contained terminal AI coding agent. It reads code, edits files, runs commands, and drives tools from a rich TUI, with cost-aware routing across LLM providers and automatic failover. Built in Go, it ships as one static binary with no runtime dependencies.
Terminal-first · Provider-agnostic · Bring your own key · MCP client · Self-updating
Homepage: https://www.fuxicode.com
FuXi's roughly 2 million lines of code were written entirely by FuXi itself.

Install
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"
Then verify and launch:
fuxi --version
fuxi doctor # environment sanity checks
fuxi # start a session
Install and upgrade are the same command. Full options, uninstall steps, and troubleshooting: setup docs.
Get started
A FuXi account is required. Run fuxi, then:
- Register and sign in —
fuxi login(orfuxi setup-tokenfor headless/CI). Registration processes only minimal account data. - Connect a model (optional) — sign-in gives access to FuXi-managed models;
to use your own provider instead, set an API key via environment variable or
~/.fuxi/config.yaml(fuxi initgenerates a template). Or runfuxi wizard.
Then type a prompt and press Enter, for example:
Fix the failing tests in this repository.
Useful commands: /model switch models · /help browse all commands ·
/config open settings · /privacy-settings privacy controls · /exit quit.
Full walkthrough: usage guide.
Permissions
Sensitive tool calls ask for approval unless you change the permission mode at launch.
--dangerously-skip-permissions starts in bypassPermissions, so tool calls
run without a prompt. Extreme commands such as rm -rf / are still blocked.
Use it only in a container or VM; on Linux and macOS, root and sudo are
rejected.
--allow-dangerously-skip-permissions keeps the normal mode and adds
bypassPermissions to the Shift+Tab cycle.
--permission-mode bypassPermissions behaves like
--dangerously-skip-permissions. The same flag also accepts default and
plan.
Data, privacy, and retention
FuXi runs on your machine and keeps your work local.
- By default, your code and conversations are never collected, stored, or
retained by FuXi. With your own key they go straight to the provider you
choose; with FuXi-managed models they are transmitted only to serve that
request. Conversation content is sent to FuXi only if you explicitly enable
send_conversations(off by default). - Credentials stay in local
~/.fuxi/and are never uploaded. - Sessions, checkpoints, memory, and audit logs live on your device and can be deleted at any time by removing the config directory.
- FuXi processes limited account and technical information to operate the service; the available analytics are disclosed and can be turned off. See Privacy Controls.
Full details: Privacy Policy · Security Whitepaper · Terms of Service.
Documentation
| Guide | What it covers |
|---|---|
| Usage guide | First session, permissions, sessions & memory, tools & MCP, CLI reference, troubleshooting |
| Architecture | Execution base, persistence, routing, multi-window coordination, extensibility |
| Keyboard shortcuts | Terminal-UI key reference |
| Environment variables | Full environment-variable reference |
| FAQ | Common questions |
| Benchmark report | Reproducible evaluation methodology and results |
| Security & privacy | Privacy Policy, Security Whitepaper, Terms of Service, Usage Policy, compliance and governance |
| Changelog | Release history |
| Support | Where to get help |
Usage policy
You must use FuXi in accordance with the laws applicable to you. FuXi is aimed at developers and professional users and is not directed at children under 14; users aged 14–17 require a parent or guardian.
Disallowed uses and full requirements: Usage Policy. If you are unsure whether a use is lawful, take advice before proceeding.
Contributing
The product source is proprietary; this repository hosts the documentation, installers, and issue tracker, which are open to contributions. See CONTRIBUTING.md.
License
Proprietary. Copyright © 2026 FUXI. All rights reserved.