10 10 

11이 가이드는 핵심 아키텍처, 내장 기능, 그리고 [Claude Code를 효과적으로 사용하기 위한 팁](#work-effectively-with-claude-code)을 다룹니다. 단계별 설명서는 [일반적인 워크플로우](/docs/ko/common-workflows)를 참조하세요. skills, MCP, hooks와 같은 확장 기능은 [Claude Code 확장](/docs/ko/features-overview)을 참조하세요.11이 가이드는 핵심 아키텍처, 내장 기능, 그리고 [Claude Code를 효과적으로 사용하기 위한 팁](#work-effectively-with-claude-code)을 다룹니다. 단계별 설명서는 [일반적인 워크플로우](/docs/ko/common-workflows)를 참조하세요. skills, MCP, hooks와 같은 확장 기능은 [Claude Code 확장](/docs/ko/features-overview)을 참조하세요.

12 12 

13<h2 id="the-agentic-loop">13## 에이전트 루프

14 에이전트 루프

15</h2>

16 14 

17Claude에게 작업을 주면 세 가지 단계를 거칩니다: **컨텍스트 수집**, **작업 수행**, **결과 검증**. 이 단계들은 함께 진행됩니다. Claude는 파일을 검색하여 코드를 이해하든, 변경을 위해 편집하든, 작업을 확인하기 위해 테스트를 실행하든 전체적으로 도구를 사용합니다.15Claude에게 작업을 주면 세 가지 단계를 거칩니다: **컨텍스트 수집**, **작업 수행**, **결과 검증**. 이 단계들은 함께 진행됩니다. Claude는 파일을 검색하여 코드를 이해하든, 변경을 위해 편집하든, 작업을 확인하기 위해 테스트를 실행하든 전체적으로 도구를 사용합니다.

18 16 

19<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agentic-loop.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=4a30fb7ce2815012a9f27c955e2c6bb0" className="dark:hidden" alt="에이전트 루프 다이어그램: 프롬프트가 Claude가 컨텍스트를 수집하고, 작업을 수행하고, 결과를 검증하고, 작업이 완료될 때까지 반복하도록 합니다. 언제든지 중단할 수 있습니다." width="720" height="280" data-path="images/agentic-loop.svg" />17![에이전트 루프 다이어그램: 프롬프트가 Claude가 컨텍스트를 수집하고, 작업을 수행하고, 결과를 검증하고, 작업이 완료될 때까지 반복하도록 합니다. 언제든지 중단할 수 있습니다.](https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agentic-loop.svg?fit=max\&auto=format\&n=ikqp3_70mqIahteV\&q=85\&s=4a30fb7ce2815012a9f27c955e2c6bb0)

20 

21<img src="https://mintcdn.com/claude-code/_xqph1dUOslCOwsj/images/agentic-loop-dark.svg?fit=max&auto=format&n=_xqph1dUOslCOwsj&q=85&s=75e1d55ed76857a952f9a2dffbab02df" className="hidden dark:block" alt="에이전트 루프 다이어그램: 프롬프트가 Claude가 컨텍스트를 수집하고, 작업을 수행하고, 결과를 검증하고, 작업이 완료될 때까지 반복하도록 합니다. 언제든지 중단할 수 있습니다." width="720" height="280" data-path="images/agentic-loop-dark.svg" />

22 18 

23루프는 사용자가 요청한 내용에 맞게 조정됩니다. 코드베이스에 대한 질문은 컨텍스트 수집만 필요할 수 있습니다. 버그 수정은 세 단계를 반복적으로 거칩니다. 리팩토링은 광범위한 검증을 포함할 수 있습니다. Claude는 이전 단계에서 배운 내용을 바탕으로 각 단계에서 필요한 것을 결정하고, 수십 개의 작업을 연결하며 그 과정에서 방향을 수정합니다.19루프는 사용자가 요청한 내용에 맞게 조정됩니다. 코드베이스에 대한 질문은 컨텍스트 수집만 필요할 수 있습니다. 버그 수정은 세 단계를 반복적으로 거칩니다. 리팩토링은 광범위한 검증을 포함할 수 있습니다. Claude는 이전 단계에서 배운 내용을 바탕으로 각 단계에서 필요한 것을 결정하고, 수십 개의 작업을 연결하며 그 과정에서 방향을 수정합니다.

24 20 

26 22 

27에이전트 루프는 두 가지 구성 요소로 구동됩니다: 추론하는 [모델](#models)과 작용하는 [도구](#tools). Claude Code는 모델 주변의 계층으로, 도구를 제공하고 모델이 보는 컨텍스트를 관리합니다. 이 주변 계층을 에이전트 하네스라는 용어가 나타냅니다.23에이전트 루프는 두 가지 구성 요소로 구동됩니다: 추론하는 [모델](#models)과 작용하는 [도구](#tools). Claude Code는 모델 주변의 계층으로, 도구를 제공하고 모델이 보는 컨텍스트를 관리합니다. 이 주변 계층을 에이전트 하네스라는 용어가 나타냅니다.

28 24 

29<h3 id="models">25### 모델

30 모델

31</h3>

32 26 

33Claude Code는 Claude 모델을 사용하여 코드를 이해하고 작업에 대해 추론합니다. Claude는 모든 언어의 코드를 읽을 수 있고, 구성 요소가 어떻게 연결되는지 이해하며, 목표를 달성하기 위해 무엇을 변경해야 하는지 파악할 수 있습니다. 복잡한 작업의 경우 작업을 단계로 나누고, 실행하고, 배운 내용을 바탕으로 조정합니다.27Claude Code는 Claude 모델을 사용하여 코드를 이해하고 작업에 대해 추론합니다. Claude는 모든 언어의 코드를 읽을 수 있고, 구성 요소가 어떻게 연결되는지 이해하며, 목표를 달성하기 위해 무엇을 변경해야 하는지 파악할 수 있습니다. 복잡한 작업의 경우 작업을 단계로 나누고, 실행하고, 배운 내용을 바탕으로 조정합니다.

34 28 

36 30 

37이 가이드에서 "Claude가 선택한다" 또는 "Claude가 결정한다"고 할 때, 모델이 추론을 수행하는 것입니다.31이 가이드에서 "Claude가 선택한다" 또는 "Claude가 결정한다"고 할 때, 모델이 추론을 수행하는 것입니다.

38 32 

39<h3 id="tools">33### 도구

40 도구

41</h3>

42 34 

43도구는 Claude Code를 에이전트로 만드는 것입니다. 도구가 없으면 Claude는 텍스트로만 응답할 수 있습니다. 도구가 있으면 Claude는 작용할 수 있습니다: 코드를 읽고, 파일을 편집하고, 명령을 실행하고, 웹을 검색하고, 외부 서비스와 상호작용합니다. 각 도구 사용은 루프에 다시 피드백되는 정보를 반환하여 Claude의 다음 결정을 알립니다.35도구는 Claude Code를 에이전트로 만드는 것입니다. 도구가 없으면 Claude는 텍스트로만 응답할 수 있습니다. 도구가 있으면 Claude는 작용할 수 있습니다: 코드를 읽고, 파일을 편집하고, 명령을 실행하고, 웹을 검색하고, 외부 서비스와 상호작용합니다. 각 도구 사용은 루프에 다시 피드백되는 정보를 반환하여 Claude의 다음 결정을 알립니다.

44 36 

67 59 

68**기본 기능 확장:** 내장 도구는 기초입니다. [skills](/docs/ko/skills)로 Claude가 알 수 있는 것을 확장하고, [MCP](/docs/ko/mcp)로 외부 서비스에 연결하고, [hooks](/docs/ko/hooks)로 워크플로우를 자동화하고, [subagents](/docs/ko/sub-agents)로 작업을 위임할 수 있습니다. 이러한 확장은 핵심 에이전트 루프 위에 계층을 형성합니다. 필요에 맞는 확장을 선택하는 방법은 [Claude Code 확장](/docs/ko/features-overview)을 참조하세요.60**기본 기능 확장:** 내장 도구는 기초입니다. [skills](/docs/ko/skills)로 Claude가 알 수 있는 것을 확장하고, [MCP](/docs/ko/mcp)로 외부 서비스에 연결하고, [hooks](/docs/ko/hooks)로 워크플로우를 자동화하고, [subagents](/docs/ko/sub-agents)로 작업을 위임할 수 있습니다. 이러한 확장은 핵심 에이전트 루프 위에 계층을 형성합니다. 필요에 맞는 확장을 선택하는 방법은 [Claude Code 확장](/docs/ko/features-overview)을 참조하세요.

69 61 

70<h2 id="what-claude-can-access">62## Claude가 접근할 수 있는 것

71 Claude가 접근할 수 있는 것

72</h2>

73 63 

74디렉토리에서 `claude`를 실행하면 Claude Code는 다음에 접근할 수 있습니다:64디렉토리에서 `claude`를 실행하면 Claude Code는 다음에 접근할 수 있습니다:

75 65 

82 72 

83Claude가 전체 프로젝트를 보기 때문에 전체 프로젝트에서 작업할 수 있습니다. "인증 버그를 수정해"라고 Claude에게 요청하면 관련 파일을 검색하고, 컨텍스트를 이해하기 위해 여러 파일을 읽고, 여러 파일에 걸쳐 조정된 편집을 수행하고, 수정을 검증하기 위해 테스트를 실행하고, 요청하면 변경 사항을 커밋합니다. 이는 현재 파일만 보는 인라인 코드 어시스턴트와 다릅니다.73Claude가 전체 프로젝트를 보기 때문에 전체 프로젝트에서 작업할 수 있습니다. "인증 버그를 수정해"라고 Claude에게 요청하면 관련 파일을 검색하고, 컨텍스트를 이해하기 위해 여러 파일을 읽고, 여러 파일에 걸쳐 조정된 편집을 수행하고, 수정을 검증하기 위해 테스트를 실행하고, 요청하면 변경 사항을 커밋합니다. 이는 현재 파일만 보는 인라인 코드 어시스턴트와 다릅니다.

84 74 

85<h2 id="environments-and-interfaces">75## 환경 및 인터페이스

86 환경 및 인터페이스

87</h2>

88 76 

89[에이전트 루프](#the-agentic-loop), [도구](#tools), 및 기능은 Claude Code를 사용하는 모든 곳에서 동일합니다. 변하는 것은 코드가 실행되는 위치와 상호작용하는 방식입니다.77[에이전트 루프](#the-agentic-loop), [도구](#tools), 및 기능은 Claude Code를 사용하는 모든 곳에서 동일합니다. 변하는 것은 코드가 실행되는 위치와 상호작용하는 방식입니다.

90 78 

91<h3 id="execution-environments">79### 실행 환경

92 실행 환경

93</h3>

94 80 

95Claude Code는 세 가지 환경에서 실행되며, 각각은 코드가 실행되는 위치에 대해 다른 장단점이 있습니다.81Claude Code는 세 가지 환경에서 실행되며, 각각은 코드가 실행되는 위치에 대해 다른 장단점이 있습니다.

96 82 

100| **클라우드** | Anthropic 관리 VM 또는 [조직이 운영하는 자체 호스팅 환경](/docs/ko/self-hosted-environments) | 작업 오프로드, 로컬에 없는 리포지토리에서 작업 |86| **클라우드** | Anthropic 관리 VM 또는 [조직이 운영하는 자체 호스팅 환경](/docs/ko/self-hosted-environments) | 작업 오프로드, 로컬에 없는 리포지토리에서 작업 |

101| **원격 제어** | 사용자 머신, 브라우저에서 제어 | 웹 UI를 사용하면서 실행 및 파일을 로컬로 유지 |87| **원격 제어** | 사용자 머신, 브라우저에서 제어 | 웹 UI를 사용하면서 실행 및 파일을 로컬로 유지 |

102 88 

103<h3 id="interfaces">89### 인터페이스

104 인터페이스

105</h3>

106 90 

107터미널, [데스크톱 앱](/docs/ko/desktop), [IDE 확장](/docs/ko/vs-code), [claude.ai/code](https://claude.ai/code), [원격 제어](/docs/ko/remote-control), [Slack](/docs/ko/slack), [CI/CD 파이프라인](/docs/ko/github-actions)을 통해 Claude Code에 접근할 수 있습니다. 인터페이스는 Claude를 보고 상호작용하는 방식을 결정하지만, 기본 에이전트 루프는 동일합니다. 전체 목록은 [Claude Code를 어디서나 사용](/docs/ko/overview#use-claude-code-everywhere)을 참조하세요.91터미널, [데스크톱 앱](/docs/ko/desktop), [IDE 확장](/docs/ko/vs-code), [claude.ai/code](https://claude.ai/code), [원격 제어](/docs/ko/remote-control), [Slack](/docs/ko/slack), [CI/CD 파이프라인](/docs/ko/github-actions)을 통해 Claude Code에 접근할 수 있습니다. 인터페이스는 Claude를 보고 상호작용하는 방식을 결정하지만, 기본 에이전트 루프는 동일합니다. 전체 목록은 [Claude Code를 어디서나 사용](/docs/ko/overview#use-claude-code-everywhere)을 참조하세요.

108 92 

109<h2 id="work-with-sessions">93## 세션으로 작업

110 세션으로 작업

111</h2>

112 94 

113Claude Code는 작업하면서 대화를 로컬에 저장합니다. 각 메시지, 도구 사용, 결과가 `~/.claude/projects/` 아래의 일반 텍스트 JSONL 파일에 기록되어 [되돌리기](#undo-changes-with-checkpoints), [재개 및 포크](#resume-or-fork-sessions) 세션을 활성화합니다. Claude가 코드를 변경하기 전에 영향을 받는 파일을 스냅샷하므로 필요하면 되돌릴 수 있습니다. 경로, 보존, 이 데이터를 지우는 방법은 [`~/.claude`의 애플리케이션 데이터](/docs/ko/claude-directory#application-data)를 참조하세요.95Claude Code는 작업하면서 대화를 로컬에 저장합니다. 각 메시지, 도구 사용, 결과가 `~/.claude/projects/` 아래의 일반 텍스트 JSONL 파일에 기록되어 [되돌리기](#undo-changes-with-checkpoints), [재개 및 포크](#resume-or-fork-sessions) 세션을 활성화합니다. Claude가 코드를 변경하기 전에 영향을 받는 파일을 스냅샷하므로 필요하면 되돌릴 수 있습니다. 경로, 보존, 이 데이터를 지우는 방법은 [`~/.claude`의 애플리케이션 데이터](/docs/ko/claude-directory#application-data)를 참조하세요.

114 96 

115**세션은 독립적입니다.** 각 새 세션은 이전 세션의 대화 기록 없이 새로운 컨텍스트 윈도우로 시작합니다. Claude는 [자동 메모리](/docs/ko/memory#auto-memory)를 사용하여 세션 간에 학습을 유지할 수 있으며, [CLAUDE.md](/docs/ko/memory)에 자신의 지속적인 지침을 추가할 수 있습니다.97**세션은 독립적입니다.** 각 새 세션은 이전 세션의 대화 기록 없이 새로운 컨텍스트 윈도우로 시작합니다. Claude는 [자동 메모리](/docs/ko/memory#auto-memory)를 사용하여 세션 간에 학습을 유지할 수 있으며, [CLAUDE.md](/docs/ko/memory)에 자신의 지속적인 지침을 추가할 수 있습니다.

116 98 

117<h3 id="work-across-branches">99### 브랜치 간 작업

118 브랜치 간 작업

119</h3>

120 100 

121각 Claude Code 대화는 현재 디렉토리에 연결된 세션입니다. `/resume` 선택기는 기본적으로 현재 worktree의 세션을 표시하며, 다른 worktrees 또는 프로젝트로 목록을 확장하는 키보드 단축키가 있습니다. 전체 선택기 단축키 목록과 이름 해석 방식은 [세션 관리](/docs/ko/sessions#use-the-session-picker)를 참조하세요.101각 Claude Code 대화는 현재 디렉토리에 연결된 세션입니다. `/resume` 선택기는 기본적으로 현재 worktree의 세션을 표시하며, 다른 worktrees 또는 프로젝트로 목록을 확장하는 키보드 단축키가 있습니다. 전체 선택기 단축키 목록과 이름 해석 방식은 [세션 관리](/docs/ko/sessions#use-the-session-picker)를 참조하세요.

122 102 

124 104 

125세션이 디렉토리에 연결되어 있으므로 [git worktrees](/docs/ko/worktrees)를 사용하여 병렬 Claude 세션을 실행할 수 있으며, 이는 개별 브랜치에 대한 별도 디렉토리를 생성합니다.105세션이 디렉토리에 연결되어 있으므로 [git worktrees](/docs/ko/worktrees)를 사용하여 병렬 Claude 세션을 실행할 수 있으며, 이는 개별 브랜치에 대한 별도 디렉토리를 생성합니다.

126 106 

127<h3 id="resume-or-fork-sessions">107### 세션 재개 또는 포크

128 세션 재개 또는 포크

129</h3>

130 108 

131`claude --continue` 또는 `claude --resume`으로 세션을 재개하면 동일한 세션 ID를 사용하여 중단한 지점부터 시작합니다. 새 메시지는 기존 대화에 추가됩니다. `--fork-session` 또는 `/branch`로 포크하면 기록을 새 세션 ID로 복사하여 원본은 변경되지 않은 상태로 유지합니다.109`claude --continue` 또는 `claude --resume`으로 세션을 재개하면 동일한 세션 ID를 사용하여 중단한 지점부터 시작합니다. 새 메시지는 기존 대화에 추가됩니다. `--fork-session` 또는 `/branch`로 포크하면 기록을 새 세션 ID로 복사하여 원본은 변경되지 않은 상태로 유지합니다.

132 110 

133<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/session-continuity.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=04ed0984a58e4127e05b3640265241a3" className="dark:hidden" alt="세션 연속성 다이어그램: 재개는 동일한 세션을 계속하고, 포크는 새 ID로 새 브랜치를 생성합니다." width="560" height="280" data-path="images/session-continuity.svg" />111![세션 연속성 다이어그램: 재개는 동일한 세션을 계속하고, 포크는 새 ID로 새 브랜치를 생성합니다.](https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/session-continuity.svg?fit=max\&auto=format\&n=ikqp3_70mqIahteV\&q=85\&s=04ed0984a58e4127e05b3640265241a3)

134 

135<img src="https://mintcdn.com/claude-code/_xqph1dUOslCOwsj/images/session-continuity-dark.svg?fit=max&auto=format&n=_xqph1dUOslCOwsj&q=85&s=886a384bce8298594e43f124617ea665" className="hidden dark:block" alt="세션 연속성 다이어그램: 재개는 동일한 세션을 계속하고, 포크는 새 ID로 새 브랜치를 생성합니다." width="560" height="280" data-path="images/session-continuity-dark.svg" />

136 112 

137재개 플래그, `/resume` 선택기, 이름 지정, 동일한 세션이 두 터미널에서 열려 있을 때 발생하는 상황은 [세션 관리](/docs/ko/sessions)를 참조하세요.113재개 플래그, `/resume` 선택기, 이름 지정, 동일한 세션이 두 터미널에서 열려 있을 때 발생하는 상황은 [세션 관리](/docs/ko/sessions)를 참조하세요.

138 114 

139<h3 id="the-context-window">115### 컨텍스트 윈도우

140 컨텍스트 윈도우

141</h3>

142 116 

143Claude의 컨텍스트 윈도우는 대화 기록, 파일 콘텐츠, 명령 출력, [CLAUDE.md](/docs/ko/memory), [자동 메모리](/docs/ko/memory#auto-memory), 로드된 skills, 시스템 지침을 보유합니다. 작업하면서 컨텍스트가 채워집니다. Claude는 자동으로 압축하지만 대화 초반의 지침이 손실될 수 있습니다. 지속적인 규칙을 CLAUDE.md에 넣고 `/context`를 실행하여 공간을 사용하는 것을 확인하세요.117Claude의 컨텍스트 윈도우는 대화 기록, 파일 콘텐츠, 명령 출력, [CLAUDE.md](/docs/ko/memory), [자동 메모리](/docs/ko/memory#auto-memory), 로드된 skills, 시스템 지침을 보유합니다. 작업하면서 컨텍스트가 채워집니다. Claude는 자동으로 압축하지만 대화 초반의 지침이 손실될 수 있습니다. 지속적인 규칙을 CLAUDE.md에 넣고 `/context`를 실행하여 공간을 사용하는 것을 확인하세요.

144 118 

145컨텍스트 윈도우의 대화형 설명은 [컨텍스트 윈도우 탐색](/docs/ko/context-window)을 참조하세요.119컨텍스트 윈도우의 대화형 설명은 [컨텍스트 윈도우 탐색](/docs/ko/context-window)을 참조하세요.

146 120 

147<h4 id="context-claude-code-adds-on-its-own">121#### 컨텍스트 Claude Code가 자체적으로 추가하는 것

148 컨텍스트 Claude Code가 자체적으로 추가하는 것

149</h4>

150 122 

151Claude가 `Co-Authored-By` 트레일러를 커밋에 추가하는 것과 같이 작성하지 않은 규칙을 따르면 규칙은 [시스템 알림](/docs/ko/glossary#system-reminder)에서 나올 수 있습니다. 작업하면서 Claude Code는 메시지와 함께 대화에 자신의 컨텍스트를 추가합니다:123Claude가 `Co-Authored-By` 트레일러를 커밋에 추가하는 것과 같이 작성하지 않은 규칙을 따르면 규칙은 [시스템 알림](/docs/ko/glossary#system-reminder)에서 나올 수 있습니다. 작업하면서 Claude Code는 메시지와 함께 대화에 자신의 컨텍스트를 추가합니다:

152 124 

157 129 

158속성 라인을 변경하거나 제거하려면 [`attribution`](/docs/ko/settings-reference#attribution)을 설정하세요. Claude Code의 기본 제공 커밋 및 풀 요청 지침을 제거하려면 [`includeGitInstructions`](/docs/ko/settings-reference#includegitinstructions)를 `false`로 설정하세요. 다른 스위치는 [에이전트가 대체하는 컨텍스트 끄기](/docs/ko/agent-sdk/modifying-system-prompts#turn-off-the-context-your-agent-replaces)를 참조하세요.130속성 라인을 변경하거나 제거하려면 [`attribution`](/docs/ko/settings-reference#attribution)을 설정하세요. Claude Code의 기본 제공 커밋 및 풀 요청 지침을 제거하려면 [`includeGitInstructions`](/docs/ko/settings-reference#includegitinstructions)를 `false`로 설정하세요. 다른 스위치는 [에이전트가 대체하는 컨텍스트 끄기](/docs/ko/agent-sdk/modifying-system-prompts#turn-off-the-context-your-agent-replaces)를 참조하세요.

159 131 

160<h4 id="when-context-fills-up">132#### 컨텍스트가 채워질 때

161 컨텍스트가 채워질 때

162</h4>

163 133 

164Claude Code는 한계에 접근할 때 컨텍스트를 자동으로 관리합니다. 먼저 이전 도구 출력을 지우고, 필요하면 대화를 요약합니다. 요청과 주요 코드 스니펫은 유지되지만 대화 초반의 자세한 지침이 손실될 수 있습니다. 대화 기록에 의존하기보다는 지속적인 규칙을 CLAUDE.md에 넣으세요.134Claude Code는 한계에 접근할 때 컨텍스트를 자동으로 관리합니다. 먼저 이전 도구 출력을 지우고, 필요하면 대화를 요약합니다. 요청과 주요 코드 스니펫은 유지되지만 대화 초반의 자세한 지침이 손실될 수 있습니다. 대화 기록에 의존하기보다는 지속적인 규칙을 CLAUDE.md에 넣으세요.

165 135 

169 139 

170`/context`를 실행하여 공간을 사용하는 것을 확인하세요. MCP 도구 정의는 기본적으로 지연되며 [도구 검색](/docs/ko/mcp#scale-with-mcp-tool-search)을 통해 요청 시 로드되므로 Claude가 특정 도구를 사용할 때까지 도구 이름과 서버 지침만 컨텍스트를 소비합니다.140`/context`를 실행하여 공간을 사용하는 것을 확인하세요. MCP 도구 정의는 기본적으로 지연되며 [도구 검색](/docs/ko/mcp#scale-with-mcp-tool-search)을 통해 요청 시 로드되므로 Claude가 특정 도구를 사용할 때까지 도구 이름과 서버 지침만 컨텍스트를 소비합니다.

171 141 

172<h4 id="manage-context-with-skills-and-subagents">142#### skills 및 subagents로 컨텍스트 관리

173 skills 및 subagents로 컨텍스트 관리

174</h4>

175 143 

176압축 외에도 다른 기능을 사용하여 컨텍스트에 로드되는 것을 제어할 수 있습니다.144압축 외에도 다른 기능을 사용하여 컨텍스트에 로드되는 것을 제어할 수 있습니다.

177 145 

181 149 

182각 기능의 비용은 [컨텍스트 비용](/docs/ko/features-overview#understand-context-costs)을 참조하고, 컨텍스트 관리 팁은 [토큰 사용 감소](/docs/ko/costs#reduce-token-usage)를 참조하세요.150각 기능의 비용은 [컨텍스트 비용](/docs/ko/features-overview#understand-context-costs)을 참조하고, 컨텍스트 관리 팁은 [토큰 사용 감소](/docs/ko/costs#reduce-token-usage)를 참조하세요.

183 151 

184<h2 id="stay-safe-with-checkpoints-and-permissions">152## 체크포인트 및 권한으로 안전 유지

185 체크포인트 및 권한으로 안전 유지

186</h2>

187 153 

188Claude는 두 가지 안전 메커니즘을 가지고 있습니다: 체크포인트는 파일 변경을 취소할 수 있게 하고, 권한은 Claude가 요청 없이 할 수 있는 것을 제어합니다.154Claude는 두 가지 안전 메커니즘을 가지고 있습니다: 체크포인트는 파일 변경을 취소할 수 있게 하고, 권한은 Claude가 요청 없이 할 수 있는 것을 제어합니다.

189 155 

190<h3 id="undo-changes-with-checkpoints">156### 체크포인트로 변경 취소

191 체크포인트로 변경 취소

192</h3>

193 157 

194**모든 파일 편집은 되돌릴 수 있습니다.** Claude가 파일을 편집하기 전에 현재 콘텐츠를 스냅샷합니다. 문제가 발생하면 `Esc`를 두 번 눌러 이전 상태로 되돌리거나 Claude에게 취소하도록 요청하세요.158**모든 파일 편집은 되돌릴 수 있습니다.** Claude가 파일을 편집하기 전에 현재 콘텐츠를 스냅샷합니다. 문제가 발생하면 `Esc`를 두 번 눌러 이전 상태로 되돌리거나 Claude에게 취소하도록 요청하세요.

195 159 

196체크포인트는 git과 분리되어 있으며 대화를 재개할 때 계속 사용할 수 있습니다. 파일 변경만 다루며, 복원 시 [심볼릭 링크 및 하드 링크 파일을 건너뜁니다](/docs/ko/checkpointing#symlinked-and-hard-linked-paths-not-restored). 원격 시스템(데이터베이스, API, 배포)에 영향을 주는 작업은 체크포인트할 수 없습니다. 이러한 작업은 권한 모드 및 권한 규칙으로 제어합니다.160체크포인트는 git과 분리되어 있으며 대화를 재개할 때 계속 사용할 수 있습니다. 파일 변경만 다루며, 복원 시 [심볼릭 링크 및 하드 링크 파일을 건너뜁니다](/docs/ko/checkpointing#symlinked-and-hard-linked-paths-not-restored). 원격 시스템(데이터베이스, API, 배포)에 영향을 주는 작업은 체크포인트할 수 없습니다. 이러한 작업은 권한 모드 및 권한 규칙으로 제어합니다.

197 161 

198<h3 id="control-what-claude-can-do">162### Claude가 할 수 있는 것 제어

199 Claude가 할 수 있는 것 제어

200</h3>

201 163 

202`Shift+Tab`을 눌러 권한 모드를 순환하세요:164`Shift+Tab`을 눌러 권한 모드를 순환하세요:

203 165 

210 172 

211***173***

212 174 

213<h2 id="work-effectively-with-claude-code">175## Claude Code를 효과적으로 사용하기

214 Claude Code를 효과적으로 사용하기

215</h2>

216 176 

217이 팁들은 Claude Code에서 더 나은 결과를 얻는 데 도움이 됩니다. 특정 프롬프트, 검증 및 계획에 대한 자세한 내용은 [모범 사례](/docs/ko/best-practices)를 참조하세요.177이 팁들은 Claude Code에서 더 나은 결과를 얻는 데 도움이 됩니다. 특정 프롬프트, 검증 및 계획에 대한 자세한 내용은 [모범 사례](/docs/ko/best-practices)를 참조하세요.

218 178 

219<h3 id="ask-claude-code-for-help">179### Claude Code에 도움을 요청하기

220 Claude Code에 도움을 요청하기

221</h3>

222 180 

223Claude Code는 사용 방법을 가르칠 수 있습니다. "hooks를 설정하려면 어떻게 하나요?" 또는 "CLAUDE.md를 구조화하는 최선의 방법은 무엇인가요?"와 같은 질문을 하면 Claude가 설명합니다.181Claude Code는 사용 방법을 가르칠 수 있습니다. "hooks를 설정하려면 어떻게 하나요?" 또는 "CLAUDE.md를 구조화하는 최선의 방법은 무엇인가요?"와 같은 질문을 하면 Claude가 설명합니다.

224 182 

227* `/init`은 프로젝트를 위한 시작 CLAUDE.md를 생성합니다185* `/init`은 프로젝트를 위한 시작 CLAUDE.md를 생성합니다

228* `/doctor`는 설치 및 구성 문제를 진단하고 수정할 수 있습니다186* `/doctor`는 설치 및 구성 문제를 진단하고 수정할 수 있습니다

229 187 

230<h3 id="it’s-a-conversation">188### 대화형입니다

231 대화형입니다

232</h3>

233 189 

234Claude Code는 대화형입니다. 완벽한 프롬프트가 필요하지 않습니다. 원하는 것으로 시작한 다음 개선하세요:190Claude Code는 대화형입니다. 완벽한 프롬프트가 필요하지 않습니다. 원하는 것으로 시작한 다음 개선하세요:

235 191 

247 203 

248첫 번째 시도가 맞지 않으면 다시 시작할 필요가 없습니다. 반복합니다.204첫 번째 시도가 맞지 않으면 다시 시작할 필요가 없습니다. 반복합니다.

249 205 

250<h4 id="interrupt-and-steer">206#### 중단 및 조종

251 중단 및 조종

252</h4>

253 207 

254언제든지 Claude를 리다이렉트할 수 있습니다. 다음 중 하나를 수행하세요:208언제든지 Claude를 리다이렉트할 수 있습니다. 다음 중 하나를 수행하세요:

255 209 

256* **`Esc` 키를 누르세요** Claude를 즉시 중지합니다. 실행 중인 도구 호출이 취소되고 Claude는 다음 지시를 기다립니다. 대기 중인 메시지가 있으면 Claude Code [다음으로 전송합니다](/docs/ko/interactive-mode#queue-messages-while-claude-works).210* **`Esc` 키를 누르세요** Claude를 즉시 중지합니다. 실행 중인 도구 호출이 취소되고 Claude는 다음 지시를 기다립니다. 대기 중인 메시지가 있으면 Claude Code [다음으로 전송합니다](/docs/ko/interactive-mode#queue-messages-while-claude-works).

257* **수정 사항을 입력하고 `Enter`를 누르세요** Claude를 중지하지 않고 메시지를 전송합니다. 메시지는 입력 상자 위에 대기 중으로 표시됩니다. Claude가 도구 호출을 실행 중이면 해당 호출이 완료되는 즉시 메시지를 읽고 같은 턴 내에서 조정한 후 다음 단계를 진행합니다. [Claude가 작업하는 동안 메시지 대기](/docs/ko/interactive-mode#queue-messages-while-claude-works)에서 다른 대기 중인 항목이 언제 전송되는지 다룹니다.211* **수정 사항을 입력하고 `Enter`를 누르세요** Claude를 중지하지 않고 메시지를 전송합니다. 메시지는 입력 상자 위에 대기 중으로 표시됩니다. Claude가 도구 호출을 실행 중이면 해당 호출이 완료되는 즉시 메시지를 읽고 같은 턴 내에서 조정한 후 다음 단계를 진행합니다. [Claude가 작업하는 동안 메시지 대기](/docs/ko/interactive-mode#queue-messages-while-claude-works)에서 다른 대기 중인 항목이 언제 전송되는지 다룹니다.

258 212 

259<h3 id="delegate-don’t-dictate">213### 지시하지 말고 위임하기

260 지시하지 말고 위임하기

261</h3>

262 214 

263능력 있는 동료에게 위임하는 것처럼 생각하세요. 컨텍스트와 방향을 제공한 다음 Claude가 세부 사항을 파악하도록 신뢰하세요:215능력 있는 동료에게 위임하는 것처럼 생각하세요. 컨텍스트와 방향을 제공한 다음 Claude가 세부 사항을 파악하도록 신뢰하세요:

264 216 

269 221 

270읽을 파일이나 실행할 명령을 지정할 필요가 없습니다. Claude가 파악합니다.222읽을 파일이나 실행할 명령을 지정할 필요가 없습니다. Claude가 파악합니다.

271 223 

272<h2 id="what’s-next">224## 다음 단계

273 다음 단계

274</h2>

275 225 

276<CardGroup cols={2}>226> **[기능으로 확장](/docs/ko/features-overview)**

277 <Card title="기능으로 확장" icon="puzzle-piece" href="/docs/ko/features-overview">227>

278 Skills 및 MCP 연결 추가228> Skills 및 MCP 연결 추가

279 </Card>

280 229 

281 <Card title="일반적인 워크플로우" icon="graduation-cap" href="/docs/ko/common-workflows">230> **[일반적인 워크플로우](/docs/ko/common-workflows)**

282 일반적인 작업을 위한 단계별 가이드231>

283 </Card>232> 일반적인 작업을 위한 단계별 가이드

284</CardGroup>