시작하기

설치 방법

Praxis는 통합 설치 CLI인 @ouonet/praxis를 제공하며, 각 AI 하네스의 네이티브 플러그인 생태계와도 완벽히 호환됩니다.

방법 1: Praxis CLI (권장)

사전에 글로벌 의존성을 설치할 필요 없이 npx를 통해 각 환경의 설치, 업데이트, 상태 확인을 통합 관리할 수 있습니다:

# 설치된 호스트 및 Praxis 상태 확인
npx @ouonet/praxis status

# 감지된 모든 호스트에 일괄 설치
npx @ouonet/praxis install --host all

# 특정 호스트에 설치
npx @ouonet/praxis install --host claude --scope user
npx @ouonet/praxis install --host opencode --scope project
npx @ouonet/praxis install --host codex --scope local
npx @ouonet/praxis install --host antigravity
npx @ouonet/praxis install --host pi
npx @ouonet/praxis install --host omp
npx @ouonet/praxis install --host qoder

지원 호스트 (Hosts)

• claude: Claude Code CLI
• codex: Codex CLI / App
• opencode: OpenCode
• antigravity (별칭 agy): Antigravity CLI / AGY
• pi: pi CLI
• omp (별칭 oh-my-pi): Oh My Pi
• qoder (별칭 qoderclicn): Qoder CLI CN
• copilot: GitHub Copilot CLI
• agents (별칭 generic): .agents 표준 사양을 따르는 범용 Agent
• all: 지원되는 모든 호스트에 설치

설치 범위 (Scopes)

• user / global (전역 기본값): 전역 사용자 홈 범위 (~/.claude, ~/.codex, ~/.gemini/config, ~/.omp, ~/.qoder-cn 등), 모든 작업 공간에서 사용 가능.
• project: Git 등으로 추적되는 프로젝트 범위 (opencode.json, .agents/skills/, .claude/settings.json 등), 팀과 공유.
• local: 현재 작업 디렉토리 전용 로컬 범위. 공유 설정 파일을 수정하지 않고 활성화.

관리 명령어

# Praxis 업데이트
npx @ouonet/praxis update --host all

# Praxis 제거
npx @ouonet/praxis uninstall --host opencode --scope project

---

방법 2: 각 호스트 네이티브 설치

각 도구의 기본 명령어나 설정 파일을 사용하여 직접 설치할 수도 있습니다:

Claude Code

claude plugins marketplace add ouonet/praxis
claude plugins install praxis

Codex

.codex/config.toml에 설정:

[plugins."praxis@git+https://github.com/ouonet/praxis.git"]
enabled = true

OpenCode

opencode.json에 설정:

{
  "plugin": ["praxis@git+https://github.com/ouonet/praxis.git"]
}

Antigravity CLI (AGY)

agy plugin install https://github.com/ouonet/praxis

pi CLI

# 전역 설치
pi install git:github.com/ouonet/praxis

# 프로젝트 범위 설치 (.pi/settings.json에 기록)
pi install -l git:github.com/ouonet/praxis

Oh My Pi (omp)

omp plugin add https://github.com/ouonet/praxis

Qoder CLI CN

프로젝트 루트의 .qoder-plugin 디렉토리에 plugin.json을 추가하거나, 전역 ~/.qoder-cn/plugins/에 설정합니다.

---

브랜치에서 설치

미출시 버전이나 개발 브랜치를 테스트하려면:

# CLI를 통한 브랜치 설치
npx @ouonet/praxis install --host claude --ref <branch>
npx @ouonet/praxis install --host opencode --ref <branch>

네이티브 방식:

• Claude Code: claude plugins marketplace add ouonet/praxis#<branch> 및 claude plugins install praxis
• pi CLI: pi install git:github.com/ouonet/praxis@<branch>
• OpenCode: "plugin": ["praxis@git+https://github.com/ouonet/praxis.git#<branch>"]

---

검증

새 세션을 시작하고 다음을 전송합니다:

fix the typo "teh" in README

예상 출력: praxis: scope=trivial, loading= —— 설계 문서나 계획 없이 파일을 바로 수정합니다.

이어서 다음을 전송합니다:

add OAuth login with GitHub

예상 출력: praxis: scope=standard, loading=design,plan,tdd,review —— 코드를 수정하기 전에 명확화 질문을 하고 명세 계약을 수립합니다.

---

모델 티어 설정 (선택 사항)

병렬 서브에이전트(subagents)나 명세 리뷰어(design 게이트)를 디스패치할 때, Praxis는 작업 기능 티어(fast, balanced, strongest)를 할당합니다.

프로젝트 루트 또는 홈 디렉토리에 .praxis/model-tiers.yaml 파일을 생성하여 티어를 특정 모델에 매핑할 수 있습니다:

fast: claude-3-5-haiku
balanced: claude-3-7-sonnet
strongest: claude-3-7-sonnet

설정 파일이 없는 경우 모든 서브에이전트는 하네스의 기본 모델을 사용합니다.