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로 언제든 모델을 전환할 수 있습니다.

3. 작업 주기

작업을 자연스러운 말로 입력하고 Enter를 누르세요:

Fix the failing tests in this repository.

iCode Agent는 코드를 탐색하고, 변경하고, 명령을 실행하며, 스스로 작업을 검증합니다. 실시간으로 지켜보고 원할 때마다 방향을 조정하세요.

비대화형 사용

스크립트와 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 검증은 아직 남아 있습니다.

계속 막혔나요? 이슈를 열어 주세요.