설치

1. AgentManager 설치

Windows (권장)

최신 릴리즈 에서 AgentManager-x.y.z-setup.exe 다운로드 → 실행.

• 서명된 설치본이지만 SmartScreen 이 경고를 띄울 수 있음 (신규 서명)
• 설치 후 자동 실행. Auto-update 는 4시간 주기로 백그라운드에서 새 버전 확인
• Portable 버전 (-debugger-portable.exe) 은 설치 없이 실행 가능하지만 auto-update 안 됨

macOS · Linux

현재 공식 빌드 없음. 소스에서 빌드 가능:

git clone https://github.com/karnelian/claude-project-manager.git
cd claude-project-manager
npm install
npm run build:electron

2. CLI 사전 준비

AgentManager 는 Claude Code / Codex CLI 를 spawn 하므로 최소 하나는 사전에 설치되어 있어야 합니다.

Claude Code

npm install -g @anthropic-ai/claude-code

설치 후 최초 1회 claude login 으로 OAuth 인증.

Codex CLI

npm install -g @openai/codex

설치 후 최초 1회 codex login 으로 인증.

앱 내 자동 설치

CLI 가 감지되지 않으면 OnboardingWizard 가 “⚡ 자동 설치” 버튼을 표시합니다. 클릭 시 앱이 npm install -g 를 실행하고 로그를 실시간 스트림해줍니다 (5분 timeout).

3. 설치 확인

앱 부팅 시 자동으로 /api/diagnostics 를 실행해 CLI · DB · System 상태를 확인합니다. 문제 발견 시 진단 패널이 자동으로 열립니다.

우측 상단 ⚡ 아이콘 → 시스템 진단 창에서 언제든 재확인 가능:

• Claude CLI — 버전 · 설치 경로
• Codex CLI — 버전 · 설치 경로
• 데이터베이스 — 크기 · 쓰기 가능
• 시스템 — win32/darwin/linux, node/electron 버전
• Claude 라이브 테스트 — 1 토큰 원샷 스폰으로 인증 실동작 확인

4. Windows Defender / 백신 예외

일부 백신이 Electron 앱을 신규 프로세스로 오탐하는 경우가 있습니다. AgentManager 실행 파일 (AgentManager.exe) 을 예외 처리하세요:

• %LocalAppData%\Programs\AgentManager\AgentManager.exe (per-user 설치 기본)

다음

• 첫 세션 — 프로젝트 등록부터 첫 응답까지