설치

빠른 설치

macOS / Linux

curl -fsSL https://harnesslab.codewithgenie.com/install | bash

Windows (PowerShell)

irm https://harnesslab.codewithgenie.com/install.ps1 | iex

Homebrew (macOS / Linux)

brew install <tap>/hlab

Docker

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

소스에서 설치

git clone https://github.com/NewTurn2017/HarneesLab
cd HarneesLab
bun install

사전 요구사항(소스 설치)

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

Claude Code 설정

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

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

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

소스 설치(bun run)는 node_modules를 통해 실행 파일을 자동으로 찾습니다. compiled HarneesLab binary(빠른 설치, Homebrew)는 Claude Code 실행 파일 위치를 직접 지정해야 합니다.

# native installer를 사용한 경우:
export CLAUDE_BIN_PATH="$HOME/.local/bin/claude"

# `npm install -g @anthropic-ai/claude-code`를 사용한 경우:
export CLAUDE_BIN_PATH="$(npm root -g)/@anthropic-ai/claude-code/cli.js"

또는 ~/.harneeslab/config.yaml에 지속 설정으로 저장할 수 있습니다. HarneesLab은 compatibility를 위해 이 기본 경로를 유지합니다.

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

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

자세한 내용과 설치 방식별 경로는 AI Assistants → Claude Code를 참고하세요.

설치 확인

hlab version

다음 단계

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