8 8 

9Claude Code는 터미널에서 실행되는 에이전트 어시스턴트입니다. 코딩에 탁월하지만 명령줄에서 할 수 있는 모든 작업을 도와줄 수 있습니다: 문서 작성, 빌드 실행, 파일 검색, 주제 조사 등.9Claude Code는 터미널에서 실행되는 에이전트 어시스턴트입니다. 코딩에 탁월하지만 명령줄에서 할 수 있는 모든 작업을 도와줄 수 있습니다: 문서 작성, 빌드 실행, 파일 검색, 주제 조사 등.

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.md)를 참조하세요. skills, MCP, hooks와 같은 확장 기능은 [Claude Code 확장](/docs/ko/features-overview.md)을 참조하세요.

12 12 

13## 에이전트 루프13## 에이전트 루프

14 14 

26 26 

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

28 28 

29[여러 모델](/docs/ko/model-config)을 사용할 수 있으며 각각 다른 장단점이 있습니다. Sonnet은 대부분의 코딩 작업을 잘 처리합니다. Opus는 복잡한 아키텍처 결정을 위한 더 강력한 추론을 제공합니다. 세션 중에 `/model`로 전환하거나 `claude --model <name>`으로 시작하세요.29[여러 모델](/docs/ko/model-config.md)을 사용할 수 있으며 각각 다른 장단점이 있습니다. Sonnet은 대부분의 코딩 작업을 잘 처리합니다. Opus는 복잡한 아키텍처 결정을 위한 더 강력한 추론을 제공합니다. 세션 중에 `/model`로 전환하거나 `claude --model <name>`으로 시작하세요.

30 30 

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

32 32 

42| **검색** | 패턴으로 파일 찾기, 정규식으로 콘텐츠 검색, 코드베이스 탐색 |42| **검색** | 패턴으로 파일 찾기, 정규식으로 콘텐츠 검색, 코드베이스 탐색 |

43| **실행** | 셸 명령 실행, 서버 시작, 테스트 실행, git 사용 |43| **실행** | 셸 명령 실행, 서버 시작, 테스트 실행, git 사용 |

44| **웹** | 웹 검색, 문서 가져오기, 오류 메시지 조회 |44| **웹** | 웹 검색, 문서 가져오기, 오류 메시지 조회 |

45| **코드 인텔리전스** | 편집 후 타입 오류 및 경고 확인, 정의로 이동, 참조 찾기 ([코드 인텔리전스 플러그인](/docs/ko/plugins/code-intelligence) 필요) |45| **코드 인텔리전스** | 편집 후 타입 오류 및 경고 확인, 정의로 이동, 참조 찾기 ([코드 인텔리전스 플러그인](/docs/ko/plugins/code-intelligence.md) 필요) |

46 46 

47이것이 주요 기능입니다. Claude는 또한 subagents를 생성하고, 질문을 하고, 다른 오케스트레이션 작업을 위한 도구를 가지고 있습니다. 전체 목록은 [Claude가 사용할 수 있는 도구](/docs/ko/tools-reference)를 참조하세요.47이것이 주요 기능입니다. Claude는 또한 subagents를 생성하고, 질문을 하고, 다른 오케스트레이션 작업을 위한 도구를 가지고 있습니다. 전체 목록은 [Claude가 사용할 수 있는 도구](/docs/ko/tools-reference.md)를 참조하세요.

48 48 

49Claude는 프롬프트와 그 과정에서 배운 내용을 바탕으로 사용할 도구를 선택합니다. "실패한 테스트를 수정해"라고 말하면 Claude는 다음을 수행할 수 있습니다:49Claude는 프롬프트와 그 과정에서 배운 내용을 바탕으로 사용할 도구를 선택합니다. "실패한 테스트를 수정해"라고 말하면 Claude는 다음을 수행할 수 있습니다:

50 50 

57 57 

58각 도구 사용은 Claude에게 다음 단계를 알리는 새로운 정보를 제공합니다. 이것이 에이전트 루프의 작동입니다.58각 도구 사용은 Claude에게 다음 단계를 알리는 새로운 정보를 제공합니다. 이것이 에이전트 루프의 작동입니다.

