Neovate Code 调研报告

一、项目概述

基本信息

一句话介绍

Neovate Code 是蚂蚁集团支付宝体验技术部开源的终端 AI 编程助手，定位为"开放的 Claude Code"——继承 Claude Code 的核心设计理念，同时增加了多模型支持、插件系统、Git Worktree 工作区隔离等企业级特性。

发展历程

• 2025 年 3 月: 项目由支付宝体验技术部在 GitHub 上创建（2025-03-11）
• 2025 年 9 月: 在阮一峰周刊（ruanyf/weekly #7805）正式自荐开源，引发社区关注
• 2025-2026 年: 快速迭代，版本从 v0.1.x 到 v0.28.5，每 3-7 天发布一个新版本
• 项目灵感来源明确承认: Claude Code、OpenCode、Gemini CLI、Cursor
• 核心贡献者: sorrycc（1,117 commits）、xierenyuan（306 commits）、afc163 等 20+ 贡献者

定位

Neovate Code 自称为 "开放的 Claude Code"，核心差异化： 1. 开放: MIT 协议，代码完全开放 2. 多模型: 不绑定任何 LLM 提供商，支持 11+ 模型供应商 3. 可扩展: 插件系统，企业可基于它构建内部 Code Agent 4. 多客户端: CLI + VS Code 扩展 + 编辑器集成

二、核心功能

功能概览

核心功能详解

1. 多模型支持（核心差异化）

Neovate Code 内置支持 11+ LLM 提供商，是最大的差异化特性：

此外支持任意 OpenAI 兼容 API。

推荐模型: Claude Sonnet 4, Claude Opus 4, Qwen3 Coder, Qwen3 Max, GPT 4.1, Gemini 2.5 Pro

近期新增模型: - v0.28.3: Claude Sonnet 4.6 - v0.28.2: minimax m2.5, gpt-5.3-codex-spark - v0.28.1: GLM-5

模型别名: deepseek, gpt-4, gpt-4o, gemini-2.5-flash, gemini-2.5-pro, grok-4, claude-sonnet-4, kimi-k2 等

2. AGENTS.md 规则文件系统

类似 Claude Code 的 CLAUDE.md，但采用双层级设计：

工作原理: - 两个文件内容合并后作为 LLM 系统上下文的一部分 - /init 命令可自动扫描项目结构并生成初始 AGENTS.md - 主要用途：编码规范、项目约定、架构决策、测试要求

3. Git Worktree 工作区隔离

Neovate Code 的独特功能——通过 Git 原生 Worktree 实现并行工作：

neovate workspace create    # 创建隔离工作区
# 在 .neovate-workspaces/<name> 下创建独立工作副本

优势: - 多个 AI Agent 可同时在不同工作区中工作，互不冲突 - 每个工作区共享 Git 历史但拥有独立的工作树 - 适合大规模并行任务处理

4. MCP (Model Context Protocol) 支持

全面的 MCP 实现，支持三种传输协议：

管理命令:

neovate mcp add      # 添加 MCP 服务器
neovate mcp get      # 查看服务器详情
neovate mcp rm       # 删除服务器
neovate mcp enable   # 启用
neovate mcp disable  # 禁用
neovate mcp ls       # 列出所有服务器

可通过 .neovate/settings.json、--mcp-config 命令行参数或 CLI 命令配置。

5. 插件系统

基于 TypeScript 的插件 API：

import type { Plugin } from '@neovate/code';

export default const plugin: Plugin = {
  name: 'my-plugin',
  context: () => {
    return {
      'Who am I': 'chencheng'
    };
  }
};

• 插件实现 Plugin 接口
• context() 方法返回键值对注入 LLM 上下文
• 支持钩子扩展 Neovate Code 行为
• 企业级应用: 蚂蚁集团、快手基于此构建内部 Code Agent

6. Headless 模式

为 CI/CD 和脚本集成设计：

neovate -q --output-format json --approval-mode yolo "完成任务X"

三、安装配置

环境要求

安装

# 全局安装
npm install -g @neovate/code

# 或使用其他包管理器
yarn global add @neovate/code
pnpm add -g @neovate/code

快速开始

# 启动交互式会话
neovate

# 常用初始命令
/login     # 登录 LLM 提供商
/model     # 选择模型
/init      # 自动生成 AGENTS.md
/review    # 审查 Git 暂存区变更

配置文件

配置 Schema: https://neovateai.dev/config.json

可配置项: approvalMode, autoCompact, autoUpdate, commit, language, mcpServers, model, outputStyle, planModel, plugins, systemPrompt, todo

四、架构设计

整体架构

┌──────────────────────────────────────────────────────────────────┐
│                     Neovate Code 系统架构                         │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌──────────────┐  ┌──────────────┐  ┌───────────────────────┐ │
│  │  CLI 终端     │  │  VS Code     │  │  编辑器扩展            │ │
│  │  (Ink/React) │  │  Extension   │  │  (多客户端架构)        │ │
│  └──────┬───────┘  └──────┬───────┘  └───────────┬───────────┘ │
│         │                  │                      │              │
│         └──────────────────┼──────────────────────┘              │
│                            │                                     │
│  ┌─────────────────────────▼──────────────────────────────────┐ │
│  │                    Core Engine (TypeScript)                 │ │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │ │
│  │  │ AI SDK   │ │ MCP      │ │ Plugin   │ │ Workspace    │ │ │
│  │  │ 多模型   │ │ 协议     │ │ 系统     │ │ Worktree     │ │ │
│  │  │ 路由     │ │ 客户端   │ │ Hooks    │ │ 管理         │ │ │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────────┘ │ │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │ │
│  │  │ 会话     │ │ 审批     │ │ AGENTS   │ │ 输出风格     │ │ │
│  │  │ 管理     │ │ 流程     │ │ .md 解析 │ │ 模板引擎     │ │ │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────────┘ │ │
│  └───────────────────────────────────────────────────────────┘ │
│                            │                                     │
│         ┌──────────────────┼──────────────────┐                │
│         ▼                  ▼                  ▼                │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐   │
│  │ LLM APIs    │  │ MCP Servers │  │ 本地工具             │   │
│  │ (11+ 提供商) │  │ (外部工具)  │  │ (Git, 文件, Shell)   │   │
│  └─────────────┘  └─────────────┘  └─────────────────────┘   │
└──────────────────────────────────────────────────────────────────┘

