Archon

把 AI 编码变成可重复执行的确定性流水线

Archon 是首个面向 AI 编程的开源 harness 构建工具，旨在解决 AI 编码结果随机、不可控的问题。它通过将复杂的 AI 编码流程编排为确定性的、可重复执行的 YAML 工作流，让开发者能够精确控制 AI 助手的每一步行为，包括模型选择、上下文注入、工具调用和输出验证。核心能力包括：可视化或代码化地定义多步骤 AI 编码流水线、内置状态管理与错误重试机制、支持与 Claude 等主流模型深度集成、以及提供 CLI 和自动化接口方便嵌入现有开发流程。项目采用 TypeScript 编写，基于 Bun 运行时，强调轻量、快速和可移植性，帮助团队将 AI 编码从实验性尝试升级为工程化实践，显著提升代码生成的一致性和可维护性。

开源 free 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 23528

维护状态活跃

是否开源是

定价模式 free

项目数据

分类编程开发

开发团队coleam00

所属国家

官网地址https://archon.diy

GitHubhttps://github.com/coleam00/Archon

定价模式free

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai,automation,bun,claude,cli,coding-assistant,developer-tools,typescript,workflow-engine,yaml

GitHub 星标★ 23528

30天Star增速

HF 下载量

上线时间2025-02-07 00:00:00

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

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数7

使用教程

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

环境要求

Bun 运行时（README 指向 bun.sh）
Claude Code（编译版二进制需单独安装）
GitHub CLI（完整安装的前置条件）
x64 平台的 macOS/Linux 快速安装需 CPU 支持 AVX2
如使用 Docker 镜像则已预装 Claude Code

安装与启动步骤

1确认前置依赖

README 要求先准备 Bun、Claude Code 与 GitHub CLI。Bun 请按 bun.sh 官网指引安装，README 未给出具体安装命令。
2快速安装(macOS/Linux)

已有 Claude Code 环境时，用官方脚本安装独立 CLI，跳过引导向导。x64 老 CPU 不支持 AVX2 需改用源码安装。
```
curl -fsSL https://archon.diy/install | bash
```
3快速安装(Windows)

在 PowerShell 中执行官方安装脚本，同样会安装独立 CLI 二进制。
```
irm https://archon.diy/install.ps1 | iex
```
4Homebrew 安装

macOS/Linux 也可通过 Homebrew 安装 Archon。
```
brew install coleam00/archon/archon
```
5安装 Claude Code 并指向

快速安装的二进制不捆绑 Claude Code，需单独安装并把 CLAUDE_BIN_PATH 指向其可执行文件。
```
curl -fsSL https://claude.ai/install.sh | bash
export CLAUDE_BIN_PATH="$HOME/.local/bin/claude"
```
6Windows 设置路径

Windows 下先执行 Claude 安装脚本，再设置 CLAUDE_BIN_PATH 环境变量指向 claude.exe。
```
irm https://claude.ai/install.ps1 | iex
$env:CLAUDE_BIN_PATH = "$env:USERPROFILE.localinclaude.exe"
```
7完整安装向导

克隆仓库后运行引导式安装向导，它会配置凭证与平台集成，并把 Archon skill 复制到目标项目中。README 未给出向导的具体执行命令。
```
git clone https://github.com/coleam00/Archon.git
```

关键配置

配置项	必填	说明	示例
`CLAUDE_BIN_PATH`	是	编译版二进制需指定 Claude Code 可执行文件路径	`$HOME/.local/bin/claude`
`assistants.claude.claudeBinaryPath`	否	在配置文件中指定 Claude 二进制路径，替代环境变量	`~/.archon/config.yaml 中设置该字段`

如何确认成功

安装脚本执行无报错即表示 CLI 安装完成；完整安装后可通过 Web 仪表盘确认可用（README 未给出具体校验命令）。

常见问题

Q：macOS/Linux 快速安装失败怎么办？

A：多为 x64 CPU 不支持 AVX2 所致，老 Intel/AMD 硬件或屏蔽了 AVX2 的虚拟机请改用源码安装指南；ARM64 不受影响。

Q：提示找不到 Claude Code 怎么办？

A：快速安装的二进制不捆绑 Claude Code，请单独安装后设置 CLAUDE_BIN_PATH，或在 ~/.archon/config.yaml 中配置 assistants.claude.claudeBinaryPath。

Q：一定要用安装向导吗？

A：不必须。已经装好 Claude Code 的用户可以直接用快速安装或 Homebrew 安装 CLI，跳过向导。

Q：Docker 环境还要装 Claude Code 吗？

A：不需要，README 说明 Docker 镜像已预装 Claude Code，可直接使用。

注意事项

README 只给出安装入口，向导的具体命令与参数未提供，需参考 archon.diy/docs 官方文档。
Homebrew 与快速安装属于两种可选路径，通常选其一即可。
Windows 用户使用 PowerShell 脚本安装，注意用 $env: 语法设置环境变量。
x64 老硬件不支持 AVX2 时请改用源码安装方式。

核心亮点

首创 harness 概念，将 AI 编码从黑盒变为可编排的透明工作流
基于 YAML 定义流程，配置即代码，易于版本控制和团队协作
深度集成 Claude 等模型，内置重试和状态管理，提升生成结果稳定性

不足之处

项目较新，生态和周边工具链尚不成熟
文档/社区待观察

适用场景

需要将 AI 编码流程固化到 CI/CD 流水线中的团队
希望对比不同模型和提示词组合对编码结果影响的开发者
构建可复用的内部 AI 编码规范或最佳实践模板的组织

替代项目

Dify、Flowise、LangChain

项目介绍

Archon 是编程开发领域的开源项目，由 coleam00 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（23,528）位列前 2%，在编程开发分类的 490 个项目里位列前 6%。

近 44 天，它的 GitHub 星标从 23,116 增加到 23,528，净增 412。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：需要将AI编码流程固化到CI/CD流水线中的团队。同类可对比的替代方案包括 Dify、Flowise、LangChain。

上一篇：awesome-claude-code

下一篇：pr-agent