59 59 

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

61 61 

62## Claude가 접근할 수 있는 것62## Claude가 접근할 수 있는 것

63 63 

66* **프로젝트.** 디렉토리 및 하위 디렉토리의 파일, 그리고 허가를 받은 다른 곳의 파일.66* **프로젝트.** 디렉토리 및 하위 디렉토리의 파일, 그리고 허가를 받은 다른 곳의 파일.

67* **터미널.** 실행할 수 있는 모든 명령: 빌드 도구, git, 패키지 관리자, 시스템 유틸리티, 스크립트. 명령줄에서 할 수 있는 것이면 Claude도 할 수 있습니다.67* **터미널.** 실행할 수 있는 모든 명령: 빌드 도구, git, 패키지 관리자, 시스템 유틸리티, 스크립트. 명령줄에서 할 수 있는 것이면 Claude도 할 수 있습니다.

68* **git 상태.** 현재 브랜치, 커밋되지 않은 변경 사항, 최근 커밋 기록.68* **git 상태.** 현재 브랜치, 커밋되지 않은 변경 사항, 최근 커밋 기록.

69* **[CLAUDE.md](/docs/ko/memory).** 프로젝트별 지침, 규칙, Claude가 매 세션마다 알아야 할 컨텍스트를 저장하는 마크다운 파일. 저장소에 다른 코딩 에이전트를 위한 AGENTS.md가 있으면 Claude는 CLAUDE.md 대신 [이를 읽을 수 있습니다](/docs/ko/memory#agents-md).69* **[CLAUDE.md](/docs/ko/memory.md).** 프로젝트별 지침, 규칙, Claude가 매 세션마다 알아야 할 컨텍스트를 저장하는 마크다운 파일. 저장소에 다른 코딩 에이전트를 위한 AGENTS.md가 있으면 Claude는 CLAUDE.md 대신 [이를 읽을 수 있습니다](/docs/ko/memory.md#agents-md).

70* **[자동 메모리](/docs/ko/memory#auto-memory).** Claude가 작업하면서 자동으로 저장하는 학습 내용(프로젝트 패턴 및 사용자 선호도 등). MEMORY.md의 처음 200줄 또는 25KB 중 먼저 도달하는 것이 각 세션 시작 시 로드됩니다.70* **[자동 메모리](/docs/ko/memory.md#auto-memory).** Claude가 작업하면서 자동으로 저장하는 학습 내용(프로젝트 패턴 및 사용자 선호도 등). MEMORY.md의 처음 200줄 또는 25KB 중 먼저 도달하는 것이 각 세션 시작 시 로드됩니다.

71* **구성한 확장.** 외부 서비스를 위한 [MCP servers](/docs/ko/mcp), 워크플로우를 위한 [skills](/docs/ko/skills), 위임된 작업을 위한 [subagents](/docs/ko/sub-agents), 브라우저 상호작용을 위한 [Claude in Chrome](/docs/ko/chrome).71* **구성한 확장.** 외부 서비스를 위한 [MCP servers](/docs/ko/mcp.md), 워크플로우를 위한 [skills](/docs/ko/skills.md), 위임된 작업을 위한 [subagents](/docs/ko/sub-agents.md), 브라우저 상호작용을 위한 [Claude in Chrome](/docs/ko/chrome.md).

72 72 

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

74 74 

88 88 

89### 인터페이스89### 인터페이스

90 90 

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

92 92 

93## 세션으로 작업93## 세션으로 작업

94 94 

95Claude 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)를 참조하세요.

96 96 

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

98 98 

99### 브랜치 간 작업99### 브랜치 간 작업

100 100 

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

102 102 

103Claude는 현재 브랜치의 파일을 봅니다. 브랜치를 전환하면 Claude는 새 브랜치의 파일을 보지만 대화 기록은 동일하게 유지됩니다. Claude는 전환 후에도 논의한 내용을 기억합니다.103Claude는 현재 브랜치의 파일을 봅니다. 브랜치를 전환하면 Claude는 새 브랜치의 파일을 보지만 대화 기록은 동일하게 유지됩니다. Claude는 전환 후에도 논의한 내용을 기억합니다.

104 104 

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

106 106 

107### 세션 재개 또는 포크107### 세션 재개 또는 포크

108 108 

110 110 

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

112 112 

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

114 114 

115### 컨텍스트 윈도우115### 컨텍스트 윈도우

116 116 

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

118 118 

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

120 120 

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

122 122 

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

124 124 

125* CLAUDE.md 파일125* CLAUDE.md 파일

126* [출력 스타일](/docs/ko/output-styles)의 지침126* [출력 스타일](/docs/ko/output-styles.md)의 지침

127* Claude가 이전에 읽은 파일이 디스크에서 변경될 때의 메모127* Claude가 이전에 읽은 파일이 디스크에서 변경될 때의 메모

128* 커밋 및 풀 요청 속성 라인128* 커밋 및 풀 요청 속성 라인

129 129 

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

131 131 

132#### 컨텍스트가 채워질 때132#### 컨텍스트가 채워질 때

133 133 

135 135 

136압축 중에 보존되는 것을 제어하려면 CLAUDE.md에 "Compact Instructions" 섹션을 추가하거나 `/compact`를 포커스와 함께 실행하세요 (예: `/compact focus on the API changes`).136압축 중에 보존되는 것을 제어하려면 CLAUDE.md에 "Compact Instructions" 섹션을 추가하거나 `/compact`를 포커스와 함께 실행하세요 (예: `/compact focus on the API changes`).

137 137 

138단일 파일 또는 도구 출력이 너무 커서 각 요약 후 컨텍스트가 즉시 다시 채워지면 Claude Code는 몇 번의 시도 후 자동 압축을 중지하고 루핑 대신 오류를 표시합니다. 복구 단계는 [자동 압축이 thrashing 오류로 중지됨](/docs/ko/troubleshooting#auto-compaction-stops-with-a-thrashing-error)을 참조하세요.138단일 파일 또는 도구 출력이 너무 커서 각 요약 후 컨텍스트가 즉시 다시 채워지면 Claude Code는 몇 번의 시도 후 자동 압축을 중지하고 루핑 대신 오류를 표시합니다. 복구 단계는 [자동 압축이 thrashing 오류로 중지됨](/docs/ko/troubleshooting.md#auto-compaction-stops-with-a-thrashing-error)을 참조하세요.

139 139 

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

141 141 

142#### skills 및 subagents로 컨텍스트 관리142#### skills 및 subagents로 컨텍스트 관리

143 143 

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

145 145 

146[Skills](/docs/ko/skills)는 요청 시 로드됩니다. Claude는 세션 시작 시 skill 설명을 보지만 전체 콘텐츠는 skill이 사용될 때만 로드됩니다. 수동으로 호출하는 skills의 경우 `disable-model-invocation: true`를 설정하여 필요할 때까지 설명을 컨텍스트 밖으로 유지하세요. 작성하지 않은 skills의 경우 [`skillOverrides`](/docs/ko/skills#override-skill-visibility-from-settings)를 사용하여 설정에서 동일하게 수행하세요.146[Skills](/docs/ko/skills.md)는 요청 시 로드됩니다. Claude는 세션 시작 시 skill 설명을 보지만 전체 콘텐츠는 skill이 사용될 때만 로드됩니다. 수동으로 호출하는 skills의 경우 `disable-model-invocation: true`를 설정하여 필요할 때까지 설명을 컨텍스트 밖으로 유지하세요. 작성하지 않은 skills의 경우 [`skillOverrides`](/docs/ko/skills#override-skill-visibility-from-settings)를 사용하여 설정에서 동일하게 수행하세요.

147 147 

148[Subagents](/docs/ko/sub-agents)는 자신의 컨텍스트 윈도우에서 작동합니다. subagent는 [포크](/docs/ko/sub-agents#fork-the-current-conversation)가 아닌 한 새로 시작하며, 포크는 지금까지의 대화 복사본으로 시작합니다. 어느 쪽이든 subagent의 도구 호출은 컨텍스트 밖에 머물러 있으며, Claude는 subagent가 완료되면 요약을 받습니다.148[Subagents](/docs/ko/sub-agents.md)는 자신의 컨텍스트 윈도우에서 작동합니다. subagent는 [포크](/docs/ko/sub-agents.md#fork-the-current-conversation)가 아닌 한 새로 시작하며, 포크는 지금까지의 대화 복사본으로 시작합니다. 어느 쪽이든 subagent의 도구 호출은 컨텍스트 밖에 머물러 있으며, Claude는 subagent가 완료되면 요약을 받습니다.

149 149 

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

151 151 

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

153 153 

157 157 

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

159 159 

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

161 161 

162### Claude가 할 수 있는 것 제어162### Claude가 할 수 있는 것 제어

163 163 

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

165 165 

166* **Auto**: 분류기가 백그라운드에서 대부분의 작업을 검토하고 요청하는 대신 위험한 작업을 차단합니다. Claude Code v2.1.283 이상에서는 대화형 터미널 및 VS Code 세션의 [기본 시작 권한 모드](/docs/ko/permission-modes#which-mode-a-session-starts-in)이며, 이전 버전에서는 Pro, Max, Team 플랜에서만 해당합니다166* **Auto**: 분류기가 백그라운드에서 대부분의 작업을 검토하고 요청하는 대신 위험한 작업을 차단합니다. Claude Code v2.1.283 이상에서는 대화형 터미널 및 VS Code 세션의 [기본 시작 권한 모드](/docs/ko/permission-modes.md#which-mode-a-session-starts-in)이며, 이전 버전에서는 Pro, Max, Team 플랜에서만 해당합니다

167* **Manual**: Claude가 파일 편집 및 셸 명령 전에 요청합니다167* **Manual**: Claude가 파일 편집 및 셸 명령 전에 요청합니다

168* **Accept edits**: Claude는 파일을 편집하고 `mkdir` 및 `mv`와 같은 일반적인 파일시스템 명령을 요청 없이 실행하지만 다른 명령은 여전히 요청합니다168* **Accept edits**: Claude는 파일을 편집하고 `mkdir` 및 `mv`와 같은 일반적인 파일시스템 명령을 요청 없이 실행하지만 다른 명령은 여전히 요청합니다

169* **Plan**: Claude는 소스 파일을 편집하지 않고 계획을 탐색하고 제안합니다169* **Plan**: Claude는 소스 파일을 편집하지 않고 계획을 탐색하고 제안합니다

170 170 

171`.claude/settings.json`에서 특정 명령을 허용하여 Claude가 매번 요청하지 않도록 할 수 있습니다. 이는 `npm test` 또는 `git status`와 같은 신뢰할 수 있는 명령에 유용합니다. 설정은 조직 전체 정책에서 개인 선호도까지 범위를 지정할 수 있습니다. 자세한 내용은 [권한](/docs/ko/permissions)을 참조하세요.171`.claude/settings.json`에서 특정 명령을 허용하여 Claude가 매번 요청하지 않도록 할 수 있습니다. 이는 `npm test` 또는 `git status`와 같은 신뢰할 수 있는 명령에 유용합니다. 설정은 조직 전체 정책에서 개인 선호도까지 범위를 지정할 수 있습니다. 자세한 내용은 [권한](/docs/ko/permissions.md)을 참조하세요.

172 172 

173***173***

174 174 

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

176 176 

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

178 178 

179### Claude Code에 도움을 요청하기179### Claude Code에 도움을 요청하기

180 180 

207 207 

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

209 209 

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

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

212 212 

213### 지시하지 말고 위임하기213### 지시하지 말고 위임하기

214 214 

223 223 

224## 다음 단계224## 다음 단계

225 225 

226> **[기능으로 확장](/docs/ko/features-overview)**226> **[기능으로 확장](/docs/ko/features-overview.md)**

227>227>

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

229 229 

230> **[일반적인 워크플로우](/docs/ko/common-workflows)**230> **[일반적인 워크플로우](/docs/ko/common-workflows.md)**

231>231>

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