how claude code works
Claude Code 가 어떻게 일하나
터미널·IDE·웹·CI 어디서든 굴러가는 에이전트 코딩 어시스턴트.
공식 문서 기반 · 7 장 · 키보드 ← → 또는 점을 눌러 넘기기
본질
모델 + 도구 = 에이전트.
Claude Code 는 모델 주변의 에이전트 하네스 — 언어 모델을 코딩 에이전트로 변환하는 자리.
모델
추론하는 자리.
Sonnet · Opus 결, 세션 중 /model 로 전환
도구
작용하는 자리. 없으면 텍스트만, 있으면 읽고·고치고·실행·검색
에이전트 루프
컨텍스트 수집 → 작업 수행 → 결과 검증
작업이 끝날 때까지 세 단계가 함께 진행·반복
코드베이스 질문은 컨텍스트 수집만으로 끝날 수 있고, 버그 수정은 세 단계를 반복하며, 리팩토링은 검증이 길다. 사용자도 루프의 일부 — 언제든 중단해서 방향을 다시 잡을 수 있다.
손에 쥐는 것
도구 — 다섯 범주
파일 작업
읽기 · 편집 · 새 파일 · 이름 변경. 편집 전 자동 스냅샷 (체크포인트)
검색
패턴으로 파일 찾기, regex 으로 콘텐츠 검색. 코드베이스 탐색
실행
셸 명령 · 서버 · 테스트 · git. 명령줄에서 할 수 있는 자리는 다
웹
검색 · 문서 가져오기 · 오류 메시지 조회. 외부 정보를 끌어옴
코드 인텔리전스
타입 오류 확인 · 정의 이동 · 참조 찾기. 플러그인으로 진입
각 도구 사용 결과는 다음 결정을 알리는 정보로 다시 루프에 들어감.
컨텍스트 윈도
한계에 닿으면 자동으로 정리된다
요청과 핵심 코드 조각은 보존되지만, 대화 초반의 자세한 지침은 손실될 수 있다. 지속 규칙은 대화에 의존하지 말고 CLAUDE.md 에 둔다.
/context 로 점유 자리 확인 · subagent 는 별도
컨텍스트라 긴 세션의 자리에 좋음.
안전
체크포인트 · 권한 4 모드
편집 전 자동 스냅샷. Esc 두 번으로
되돌림. git 과 분리, 파일 변경만 다룸 — DB · API · 배포 같은
외부 부작용은 매번 묻기.
파일 편집 · 셸 명령 전 매번 묻기.
편집은 자동, 명령은 여전히 묻기.
읽기 전용 도구만 사용, 실행 전 사용자에게 계획 승인을 받음.
백그라운드 안전 검사로 모든 작업 평가 (연구 미리보기).
Shift+Tab 으로 모드 순환 ·
.claude/settings.json 에서 신뢰 명령 미리 허용.
세션 너머
새 세션은 새 컨텍스트. 잇는 자리는 따로.
프로젝트별 지속 지침. 매 세션마다 읽힌다.
MEMORY.md 에 학습 누적. 세션 시작 시 처음 200 줄 또는 25KB 가 자동 로드.
claude --continue · --resume 으로
이어가고, --fork-session 으로 같은 시작점에서 새
갈래.
핵심 위에 skills · MCP · hooks · subagents 가 계층으로 얹힘 — 워크플로우 자동화 · 외부 서비스 · 작업 위임.