8 8
9이 용어집은 Claude Code 용어를 정의합니다. 각 항목은 개념이 심층적으로 다루어지는 페이지로 연결됩니다. 토큰, 온도, RAG와 같은 모델 수준의 개념은 [플랫폼 용어집](https://platform.claude.com/docs/ko/about-claude/glossary)을 참조하십시오. Claude Desktop 용어(예: 데스크톱 확장, MCPB, DXT)는 [Claude 도움말 센터](https://support.claude.com/)를 참조하십시오.9이 용어집은 Claude Code 용어를 정의합니다. 각 항목은 개념이 심층적으로 다루어지는 페이지로 연결됩니다. 토큰, 온도, RAG와 같은 모델 수준의 개념은 [플랫폼 용어집](https://platform.claude.com/docs/ko/about-claude/glossary)을 참조하십시오. Claude Desktop 용어(예: 데스크톱 확장, MCPB, DXT)는 [Claude 도움말 센터](https://support.claude.com/)를 참조하십시오.
10 10
11<h2 id="a">11## A
12 A
13</h2>
14 12
15<h3 id="agents-md">13### AGENTS.md
16 AGENTS.md
17</h3>
18 14
19AI 코딩 에이전트를 위해 작성하는 프로젝트 지침의 마크다운 파일입니다. 저장소에 이 파일이 있고 [CLAUDE.md](#claude-md)가 없으면, Claude는 두 번째 파일을 추가하지 않고도 이를 프로젝트 지침으로 읽습니다. `/config`의 **프로젝트 지침** 설정을 변경하여 Claude가 두 파일을 모두 읽거나 `CLAUDE.md`만 읽도록 할 수 있습니다. `AGENTS.md`를 직접 읽으려면 Claude Code v2.1.277 이상이 필요합니다. 일부 세션에서는 Claude가 [`AGENTS.md`를 읽을 수 없으므로](/docs/ko/memory#when-agents-md-support-is-unavailable), 대신 [`CLAUDE.md`에서 가져오세요](/docs/ko/memory#share-one-file-with-other-coding-tools).15AI 코딩 에이전트를 위해 작성하는 프로젝트 지침의 마크다운 파일입니다. 저장소에 이 파일이 있고 [CLAUDE.md](#claude-md)가 없으면, Claude는 두 번째 파일을 추가하지 않고도 이를 프로젝트 지침으로 읽습니다. `/config`의 **프로젝트 지침** 설정을 변경하여 Claude가 두 파일을 모두 읽거나 `CLAUDE.md`만 읽도록 할 수 있습니다. `AGENTS.md`를 직접 읽으려면 Claude Code v2.1.277 이상이 필요합니다. 일부 세션에서는 Claude가 [`AGENTS.md`를 읽을 수 없으므로](/docs/ko/memory#when-agents-md-support-is-unavailable), 대신 [`CLAUDE.md`에서 가져오세요](/docs/ko/memory#share-one-file-with-other-coding-tools).
20 16
21자세히 알아보기: [AGENTS.md](/docs/ko/memory#agents-md)17자세히 알아보기: [AGENTS.md](/docs/ko/memory#agents-md)
22 18
23<h3 id="agent-teams">19### Agent teams
24 Agent teams
25</h3>
26 20
27여러 개의 독립적인 Claude Code 세션이 팀 리더에 의해 조정되며, 공유 작업 목록과 피어 투 피어 메시징을 갖춘 구성입니다. 단일 세션 내에서 실행되고 부모에게만 보고하는 [서브에이전트](#subagent)와 달리, 팀원들은 각각 자신의 컨텍스트 윈도우를 가지며 어느 팀원과도 직접 상호작용할 수 있습니다. Agent teams는 실험적이며 비활성화되어 있습니다. [에이전트 팀 활성화](/docs/ko/agent-teams#enable-agent-teams)를 참조하세요.21여러 개의 독립적인 Claude Code 세션이 팀 리더에 의해 조정되며, 공유 작업 목록과 피어 투 피어 메시징을 갖춘 구성입니다. 단일 세션 내에서 실행되고 부모에게만 보고하는 [서브에이전트](#subagent)와 달리, 팀원들은 각각 자신의 컨텍스트 윈도우를 가지며 어느 팀원과도 직접 상호작용할 수 있습니다. Agent teams는 실험적이며 비활성화되어 있습니다. [에이전트 팀 활성화](/docs/ko/agent-teams#enable-agent-teams)를 참조하세요.
28 22
29자세히 알아보기: [에이전트 팀 실행](/docs/ko/agent-teams)23자세히 알아보기: [에이전트 팀 실행](/docs/ko/agent-teams)
30 24
31<h3 id="agentic-coding">25### Agentic coding
32 Agentic coding
33</h3>
34 26
35AI가 파일을 읽고, 명령을 실행하고, 변경 사항을 자율적으로 만들 수 있는 워크플로우입니다. 사용자가 직접 적용해야 하는 텍스트만 응답하는 채팅 기반 어시스턴트와 달리, 사용자가 지켜보거나, 리디렉션하거나, 떠날 수 있습니다. Claude Code는 조언만 하는 것이 아니라 행동할 수 있게 해주는 [도구](#tool)를 가지고 있기 때문에 에이전트입니다.27AI가 파일을 읽고, 명령을 실행하고, 변경 사항을 자율적으로 만들 수 있는 워크플로우입니다. 사용자가 직접 적용해야 하는 텍스트만 응답하는 채팅 기반 어시스턴트와 달리, 사용자가 지켜보거나, 리디렉션하거나, 떠날 수 있습니다. Claude Code는 조언만 하는 것이 아니라 행동할 수 있게 해주는 [도구](#tool)를 가지고 있기 때문에 에이전트입니다.
36 28
37자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works)29자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works)
38 30
39<h3 id="agentic-harness">31### Agentic harness
40 Agentic harness
41</h3>
42 32
43언어 모델을 능력 있는 코딩 에이전트로 변환하는 도구, 컨텍스트 관리 및 실행 환경입니다. Claude Code는 하네스이고, Claude는 그 안의 모델입니다. 하네스는 파일 액세스, 셸 실행, 권한 게이팅, 메모리 로딩 및 작업을 함께 연결하는 루프를 제공합니다.33언어 모델을 능력 있는 코딩 에이전트로 변환하는 도구, 컨텍스트 관리 및 실행 환경입니다. Claude Code는 하네스이고, Claude는 그 안의 모델입니다. 하네스는 파일 액세스, 셸 실행, 권한 게이팅, 메모리 로딩 및 작업을 함께 연결하는 루프를 제공합니다.
44 34
45자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works)35자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works)
46 36
47<h3 id="agentic-loop">37### Agentic loop
48 Agentic loop
49</h3>
50 38
51Claude가 모든 작업을 수행하는 사이클입니다: 컨텍스트 수집, 작업 수행, 결과 확인 및 완료될 때까지 반복합니다. 각 도구 사용은 다음 단계를 알려주는 정보를 반환합니다. 언제든지 루프를 중단하여 리디렉션할 수 있습니다. [훅](#hook), [스킬](#skill), [MCP](#mcp-model-context-protocol)을 포함한 대부분의 확장 포인트는 이 루프의 특정 단계에 연결됩니다.39Claude가 모든 작업을 수행하는 사이클입니다: 컨텍스트 수집, 작업 수행, 결과 확인 및 완료될 때까지 반복합니다. 각 도구 사용은 다음 단계를 알려주는 정보를 반환합니다. 언제든지 루프를 중단하여 리디렉션할 수 있습니다. [훅](#hook), [스킬](#skill), [MCP](#mcp-model-context-protocol)을 포함한 대부분의 확장 포인트는 이 루프의 특정 단계에 연결됩니다.
52 40
53자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works#the-agentic-loop)41자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works#the-agentic-loop)
54 42
55<h3 id="artifact">43### Artifact
56 Artifact
57</h3>
58 44
59Claude Code가 세션에서 claude.ai의 비공개 URL로 게시하는 라이브 대화형 웹 페이지이므로, 터미널 텍스트를 읽는 대신 시각적으로 출력을 보거나 공유할 수 있습니다. 세션이 다시 게시될 때 페이지가 제자리에서 업데이트됩니다. Claude Code에서 만든 Artifact는 claude.ai 대화에서 만든 Artifact와 동일한 갤러리에 나타납니다. 공유 옵션은 플랜에 따라 달라집니다: [Artifact 공유](/docs/ko/artifacts#share-an-artifact)를 참조하세요.45Claude Code가 세션에서 claude.ai의 비공개 URL로 게시하는 라이브 대화형 웹 페이지이므로, 터미널 텍스트를 읽는 대신 시각적으로 출력을 보거나 공유할 수 있습니다. 세션이 다시 게시될 때 페이지가 제자리에서 업데이트됩니다. Claude Code에서 만든 Artifact는 claude.ai 대화에서 만든 Artifact와 동일한 갤러리에 나타납니다. 공유 옵션은 플랜에 따라 달라집니다: [Artifact 공유](/docs/ko/artifacts#share-an-artifact)를 참조하세요.
60 46
61자세히 알아보기: [세션 출력을 Artifact로 공유](/docs/ko/artifacts)47자세히 알아보기: [세션 출력을 Artifact로 공유](/docs/ko/artifacts)
62 48
63<h3 id="auto-memory">49### Auto memory
64 Auto memory
65</h3>
66 50
67Claude가 사용자의 수정 및 선호도를 기반으로 자신을 위해 작성한 노트이며, `~/.claude/projects/` 아래 git 저장소별로 저장됩니다. 동일한 저장소의 모든 worktree는 하나의 auto memory 디렉토리를 공유합니다. `MEMORY.md` 인덱스의 처음 200줄 또는 25KB가 모든 세션의 시작 시 로드됩니다. Auto memory는 사용자가 작성하는 [CLAUDE.md](#claude-md)의 Claude 작성 대응물입니다.51Claude가 사용자의 수정 및 선호도를 기반으로 자신을 위해 작성한 노트이며, `~/.claude/projects/` 아래 git 저장소별로 저장됩니다. 동일한 저장소의 모든 worktree는 하나의 auto memory 디렉토리를 공유합니다. `MEMORY.md` 인덱스의 처음 200줄 또는 25KB가 모든 세션의 시작 시 로드됩니다. Auto memory는 사용자가 작성하는 [CLAUDE.md](#claude-md)의 Claude 작성 대응물입니다.
68 52
69자세히 알아보기: [Auto memory](/docs/ko/memory#auto-memory)53자세히 알아보기: [Auto memory](/docs/ko/memory#auto-memory)
70 54
71<h3 id="auto-mode">55### Auto mode
72 Auto mode
73</h3>
74 56
75백그라운드에서 별도의 분류기 모델이 각 작업을 검토하는 [권한 모드](#permission-mode)이므로, Claude Code는 대부분의 작업을 사용자에게 묻지 않고 실행합니다. Claude Code는 여전히 명시적 요청 규칙과 일치하는 작업 전에 사용자에게 묻습니다. Claude Code v2.1.283 이상에서 auto mode는 대화형 터미널 및 VS Code 세션의 [기본 시작 권한 모드](/docs/ko/permission-modes#which-mode-a-session-starts-in)이며, 이전 버전에서는 Pro, Max 및 Team 플랜에서만 사용됩니다. 분류기는 범위 확대, 신뢰할 수 없는 인프라 및 [프롬프트 주입](#prompt-injection)을 차단합니다. 도구 결과는 분류기가 보는 것에서 제거되므로, 파일이나 웹 페이지의 악의적인 콘텐츠가 직접 조작할 수 없습니다.57백그라운드에서 별도의 분류기 모델이 각 작업을 검토하는 [권한 모드](#permission-mode)이므로, Claude Code는 대부분의 작업을 사용자에게 묻지 않고 실행합니다. Claude Code는 여전히 명시적 요청 규칙과 일치하는 작업 전에 사용자에게 묻습니다. Claude Code v2.1.283 이상에서 auto mode는 대화형 터미널 및 VS Code 세션의 [기본 시작 권한 모드](/docs/ko/permission-modes#which-mode-a-session-starts-in)이며, 이전 버전에서는 Pro, Max 및 Team 플랜에서만 사용됩니다. 분류기는 범위 확대, 신뢰할 수 없는 인프라 및 [프롬프트 주입](#prompt-injection)을 차단합니다. 도구 결과는 분류기가 보는 것에서 제거되므로, 파일이나 웹 페이지의 악의적인 콘텐츠가 직접 조작할 수 없습니다.
76 58
77자세히 알아보기: [Auto mode로 프롬프트 제거](/docs/ko/permission-modes#eliminate-prompts-with-auto-mode)59자세히 알아보기: [Auto mode로 프롬프트 제거](/docs/ko/permission-modes#eliminate-prompts-with-auto-mode)
78 60
79<h2 id="b">61## B
80 B
81</h2>
82 62
83<h3 id="bare-mode">63### Bare mode
84 Bare mode
85</h3>
86 64
87`--bare`를 사용하면 Claude Code는 `--add-dir`으로 전달하는 디렉터리의 스킬을 제외하고 훅, 스킬, 사용자 정의 명령, 서브에이전트, 설치된 플러그인, MCP 서버, auto memory 또는 CLAUDE.md를 로드하지 않고 시작합니다. CI 및 스크립트된 호출에 권장되며, 모든 머신에서 동일한 결과가 필요한 경우에 사용합니다.65`--bare`를 사용하면 Claude Code는 `--add-dir`으로 전달하는 디렉터리의 스킬을 제외하고 훅, 스킬, 사용자 정의 명령, 서브에이전트, 설치된 플러그인, MCP 서버, auto memory 또는 CLAUDE.md를 로드하지 않고 시작합니다. CI 및 스크립트된 호출에 권장되며, 모든 머신에서 동일한 결과가 필요한 경우에 사용합니다.
88 66
89자세히 알아보기: [bare mode로 더 빠르게 시작](/docs/ko/headless#start-faster-with-bare-mode)67자세히 알아보기: [bare mode로 더 빠르게 시작](/docs/ko/headless#start-faster-with-bare-mode)
90 68
91<h3 id="bundled-skills">69### Bundled skills
92 Bundled skills
93</h3>
94 70
95Claude Code에 포함된 프롬프트 기반 플레이북입니다. `/batch`, `/code-review`, `/debug`, `/loop` 등이 있습니다. 고정 로직을 실행하는 기본 제공 명령과 달리, 번들 스킬은 Claude에 상세한 프롬프트를 제공하고 작업을 조율하도록 하므로 에이전트를 생성하고, 파일을 읽고, 코드베이스에 적응할 수 있습니다.71Claude Code에 포함된 프롬프트 기반 플레이북입니다. `/batch`, `/code-review`, `/debug`, `/loop` 등이 있습니다. 고정 로직을 실행하는 기본 제공 명령과 달리, 번들 스킬은 Claude에 상세한 프롬프트를 제공하고 작업을 조율하도록 하므로 에이전트를 생성하고, 파일을 읽고, 코드베이스에 적응할 수 있습니다.
96 72
97자세히 알아보기: [번들 스킬](/docs/ko/skills#bundled-skills)73자세히 알아보기: [번들 스킬](/docs/ko/skills#bundled-skills)
98 74
99<h2 id="c">75## C
100 C
101</h2>
102 76
103<h3 id="channel">77### Channel
104 Channel
105</h3>
106 78
107실행 중인 세션에 이벤트를 푸시하는 [MCP 서버](#mcp-model-context-protocol)이므로 Claude는 터미널에서 떨어져 있을 때 발생하는 일에 반응할 수 있습니다. 채널은 양방향일 수 있습니다: Claude는 인바운드 이벤트를 읽고 동일한 채널을 통해 다시 응답합니다. Telegram, Discord 및 iMessage는 연구 미리보기에 포함됩니다.79실행 중인 세션에 이벤트를 푸시하는 [MCP 서버](#mcp-model-context-protocol)이므로 Claude는 터미널에서 떨어져 있을 때 발생하는 일에 반응할 수 있습니다. 채널은 양방향일 수 있습니다: Claude는 인바운드 이벤트를 읽고 동일한 채널을 통해 다시 응답합니다. Telegram, Discord 및 iMessage는 연구 미리보기에 포함됩니다.
108 80
109자세히 알아보기: [채널](/docs/ko/channels)81자세히 알아보기: [채널](/docs/ko/channels)
110 82
111<h3 id="checkpoint">83### Checkpoint
112 Checkpoint
113</h3>
114 84
115각 프롬프트를 전송할 때마다 생성되는 복원 지점입니다. Claude Code는 모든 편집 전에 파일을 스냅샷하므로 체크포인트가 파일을 되돌릴 수 있습니다. `Esc`를 두 번 누르거나 `/rewind`를 실행하여 코드, 대화 또는 둘 다를 이전 지점으로 복원하거나, 선택한 메시지에서 대화의 일부를 요약합니다. 체크포인트는 세션에 저장되므로 재개된 세션도 여전히 `/rewind`를 사용하여 이들로 돌아갈 수 있습니다. 이들은 git과 별개이며 Bash 도구를 통해 수행된 변경 사항을 추적하지 않습니다.85각 프롬프트를 전송할 때마다 생성되는 복원 지점입니다. Claude Code는 모든 편집 전에 파일을 스냅샷하므로 체크포인트가 파일을 되돌릴 수 있습니다. `Esc`를 두 번 누르거나 `/rewind`를 실행하여 코드, 대화 또는 둘 다를 이전 지점으로 복원하거나, 선택한 메시지에서 대화의 일부를 요약합니다. 체크포인트는 세션에 저장되므로 재개된 세션도 여전히 `/rewind`를 사용하여 이들로 돌아갈 수 있습니다. 이들은 git과 별개이며 Bash 도구를 통해 수행된 변경 사항을 추적하지 않습니다.
116 86
117자세히 알아보기: [체크포인팅](/docs/ko/checkpointing)87자세히 알아보기: [체크포인팅](/docs/ko/checkpointing)
118 88
119<h3 id="claude-directory">89### `.claude` directory
120 `.claude` directory
121</h3>
122 90
123Claude Code가 프로젝트 범위 구성을 읽는 디렉토리입니다: 설정, 훅, 스킬, 서브에이전트, 규칙 및 auto memory. 프로젝트는 루트에 `.claude/`를 가지며, 사용자 수준 기본값은 `~/.claude/`에 있습니다.91Claude Code가 프로젝트 범위 구성을 읽는 디렉토리입니다: 설정, 훅, 스킬, 서브에이전트, 규칙 및 auto memory. 프로젝트는 루트에 `.claude/`를 가지며, 사용자 수준 기본값은 `~/.claude/`에 있습니다.
124 92
125자세히 알아보기: [`.claude` 디렉토리](/docs/ko/claude-directory)93자세히 알아보기: [`.claude` 디렉토리](/docs/ko/claude-directory)
126 94
127<h3 id="claude-md">95### CLAUDE.md
128 CLAUDE.md
129</h3>
130 96
131Claude를 위해 작성하는 지속적인 지침의 마크다운 파일이며, 시스템 프롬프트 이후 사용자 메시지로 모든 세션의 시작 시 로드됩니다. 프로젝트 규칙, 아키텍처 노트 및 "항상 X를 수행" 규칙을 여기에 넣습니다. 프로젝트 루트 CLAUDE.md는 [컴팩션](#compaction)을 견디고 이후 디스크에서 새로 다시 읽습니다.97Claude를 위해 작성하는 지속적인 지침의 마크다운 파일이며, 시스템 프롬프트 이후 사용자 메시지로 모든 세션의 시작 시 로드됩니다. 프로젝트 규칙, 아키텍처 노트 및 "항상 X를 수행" 규칙을 여기에 넣습니다. 프로젝트 루트 CLAUDE.md는 [컴팩션](#compaction)을 견디고 이후 디스크에서 새로 다시 읽습니다.
132 98
134 100
135자세히 알아보기: [CLAUDE.md 파일](/docs/ko/memory#claude-md-files)101자세히 알아보기: [CLAUDE.md 파일](/docs/ko/memory#claude-md-files)
136 102
137<h3 id="cloud-session">103### Cloud session
138 Cloud session
139</h3>
140 104
141claude.ai/code, Claude 모바일 앱, **Cloud**가 선택된 Desktop 앱, `claude --cloud` 또는 [루틴](/docs/ko/routines)에서 시작하는 Claude Code 세션입니다. 머신 대신 클라우드 인프라에서 실행되므로 노트북을 닫은 후에도 계속 실행됩니다: 기본적으로 Anthropic에서 관리하거나, 조직이 운영하는 [자체 호스팅 환경](/docs/ko/self-hosted-environments). 터미널, IDE 또는 **Local**이 선택된 Desktop 앱의 세션은 로컬 세션입니다. 다른 디바이스에서 로컬 세션에 접근하려면 [원격 제어](#remote-control)를 사용합니다.105사용자의 머신 대신 클라우드 인프라에서 실행되므로 노트북을 닫은 후에도 계속 실행되는 Claude Code 세션입니다. 이 인프라는 기본적으로 Anthropic에서 관리하며, 조직이 운영하는 [자체 호스팅 환경](/docs/ko/self-hosted-environments)일 수도 있습니다. 클라우드 세션은 claude.ai/code, Claude 모바일 앱, **Cloud**가 선택된 Desktop 앱, `claude --cloud` 또는 [클라우드 예약 작업](/docs/ko/routines)에서 시작합니다.
106
107터미널, IDE 또는 **Local**이 선택된 Desktop 앱의 세션은 로컬 세션입니다. 다른 디바이스에서 로컬 세션에 접근하려면 [Remote Control](#remote-control)을 사용합니다.
142 108
143자세히 알아보기: [클라우드에서 Claude Code 사용](/docs/ko/claude-code-on-the-web)109자세히 알아보기: [클라우드에서 Claude Code 사용](/docs/ko/claude-code-on-the-web)
144 110
145<h3 id="command">111### Command
146 Command
147</h3>
148 112
149프롬프트에 `/name`을 입력하여 호출하는 재사용 가능한 지침입니다. `/clear`, `/model`, `/compact`와 같은 기본 제공 명령은 세션을 제어합니다. `.claude/commands/`의 파일로 자신의 명령을 정의하거나 [플러그인](#plugin)에서 설치할 수 있습니다. [스킬](#skill)은 다단계 명령을 패키징하는 권장 방법입니다.113프롬프트에 `/name`을 입력하여 호출하는 재사용 가능한 지침입니다. `/clear`, `/model`, `/compact`와 같은 기본 제공 명령은 세션을 제어합니다. `.claude/commands/`의 파일로 자신의 명령을 정의하거나 [플러그인](#plugin)에서 설치할 수 있습니다. [스킬](#skill)은 다단계 명령을 패키징하는 권장 방법입니다.
150 114
152 116
153자세히 알아보기: [명령](/docs/ko/commands) · [스킬](/docs/ko/skills)117자세히 알아보기: [명령](/docs/ko/commands) · [스킬](/docs/ko/skills)
154 118
155<h3 id="compaction">119### Compaction
156 Compaction
157</h3>
158 120
159[컨텍스트 윈도우](#context-window)가 한계에 접근할 때 대화의 자동 요약입니다. 이전 도구 출력이 먼저 지워지고, 그 다음 대화가 요약됩니다. 프로젝트 루트 CLAUDE.md 및 auto memory는 컴팩션을 견디고 디스크에서 다시 로드됩니다. 대화에서만 제공된 지침은 손실될 수 있습니다. `/compact`를 수동으로 트리거하거나, `/compact focus on the API changes`와 같은 포커스를 선택적으로 사용합니다.121[컨텍스트 윈도우](#context-window)가 한계에 접근할 때 대화의 자동 요약입니다. 이전 도구 출력이 먼저 지워지고, 그 다음 대화가 요약됩니다. 프로젝트 루트 CLAUDE.md 및 auto memory는 컴팩션을 견디고 디스크에서 다시 로드됩니다. 대화에서만 제공된 지침은 손실될 수 있습니다. `/compact`를 수동으로 트리거하거나, `/compact focus on the API changes`와 같은 포커스를 선택적으로 사용합니다.
160 122
161자세히 알아보기: [컴팩션에서 생존하는 것](/docs/ko/context-window#what-survives-compaction) · [컨텍스트가 가득 찰 때](/docs/ko/how-claude-code-works#when-context-fills-up)123자세히 알아보기: [컴팩션에서 생존하는 것](/docs/ko/context-window#what-survives-compaction) · [컨텍스트가 가득 찰 때](/docs/ko/how-claude-code-works#when-context-fills-up)
162 124
163<h3 id="connector">125### Connector
164 Connector
165</h3>
166 126
167Claude Code가 아닌 claude.ai 계정에 추가된 [MCP 서버](#mcp-server)입니다. 해당 계정으로 Claude Code에 로그인하면, 커넥터가 로컬로 추가한 서버와 함께 `/mcp`에 나타납니다. 조직은 또한 커넥터를 프로비저닝하고 이들에 대한 도구별 제어를 설정할 수 있습니다.127Claude Code가 아닌 claude.ai 계정에 추가된 [MCP 서버](#mcp-server)입니다. 해당 계정으로 Claude Code에 로그인하면, 커넥터가 로컬로 추가한 서버와 함께 `/mcp`에 나타납니다. 조직은 또한 커넥터를 프로비저닝하고 이들에 대한 도구별 제어를 설정할 수 있습니다.
168 128
169자세히 알아보기: [claude.ai에서 MCP 서버 사용](/docs/ko/mcp#use-mcp-servers-from-claude-ai)129자세히 알아보기: [claude.ai에서 MCP 서버 사용](/docs/ko/mcp#use-mcp-servers-from-claude-ai)
170 130
171<h3 id="context-window">131### Context window
172 Context window
173</h3>
174 132
175세션의 작업 메모리이며, 대화 기록, 파일 내용, 명령 출력, CLAUDE.md, auto memory, 로드된 스킬 및 시스템 지침을 보유합니다. 작업하면서 컨텍스트가 가득 찰 때까지 채워지고 [컴팩션](#compaction)이 요약합니다. `/context`를 실행하여 공간을 사용하는 것을 확인합니다. 기본 모델 개념은 [플랫폼 용어집](https://platform.claude.com/docs/ko/about-claude/glossary#context-window)을 참조하십시오.133세션의 작업 메모리이며, 대화 기록, 파일 내용, 명령 출력, CLAUDE.md, auto memory, 로드된 스킬 및 시스템 지침을 보유합니다. 작업하면서 컨텍스트가 가득 찰 때까지 채워지고 [컴팩션](#compaction)이 요약합니다. `/context`를 실행하여 공간을 사용하는 것을 확인합니다. 기본 모델 개념은 [플랫폼 용어집](https://platform.claude.com/docs/ko/about-claude/glossary#context-window)을 참조하십시오.
176 134
177자세히 알아보기: [컨텍스트 윈도우 탐색](/docs/ko/context-window)135자세히 알아보기: [컨텍스트 윈도우 탐색](/docs/ko/context-window)
178 136
179<h2 id="d">137## D
180 D
181</h2>
182 138
183<h3 id="dispatch">139### Dispatch
184 Dispatch
185</h3>
186 140
187Claude 모바일 앱에서 코딩 작업을 보낼 때 Desktop 앱에서 Claude Code 세션을 생성하는 휴대폰 시작 작업 라우터입니다. 프롬프트가 올바른 도구로 자동으로 라우팅됩니다. Pro 및 Max 플랜에서 사용 가능합니다.141Claude 모바일 앱에서 코딩 작업을 보낼 때 Desktop 앱에서 Claude Code 세션을 생성하는 휴대폰 시작 작업 라우터입니다. 프롬프트가 올바른 도구로 자동으로 라우팅됩니다. Pro 및 Max 플랜에서 사용 가능합니다.
188 142
189자세히 알아보기: [Dispatch의 세션](/docs/ko/desktop#sessions-from-dispatch)143자세히 알아보기: [Dispatch의 세션](/docs/ko/desktop#sessions-from-dispatch)
190 144
191<h2 id="e">145## E
192 E
193</h2>
194 146
195<h3 id="effort-level">147### Effort level
196 Effort level
197</h3>
198 148
199적응형 추론을 제어하는 설정으로, 모델이 각 단계에서 사고할지 여부와 얼마나 사고할지를 스스로 결정하도록 합니다. effort가 높을수록 더 많은 사고 토큰과 더 깊은 추론을 의미하며, effort가 낮을수록 더 빠르고 저렴합니다. Effort는 Fable 모델, Opus 4.6 이상, Sonnet 4.6 이상 및 Haiku 5.5에서 지원됩니다.149적응형 추론을 제어하는 설정으로, 모델이 각 단계에서 사고할지 여부와 얼마나 사고할지를 스스로 결정하도록 합니다. effort가 높을수록 더 많은 사고 토큰과 더 깊은 추론을 의미하며, effort가 낮을수록 더 빠르고 저렴합니다. Effort는 Fable 모델, Opus 4.6 이상, Sonnet 4.6 이상 및 Haiku 5.5에서 지원됩니다.
200 150
201자세히 알아보기: [노력 수준 조정](/docs/ko/model-config#adjust-effort-level)151자세히 알아보기: [노력 수준 조정](/docs/ko/model-config#adjust-effort-level)
202 152
203<h3 id="extended-thinking">153### Extended thinking
204 Extended thinking
205</h3>
206 154
207모델이 응답하기 전에 수행하는 가시적인 단계별 추론입니다. [노력 수준](#effort-level)으로 조정하거나 고정된 사고 예산이 있는 모델에서 `MAX_THINKING_TOKENS`로 사고 토큰을 제한할 수 있습니다. 사고는 터미널에서 회색 이탤릭 텍스트로 나타납니다.155모델이 응답하기 전에 수행하는 가시적인 단계별 추론입니다. [노력 수준](#effort-level)으로 조정하거나 고정된 사고 예산이 있는 모델에서 `MAX_THINKING_TOKENS`로 사고 토큰을 제한할 수 있습니다. 사고는 터미널에서 회색 이탤릭 텍스트로 나타납니다.
208 156
209자세히 알아보기: [확장 사고 사용](/docs/ko/model-config#extended-thinking)157자세히 알아보기: [확장 사고 사용](/docs/ko/model-config#extended-thinking)
210 158
211<h2 id="f">159## F
212 F
213</h2>
214 160
215<h3 id="frontmatter">161### Frontmatter
216 Frontmatter
217</h3>
218 162
219Markdown 파일의 맨 위에 있는 YAML 설정 블록으로, 여는 `---` 줄과 닫는 `---` 줄 사이에 위치합니다. 스킬, 서브에이전트, 출력 스타일 및 규칙은 각각 frontmatter에서 구성을 읽습니다. 예를 들어 스킬의 `description` 또는 서브에이전트의 `tools`와 같은 설정을 읽으며, 닫는 `---` 이후의 모든 내용을 지시사항으로 처리합니다. 여는 `---`은 파일의 첫 번째 줄이어야 합니다. 각 파일 유형은 자신의 필드 집합을 허용합니다.163Markdown 파일의 맨 위에 있는 YAML 설정 블록으로, 여는 `---` 줄과 닫는 `---` 줄 사이에 위치합니다. 스킬, 서브에이전트, 출력 스타일 및 규칙은 각각 frontmatter에서 구성을 읽습니다. 예를 들어 스킬의 `description` 또는 서브에이전트의 `tools`와 같은 설정을 읽으며, 닫는 `---` 이후의 모든 내용을 지시사항으로 처리합니다. 여는 `---`은 파일의 첫 번째 줄이어야 합니다. 각 파일 유형은 자신의 필드 집합을 허용합니다.
220 164
221자세히 알아보기: [스킬 frontmatter](/docs/ko/skills#frontmatter-reference), [서브에이전트 frontmatter](/docs/ko/sub-agents#supported-frontmatter-fields), [출력 스타일 frontmatter](/docs/ko/output-styles#frontmatter), [규칙 frontmatter](/docs/ko/memory#rules-frontmatter-reference)165자세히 알아보기: [스킬 frontmatter](/docs/ko/skills#frontmatter-reference), [서브에이전트 frontmatter](/docs/ko/sub-agents#supported-frontmatter-fields), [출력 스타일 frontmatter](/docs/ko/output-styles#frontmatter), [규칙 frontmatter](/docs/ko/memory#rules-frontmatter-reference)
222 166
223<h2 id="h">167## H
224 H
225</h2>
226 168
227<h3 id="hook">169### Hook
228 Hook
229</h3>
230 170
231Claude Code의 라이프사이클의 특정 지점에서 자동으로 실행되는 사용자 정의 핸들러입니다. 도구 실행 전, 파일 편집 후 또는 세션 시작 시 등입니다. 핸들러는 셸 명령, HTTP 엔드포인트, MCP 도구, LLM 프롬프트 또는 서브에이전트일 수 있습니다. 훅은 결정론적입니다: 모델의 재량이 아니라 고정된 라이프사이클 포인트에서 발생합니다.171Claude Code의 라이프사이클의 특정 지점에서 자동으로 실행되는 사용자 정의 핸들러입니다. 도구 실행 전, 파일 편집 후 또는 세션 시작 시 등입니다. 핸들러는 셸 명령, HTTP 엔드포인트, MCP 도구, LLM 프롬프트 또는 서브에이전트일 수 있습니다. 훅은 결정론적입니다: 모델의 재량이 아니라 고정된 라이프사이클 포인트에서 발생합니다.
232 172
238 178
239자세히 알아보기: [훅 시작하기](/docs/ko/hooks-guide) · [훅 참조](/docs/ko/hooks)179자세히 알아보기: [훅 시작하기](/docs/ko/hooks-guide) · [훅 참조](/docs/ko/hooks)
240 180
241<h2 id="m">181## M
242 M
243</h2>
244 182
245<h3 id="managed-settings">183### Managed settings
246 Managed settings
247</h3>
248 184
249IT 또는 DevOps에 의해 조직 전체에 적용되는 설정이며, Anthropic의 서버를 통해 관리 콘솔에서 전달되거나 `~/.claude` 외부의 OS 수준 경로에 배치됩니다. 사용자 및 프로젝트 설정은 관리 설정을 재정의할 수 없습니다. 서버 관리 전달은 [적격 구성](/docs/ko/server-managed-settings#platform-availability)에 적용됩니다. [보안 고려 사항](/docs/ko/server-managed-settings#security-considerations)을 참조하십시오. 보안 정책, 규정 준수 요구 사항 또는 플릿 전체의 표준화된 도구에 사용합니다.185IT 또는 DevOps에 의해 조직 전체에 적용되는 설정이며, Anthropic의 서버를 통해 관리 콘솔에서 전달되거나 `~/.claude` 외부의 OS 수준 경로에 배치됩니다. 사용자 및 프로젝트 설정은 관리 설정을 재정의할 수 없습니다. 서버 관리 전달은 [적격 구성](/docs/ko/server-managed-settings#platform-availability)에 적용됩니다. [보안 고려 사항](/docs/ko/server-managed-settings#security-considerations)을 참조하십시오. 보안 정책, 규정 준수 요구 사항 또는 플릿 전체의 표준화된 도구에 사용합니다.
250 186
251자세히 알아보기: [Server-managed settings](/docs/ko/server-managed-settings) · [Settings files](/docs/ko/settings#where-settings-live)187자세히 알아보기: [Server-managed settings](/docs/ko/server-managed-settings) · [Settings files](/docs/ko/settings#where-settings-live)
252 188
253<h3 id="mcp-model-context-protocol">189### MCP (Model Context Protocol)
254 MCP (Model Context Protocol)
255</h3>
256 190
257AI 도구를 외부 데이터 소스 및 서비스에 연결하기 위한 개방형 표준입니다. MCP 서버는 Claude에 Slack, Jira, 데이터베이스, 브라우저 및 수백 개의 다른 통합을 위한 새로운 도구를 제공합니다. `/mcp`를 통해 또는 `.mcp.json`에 추가하여 서버를 연결합니다. 프로토콜 자체는 [플랫폼 용어집](https://platform.claude.com/docs/ko/about-claude/glossary#mcp-model-context-protocol)을 참조하십시오.191AI 도구를 외부 데이터 소스 및 서비스에 연결하기 위한 개방형 표준입니다. MCP 서버는 Claude에 Slack, Jira, 데이터베이스, 브라우저 및 수백 개의 다른 통합을 위한 새로운 도구를 제공합니다. `/mcp`를 통해 또는 `.mcp.json`에 추가하여 서버를 연결합니다. 프로토콜 자체는 [플랫폼 용어집](https://platform.claude.com/docs/ko/about-claude/glossary#mcp-model-context-protocol)을 참조하십시오.
258 192
259자세히 알아보기: [Model Context Protocol](/docs/ko/mcp)193자세히 알아보기: [Model Context Protocol](/docs/ko/mcp)
260 194
261<h3 id="mcp-server">195### MCP server
262 MCP server
263</h3>
264 196
265Claude에 [MCP](#mcp-model-context-protocol)를 통해 도구, 프롬프트 또는 리소스를 제공하는 프로그램입니다. `claude mcp add`를 사용하여, `.mcp.json`에서, [플러그인](#plugin)을 통해, 또는 claude.ai [커넥터](#connector)로 서버를 추가합니다. 로컬 stdio 서버는 Claude Code가 구성의 `command` 및 `args` 필드에서 시작하는 프로세스로 실행되며, 이는 프롬프트에서 입력하는 [명령어](#command)와는 관계가 없습니다.197Claude에 [MCP](#mcp-model-context-protocol)를 통해 도구, 프롬프트 또는 리소스를 제공하는 프로그램입니다. `claude mcp add`를 사용하여, `.mcp.json`에서, [플러그인](#plugin)을 통해, 또는 claude.ai [커넥터](#connector)로 서버를 추가합니다. 로컬 stdio 서버는 Claude Code가 구성의 `command` 및 `args` 필드에서 시작하는 프로세스로 실행되며, 이는 프롬프트에서 입력하는 [명령어](#command)와는 관계가 없습니다.
266 198
267자세히 알아보기: [Model Context Protocol](/docs/ko/mcp)199자세히 알아보기: [Model Context Protocol](/docs/ko/mcp)
268 200
269<h3 id="mcp-tool-search">201### MCP Tool Search
270 MCP Tool Search
271</h3>
272 202
273필요할 때까지 MCP 도구 스키마를 연기하는 컨텍스트 절약 메커니즘입니다. 시작 시 도구 이름과 서버 지침만 로드됩니다. Claude는 특정 도구를 사용하기로 결정할 때 전체 스키마를 요청합니다. 이렇게 하면 유휴 MCP 서버가 많은 컨텍스트를 소비하지 않습니다.203필요할 때까지 MCP 도구 스키마를 연기하는 컨텍스트 절약 메커니즘입니다. 시작 시 도구 이름과 서버 지침만 로드됩니다. Claude는 특정 도구를 사용하기로 결정할 때 전체 스키마를 요청합니다. 이렇게 하면 유휴 MCP 서버가 많은 컨텍스트를 소비하지 않습니다.
274 204
275자세히 알아보기: [MCP Tool Search로 확장](/docs/ko/mcp#scale-with-mcp-tool-search)205자세히 알아보기: [MCP Tool Search로 확장](/docs/ko/mcp#scale-with-mcp-tool-search)
276 206
277<h2 id="n">207## N
278 N
279</h2>
280 208
281<h3 id="non-interactive-mode">209### Non-interactive mode
282 Non-interactive mode
283</h3>
284 210
285`-p` 또는 `--print`로 호출되는 단일 프롬프트를 실행하고 대화형 프롬프트 없이 종료하는 모드입니다. CI, 스크립트 및 파이핑에 사용됩니다. `--no-session-persistence`를 전달하지 않는 한 실행은 여전히 재개 가능한 세션으로 저장됩니다. [Agent SDK](/docs/ko/agent-sdk/overview)는 Python 및 TypeScript 동등물입니다. 이전에는 headless mode라고 불렸습니다.211`-p` 또는 `--print`로 호출되는 단일 프롬프트를 실행하고 대화형 프롬프트 없이 종료하는 모드입니다. CI, 스크립트 및 파이핑에 사용됩니다. `--no-session-persistence`를 전달하지 않는 한 실행은 여전히 재개 가능한 세션으로 저장됩니다. [Agent SDK](/docs/ko/agent-sdk/overview)는 Python 및 TypeScript 동등물입니다. 이전에는 headless mode라고 불렸습니다.
286 212
287자세히 알아보기: [Claude Code를 프로그래밍 방식으로 실행](/docs/ko/headless)213자세히 알아보기: [Claude Code를 프로그래밍 방식으로 실행](/docs/ko/headless)
288 214
289<h2 id="o">215## O
290 O
291</h2>
292 216
293<h3 id="output-style">217### Output style
294 Output style
295</h3>
296 218
297Claude Code가 Claude에 제공하는 지시사항을 변경하여 응답 동작, 톤 또는 형식을 설정하는 구성입니다. 프로젝트 컨텍스트를 Claude Code의 기본 지시사항과 함께 추가하는 [CLAUDE.md](#claude-md)와 달리, 사용자 정의 출력 스타일은 자체 지시사항을 추가하며 기본 소프트웨어 엔지니어링 지시사항을 제외할 수 있습니다.219Claude Code가 Claude에 제공하는 지시사항을 변경하여 응답 동작, 톤 또는 형식을 설정하는 구성입니다. 프로젝트 컨텍스트를 Claude Code의 기본 지시사항과 함께 추가하는 [CLAUDE.md](#claude-md)와 달리, 사용자 정의 출력 스타일은 자체 지시사항을 추가하며 기본 소프트웨어 엔지니어링 지시사항을 제외할 수 있습니다.
298 220
299자세히 알아보기: [출력 스타일](/docs/ko/output-styles)221자세히 알아보기: [출력 스타일](/docs/ko/output-styles)
300 222
301<h2 id="p">223## P
302 P
303</h2>
304 224
305<h3 id="permission-mode">225### Permission mode
306 Permission mode
307</h3>
308 226
309세션의 기본 승인 동작입니다. CLI에서 `Shift+Tab`으로 순환하거나 VS Code, Desktop 및 claude.ai의 모드 선택기를 사용합니다. 사용 가능한 모드는 `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` 및 `bypassPermissions`입니다.227세션의 기본 승인 동작입니다. CLI에서 `Shift+Tab`으로 순환하거나 VS Code, Desktop 및 claude.ai의 모드 선택기를 사용합니다. 사용 가능한 모드는 `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` 및 `bypassPermissions`입니다.
310 228
312 230
313자세히 알아보기: [권한 모드 선택](/docs/ko/permission-modes)231자세히 알아보기: [권한 모드 선택](/docs/ko/permission-modes)
314 232
315<h3 id="permission-rule">233### Permission rule
316 Permission rule
317</h3>
318 234
319도구 이름 및 인수 패턴을 기반으로 도구 호출을 허용, 질문 또는 거부하는 설정 항목입니다. 규칙은 deny→ask→allow로 평가되며, 첫 번째 일치가 우선합니다. 권한 규칙은 더 광범위한 [권한 모드](#permission-mode) 위에 계층화된 세밀한 제어입니다.235도구 이름 및 인수 패턴을 기반으로 도구 호출을 허용, 질문 또는 거부하는 설정 항목입니다. 규칙은 deny→ask→allow로 평가되며, 첫 번째 일치가 우선합니다. 권한 규칙은 더 광범위한 [권한 모드](#permission-mode) 위에 계층화된 세밀한 제어입니다.
320 236
321자세히 알아보기: [권한 구성](/docs/ko/permissions)237자세히 알아보기: [권한 구성](/docs/ko/permissions)
322 238
323<h3 id="plan-mode">239### Plan mode
324 Plan mode
325</h3>
326 240
327Claude가 소스 파일을 편집하지 않고 변경 사항을 연구하고 제안하는 [권한 모드](#permission-mode)입니다. 읽고, 검색하고, 탐색 명령을 실행할 수 있으며, 아무것도 건드리기 전에 승인을 위한 계획을 제시합니다. `/plan`을 입력하거나 `Shift+Tab`을 눌러 plan mode에 들어갑니다.241Claude가 소스 파일을 편집하지 않고 변경 사항을 연구하고 제안하는 [권한 모드](#permission-mode)입니다. 읽고, 검색하고, 탐색 명령을 실행할 수 있으며, 아무것도 건드리기 전에 승인을 위한 계획을 제시합니다. `/plan`을 입력하거나 `Shift+Tab`을 눌러 plan mode에 들어갑니다.
328 242
329자세히 알아보기: [plan mode로 편집 전에 분석](/docs/ko/permission-modes#analyze-before-you-edit-with-plan-mode)243자세히 알아보기: [plan mode로 편집 전에 분석](/docs/ko/permission-modes#analyze-before-you-edit-with-plan-mode)
330 244
331<h3 id="plugin">245### Plugin
332 Plugin
333</h3>
334 246
335스킬, 훅, 서브에이전트 및 MCP 서버의 번들이며, 단일 설치 가능한 단위로 패키징됩니다. 플러그인 스킬은 `plugin-name:skill-name`으로 네임스페이스되므로 여러 플러그인이 공존합니다. [마켓플레이스](/docs/ko/plugins/overview)를 통해 팀 전체에 플러그인을 배포합니다.247스킬, 훅, 서브에이전트 및 MCP 서버의 번들이며, 단일 설치 가능한 단위로 패키징됩니다. 플러그인 스킬은 `plugin-name:skill-name`으로 네임스페이스되므로 여러 플러그인이 공존합니다. [마켓플레이스](/docs/ko/plugins/overview)를 통해 팀 전체에 플러그인을 배포합니다.
336 248
337자세히 알아보기: [플러그인](/docs/ko/plugins/overview)249자세히 알아보기: [플러그인](/docs/ko/plugins/overview)
338 250
339<h3 id="project-trust">251### Project trust
340 Project trust
341</h3>
342 252
343Claude Code가 구성을 로드하기 전에 디렉토리를 수락하는 대화입니다. 수락은 프로젝트 디렉토리별로 저장되며, 홈 디렉토리는 제외되고, 여기서 신뢰는 현재 세션에만 유지되며 각 실행 시 프롬프트가 다시 나타납니다. 디렉토리를 신뢰할 때까지 Claude Code는 저장소가 제공하는 일부 콘텐츠를 보류합니다. 예를 들어 `.claude/settings.json`의 프로젝트 허용 규칙 및 마켓플레이스입니다. [폴더를 신뢰하기 전에 실행되는 것](/docs/ko/permissions#what-runs-before-you-trust-a-folder)에서는 `-p` 세션이 대화 없이 실행하는 것을 포함하여 각 종류의 콘텐츠를 나열합니다.253Claude Code가 구성을 로드하기 전에 디렉토리를 수락하는 대화입니다. 수락은 프로젝트 디렉토리별로 저장되며, 홈 디렉토리는 제외되고, 여기서 신뢰는 현재 세션에만 유지되며 각 실행 시 프롬프트가 다시 나타납니다. 디렉토리를 신뢰할 때까지 Claude Code는 저장소가 제공하는 일부 콘텐츠를 보류합니다. 예를 들어 `.claude/settings.json`의 프로젝트 허용 규칙 및 마켓플레이스입니다. [폴더를 신뢰하기 전에 실행되는 것](/docs/ko/permissions#what-runs-before-you-trust-a-folder)에서는 `-p` 세션이 대화 없이 실행하는 것을 포함하여 각 종류의 콘텐츠를 나열합니다.
344 254
345자세히 알아보기: [`.claude` 디렉토리](/docs/ko/claude-directory)255자세히 알아보기: [`.claude` 디렉토리](/docs/ko/claude-directory)
346 256
347<h3 id="prompt-injection">257### Prompt injection
348 Prompt injection
349</h3>
350 258
351파일, 웹 페이지 또는 도구 결과에 포함된 적대적 지침이며, Claude를 요청하지 않은 작업으로 리디렉션하려고 시도합니다. Claude Code의 방어에는 권한 시스템, 명령 주입 탐지 및 신뢰 확인이 포함됩니다. [Auto mode](#auto-mode)는 도구 결과에서 의심스러운 내용을 스캔하는 서버 측 프로브와 도구 결과를 제거한 상태에서 작업을 검토하는 분류기를 추가하므로 주입된 텍스트가 직접 이를 조작할 수 없습니다.259파일, 웹 페이지 또는 도구 결과에 포함된 적대적 지침이며, Claude를 요청하지 않은 작업으로 리디렉션하려고 시도합니다. Claude Code의 방어에는 권한 시스템, 명령 주입 탐지 및 신뢰 확인이 포함됩니다. [Auto mode](#auto-mode)는 도구 결과에서 의심스러운 내용을 스캔하는 서버 측 프로브와 도구 결과를 제거한 상태에서 작업을 검토하는 분류기를 추가하므로 주입된 텍스트가 직접 이를 조작할 수 없습니다.
352 260
353자세히 알아보기: [프롬프트 주입으로부터 보호](/docs/ko/security#protect-against-prompt-injection)261자세히 알아보기: [프롬프트 주입으로부터 보호](/docs/ko/security#protect-against-prompt-injection)
354 262
355<h2 id="r">263## R
356 R
357</h2>
358 264
359<h3 id="remote-control">265### Remote Control
360 Remote Control
361</h3>
362 266
363claude.ai를 통해 휴대폰 또는 브라우저에서 로컬 Claude Code 세션을 계속하는 방법입니다. 코드 실행 및 파일은 머신에 남아 있습니다. 인터페이스만 원격입니다. 클라우드 샌드박스에서 실행되는 [웹의 Claude Code](/docs/ko/claude-code-on-the-web)와 다릅니다.267claude.ai를 통해 휴대폰 또는 브라우저에서 로컬 Claude Code 세션을 계속하는 방법입니다. 코드 실행 및 파일은 머신에 남아 있습니다. 인터페이스만 원격입니다. 클라우드 샌드박스에서 실행되는 [웹의 Claude Code](/docs/ko/claude-code-on-the-web)와 다릅니다.
364 268
365자세히 알아보기: [Remote Control](/docs/ko/remote-control)269자세히 알아보기: [Remote Control](/docs/ko/remote-control)
366 270
367<h3 id="rules">271### Rules
368 Rules
369</h3>
370 272
371CLAUDE.md와 함께 로드되는 `.claude/rules/`의 모듈식 지침 파일입니다. 규칙은 YAML `paths:` frontmatter로 경로 범위를 지정할 수 있으므로 Claude가 일치하는 파일을 읽거나, 쓰거나, 편집할 때만 로드되어 관련될 때까지 컨텍스트를 간결하게 유지합니다.273CLAUDE.md와 함께 로드되는 `.claude/rules/`의 모듈식 지침 파일입니다. 규칙은 YAML `paths:` frontmatter로 경로 범위를 지정할 수 있으므로 Claude가 일치하는 파일을 읽거나, 쓰거나, 편집할 때만 로드되어 관련될 때까지 컨텍스트를 간결하게 유지합니다.
372 274
373자세히 알아보기: [`.claude/rules/`로 규칙 구성](/docs/ko/memory#organize-rules-with-claude/rules/)275자세히 알아보기: [`.claude/rules/`로 규칙 구성](/docs/ko/memory#organize-rules-with-claude/rules/)
374 276
375<h2 id="s">277## S
376 S
377</h2>
378 278
379<h3 id="sandboxing">279### Sandboxing
380 Sandboxing
381</h3>
382 280
383Bash 도구에 대한 OS 수준 파일 시스템 및 네트워크 격리입니다. 명령은 미리 정의한 경계 내에서 실행되므로 Claude는 명령별 승인 프롬프트 없이 그 안에서 자유롭게 작업할 수 있습니다. 샌드박싱은 [권한 규칙](#permission-rule)과 별개의 계층입니다.281Bash 도구에 대한 OS 수준 파일 시스템 및 네트워크 격리입니다. 명령은 미리 정의한 경계 내에서 실행되므로 Claude는 명령별 승인 프롬프트 없이 그 안에서 자유롭게 작업할 수 있습니다. 샌드박싱은 [권한 규칙](#permission-rule)과 별개의 계층입니다.
384 282
385자세히 알아보기: [샌드박싱](/docs/ko/sandboxing)283자세히 알아보기: [샌드박싱](/docs/ko/sandboxing)
386 284
387<h3 id="session">285### Session
388 Session
389</h3>
390 286
391현재 디렉토리에 연결된 대화이며, 자신의 독립적인 [컨텍스트 윈도우](#context-window)를 가집니다. 세션은 `claude -c`로 재개할 수 있고, `--fork-session`으로 포크하여 새 세션 ID 아래에 기록을 보존하거나, 여러 터미널에서 병렬로 실행할 수 있습니다. `/clear`를 실행하면 새 세션이 시작됩니다. 이전 세션은 저장된 상태로 유지되며 `/resume`을 통해 사용할 수 있습니다. 각 세션의 트랜스크립트는 `~/.claude/projects/` 아래에 저장됩니다.287현재 디렉토리에 연결된 대화이며, 자신의 독립적인 [컨텍스트 윈도우](#context-window)를 가집니다. 세션은 `claude -c`로 재개할 수 있고, `--fork-session`으로 포크하여 새 세션 ID 아래에 기록을 보존하거나, 여러 터미널에서 병렬로 실행할 수 있습니다. `/clear`를 실행하면 새 세션이 시작됩니다. 이전 세션은 저장된 상태로 유지되며 `/resume`을 통해 사용할 수 있습니다. 각 세션의 트랜스크립트는 `~/.claude/projects/` 아래에 저장됩니다.
392 288
393자세히 알아보기: [세션으로 작업](/docs/ko/how-claude-code-works#work-with-sessions)289자세히 알아보기: [세션으로 작업](/docs/ko/how-claude-code-works#work-with-sessions)
394 290
395<h3 id="settings-layers">291### Settings layers
396 Settings layers
397</h3>
398 292
399Claude Code가 구성을 읽는 계층 구조이며, 우선순위가 높은 것부터 낮은 순서로 다음과 같습니다: [관리형 정책](#managed-settings), `--settings` 플래그로 전달하는 설정, `.claude/settings.local.json`의 로컬 설정, `.claude/settings.json`의 프로젝트 설정, 그 다음 `~/.claude/settings.json`의 사용자 설정. 배열은 계층 전체에서 병합되며, 스칼라는 더 높은 계층의 값이 더 낮은 계층의 값을 재정의합니다. [설정 우선순위](/docs/ko/settings#settings-precedence)를 참조하십시오.293Claude Code가 구성을 읽는 계층 구조이며, 우선순위가 높은 것부터 낮은 순서로 다음과 같습니다: [관리형 정책](#managed-settings), `--settings` 플래그로 전달하는 설정, `.claude/settings.local.json`의 로컬 설정, `.claude/settings.json`의 프로젝트 설정, 그 다음 `~/.claude/settings.json`의 사용자 설정. 배열은 계층 전체에서 병합되며, 스칼라는 더 높은 계층의 값이 더 낮은 계층의 값을 재정의합니다. [설정 우선순위](/docs/ko/settings#settings-precedence)를 참조하십시오.
400 294
401자세히 알아보기: [설정 파일](/docs/ko/settings#where-settings-live)295자세히 알아보기: [설정 파일](/docs/ko/settings#where-settings-live)
402 296
403<h3 id="skill">297### Skill
404 Skill
405</h3>
406 298
407지침, 지식 또는 Claude가 도구 키트에 추가하는 워크플로를 포함하는 `SKILL.md` 파일입니다. Claude는 관련이 있을 때 스킬을 자동으로 로드하며, 사용자가 `/skill-name`으로 직접 호출할 수도 있습니다. 스킬은 Agent Skills 개방형 표준을 따르며, Claude Code는 이를 호출 제어 및 서브에이전트 실행으로 확장합니다.299지침, 지식 또는 Claude가 도구 키트에 추가하는 워크플로를 포함하는 `SKILL.md` 파일입니다. Claude는 관련이 있을 때 스킬을 자동으로 로드하며, 사용자가 `/skill-name`으로 직접 호출할 수도 있습니다. 스킬은 Agent Skills 개방형 표준을 따르며, Claude Code는 이를 호출 제어 및 서브에이전트 실행으로 확장합니다.
408 300
410 302
411자세히 알아보기: [스킬로 Claude 확장](/docs/ko/skills)303자세히 알아보기: [스킬로 Claude 확장](/docs/ko/skills)
412 304
413<h3 id="subagent">305### Subagent
414 Subagent
415</h3>
416 306
417자신의 컨텍스트 윈도우, 사용자 정의 시스템 프롬프트, 특정 도구 액세스 및 독립적인 권한으로 실행되는 특화된 AI 어시스턴트입니다. 위임된 작업을 수행하고 주 대화에 요약을 반환합니다. 서브에이전트를 사용하여 큰 탐색을 기본 컨텍스트 밖으로 유지하거나 병렬 연구를 실행합니다. 서브에이전트는 이를 생성한 세션 내에 머물러 있습니다. 직접 실행하는 별도의 세션 간에 발견 사항을 전달하려면 [세션 간 메시징](/docs/ko/cross-session-messaging)을 사용하십시오.307자신의 컨텍스트 윈도우, 사용자 정의 시스템 프롬프트, 특정 도구 액세스 및 독립적인 권한으로 실행되는 특화된 AI 어시스턴트입니다. 위임된 작업을 수행하고 주 대화에 요약을 반환합니다. 서브에이전트를 사용하여 큰 탐색을 기본 컨텍스트 밖으로 유지하거나 병렬 연구를 실행합니다. 서브에이전트는 이를 생성한 세션 내에 머물러 있습니다. 직접 실행하는 별도의 세션 간에 발견 사항을 전달하려면 [세션 간 메시징](/docs/ko/cross-session-messaging)을 사용하십시오.
418 308
420 310
421자세히 알아보기: [사용자 정의 서브에이전트 생성](/docs/ko/sub-agents)311자세히 알아보기: [사용자 정의 서브에이전트 생성](/docs/ko/sub-agents)
422 312
423<h3 id="surface">313### Surface
424 Surface
425</h3>
426 314
427Claude Code에 액세스하는 모든 장소입니다: CLI, VS Code, JetBrains, Desktop 또는 claude.ai. 모든 사용 환경은 동일한 엔진을 공유합니다. 컴퓨터의 세션은 로컬 CLAUDE.md, 설정 및 스킬을 읽습니다. [클라우드 세션](/docs/ko/cloud-environments#what-carries-over-from-your-setup)은 저장소의 새로운 클론에서 시작되며 컴퓨터의 `~/.claude/`를 읽지 않습니다. Slack 및 Chrome 확장 프로그램은 사용 환경 자체가 아니라 사용 환경에 연결되는 통합입니다.315Claude Code에 액세스하는 모든 장소입니다: CLI, VS Code, JetBrains, Desktop 또는 claude.ai. 모든 사용 환경은 동일한 엔진을 공유합니다. 컴퓨터의 세션은 로컬 CLAUDE.md, 설정 및 스킬을 읽습니다. [클라우드 세션](/docs/ko/cloud-environments#what-carries-over-from-your-setup)은 저장소의 새로운 클론에서 시작되며 컴퓨터의 `~/.claude/`를 읽지 않습니다. Slack 및 Chrome 확장 프로그램은 사용 환경 자체가 아니라 사용 환경에 연결되는 통합입니다.
428 316
429자세히 알아보기: [플랫폼 및 통합](/docs/ko/platforms)317자세히 알아보기: [플랫폼 및 통합](/docs/ko/platforms)
430 318
431<h3 id="system-prompt">319### System prompt
432 System prompt
433</h3>
434 320
435Claude Code가 모든 요청에서 대화 앞에 보내는 지침으로, Claude가 도구를 사용하는 방법, 안전하게 작동하는 방법 및 응답 형식을 지정합니다. `--append-system-prompt`로 시스템 프롬프트에 추가하거나 `--system-prompt`로 바꿀 수 있습니다. 시스템 프롬프트는 [프롬프트 캐시](/docs/ko/prompt-caching#how-the-cache-is-organized)의 첫 번째 계층입니다.321Claude Code가 모든 요청에서 대화 앞에 보내는 지침으로, Claude가 도구를 사용하는 방법, 안전하게 작동하는 방법 및 응답 형식을 지정합니다. `--append-system-prompt`로 시스템 프롬프트에 추가하거나 `--system-prompt`로 바꿀 수 있습니다. 시스템 프롬프트는 [프롬프트 캐시](/docs/ko/prompt-caching#how-the-cache-is-organized)의 첫 번째 계층입니다.
436 322
438 324
439자세히 알아보기: [시스템 프롬프트 플래그](/docs/ko/cli-reference#system-prompt-flags)325자세히 알아보기: [시스템 프롬프트 플래그](/docs/ko/cli-reference#system-prompt-flags)
440 326
441<h3 id="system-reminder">327### System reminder
442 System reminder
443</h3>
444 328
445Claude Code가 [에이전틱 하네스](#agentic-harness)로서 대화에 추가하여 Claude에 컨텍스트를 제공하는 메시지입니다. 시스템 리마인더는 사용자가 직접 보내지 않습니다. Claude Code는 세션이 실행되는 동안 이를 삽입합니다. 예를 들어 세션이 시작될 때, 훅이 텍스트를 반환할 때 또는 파일이 디스크에서 변경될 때입니다. Claude는 사용자의 메시지와 함께 시스템 리마인더를 읽습니다. 다음은 모두 시스템 리마인더로 Claude에 전달됩니다:329Claude Code가 [에이전틱 하네스](#agentic-harness)로서 대화에 추가하여 Claude에 컨텍스트를 제공하는 메시지입니다. 시스템 리마인더는 사용자가 직접 보내지 않습니다. Claude Code는 세션이 실행되는 동안 이를 삽입합니다. 예를 들어 세션이 시작될 때, 훅이 텍스트를 반환할 때 또는 파일이 디스크에서 변경될 때입니다. Claude는 사용자의 메시지와 함께 시스템 리마인더를 읽습니다. 다음은 모두 시스템 리마인더로 Claude에 전달됩니다:
446 330
455 339
456자세히 알아보기: [시스템 프롬프트 외부에서 Claude Code가 추가하는 컨텍스트](/docs/ko/agent-sdk/modifying-system-prompts#context-claude-code-adds-outside-the-system-prompt)340자세히 알아보기: [시스템 프롬프트 외부에서 Claude Code가 추가하는 컨텍스트](/docs/ko/agent-sdk/modifying-system-prompts#context-claude-code-adds-outside-the-system-prompt)
457 341
458<h2 id="t">342## T
459 T
460</h2>
461 343
462<h3 id="teleport">344### Teleport
463 Teleport
464</h3>
465 345
466클라우드 Claude Code 세션을 로컬 터미널로 가져오는 명령 `/teleport`입니다. Claude는 분기를 가져오고, 대화 기록을 로드하고, 클라우드 세션의 마지막 상태에서 재개합니다. 역방향은 `--cloud`이며, 로컬 작업을 클라우드에서 실행하도록 보냅니다.346클라우드 Claude Code 세션을 로컬 터미널로 가져오는 명령 `/teleport`입니다. Claude는 분기를 가져오고, 대화 기록을 로드하고, 클라우드 세션의 마지막 상태에서 재개합니다. 역방향은 `--cloud`이며, 로컬 작업을 클라우드에서 실행하도록 보냅니다.
467 347
468자세히 알아보기: [터미널에서 클라우드 세션 계속하기](/docs/ko/claude-code-on-the-web#from-cloud-to-terminal)348자세히 알아보기: [터미널에서 클라우드 세션 계속하기](/docs/ko/claude-code-on-the-web#from-cloud-to-terminal)
469 349
470<h3 id="tool">350### Tool
471 Tool
472</h3>
473 351
474Claude가 수행할 수 있는 작업입니다: 파일 읽기, 코드 편집, 셸 명령 실행, 웹 검색, 서브에이전트 생성. 도구는 Claude Code를 에이전트로 만드는 것입니다. 도구 없이 Claude는 텍스트로만 응답할 수 있습니다. 각 도구 사용은 [에이전트 루프](#agentic-loop)에서 Claude의 다음 결정을 알려주는 결과를 반환합니다.352Claude가 수행할 수 있는 작업입니다: 파일 읽기, 코드 편집, 셸 명령 실행, 웹 검색, 서브에이전트 생성. 도구는 Claude Code를 에이전트로 만드는 것입니다. 도구 없이 Claude는 텍스트로만 응답할 수 있습니다. 각 도구 사용은 [에이전트 루프](#agentic-loop)에서 Claude의 다음 결정을 알려주는 결과를 반환합니다.
475 353
476자세히 알아보기: [Claude에서 사용 가능한 도구](/docs/ko/tools-reference)354자세히 알아보기: [Claude에서 사용 가능한 도구](/docs/ko/tools-reference)
477 355
478<h3 id="transcript">356### Transcript
479 Transcript
480</h3>
481 357
482[세션](#session)의 저장된 기록입니다. 대화는 사용자와 Claude가 교환하는 것이고, 트랜스크립트는 기본적으로 `~/.claude/projects/<project>/<session-id>.jsonl`에 파일로 보관된 그 대화입니다. Claude Code는 재개할 때 파일을 다시 읽으며, 이것이 세션이 끝난 후에도 대화가 계속되는 방식입니다. 동일한 대화의 화면상 보기는 [트랜스크립트 뷰어](/docs/ko/interactive-mode#transcript-viewer)를 참조하십시오.358[세션](#session)의 저장된 기록입니다. 대화는 사용자와 Claude가 교환하는 것이고, 트랜스크립트는 기본적으로 `~/.claude/projects/<project>/<session-id>.jsonl`에 파일로 보관된 그 대화입니다. Claude Code는 재개할 때 파일을 다시 읽으며, 이것이 세션이 끝난 후에도 대화가 계속되는 방식입니다. 동일한 대화의 화면상 보기는 [트랜스크립트 뷰어](/docs/ko/interactive-mode#transcript-viewer)를 참조하십시오.
483 359
484자세히 알아보기: [트랜스크립트가 저장되는 위치](/docs/ko/sessions#where-transcripts-are-stored)360자세히 알아보기: [트랜스크립트가 저장되는 위치](/docs/ko/sessions#where-transcripts-are-stored)
485 361
486<h3 id="turn">362### Turn
487 Turn
488</h3>
489 363
490[세션](#session) 내에서 Claude의 한 번의 완전한 응답입니다. 턴은 메시지를 보낼 때 시작되고 Claude가 응답을 마칠 때 끝나며, 그 사이에 여러 개의 [도구](#tool) 호출이 있을 수 있습니다. [Stop 훅](#hook)은 각 턴의 끝에서 실행됩니다. 세션은 많은 턴으로 구성되며, [에이전트 루프](#agentic-loop)는 한 턴 내에서 일어나는 일을 설명합니다.364[세션](#session) 내에서 Claude의 한 번의 완전한 응답입니다. 턴은 메시지를 보낼 때 시작되고 Claude가 응답을 마칠 때 끝나며, 그 사이에 여러 개의 [도구](#tool) 호출이 있을 수 있습니다. [Stop 훅](#hook)은 각 턴의 끝에서 실행됩니다. 세션은 많은 턴으로 구성되며, [에이전트 루프](#agentic-loop)는 한 턴 내에서 일어나는 일을 설명합니다.
491 365
492자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works#the-agentic-loop)366자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works#the-agentic-loop)
493 367
494<h2 id="v">368## V
495 V
496</h2>
497 369
498<h3 id="verification-loop">370### Verification loop
499 Verification loop
500</h3>
501 371
502그럴듯해 보이는 결과를 그대로 받아들이는 대신 세션이 작업이 실제로 완료되었는지 확인하는 방법입니다. 테스트 스위트, 빌드 또는 스크린샷 비교와 같이 Claude가 실행할 수 있는 검사를 제공하면, Claude는 한 번의 시도 후 중단하는 대신 검사가 통과할 때까지 반복합니다. 검증 루프는 [`/goal`](/docs/ko/goal), 무인 실행 및 [동적 워크플로](/docs/ko/workflows)의 사전 요구 사항입니다. 검증 루프가 없으면 에이전트가 완료되었는지 판단하는 주체는 에이전트 자신뿐입니다.372그럴듯해 보이는 결과를 그대로 받아들이는 대신 세션이 작업이 실제로 완료되었는지 확인하는 방법입니다. 테스트 스위트, 빌드 또는 스크린샷 비교와 같이 Claude가 실행할 수 있는 검사를 제공하면, Claude는 한 번의 시도 후 중단하는 대신 검사가 통과할 때까지 반복합니다. 검증 루프는 [`/goal`](/docs/ko/goal), 무인 실행 및 [동적 워크플로](/docs/ko/workflows)의 사전 요구 사항입니다. 검증 루프가 없으면 에이전트가 완료되었는지 판단하는 주체는 에이전트 자신뿐입니다.
503 373
504자세히 알아보기: [Claude에 작업 확인 방법 제공](/docs/ko/best-practices#give-claude-a-way-to-verify-its-work)374자세히 알아보기: [Claude에 작업 확인 방법 제공](/docs/ko/best-practices#give-claude-a-way-to-verify-its-work)
505 375
506<h2 id="w">376## W
507 W
508</h2>
509 377
510<h3 id="worktree-isolation">378### Worktree isolation
511 Worktree isolation
512</h3>
513 379
514`.claude/worktrees/` 아래의 별도 git worktree에서 Claude를 실행하는 격리 모드이며, `-w` 플래그 또는 서브에이전트 구성의 `isolation: worktree`로 활성화됩니다. 변경 사항은 별도 디렉토리의 별도 브랜치에 남아 있으므로 병렬 에이전트는 각자 자신의 파일 사본을 편집합니다.380`.claude/worktrees/` 아래의 별도 git worktree에서 Claude를 실행하는 격리 모드이며, `-w` 플래그 또는 서브에이전트 구성의 `isolation: worktree`로 활성화됩니다. 변경 사항은 별도 디렉토리의 별도 브랜치에 남아 있으므로 병렬 에이전트는 각자 자신의 파일 사본을 편집합니다.
515 381
517 383
518***384***
519 385
520<h2 id="deprecated-and-renamed-terms">386## 더 이상 사용되지 않는 용어 및 이름이 변경된 용어
521 더 이상 사용되지 않는 용어 및 이름이 변경된 용어
522</h2>
523 387
524이 용어는 이전 문서, 블로그 게시물 및 커뮤니티 콘텐츠에 나타납니다. 이 사이트를 검색할 때 현재 이름을 사용합니다.388이 용어는 이전 문서, 블로그 게시물 및 커뮤니티 콘텐츠에 나타납니다. 이 사이트를 검색할 때 현재 이름을 사용합니다.
525 389