KlaatAI/klaatcode

Klaat Code – 터미널 네이티브 AI 코딩 어시스턴트

개요 – Klaat Code는 터미널에서 직접 AI 코딩 에이전트와 대화할 수 있는 명령줄 도구입니다. 요청을 입력하면(예: “fix all TypeScript errors”) 에이전트가 프로젝트를 읽고, 파일을 편집하고, 명령을 실행하고, 결과를 확인하며, 이 모든 과정은 사용자의 제어 하에 이루어집니다.

작동 방식 – 모든 사용자 메시지는 호스팅된 "라우터" 모델인 Klaatu-o1으로 전송됩니다. Klaatu는 6개의 비용 계층 모델(nano, fast, code, reason, heavy, titan) 중 요청에 적합한 모델을 결정하고 프롬프트를 전달합니다. 라우터는 작업이 예상보다 어려울 경우 자동으로 더 강력한 계층으로 에스컬레이션하고, 추가 능력이 필요하지 않을 때 디에스컬레이션합니다. 사용자 메시지만 할당량에 포함되며, 모든 도구 호출(파일 읽기, 셸 명령, 웹 검색 등)은 무료입니다.

주요 차별화 요소

1. 요청별 스마트 라우팅 – 모델을 미리 선택할 필요가 없습니다. 서비스가 해당 턴을 해결할 수 있는 가장 저렴한 계층을 선택하고 필요한 경우에만 업그레이드합니다.
2. 코드 그래프 인덱스 – 프로젝트는 의미론적 호출 그래프로 인덱싱됩니다. 에이전트는 전체 파일을 로드하지 않고도 심볼, 호출자, 피호출자, 영향 범위를 쿼리할 수 있어 토큰 사용량을 5~15배 절감합니다.
3. 무제한 도구 라운드 – 고정된 횟수의 도구 호출 후 중단되는 많은 CLI 에이전트와 달리, Klaat Code는 모델이 자유롭게 반복하도록 허용합니다. 서버는 실제 루프를 감지하고 복구 지침과 함께 중단합니다.
4. 내장 비용 가드 – 실시간 소비율 모니터링, 작업별 비용 분석, 하드 세션 캡, CI 파이프라인용 --max-cost 플래그.
5. 검증을 통한 컨텍스트 압축 – 대화가 모델의 컨텍스트 창을 초과하면 클라이언트는 손실된 부분을 자동으로 요약하고, 요약을 검증하며, 무엇이 잊혀졌는지 모델에게 정확히 알립니다.
6. 재현 가능한 벤치마크 – 리포지토리에는 Claude Code, Cursor, opencode 등에 대해 게시된 비용 및 속도 수치를 재현하는 벤치마크 하네스(bun run bench)가 포함되어 있습니다.

주요 기능

• 풍부한 터미널 UI – 구문 강조 Markdown, 실시간 토큰/비용 카운터, 마우스로 드래그 가능한 코드 블록, 14가지 색상 테마, Vim 모드, 라우팅 분석을 보여주는 사이드바.
• 슬래시 명령 – /tier, /model, /why, /cost, /context, /compact, /diff, /review, /commit, /undo, /checkpoint, /rollback, /skill, /plugin, /mcp 등.
• 도구 세트 – 파일 읽기/쓰기, 패치 적용, glob/grep, 셸 명령 실행(권한 제어), 웹 가져오기/검색, 프로젝트 그래프 쿼리, 의미론적 검색, 영향 범위 분석, 브라우저 자동화, 범위 지정 작업을 위해 하위 에이전트를 생성하는 위임 시스템.
• Git 통합 – AI 생성 diff, 리뷰, 커밋 메시지, 쉬운 실행 취소/롤백.
• 확장성 – 사용자 지정 도구(JavaScript 플러그인), 재사용 가능한 프롬프트 템플릿(스킬), 수명 주기 후크, 프로젝트 전체 규칙 파일.
• 권한 및 안전 – 3계층 권한 모델, 샌드박스 쓰기, 위험한 명령에 대한 거부 목록, 폭주 루프 자동 감지.

설치 – 전역 npm 패키지, 한 줄 스크립트, Homebrew 공식 또는 Windows PowerShell 설치 프로그램으로 제공됩니다. 설치된 바이너리는 Node/Bun 런타임 없이 실행됩니다. CLI 자체는 작은 도우미(klaatai)와 함께 제공되는 컴파일된 바이너리입니다.

일반적인 워크플로우

klaatcode login               # 브라우저를 열고 KlaatAI 계정에 로그인
klaatcode                     # 현재 리포지토리에서 대화형 세션 시작
# 요청 예시
> fix all TypeScript errors
# 에이전트:
#   • 프로젝트 그래프 읽기
#   • TypeScript 컴파일러 실행
#   • 파일 편집
#   • linter 다시 실행
#   • diff 및 요약 반환

CI의 경우 헤드리스로 실행할 수 있습니다:

klaatcode run "apply eslint fixes" --max-cost 0.10

실행이 예산을 초과하면 파이프라인이 안전하게 실패할 수 있도록 특정 코드로 종료됩니다.

벤치마크(2026년 7월) – 33개 작업 제품군에서 에이전트는 작업당 평균 $0.027(약 52K 토큰)의 비용과 23초의 중앙값 지연 시간으로 33/33 작업을 해결했습니다. 이는 Claude Code보다 약 5.4배, 가장 가까운 경쟁사보다 약 1.7배 저렴하면서도 완벽한 해결률을 유지합니다.

적합한 대상 – 터미널에 상주하는 AI 페어 프로그래머를 원하는 개발자, 세밀한 비용 제어가 필요한 개발자, 토큰 예산이 중요한 코드베이스(대규모 모노레포, CI 파이프라인 등)에서 작업하는 개발자. 또한 라우팅 인텔리전스는 비공개로 유지하면서 클라이언트는 오픈 소스로 공개하려는 팀에게도 적합합니다.

문서 및 지원 – 전체 참조는 https://klaatai.com/docs, 실시간 Discord 커뮤니티, 공개 벤치마크 대시보드를 참조하세요.