claude-code
무엇인가
Claude Code는 터미널 세션 안에서 동작하는 에이전트형 코딩 도구다. 자동완성이나 채팅 창이 아니라 저장소를 직접 읽고 명령을 실행하는 실행 주체로 자리한다. 반복 작업 실행, 복잡한 코드 설명, git 워크플로 처리를 자연어 지시로 수행한다.
어떻게 동작하나
배포 단위는 npm 패키지 @anthropic-ai/claude-code이며, 프로젝트 디렉터리에서 `claude`를 실행하면 세션이 시작된다. 세션은 현재 작업 디렉터리의 코드베이스를 읽어 맥락으로 삼고, 입력된 자연어 명령을 파일 편집·셸 명령 실행·git 조작으로 옮긴다. 저장소에는 커스텀 명령과 에이전트를 추가하는 플러그인 디렉터리가 포함된다. 터미널 외에 IDE와 GitHub에서 @claude 멘션으로도 호출된다.
무엇과 다른가
인라인 자동완성 도구가 커서 위치의 다음 토큰을 제안하는 것과 달리, 이 도구는 작업 단위를 통째로 위임받는다. 채팅 UI가 코드를 대화 맥락에만 두는 것과 달리 파일 시스템과 셸에 직접 접근해 변경을 적용한다. 브랜치·커밋·diff 같은 git 워크플로가 도구의 실행 범위 안에 들어간다.
어떻게 쓰나
설치는 Homebrew, WinGet 같은 패키지 관리자를 권장하며 npm 설치는 지원 중단됐다. 설치 후 프로젝트 디렉터리로 이동해 `claude`를 실행하는 것이 첫 단계다. 플러그인 디렉터리의 커스텀 명령·에이전트로 기능을 확장하고, 문제 보고는 세션 안에서 `/bug` 명령으로 한다.
전제와 한계
동작에는 Claude 모델 접근 권한이 전제된다. 사용 시 코드 수락·거부 같은 사용 데이터, 관련 대화 데이터, `/bug`로 제출한 피드백이 수집된다. 민감 정보에는 제한된 보존 기간이 적용되고, 피드백을 모델 학습에 사용하지 않는 정책이 명시돼 있다. 설치 방식별 지원 범위와 제거 절차는 별도 setup 문서를 따른다.
관련 논문 3
유사 도구
- aiden파일·터미널·브라우저·API 작업을 계획-실행-검증 절차로 규율하는 자율 에이전트 런타임이다. npm으로 설치해 aiden 명령과 트리거로 규칙을 주입한다.
- Graft코드베이스를 링크된 마크다운 노드 그래프로 만들어 저장소에 두고, 코딩 에이전트가 탐색 없이 읽게 하는 TypeScript CLI다.
- emdash여러 AI 코딩 에이전트를 Git worktree마다 격리해 병렬 실행하고, diff 검토와 PR 생성·CI 확인·머지를 한 화면에서 처리하는 데스크톱 앱이다.
- code2prompt코드베이스를 소스 트리와 함께 하나의 LLM 프롬프트로 렌더링하는 Rust CLI다. glob 필터와 Handlebars 템플릿, 토큰 추정을 쓴다.
- gawkbot자연어 한 문장으로 업무 워크플로를 로컬 AI 봇과 마이크로앱으로 만들어 주는 Go 기반 CLI다. 외부로 나가는 모든 동작에 사람 승인 게이트를 둔다.
- nixopusGitHub 저장소를 연결하면 AI 에이전트가 코드베이스를 분석해 빌드 설정을 생성하고 컨테이너로 배포하는 셀프호스팅 배포 플랫폼이다. Caddy로 TLS를 자동 발급한다.