에이전트 루프
Claude에게 작업을 주면 세 가지 단계를 거칩니다: 컨텍스트 수집, 작업 수행, 결과 검증. 이 단계들은 함께 진행됩니다. Claude는 파일을 검색하여 코드를 이해하든, 변경을 위해 편집하든, 작업을 확인하기 위해 테스트를 실행하든 전체적으로 도구를 사용합니다.
모델
Claude Code는 Claude 모델을 사용하여 코드를 이해하고 작업에 대해 추론합니다. Claude는 모든 언어의 코드를 읽을 수 있고, 구성 요소가 어떻게 연결되는지 이해하며, 목표를 달성하기 위해 무엇을 변경해야 하는지 파악할 수 있습니다. 복잡한 작업의 경우 작업을 단계로 나누고, 실행하고, 배운 내용을 바탕으로 조정합니다. 여러 모델을 사용할 수 있으며 각각 다른 장단점이 있습니다. Sonnet은 대부분의 코딩 작업을 잘 처리합니다. Opus는 복잡한 아키텍처 결정을 위한 더 강력한 추론을 제공합니다. 세션 중에/model로 전환하거나 claude --model <name>으로 시작하세요.
이 가이드에서 “Claude가 선택한다” 또는 “Claude가 결정한다”고 할 때, 모델이 추론을 수행하는 것입니다.
도구
도구는 Claude Code를 에이전트로 만드는 것입니다. 도구가 없으면 Claude는 텍스트로만 응답할 수 있습니다. 도구가 있으면 Claude는 작용할 수 있습니다: 코드를 읽고, 파일을 편집하고, 명령을 실행하고, 웹을 검색하고, 외부 서비스와 상호작용합니다. 각 도구 사용은 루프에 다시 피드백되는 정보를 반환하여 Claude의 다음 결정을 알립니다. 내장 도구는 일반적으로 다섯 가지 범주로 나뉘며, 각각은 다른 종류의 에이전시를 나타냅니다.| 범주 | Claude가 할 수 있는 것 |
|---|---|
| 파일 작업 | 파일 읽기, 코드 편집, 새 파일 생성, 이름 변경 및 재구성 |
| 검색 | 패턴으로 파일 찾기, 정규식으로 콘텐츠 검색, 코드베이스 탐색 |
| 실행 | 셸 명령 실행, 서버 시작, 테스트 실행, git 사용 |
| 웹 | 웹 검색, 문서 가져오기, 오류 메시지 조회 |
| 코드 인텔리전스 | 편집 후 타입 오류 및 경고 확인, 정의로 이동, 참조 찾기 (코드 인텔리전스 플러그인 필요) |
- 테스트 스위트를 실행하여 무엇이 실패하는지 확인
- 오류 출력 읽기
- 관련 소스 파일 검색
- 해당 파일을 읽어 코드 이해
- 파일을 편집하여 문제 수정
- 테스트를 다시 실행하여 검증
Claude가 접근할 수 있는 것
이 가이드는 터미널에 중점을 둡니다. Claude Code는 또한 VS Code, JetBrains IDE, 및 기타 환경에서 실행됩니다. 디렉토리에서claude를 실행하면 Claude Code는 다음에 접근할 수 있습니다:
- 프로젝트. 디렉토리 및 하위 디렉토리의 파일, 그리고 허가를 받은 다른 곳의 파일.
- 터미널. 실행할 수 있는 모든 명령: 빌드 도구, git, 패키지 관리자, 시스템 유틸리티, 스크립트. 명령줄에서 할 수 있는 것이면 Claude도 할 수 있습니다.
- git 상태. 현재 브랜치, 커밋되지 않은 변경 사항, 최근 커밋 기록.
- CLAUDE.md. 프로젝트별 지침, 규칙, Claude가 매 세션마다 알아야 할 컨텍스트를 저장하는 마크다운 파일.
- 자동 메모리. Claude가 작업하면서 자동으로 저장하는 학습 내용(프로젝트 패턴 및 사용자 선호도 등). MEMORY.md의 처음 200줄이 각 세션 시작 시 로드됩니다.
- 구성한 확장. 외부 서비스를 위한 MCP servers, 워크플로우를 위한 skills, 위임된 작업을 위한 subagents, 브라우저 상호작용을 위한 Claude in Chrome.
환경 및 인터페이스
위에서 설명한 에이전트 루프, 도구, 기능은 Claude Code를 사용하는 모든 곳에서 동일합니다. 변하는 것은 코드가 실행되는 위치와 상호작용하는 방식입니다.실행 환경
Claude Code는 세 가지 환경에서 실행되며, 각각은 코드가 실행되는 위치에 대해 다른 장단점이 있습니다.| 환경 | 코드 실행 위치 | 사용 사례 |
|---|---|---|
| 로컬 | 사용자 머신 | 기본값. 파일, 도구, 환경에 대한 전체 접근 |
| 클라우드 | Anthropic 관리 VM | 작업 오프로드, 로컬에 없는 리포지토리에서 작업 |
| 원격 제어 | 사용자 머신, 브라우저에서 제어 | 웹 UI를 사용하면서 모든 것을 로컬로 유지 |
인터페이스
터미널, 데스크톱 앱, IDE 확장, claude.ai/code, 원격 제어, Slack, CI/CD 파이프라인을 통해 Claude Code에 접근할 수 있습니다. 인터페이스는 Claude를 보고 상호작용하는 방식을 결정하지만, 기본 에이전트 루프는 동일합니다. 전체 목록은 Claude Code를 어디서나 사용을 참조하세요.세션으로 작업
Claude Code는 작업하면서 대화를 로컬에 저장합니다. 각 메시지, 도구 사용, 결과가 저장되어 되돌리기, 재개 및 포크 세션을 활성화합니다. Claude가 코드를 변경하기 전에 영향을 받는 파일을 스냅샷하므로 필요하면 되돌릴 수 있습니다. 세션은 독립적입니다. 각 새 세션은 이전 세션의 대화 기록 없이 새로운 컨텍스트 윈도우로 시작합니다. Claude는 자동 메모리를 사용하여 세션 간에 학습을 유지할 수 있으며, CLAUDE.md에 자신의 지속적인 지침을 추가할 수 있습니다.브랜치 간 작업
각 Claude Code 대화는 현재 디렉토리에 연결된 세션입니다. 재개할 때 해당 디렉토리의 세션만 표시됩니다. Claude는 현재 브랜치의 파일을 봅니다. 브랜치를 전환하면 Claude는 새 브랜치의 파일을 보지만 대화 기록은 동일하게 유지됩니다. Claude는 전환 후에도 논의한 내용을 기억합니다. 세션이 디렉토리에 연결되어 있으므로 git worktrees를 사용하여 병렬 Claude 세션을 실행할 수 있으며, 이는 개별 브랜치에 대한 별도 디렉토리를 생성합니다.세션 재개 또는 포크
claude --continue 또는 claude --resume으로 세션을 재개하면 동일한 세션 ID를 사용하여 중단한 지점부터 시작합니다. 새 메시지는 기존 대화에 추가됩니다. 전체 대화 기록이 복원되지만 세션 범위 권한은 복원되지 않습니다. 다시 승인해야 합니다.
--fork-session 플래그를 사용하세요:
--fork-session을 사용하여 각 터미널에 자신의 깨끗한 세션을 제공하세요.
컨텍스트 윈도우
Claude의 컨텍스트 윈도우는 대화 기록, 파일 콘텐츠, 명령 출력, CLAUDE.md, 자동 메모리, 로드된 skills, 시스템 지침을 보유합니다. 작업하면서 컨텍스트가 채워집니다. Claude는 자동으로 압축하지만 대화 초반의 지침이 손실될 수 있습니다. 지속적인 규칙을 CLAUDE.md에 넣고/context를 실행하여 공간을 사용하는 것을 확인하세요.
컨텍스트가 채워질 때
Claude Code는 한계에 접근할 때 컨텍스트를 자동으로 관리합니다. 먼저 이전 도구 출력을 지우고, 필요하면 대화를 요약합니다. 요청과 주요 코드 스니펫은 유지되지만 대화 초반의 자세한 지침이 손실될 수 있습니다. 대화 기록에 의존하기보다는 지속적인 규칙을 CLAUDE.md에 넣으세요. 압축 중에 보존되는 것을 제어하려면 CLAUDE.md에 “Compact Instructions” 섹션을 추가하거나/compact를 포커스와 함께 실행하세요 (예: /compact focus on the API changes).
/context를 실행하여 공간을 사용하는 것을 확인하세요. MCP servers는 모든 요청에 도구 정의를 추가하므로 몇 개의 서버가 작업을 시작하기 전에 상당한 컨텍스트를 소비할 수 있습니다. /mcp를 실행하여 서버별 비용을 확인하세요.
skills 및 subagents로 컨텍스트 관리
압축 외에도 다른 기능을 사용하여 컨텍스트에 로드되는 것을 제어할 수 있습니다. Skills는 요청 시 로드됩니다. Claude는 세션 시작 시 skill 설명을 보지만 전체 콘텐츠는 skill이 사용될 때만 로드됩니다. 수동으로 호출하는 skills의 경우disable-model-invocation: true를 설정하여 필요할 때까지 설명을 컨텍스트 밖으로 유지하세요.
Subagents는 주 대화와 완전히 분리된 자신의 새로운 컨텍스트를 얻습니다. 그들의 작업은 컨텍스트를 부풀리지 않습니다. 완료되면 요약을 반환합니다. 이 격리가 긴 세션에서 subagents가 도움이 되는 이유입니다.
각 기능의 비용은 컨텍스트 비용을 참조하고, 컨텍스트 관리 팁은 토큰 사용 감소를 참조하세요.
체크포인트 및 권한으로 안전 유지
Claude는 두 가지 안전 메커니즘을 가지고 있습니다: 체크포인트는 파일 변경을 취소할 수 있게 하고, 권한은 Claude가 요청 없이 할 수 있는 것을 제어합니다.체크포인트로 변경 취소
모든 파일 편집은 되돌릴 수 있습니다. Claude가 파일을 편집하기 전에 현재 콘텐츠를 스냅샷합니다. 문제가 발생하면Esc를 두 번 눌러 이전 상태로 되돌리거나 Claude에게 취소하도록 요청하세요.
체크포인트는 세션에 로컬이며 git과 분리되어 있습니다. 파일 변경만 다룹니다. 원격 시스템(데이터베이스, API, 배포)에 영향을 주는 작업은 체크포인트할 수 없으므로 Claude는 외부 부작용이 있는 명령을 실행하기 전에 요청합니다.
Claude가 할 수 있는 것 제어
Shift+Tab을 눌러 권한 모드를 순환하세요:
- 기본값: Claude는 파일 편집 및 셸 명령 전에 요청
- 자동 수락 편집: Claude는 파일을 편집하지만 명령은 여전히 요청
- 계획 모드: Claude는 읽기 전용 도구만 사용하여 실행 전에 승인할 수 있는 계획을 생성
- 자동 모드: Claude는 백그라운드 안전 검사로 모든 작업을 평가합니다. 현재 연구 미리보기입니다
.claude/settings.json에서 특정 명령을 허용하여 Claude가 매번 요청하지 않도록 할 수 있습니다. 이는 npm test 또는 git status와 같은 신뢰할 수 있는 명령에 유용합니다. 설정은 조직 전체 정책에서 개인 선호도까지 범위를 지정할 수 있습니다. 자세한 내용은 권한을 참조하세요.
Claude Code를 효과적으로 사용
이 팁은 Claude Code에서 더 나은 결과를 얻는 데 도움이 됩니다.Claude Code에 도움을 요청
Claude Code는 사용 방법을 가르칠 수 있습니다. “hooks를 설정하려면 어떻게 하나요?” 또는 “CLAUDE.md를 구조화하는 최선의 방법은 무엇인가요?”와 같은 질문을 하면 Claude가 설명합니다. 내장 명령도 설정을 안내합니다:/init은 프로젝트를 위한 CLAUDE.md 생성을 안내합니다/agents는 사용자 정의 subagents 구성을 도와줍니다/doctor는 설치의 일반적인 문제를 진단합니다
대화입니다
Claude Code는 대화형입니다. 완벽한 프롬프트가 필요하지 않습니다. 원하는 것으로 시작한 다음 개선하세요:중단 및 조종
언제든지 Claude를 중단할 수 있습니다. 잘못된 경로로 가고 있으면 수정 사항을 입력하고 Enter를 누르세요. Claude는 작업을 중지하고 입력을 바탕으로 접근 방식을 조정합니다. 완료될 때까지 기다리거나 다시 시작할 필요가 없습니다.처음부터 구체적으로
초기 프롬프트가 정확할수록 필요한 수정이 적습니다. 특정 파일을 참조하고, 제약 조건을 언급하고, 예제 패턴을 지적하세요.Claude가 검증할 수 있는 것을 제공
Claude는 자신의 작업을 확인할 수 있을 때 더 잘 수행합니다. 테스트 케이스를 포함하고, 예상 UI의 스크린샷을 붙여넣거나, 원하는 출력을 정의하세요.구현 전에 탐색
복잡한 문제의 경우 연구와 코딩을 분리하세요. 계획 모드(Shift+Tab 두 번)를 사용하여 먼저 코드베이스를 분석하세요:
지시하지 말고 위임
능력 있는 동료에게 위임하는 것처럼 생각하세요. 컨텍스트와 방향을 제공한 다음 Claude가 세부 사항을 파악하도록 신뢰하세요:다음 단계
기능으로 확장
Skills, MCP 연결, 사용자 정의 명령 추가
일반적인 워크플로우
일반적인 작업을 위한 단계별 가이드