AI 에이전트 CLI 설치
이 페이지는 HagiCode의 통합 AI Agent CLI 로컬 설치 진입점입니다. HagiCode는 현재 11개의 Agent CLI를 활발히 지원합니다: Claude Code, Codex, GitHub Copilot, OpenCode, Hermes, QoderCLI, Kiro, Kimi, Gemini, DeepAgents, Codebuddy.
이용 방법
아래 표에서 각 CLI의 현재 상태와 설치 방식을 먼저 확인한 다음, 해당 공식 문서로 이동해 설치, 로그인, ACP, 권한, 문제 해결을 진행하세요. 핵심은 지원 여부와 원클릭 설치 지원 여부가 별개라는 점입니다.
설치하기 전에 Node.js 24+를 준비하세요
원클릭 설치를 지원하는 CLI 대부분은 Node.js와 npm에 의존하며, Desktop도 시스템의 node와 npm을 사용합니다(Desktop은 더 이상 Node.js를 내장하지 않습니다). 먼저 Node.js 설치에 따라 24 이상 버전을 준비하고, 설치를 마친 뒤에는 로그인 또는 인증을 완료하세요. 초기화 마법사에는 로컬에서 감지된 CLI만 표시됩니다.
현재 지원 매트릭스
| 도구 | 현재 상태 | 설치 방식 | 공식 설치 진입점 | 공식 참고 진입점 | 비고 |
|---|---|---|---|---|---|
| Claude Code | 현재 지원 | 원클릭 설치 | Getting Started | Overview | 기본 원클릭 설치 경로입니다. |
| Codex | 현재 지원 | 원클릭 설치 | OpenAI Codex CLI repository | OpenAI Codex docs | 기본 원클릭 설치 경로입니다. |
| GitHub Copilot | 현재 지원 | 원클릭 설치 | Install Copilot CLI | Copilot CLI overview | 기본 원클릭 설치 경로입니다. |
| OpenCode | 현재 지원 | 원클릭 설치 | OpenCode CLI docs | OpenCode docs | 설치 후 보통 로그인이나 /connect를 한 번 더 해야 합니다. |
| Hermes | 현재 지원 | 수동 설치 / 인증 | Hermes installation | Hermes quickstart | 현재 지원하지만 먼저 로컬 설치와 인증을 완료해야 합니다. |
| QoderCLI | 현재 지원 | 원클릭 설치 | Qoder Quick Start | Qoder ACP | 설치 후 공식 절차에 따라 로그인을 완료합니다. |
| Kiro | 현재 지원 | 원클릭 설치 | Kiro Installation | Kiro Authentication, Kiro ACP | 공식 설치 프로그램이 첫 실행 시 인증 절차를 안내합니다. |
| Kimi | 현재 지원 | 원클릭 설치 | Kimi Getting Started | Kimi ACP Reference | 설치 후 공식 절차에 따라 로그인을 완료합니다. |
| Gemini | 현재 지원 | 수동 설치 / 인증 | Gemini CLI installation, execution, and releases | Gemini CLI authentication setup | 현재 지원하지만 먼저 로컬 CLI 설치와 인증을 완료해야 합니다. |
| DeepAgents | 현재 지원 | 수동 설치 / 인증 | DeepAgents CLI overview | DeepAgents ACP | 현재 지원하지만 먼저 사용할 수 있는 deepagents --acp를 준비해야 합니다. |
| Codebuddy | 현재 지원 | 원클릭 설치 | CodeBuddy CLI Installation | CodeBuddy ACP | 기본 원클릭 설치 경로입니다. |
상태 설명
- 현재 지원: HagiCode가 현재 활발히 지원하는 범위에 속하며, 시스템에서 현행 Agent CLI로 사용할 수 있습니다.
- 원클릭 설치: HagiCode가 안내식 설치 진입점을 제공합니다. 일부 CLI는 설치 후에도 공급업체의 절차에 따라 로그인이나 인증을 계속해야 합니다.
- 수동 설치 / 인증: 이 CLI는 현재 지원 범위에 있지만, 먼저 로컬 설치, 로그인 또는 인증을 완료한 뒤 HagiCode로 돌아와 사용 가능 상태를 새로 고쳐야 합니다.
- 기존 호환성만 유지: iFlow CLI는 이전 데이터와의 호환성을 위해서만 유지되며, 현재 활발히 지원하는 목록에 속하지 않고 현행 권장 항목으로 간주해서도 안 됩니다.
다음 단계 제안
- 기본 환경을 먼저 갖추려면 Node.js 설치를 계속 읽고, 필요에 따라 OpenSpec 소개도 읽어 보세요.
- 여러 OpenAI 호환 도구를 하나의 로컬 게이트웨이로 통합하고 싶다면 OmniRoute 설치 및 사용을 계속 읽어 보세요.
- 이 Agent CLI들로 스펙 기반 개발을 시험해 보려면 Spec Kit 설치 방법을 읽고 Spec Kit과 OpenSpec 비교와 견주어 보세요.
- 전체 설치 경로와 Node.js, Git 등 사전 요구 사항이 궁금하다면 설치 가이드로 돌아가세요.
- 과거 글을 통해 이 사이트에 들어왔다면 이 페이지와 설치 개요 페이지의 현행 지원 설명을 기준으로 삼으세요.
HagiCode
HagiCode는 에이전트 코딩 작업 공간입니다. 풍부하고 편리한 UI 상호작용으로 계획 수립, 에이전트 실행, 프로젝트 작업을 쉽게 시작하고 따라가며 개발을 더 흥미로운 경험으로 만듭니다.
풍부하고 편리한 UI 상호작용으로 계획부터 프로젝트 작업까지 쉽게 따라갈 수 있습니다.
- 스마트OpenSpec 워크플로는 의도를 제안, 설계, 작업을 거쳐 배포까지 이어지는 실행 가능한 경로로 바꿉니다.
- 효율적다중 에이전트 실행으로 조사, 구현, 검토를 병렬로 진행하며 여러 저장소와 익숙한 Agent CLI를 지원합니다.
- 흥미로운풍부하고 편리한 UI 상호작용으로 계획 수립, 에이전트 실행, 프로젝트 작업을 쉽게 시작하고 따라갈 수 있습니다.
Windows용 다운로드
HagiCode 공유
아이디어를 실제로 배포되는 소프트웨어로.
HagiCode는 에이전트 코딩 작업 공간입니다. OpenSpec 워크플로로 변경을 계획하고, 다중 에이전트 실행으로 진행하며, Hero Scenario로 긴 작업의 진행 상황을 한눈에 보여 아이디어를 실제로 배포되는 소프트웨어로 만듭니다.
- 스마트
- OpenSpec 워크플로는 의도를 제안부터 배포까지 이어지는 실행 가능한 경로로 바꿉니다.
- 효율적
- 다중 에이전트 실행으로 조사, 구현, 검토를 병렬로 진행합니다.
- 즐거운
- 편리한 UI 상호작용으로 계획, 에이전트 실행, 프로젝트 작업을 쉽게 따라갈 수 있습니다.
© 2026 HagiCode | Powered By hagilight-starlight@0.20.0 | Branch: main | Commit: 0dde182 | Built: