fx

这是什么？适合谁？

fx（vercel-labs/fx）是 Vercel Labs 出品的 Unix 风格 coding agent。它把 Agent 行为设计为可管道组合的 Unix 命令：fx plan | fx review | fx implement，让 AI 编程像 shell 脚本一样可组合、可复现。

核心理念：不像传统 Agent 那样「一个会话做所有事」，而是把 Agent 能力拆成独立、可组合的命令，每个命令做一件事并做好。这继承了 Unix 哲学——Do one thing and do it well。

适合人群：

• 习惯命令行的资深开发者
• 需要将 AI 编程集成到 CI/CD 管道的团队
• 喜欢 Unix 哲学的开发者
• 需要可重复、可审计的 AI 编程流程的团队

不适合：偏好 GUI 的开发者；刚接触命令行的新手；只需要「帮我写个函数」的轻度用户。

使用前提：Node.js 18+；LLM API Key（支持 OpenAI / Anthropic / DeepSeek）；熟悉 Unix 管道和 shell 脚本。

准备工作

1. Node.js 18+：运行环境
2. LLM API Key：OpenAI / Anthropic / DeepSeek 至少一个
3. Shell 环境：bash / zsh / fish
4. 成本：fx 开源免费（MIT License）；API 调用按模型定价
5. 时间预算：安装 2 分钟；理解管道模式 15 分钟

快速上手（3 步）

第一步：安装

npm install -g @vercel-labs/fx
# 或
npx @vercel-labs/fx --help

第二步：配置 API Key

export FX_API_KEY=sk-xxx
export FX_MODEL=claude-sonnet-4-20250514

第三步：第一个管道

# 审查当前目录的代码
fx plan --dir . | fx review | fx implement

初级用法

核心命令

管道组合

# 完整工作流：计划 → 审查 → 实施 → 测试
fx plan --dir src/ | fx review --strict | fx implement | fx test --coverage

# 仅生成计划并保存
fx plan --dir src/ > plan.md

# 从文件读取计划并执行
fx implement < plan.md

自定义提示词

fx plan --dir src/ --prompt "重点关注性能优化和安全漏洞"

高级玩法

CI/CD 集成

# .github/workflows/fx-review.yml
name: AI Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm install -g @vercel-labs/fx
      - run: fx review --pr ${{ github.event.number }} | fx comment --pr
        env:
          FX_API_KEY: ${{ secrets.FX_API_KEY }}

多模型路由

# 用 Claude 做计划，用 DeepSeek 做实施（成本优化）
fx plan --model claude-sonnet-4-20250514 | fx implement --model deepseek-chat

管道日志与回放

# 记录管道执行日志
fx plan --dir src/ --log pipe.log | fx review --log pipe.log | fx implement --log pipe.log

# 回放管道
fx replay pipe.log

小技巧

1. 管道复用：将常用管道保存为 shell 脚本，fx-review.sh 一键执行
2. 增量模式：使用 --diff 仅分析 Git 变更，避免全量扫描
3. 并行执行：对独立模块并行运行 fx plan，提高效率
4. 自定义 reviewer：创建 .fx/review-rules.md 定义团队代码审查标准
5. 成本追踪：使用 fx --cost 查看每次管道执行的 API 费用

常见踩坑

踩坑 1：管道中断后状态丢失

现象：fx plan | fx review 中 plan 成功但 review 失败，从头重跑浪费 tokens

原因：管道默认不留中间结果

解决：使用 --save 保存中间结果，或使用 fx plan --save step1.json && fx review step1.json

踩坑 2：大项目扫描超时

现象：fx plan --dir . 在大型项目上运行超过 10 分钟

原因：全量文件扫描 token 消耗大

解决：使用 --diff 仅分析变更；或 --exclude node_modules,dist 排除不需要的目录

踩坑 3：API Key 配置混淆

现象：fx 使用了错误的 API Key

原因：多个环境变量冲突（FX_API_KEY vs OPENAI_API_KEY vs ANTHROPIC_API_KEY）

解决：明确使用 FX_API_KEY 作为 fx 的主 Key；检查 fx config 查看当前配置

踩坑 4：review 过于严格

现象：fx review 对每个小改动都提出大量修改建议

原因：默认审查标准较严格

解决：创建 .fx/review-rules.md 自定义审查规则，降低非关键问题的严重级别

踩坑 5：implement 产生不兼容改动

现象：fx implement 修改了不应修改的文件

原因：plan 阶段的范围不够精确

解决：在 fx plan 阶段使用 --scope 明确限定文件范围

常见问题 FAQ

Q1: fx 和 Claude Code 有什么区别？

A: Claude Code 是交互式会话 Agent（你问它答，连续对话），fx 是管道式命令 Agent（每个命令独立，可组合）。Claude Code 适合探索性编程，fx 适合可重复、可审计的自动化流程。它们可以互补使用。

Q2: 支持哪些模型？

A: 任何 OpenAI 兼容 API 的模型都支持，包括 GPT-4o、Claude Sonnet/Opus、DeepSeek V4、以及本地 Ollama 模型。

Q3: 管道之间如何传递数据？

A: 通过标准输入/输出（stdin/stdout）传递 JSON 格式的结构化数据。你也可以用 --save 保存中间结果为文件。

Q4: 是否支持自定义命令？

A: 支持。通过 fx plugin 机制可以创建自定义命令。参见 fx 插件开发文档。

Q5: Vercel 会持续维护吗？

A: fx 是 Vercel Labs 项目，由 Vercel 官方实验室维护。虽然 Labs 项目可能随时变化，但 fx 自发布以来 Issues 144 个高度活跃，Vercel 投入信号明确。

进阶学习建议

掌握 fx 基础管道后，建议深入：

1. Agent 管道编排：将 fx 管道与 agent-safe-pipeline（人机审批工作流）结合，构建「AI 计划 → AI 审查 → 人类审批 → AI 实施」的完整开发流程。
2. 多 Agent 协同：研究如何让多个 fx 实例并行处理不同模块，通过 Git 分支合并实现「AI 并行开发」。结合 TabTin（多 Agent 协作空间）实现可视化协同。
3. 团队标准库：建立团队的 .fx/ 配置仓库，包含统一的审查规则、提示词模板和常用管道脚本，让 AI 编程在团队内保持一致风格。

参考链接

• 官方仓库
• Vercel Labs
• Unix 哲学

最后更新：2026-08-26 · 作者：MagicNetWorld · 基于公开资料整理，AI 辅助生成