项目结构

neovate-code/
├── src/                    # 核心源码
├── vscode-extension/       # VS Code 扩展（monorepo 子包）
├── examples/               # 插件和使用示例
├── e2e/                    # 端到端测试
├── patches/                # 第三方补丁
├── scripts/                # 构建、发布脚本
├── vendor/                 # 打包的二进制依赖（如 ripgrep）
├── package.json            # 根项目配置
├── pnpm-workspace.yaml     # monorepo 工作区配置
└── tsconfig.json           # TypeScript 配置

核心技术选型

仓库结构

项目采用 pnpm workspace monorepo： - 根包: @neovate/code（CLI + Core） - 子包: neovate-assistant（VS Code 扩展）

五、使用场景

适用场景

不适用场景

• 不需要 AI 辅助的简单编码任务
• 需要 GUI/IDE 深度集成的场景（当前 CLI 为主）
• 对模型延迟极度敏感的实时编码场景

企业级应用

• 蚂蚁集团: 内部 Code Agent 基础设施
• 快手 (Kuaishou): 基于插件系统构建内部工具
• 其他企业可基于 MIT 协议自由定制

六、对比分析

Neovate Code vs Claude Code

Neovate Code vs Cursor

Neovate Code vs GitHub Copilot

Neovate Code vs Cline

选型建议

• 选择 Neovate Code: 需要多模型灵活性、避免厂商锁定、企业定制需求、CI/CD 集成
• 选择 Claude Code: 重度依赖 Anthropic 模型、追求与 Claude 生态深度整合
• 选择 Cursor: 需要 IDE 级别的深度集成和图形界面
• 选择 GitHub Copilot: 偏好代码补全体验、已深度使用 GitHub 生态
• 选择 Cline: 偏好 VS Code 扩展形式、社区驱动的开源方案

七、最佳实践

推荐做法

1. Spec 驱动开发: 先在 Brainstorm Mode（Shift+Tab 两次）中讨论设计，再实现
2. 并行 Agent 模式: 创建多个 workspace，同时运行多个 Neovate 实例处理不同任务
3. AGENTS.md 优先: 使用 /init 生成初始文件，手动精炼后提交到 Git
4. 代码审查集成: git add . && neovate /review 快速审查变更
5. 审批模式按需调整: 日常用 autoEdit，CI 用 yolo，重要操作用 default

避坑指南

1. API Key 安全: 不要将 API Key 硬编码在配置文件中，使用环境变量
2. AGENTS.md 不要过长: 保持精简聚焦，过长会影响 LLM 注意力和 Token 消耗
3. Workspace 清理: 并行工作完成后及时清理 .neovate-workspaces/ 目录
4. Headless 模式审批: 在 CI 中使用 yolo 模式前确保充分测试

八、总结

优势

1. 多模型无锁定: 11+ 提供商 + OpenAI 兼容 API，灵活切换不绑定
2. 完全开源: MIT 协议，可自由定制和二次开发
3. 企业级架构: 插件系统 + Worktree 隔离 + Headless 模式，满足企业需求
4. 社区背书: 蚂蚁集团出品，Sorrycc 等知名工程师维护
5. 活跃迭代: 版本快速更新（v0.28.5），功能持续增强
6. 工作流创新: Spec 驱动 + 并行 Agent 模式是独特的工作流创新

劣势

1. 项目年轻: 2025 年才开源，生态和文档仍需完善
2. CLI 为主: GUI 集成有限，VS Code 扩展成熟度待提升
3. 插件生态: 插件系统刚起步，社区插件数量有限
4. 中文文档为主: 国际化文档覆盖尚需提升
5. 竞争激烈: Claude Code、Cursor 等成熟竞品迭代速度快

最终建议

Neovate Code 在 AI Code Agent 领域找到了一个独特的定位——"开放的 Claude Code"。对于以下用户特别有价值：

• 推荐使用: 需要多模型灵活性、企业定制 AI 开发工具、CI/CD 集成、避免厂商锁定的团队
• 观望: 重度依赖单一模型（如只用 Claude）、需要成熟 IDE 集成的用户
• 关注趋势: 即使不使用，Neovate Code 代表的"开放 Agent + 插件架构"理念值得学习

参考资料

• GitHub 仓库: https://github.com/neovateai/neovate-code
• 官方文档: https://neovateai.dev
• npm 包: https://www.npmjs.com/package/@neovate/code
• 阮一峰周刊自荐: https://github.com/ruanyf/weekly/issues/7805
• 知乎官方公告: https://zhuanlan.zhihu.com/p/1954202059206277079
• Sorrycc 最佳实践: https://sorrycc.com/best-practices-with-neovate-code
• Jimmy Song AI 开源全景: https://jimmysong.io/zh/ai/neovate-code/
• VS Code 扩展: 搜索 neovate-assistant