iCode Agent · 시작하기
iCode Agent를 설치하세요.
패키지 하나, 설치 한 번. iCode Agent는 Windows, macOS, Linux에서 Node.js 22 이상으로 실행됩니다.
이 가이드는 터미널 에이전트를 다룹니다. 데스크톱 환경은 iCode Workbench를 참고하세요.
1. 설치
전역으로 설치한 뒤 아무 프로젝트에서나 실행하세요:
npm install -g @icodehq/icode-agent cd ~/my-project icode-agent
설치를 원하지 않나요? npx @icodehq/icode-agent로 한 번 실행해 보세요.
2. 모델 구성
처음 실행하면 iCode Agent는 워크스페이스가 열리기 전에 모델을 설정합니다. openai 및 anthropic 프로토콜을 사용하므로 공식 API와 호환되는 모든 엔드포인트에서 작동합니다.
- 기존 구성을 선택하거나 새로 추가하세요: 프로토콜, 엔드포인트, 모델 이름, API 키.
- 실제 연결 테스트를 통과해야만 저장됩니다.
- 구성은
~/.icode-agent/models.json에 로컬로 저장됩니다.
/model 또는 Ctrl+P로 언제든 모델을 전환할 수 있습니다.
비대화형 사용
스크립트와 CI용:
icode-agent -p "run the tests and report failures" # print the final response icode-agent --mode json -p "find TODO comments" # stream events as JSON lines icode-agent -c -p "now fix what you found" # continue the last session
문제 해결
- 워크스페이스가 열리지 않습니다 — 아직 활성 모델이 없습니다. 설정 흐름을 완료하거나
~/.icode-agent/models.json을 직접 작성하세요. - 명령이 즉시 실패합니다 — Windows에서는 기본적으로 명령이 PowerShell에서 실행됩니다. CMD를 사용하려면 설정에서
"shell": "cmd"를 지정하세요. - 긴 작업이 느려집니다 — iCode Agent는 요청을 제한된 크기로 유지하려고 오래된 컨텍스트를 요약하며, 그럴 때 알려 줍니다.
크로스 플랫폼 호환성이 구현되어 있습니다. 자동 검증은 Linux에서 수행되며, 네이티브 Windows 및 macOS 검증은 아직 남아 있습니다.
계속 막혔나요? 이슈를 열어 주세요.