iCode란 무엇인가요?
iCode는 AI 에이전트와 워크플로를 오케스트레이션하는 오픈 소스 터미널 애플리케이션입니다. 대화, 모델 프로필, 에이전트 구성, 셸 액세스, 파일 변경 사항, 롤백 제어, 실행 분석을 하나의 인터페이스로 제공합니다.
개발 중: iCode의 인터페이스, 파일 형식, 기본값은 릴리스마다 변경될 수 있습니다.
iCode에는 AI 모델이 포함되어 있지 않습니다. 대신 모델 제공업체를 직접 연결하고, 에이전트가 사용할 구성된 프로필을 선택합니다.
주요 기능
- 터미널 채팅: 서식이 적용된 목록과 다이어그램을 포함한 풍부한 Markdown 응답을 확인할 수 있습니다.
- 구성 가능한 에이전트: 에이전트 코드를 작성하지 않고도 지침, 도구, 하위 에이전트, 스킬, MCP 서버, 메모리를 정의할 수 있습니다.
- 다중 모델 프로필: 여러 제공업체의 프로필을 구성하고 대화 중에 모델을 전환할 수 있습니다.
- 워크플로 시각화: 워크플로를 노드별로 따라가며 각 에이전트 노드의 모델, 도구 호출, 토큰 사용량을 확인할 수 있습니다.
- 변경 사항 검토: 통합 또는 분할 diff 보기에서 에이전트가 수정한 모든 파일을 확인할 수 있습니다.
- 롤백: 이전 턴을 선택하고 되돌릴 변경 사항을 검토한 뒤 해당 시점 이후의 대화를 삭제할 수 있습니다.
- 실행 경로 분석: 시간, 토큰, 캐시, 병렬 처리 내역과 모델 호출, 훅, 도구 호출을 확인할 수 있습니다.
- 통합 셸: 전체 화면 애플리케이션을 포함한 실제 터미널을 iCode 안에서 실행할 수 있습니다.
사전 요구 사항
필수 사전 요구 사항은 uv뿐입니다. 프로젝트에서 Python 3.14를 제공하므로 해당 Python 버전을 별도로 설치할 필요가 없습니다.
최상의 경험을 위해 최신 터미널을 사용하세요. README에서는 Windows에서 Windows Terminal을, macOS와 Linux에서 Ghostty를 사용할 것을 권장합니다.
iCode 설치 및 실행
먼저 저장소를 로컬에 체크아웃합니다. 루트 디렉터리에서 터미널을 열고 필요한 모든 추가 기능과 함께 프로젝트를 동기화하세요.
uv sync --extra all--extra all을 표시된 그대로 사용하세요. 프로젝트에서는 단순히 uv sync를 사용하거나 해당 옵션을 --all-extras로 바꾸지 말 것을 명시적으로 안내합니다.
다음으로 포함된 ripgrep 바이너리를 다운로드합니다. macOS 또는 Linux에서는 다음을 실행하세요.
./scripts/fetch_rg.shWindows에서는 대신 PowerShell 스크립트를 실행하세요.
.\scripts\fetch_rg.ps1마지막으로 iCode를 실행합니다.
uv run icode프로젝트의 코드명은 Chrys이므로 다음 명령으로 동일한 애플리케이션을 시작할 수 있습니다.
uv run chrys첫 번째 모델 구성
iCode는 모델 프로필 없이 제공됩니다. 처음 실행할 때 F4를 눌러 모델 구성을 열고 사용하는 모델 제공업체의 프로필을 추가하세요.
프로필을 구성한 후에는 서로 다른 제공업체의 프로필을 나란히 유지하고 대화 중에 전환할 수 있습니다. iCode 자체에는 모델이 없으므로 구성한 제공업체 연결에 따라 모델 요청이 전송되는 곳이 결정됩니다.
기본 사용법
입력창에서 탐색
홈 화면에는 현재 에이전트, 모델, 승인 모드, 세션이 표시됩니다. 여러 접두사를 사용하면 중요한 기능에 빠르게 액세스할 수 있습니다.
#에이전트에 액세스합니다.$모델에 액세스합니다./명령에 액세스합니다.@파일에 액세스합니다.!셸에 액세스합니다.
대화 시작
에이전트와 구성된 모델을 선택한 다음 입력창에 요청을 입력하세요. 응답은 터미널에 풍부한 Markdown 형식으로 바로 표시됩니다. 에이전트가 파일을 수정하면 iCode가 해당 변경 사항을 기록하므로 턴별로 또는 한 번에 검토할 수 있습니다.
에이전트 구성
F2를 눌러 에이전트 구성을 여세요. 에이전트는 애플리케이션 코드가 아니라 구성으로 이루어집니다. 이 화면에서 지침, 도구, 하위 에이전트, 스킬, MCP 서버, 메모리를 편집할 수 있습니다.
에이전트의 지침을 목적에 맞게 유지하고 필요한 도구와 통합 기능만 활성화하세요. 외부 도구와 서버가 데이터를 독립적으로 처리할 수 있으므로 개인정보 보호 측면에서도 중요합니다.
파일 변경 사항 검토
diff 뷰어를 사용하여 에이전트가 변경한 파일을 확인하세요. 한 번에 한 턴씩 변경 사항을 검토하거나 전체 보기로 모을 수 있습니다. 통합 보기와 분할 보기 모두 사용할 수 있습니다.
워크플로 실행 및 검사
워크플로 모드를 사용하면 워크플로가 노드별로 실행되는 과정을 확인할 수 있습니다. 각 에이전트 노드에서 iCode는 선택한 모델, 도구 호출, 토큰 사용량을 표시할 수 있습니다.
이 보기는 여러 단계나 에이전트가 포함된 작업에 유용합니다. 실행을 하나의 불투명한 응답으로 처리하는 대신, 작업이 그래프를 통해 어떻게 진행되는지 확인할 수 있습니다.
고급 팁
잘못된 턴에서 계속하기 전에 롤백 사용
대화에서 원치 않는 수정이 발생하면 이전 턴을 선택하고 롤백을 엽니다. iCode는 롤백을 적용하기 전에 되돌릴 파일 변경 사항을 표시합니다. 그런 다음 선택한 턴 이후의 대화 내용을 삭제합니다.
확인하기 전에 제안된 파일 되돌리기 내용을 주의 깊게 검토하세요. 특히 여러 턴에서 같은 파일을 수정한 경우에는 더욱 그렇습니다.
Trajectory로 실행 분석
F12를 눌러 궤적 보기를 엽니다. 개요에서 모델 활동, 도구 실행, 대기 시간을 구분하여 시간과 토큰이 어디에 사용되었는지 설명합니다. 턴별 토큰 및 캐시 사용량과 병렬 처리 정보도 제공합니다.
타임라인에서는 한 턴 내의 개별 모델 호출, 훅, 도구 호출을 자세히 확인할 수 있습니다. 비용이 많이 들거나 느린 상호작용을 조사하고 작업 순서를 파악하는 데 사용하세요.
통합 셸 사용
!를 입력하여 셸을 엽니다. 제한된 명령 출력 패널이 아니라 실제 터미널이므로 전체 화면 프로그램을 그 자리에서 실행하고 모든 키 입력을 전달할 수 있습니다.
명령, 스킬 스크립트, 워크플로는 네트워크에 액세스할 수 있는 독립적인 프로그램입니다. 특히 민감한 환경에서는 실행하기 전에 해당 작업을 검토하세요.
전체 사용자 가이드 열기
iCode에서 F8을 눌러 내장 사용자 가이드를 엽니다. 동일한 문서는 저장소의 docs/ 디렉터리에서 영어와 중국어 간체로 제공됩니다.
개인정보 보호 및 외부 연결
iCode에는 원격 측정, 분석 또는 충돌 보고 기능이 없으며 사용자의 데이터를 수집하지 않습니다. 기본적으로 사용 데이터 등 어떤 정보도 프로젝트나 다른 제3자에게 전송하지 않습니다.
그러나 모델 제공업체, MCP 서버, 훅, OpenTelemetry 내보내기 등 사용자가 구성한 대상으로 데이터가 전송될 수 있습니다. 웹 도구는 기본적으로 비활성화되어 있습니다. 활성화하면 검색은 구성한 제공업체로 전송되며, 제공업체가 구성되지 않은 경우 Exa의 공개 mcp.exa.ai 서비스로 전송됩니다. 페이지는 해당 웹사이트에서 직접 요청합니다.
규정 준수 및 라이선스
iCode는 오케스트레이션 도구이며 AI 모델을 제공하지 않습니다. 비즈니스 또는 엔지니어링 용도로 모델을 연결할 때 EU AI 법 및 기타 적용 가능한 법률 또는 규제 요건을 준수할 책임은 사용자에게 있습니다.
이 프로젝트는 Apache License 2.0에 따라 오픈 소스로 제공됩니다. 포함된 타사 구성 요소에는 각각의 라이선스가 적용되며, 해당 라이선스는 저장소의 NOTICE 파일에 문서화되어 있습니다.
결론
uv, 최신 터미널, 구성된 모델 프로필을 사용하면 iCode를 터미널 기반 AI 에이전트와 워크플로를 위한 중앙 인터페이스로 활용할 수 있습니다. 간단한 대화부터 시작하여 생성된 모든 파일 변경 사항을 검토한 다음, 작업이 복잡해질수록 에이전트 구성, 워크플로, 롤백, 셸 액세스, 궤적 분석을 살펴보세요.