n8n-as-code

用代码和AI助手轻松构建、同步和管理n8n工作流

n8n-as-code 是一个将 n8n 工作流自动化平台与 AI 编程助手（如 Claude、Copilot、Cursor）深度结合的开源项目。它解决了 AI 助手无法直接操作 n8n 复杂节点和模板的问题，通过提供 537 个节点的完整 schema 定义、7700 多个可复用模板，以及类似 Git 的同步机制，让开发者可以用 TypeScript 以代码形式编写、版本管理和同步 n8n 工作流。核心能力包括：为 AI 助手提供结构化的节点知识库，使其能准确生成或修改工作流；支持 GitOps 流程，实现工作流的版本控制和团队协作；提供类型安全的 TypeScript 工作流定义，提升开发效率和可维护性。该项目特别适合希望将低代码自动化与 AI 辅助开发结合的团队，能够显著降低工作流开发门槛，并保证复杂自动化逻辑的可追溯性和可测试性。

开源 unknown 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1582

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类自动化工作流

开发团队EtienneLescot

所属国家

官网地址https://n8nascode.dev

GitHubhttps://github.com/EtienneLescot/n8n-as-code

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai-skills,claude,copilot,cursor,gitops,low-code,n8n,ontology,skills,typescript,vscode,workflow-automation

GitHub 星标★ 1582

30天Star增速

HF 下载量

上线时间2026-01-03 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-10

浏览次数7

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

一个可用的 n8n 实例，建议保持为最新稳定版本
n8nac CLI（安装方式见官方 Getting Started 文档，README 未给出安装命令）
n8n 实例的 API Key（用于 n8nac env auth set）
可选：VS Code / Cursor 编辑器，用于 AI 助手集成

安装与启动步骤

1安装 n8nac CLI

按官方 Getting Started 文档安装 n8nac 命令行工具；README 未给出安装命令，请勿猜测包名。
2查看已有环境

列出当前已配置的 n8n 环境，确认是否已有可用环境再决定是否新增。
```
n8nac env list
```
3添加远程环境

新增名为 Dev 的环境，指向你的 n8n 实例地址，工作流保存到 workflows/dev 目录。
```
n8nac env add Dev --base-url https://n8n.example.com --workflows-path workflows/dev
```
4添加托管环境

新增名为 Local 的环境，绑定一个托管实例 ID，工作流保存到 workflows/local 目录。
```
n8nac env add Local --managed-instance my-instance-id --workflows-path workflows/local
```
5切换当前环境

把默认使用的环境切换为 Dev，之后的操作都会针对该环境进行。
```
n8nac env use Dev
```
6设置 API Key

为 Dev 环境配置访问密钥，命令从标准输入读取，避免密钥出现在命令历史中。
```
n8nac env auth set Dev --api-key-stdin
```

关键配置

配置项	必填	说明	示例
`--base-url`	是	n8n 实例的访问地址	`https://n8n.example.com`
`--workflows-path`	是	该环境工作流文件在仓库中的存放路径	`workflows/dev`
`--managed-instance`	否	托管实例 ID，用于本地/托管型 n8n 环境	`my-instance-id`
`--api-key-stdin`	是	从标准输入读取 n8n API Key 完成鉴权	`sk-xxxxxxxx`

如何确认成功

执行 n8nac env list 能看到新增的 Dev / Local 环境，且 n8nac env use Dev 切换成功即表示配置完成。

常见问题

Q：怎么安装 n8nac CLI？

A：README 未给出安装命令，请按官网 Getting Started 文档（https://n8nascode.dev/docs/getting-started/）的说明安装后再执行后续命令。

Q：我的 n8n 版本比较旧，会有影响吗？

A：内置节点 schema 基于最新稳定版 n8n 构建，建议保持实例更新，以获得最佳的生成和校验效果。

Q：如何删除已配置的环境？

A：执行 n8nac env remove Dev 即可移除该环境配置，之后可用 env list 确认是否删除成功。

Q：API Key 会不会被记录在命令里？

A：使用 --api-key-stdin 从标准输入传入密钥，不会直接写在命令行参数中，可降低泄露风险。

注意事项

README 未提供 CLI 安装命令，安装步骤请以官方文档为准，不要臆造包名与参数。
n8n-as-code 是独立项目，与 n8n 官方无关。
VS Code / Cursor 的 AI 助手集成方式请参考官网 VS Code Guide 与 CLI Guide 文档。

核心亮点

提供537个节点的完整schema，AI助手能精准生成复杂工作流，减少手动配置错误
内置7700+模板，可直接复用社区最佳实践，大幅缩短开发时间
支持Git-like同步，工作流可版本控制、团队协作，符合GitOps最佳实践

不足之处

文档/社区待观察
依赖n8n平台，对非n8n用户无直接价值

适用场景

团队使用n8n进行自动化，希望引入AI辅助开发工作流
需要将n8n工作流纳入Git版本管理，实现审计和回滚
开发者希望用TypeScript编写类型安全的工作流，替代手动拖拽配置

替代项目

n8n、Windmill、Trigger.dev

项目介绍

n8n-as-code 是自动化工作流领域的开源项目，由 EtienneLescot 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,582）位列前 30%，在自动化工作流分类中处于中上游。

近 45 天，它的 GitHub 星标从 1,487 增加到 1,582，净增 95。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：团队使用n8n进行自动化，希望引入AI辅助开发工作流。同类可对比的替代方案包括 n8n、Windmill、Trigger.dev。

上一篇：n8nworkflows.xyz

下一篇：bytechef