설치

빠른 설치

macOS / Linux

curl -fsSL https://archon.diy/install | bash

Windows (PowerShell)

irm https://archon.diy/install.ps1 | iex

Homebrew (macOS / Linux)

brew install coleam00/archon/archon

Docker

docker run --rm -v "$PWD:/workspace" ghcr.io/coleam00/archon:latest workflow list

소스에서 설치

git clone https://github.com/coleam00/Archon
cd Archon
bun install

사전 요구사항(Source Install)

• Bun >= 1.0.0
• GitHub CLI (gh)
• Claude Code (claude)

Claude Code가 필요합니다

Archon은 Claude Code를 orchestration하지만, Claude Code를 함께 포함하지는 않습니다. Claude Code는 별도로 설치해야 합니다.

# macOS / Linux / WSL (Anthropic's recommended installer)
curl -fsSL https://claude.ai/install.sh | bash

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

source install(bun run)은 node_modules를 통해 실행 파일을 자동으로 찾습니다. compiled binary(quick install, Homebrew)는 Claude Code 실행 파일 위치를 직접 지정해야 합니다.

# After the native installer:
export CLAUDE_BIN_PATH="$HOME/.local/bin/claude"

# After `npm install -g @anthropic-ai/claude-code`:
export CLAUDE_BIN_PATH="$(npm root -g)/@anthropic-ai/claude-code/cli.js"

또는 ~/.archon/config.yaml에 지속 설정으로 저장할 수 있습니다.

assistants:
  claude:
    claudeBinaryPath: /absolute/path/to/claude

Docker image(ghcr.io/coleam00/archon)에는 Claude Code가 미리 설치되어 있고 CLAUDE_BIN_PATH도 미리 설정되어 있으므로 별도 설정이 필요 없습니다.

자세한 내용과 install layout별 경로는 AI Assistants → Claude Code를 참고하세요.

설치 확인

archon version

다음 단계

• 핵심 개념 — workflow, node, command, isolation 이해하기
• 빠른 시작 — 첫 workflow 실행하기
• 설정 — API key와 preference 설정하기