安装必备工具

按照README要求安装Bun运行时、GitHub CLI和Claude Code。验证安装：运行`bun --version`、`gh --version`确保工具可用

Claude Code需要注册Claude账号，如果已有账号可直接使用

选择安装方式

根据自身情况选择： 1. 完整安装（推荐新手）：克隆仓库运行引导设置 2. 快速安装：如果已有Claude Code，直接安装CLI二进制文件

新手建议使用完整安装，引导设置会配置好所有必要项

运行设置向导

如果选择完整安装，运行设置向导配置凭证、平台集成，并将Archon技能复制到目标项目

按照向导提示一步步操作，注意保存生成的配置信息

启动Web UI

运行`archon serve`启动Web界面，这是最直观的交互方式

Web UI会自动下载并启动，首次启动可能需要几分钟

注册第一个项目

在Web UI中点击侧边栏Project旁的+号，输入GitHub仓库URL或本地路径注册项目

可以从一个简单的个人项目开始，避免在复杂项目上初次尝试

运行预置工作流

在聊天界面尝试： 1. 输入简单问题测试`archon-assist`工作流 2. 尝试`archon-fix-github-issue`修复一个小bug

观察工作流执行步骤，理解AI节点和确定性节点的区别

学习CLI基本命令

掌握关键CLI命令： - `archon workflow list` 查看所有工作流 - `archon workflow run <workflow-name>` 运行特定工作流 - `archon serve` 启动Web UI

CLI适合自动化场景，Web UI适合交互式使用

理解工作流结构

查看`.archon/workflows/defaults/`目录下的示例工作流，理解YAML结构： - phases（阶段） - nodes（节点） - validation gates（验证门）

重点关注`archon-fix-github-issue.yaml`，这是最常用的工作流

体验工作树隔离

同时运行两个工作流任务，观察Archon如何为每个运行创建独立的git worktree避免冲突

这是Archon的核心特性之一，确保并行任务不会相互干扰

创建自定义命令

在`.archon/commands/`目录创建markdown文件定义新命令，让AI理解你的特定需求

可以从复制默认命令开始修改，逐步添加自己的需求描述

修改现有工作流

复制默认工作流到项目根目录的`.archon/workflows/`并修改，添加或删除步骤

项目目录的工作流会覆盖默认工作流，这是定制化的关键

连接外部平台

选择连接一个平台（推荐Telegram，设置最简单），体验从聊天平台触发工作流

平台集成让你可以在移动设备上管理开发任务