iCode Agent · FAQ

질문과 답변.

iCode Agent는 어떻게 설치하나요?

Node.js 22 이상을 설치한 후 npm install -g @icodehq/icode-agent를 실행하세요. 시작하기를 참고하세요.

iCode Workbench와 iCode Agent는 어떻게 다른가요?

iCode Workbench(1.0 이전)는 데스크톱 ADE입니다. Claude Code, Codex, OpenCode를 각자의 Git 워크트리에서 병렬로 실행하며, 프로젝트 전반의 작업, 검토, Mira를 제공합니다. iCode Agent는 이 FAQ에서 설명하는 집중형 터미널 에이전트입니다. 두 제품은 별개이며 각각 단독으로 작동합니다.

Agent를 쓰려면 Workbench가 필요한가요?

아니요. iCode Agent는 독립형 CLI입니다. npm으로 설치해 어떤 저장소에서든 실행하면 됩니다. 현재 Workbench는 iCode Agent를 감싸거나 실행하지 않습니다.

어떤 모델을 사용할 수 있나요?

iCode Agent는 openai 및 anthropic 프로토콜을 사용하므로 공식 API와 호환되는 모든 엔드포인트에서 작동합니다. /model로 설정하세요.

Bun이 필요한가요?

아니요. Bun은 iCode Agent 자체를 개발할 때 쓰는 런타임입니다. 게시된 패키지는 Node.js 22 이상에서 실행됩니다.

어떤 플랫폼이 검증되었나요?

Windows, macOS, Linux용 크로스 플랫폼 호환성이 구현되어 있습니다. 자동 검증은 Linux에서 수행되며, 네이티브 Windows 및 macOS 검증은 아직 남아 있습니다.

iCode Agent가 내 코드를 업로드하나요?

로컬에서 실행되며, 제공한 API 키를 사용해 설정한 모델 엔드포인트와만 통신합니다. 소스는 실행하는 작업의 컨텍스트로 해당 엔드포인트에 전송되며, 공급자의 데이터 정책이 적용됩니다.

실행 비용은 얼마인가요?

iCode Agent 자체는 무료 오픈 소스(Apache-2.0)입니다. 사용한 토큰에 대해 모델 공급자에게만 비용을 지불하며, iCode Agent는 긴 작업에서 그 비용을 낮게 유지하도록 만들어졌습니다.

iCode Agent는 토큰 사용량을 어떻게 낮게 유지하나요?

컨텍스트는 모든 경계에서 관리됩니다. 출력은 생성되는 즉시 제한되고, 오래된 도구 결과는 요청이 예산을 초과할 때만 축소되며, 넘치는 기록은 최근 구간을 유지한 채 요약됩니다. 컨텍스트 관리 방식을 참고하세요.

컨텍스트를 줄이면 정보가 사라지나요?

보류된 결과는 전체 출력이 아직 있는 위치를 알려 주는 마커로 대체되어, 에이전트가 다시 읽을 수 있습니다. 실패 증거와 오류는 절대 보류하지 않으며, 축소는 전송되는 요청만 바꿉니다. 저장된 세션은 모든 결과를 보관합니다.

작업은 어디에 저장되나요?

세션은 구성 디렉터리(~/.icode-agent/)에 자동으로 저장됩니다. --continue로 최근 세션을, --resume <id>로 특정 세션을 재개하거나 /session으로 관리하세요.

어떤 에이전트나 편집기와 함께 쓰이나요?

iCode Agent는 자체 터미널 에이전트입니다. 다른 에이전트를 거치지 않고 직접 사용합니다. 구성과 세션은 CLI와 TUI에서만 읽습니다.

프로덕션 사용에 적합한가요?

iCode Agent는 초기 실험 개발 단계이며 빠르게 바뀝니다. 각 릴리스의 내용은 변경 로그를 참고하세요.