설치와 oah doctor

다른 도구를 설치하는 도구는 예상하지 못한 방식으로 컴퓨터를 바꿀 수 있고, 빠진 준비물은 대개 가장 곤란한 순간에 드러난다.

1. macOS는 xcode-select --install로 git을 준비하고 클론한 뒤 bash install/install.sh를 실행한다. Windows는 winget install --id Git.Git -e로 Git을 준비하고 클론한 뒤 powershell -ExecutionPolicy Bypass -File .\install\install.ps1을 실행한다.
2. 또는 릴리스 페이지에서 v0.3.0 태그의 소스 압축 파일과 SHA256SUMS를 받고, 압축 파일의 SHA-256(macOS는 shasum -a 256, Windows는 Get-FileHash -Algorithm SHA256)이 해당 항목과 일치할 때만 푼다.
3. --dry-run(-DryRun)은 순서대로 된 계획만 출력하고 아무것도 바꾸지 않는다. --yes는 빠진 도구를 하나씩 묻지 않고 설치하고, --skip-tools는 oah만 설치한다.
4. 다섯 단계다. Python 3.11 이상 찾기(없으면 uv 제안), 도구 확인과 빠진 도구마다 Install now? [y/N] 묻기, oah 설치, 새 터미널에서 oah를 찾는지 확인, oah doctor 실행.
5. 마지막 줄은 OAH_INSTALL_OK이거나 남은 일과 함께 OAH_INSTALL_INCOMPLETE다. 새 터미널에서 oah --version은 oah 0.3.0을 출력한다.

macOS에서 클론으로 설치한다(README).

git clone --branch v0.3.0 --depth 1 https://github.com/KenSuh/open-agent-harness.git
cd open-agent-harness
bash install/install.sh

• WSL 없이 macOS 13 이상이나 Windows 11. Windows 10 22H2는 가능한 범위에서 지원한다.
• Python 3.11 이상(실행 시 서드파티 패키지 없음), git, GitHub 저장소 같은 원격.
• 사용자가 설치하고 로그인한 Claude Code(Pro, Max, Team, Enterprise, Console 계정)와 Codex CLI(ChatGPT 요금제나 API 키).
• 권장. uv, Node.js(프로젝트가 게이트를 쓰면 필수), unlazy, graphify, gh, gitleaks, jq, ripgrep.

• Linux는 아직 지원하지 않는다.
• 비밀번호가 필요한 설치 프로그램은 직접 묻는다. oah는 비밀번호를 보지 않는다.
• dry run은 직접 받은 압축 파일을 검증하지 않는다. 지문 확인을 먼저 끝낸다.
• 설치 뒤 oah를 찾지 못하면 새 터미널을 열고, 그래도 안 되면 uv tool update-shell을 실행한다.
• pip가 “externally managed environment”라고 하면 uv를 설치하고 다시 실행한다. Windows에서 winget을 찾지 못하면 Microsoft Store에서 App Installer를 설치한다.

• README.ko.md ↗탐색기에서 열기
• docs/ko/install-windows.md ↗탐색기에서 열기
• docs/ko/how-it-works.md ↗탐색기에서 열기
• macOS에 설치하기 › 1. 설치 방법 고르기 ↗탐색기에서 열기

• 안내형 설정 oah init
• oah와 구성 요소 업그레이드
• 키와 로그인
• OAH_* 거절 해결