6 6
7> Claude Code 용어 정의. 에이전트 루프, 컴팩션, CLAUDE.md, 훅, 서브에이전트, MCP 및 기타 핵심 개념의 의미를 알아봅니다.7> Claude Code 용어 정의. 에이전트 루프, 컴팩션, CLAUDE.md, 훅, 서브에이전트, MCP 및 기타 핵심 개념의 의미를 알아봅니다.
8 8
9이 용어집은 Claude Code 용어를 정의합니다. 각 항목은 개념이 심층적으로 다루어지는 페이지로 연결됩니다. 토큰, 온도, RAG와 같은 모델 수준의 개념은 [플랫폼 용어집](https://platform.claude.com/docs/ko/about-claude/glossary)을 참조하십시오.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<h2 id="a">
12 A12 A
16 Agent teams16 Agent teams
17</h3>17</h3>
18 18
19여러 개의 독립적인 Claude Code 세션이 팀 리더에 의해 조정되며, 공유 작업 목록과 피어 투 피어 메시징을 갖춘 구성입니다. 단일 세션 내에서 실행되고 부모에게만 보고하는 [서브에이전트](#subagent)와 달리, 팀원들은 각각 자신의 컨텍스트 윈도우를 가지며 어느 팀원과도 직접 상호작용할 수 있습니다. Agent teams는 실험적이며 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`을 설정하여 활성화해야 합니다.19여러 개의 독립적인 Claude Code 세션이 팀 리더에 의해 조정되며, 공유 작업 목록과 피어 투 피어 메시징을 갖춘 구성입니다. 단일 세션 내에서 실행되고 부모에게만 보고하는 [서브에이전트](#subagent)와 달리, 팀원들은 각각 자신의 컨텍스트 윈도우를 가지며 어느 팀원과도 직접 상호작용할 수 있습니다. Agent teams는 실험적이며 비활성화되어 있습니다. [에이전트 팀 활성화](/docs/ko/agent-teams#enable-agent-teams)를 참조하세요.
20 20
21자세히 알아보기: [에이전트 팀 실행](/ko/agent-teams)21자세히 알아보기: [에이전트 팀 실행](/docs/ko/agent-teams)
22 22
23<h3 id="agentic-coding">23<h3 id="agentic-coding">
24 Agentic coding24 Agentic coding
26 26
27AI가 파일을 읽고, 명령을 실행하고, 변경 사항을 자율적으로 만들 수 있는 워크플로우입니다. 사용자가 직접 적용해야 하는 텍스트만 응답하는 채팅 기반 어시스턴트와 달리, 사용자가 지켜보거나, 리디렉션하거나, 떠날 수 있습니다. Claude Code는 조언만 하는 것이 아니라 행동할 수 있게 해주는 [도구](#tool)를 가지고 있기 때문에 에이전트입니다.27AI가 파일을 읽고, 명령을 실행하고, 변경 사항을 자율적으로 만들 수 있는 워크플로우입니다. 사용자가 직접 적용해야 하는 텍스트만 응답하는 채팅 기반 어시스턴트와 달리, 사용자가 지켜보거나, 리디렉션하거나, 떠날 수 있습니다. Claude Code는 조언만 하는 것이 아니라 행동할 수 있게 해주는 [도구](#tool)를 가지고 있기 때문에 에이전트입니다.
28 28
29자세히 알아보기: [Claude Code 작동 방식](/ko/how-claude-code-works)29자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works)
30 30
31<h3 id="agentic-harness">31<h3 id="agentic-harness">
32 Agentic harness32 Agentic harness
34 34
35언어 모델을 능력 있는 코딩 에이전트로 변환하는 도구, 컨텍스트 관리 및 실행 환경입니다. Claude Code는 하네스이고, Claude는 그 안의 모델입니다. 하네스는 파일 액세스, 셸 실행, 권한 게이팅, 메모리 로딩 및 작업을 함께 연결하는 루프를 제공합니다.35언어 모델을 능력 있는 코딩 에이전트로 변환하는 도구, 컨텍스트 관리 및 실행 환경입니다. Claude Code는 하네스이고, Claude는 그 안의 모델입니다. 하네스는 파일 액세스, 셸 실행, 권한 게이팅, 메모리 로딩 및 작업을 함께 연결하는 루프를 제공합니다.
36 36
37자세히 알아보기: [Claude Code 작동 방식](/ko/how-claude-code-works)37자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works)
38 38
39<h3 id="agentic-loop">39<h3 id="agentic-loop">
40 Agentic loop40 Agentic loop
42 42
43Claude가 모든 작업을 수행하는 사이클입니다: 컨텍스트 수집, 작업 수행, 결과 확인 및 완료될 때까지 반복합니다. 각 도구 사용은 다음 단계를 알려주는 정보를 반환합니다. 언제든지 루프를 중단하여 리디렉션할 수 있습니다. [훅](#hook), [스킬](#skill), [MCP](#mcp-model-context-protocol)을 포함한 대부분의 확장 포인트는 이 루프의 특정 단계에 연결됩니다.43Claude가 모든 작업을 수행하는 사이클입니다: 컨텍스트 수집, 작업 수행, 결과 확인 및 완료될 때까지 반복합니다. 각 도구 사용은 다음 단계를 알려주는 정보를 반환합니다. 언제든지 루프를 중단하여 리디렉션할 수 있습니다. [훅](#hook), [스킬](#skill), [MCP](#mcp-model-context-protocol)을 포함한 대부분의 확장 포인트는 이 루프의 특정 단계에 연결됩니다.
44 44
45자세히 알아보기: [Claude Code 작동 방식](/ko/how-claude-code-works#the-agentic-loop)45자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works#the-agentic-loop)
46 46
47<h3 id="artifact">47<h3 id="artifact">
48 Artifact48 Artifact
50 50
51Claude Code가 세션에서 claude.ai의 비공개 URL로 게시하는 라이브 대화형 웹 페이지이므로, 터미널 텍스트를 읽는 대신 시각적으로 출력을 보거나 공유할 수 있습니다. 세션이 다시 게시될 때 페이지가 제자리에서 업데이트됩니다. Claude Code에서 만든 Artifact는 claude.ai 대화에서 만든 Artifact와 동일한 갤러리에 나타납니다. 공유는 플랜에 따라 달라집니다: Pro 및 Max에서는 누구나 열 수 있는 공개 링크이고, Team 및 Enterprise에서는 조직 내 공유이며, 소유자가 활성화하면 공개 링크도 가능합니다.51Claude Code가 세션에서 claude.ai의 비공개 URL로 게시하는 라이브 대화형 웹 페이지이므로, 터미널 텍스트를 읽는 대신 시각적으로 출력을 보거나 공유할 수 있습니다. 세션이 다시 게시될 때 페이지가 제자리에서 업데이트됩니다. Claude Code에서 만든 Artifact는 claude.ai 대화에서 만든 Artifact와 동일한 갤러리에 나타납니다. 공유는 플랜에 따라 달라집니다: Pro 및 Max에서는 누구나 열 수 있는 공개 링크이고, Team 및 Enterprise에서는 조직 내 공유이며, 소유자가 활성화하면 공개 링크도 가능합니다.
52 52
53자세히 알아보기: [세션 출력을 Artifact로 공유](/ko/artifacts)53자세히 알아보기: [세션 출력을 Artifact로 공유](/docs/ko/artifacts)
54 54
55<h3 id="auto-memory">55<h3 id="auto-memory">
56 Auto memory56 Auto memory
58 58
59Claude가 사용자의 수정 및 선호도를 기반으로 자신을 위해 작성한 노트이며, `~/.claude/projects/` 아래 git 저장소별로 저장됩니다. 동일한 저장소의 모든 worktree는 하나의 auto memory 디렉토리를 공유합니다. `MEMORY.md` 인덱스의 처음 200줄 또는 25KB가 모든 세션의 시작 시 로드됩니다. Auto memory는 사용자가 작성하는 [CLAUDE.md](#claude-md)의 Claude 작성 대응물입니다.59Claude가 사용자의 수정 및 선호도를 기반으로 자신을 위해 작성한 노트이며, `~/.claude/projects/` 아래 git 저장소별로 저장됩니다. 동일한 저장소의 모든 worktree는 하나의 auto memory 디렉토리를 공유합니다. `MEMORY.md` 인덱스의 처음 200줄 또는 25KB가 모든 세션의 시작 시 로드됩니다. Auto memory는 사용자가 작성하는 [CLAUDE.md](#claude-md)의 Claude 작성 대응물입니다.
60 60
61자세히 알아보기: [Auto memory](/ko/memory#auto-memory)61자세히 알아보기: [Auto memory](/docs/ko/memory#auto-memory)
62 62
63<h3 id="auto-mode">63<h3 id="auto-mode">
64 Auto mode64 Auto mode
65</h3>65</h3>
66 66
67백그라운드에서 별도의 분류기 모델이 각 작업을 검토하는 [권한 모드](#permission-mode)이며, 대부분은 승인 프롬프트 없이 실행됩니다. 명시적 요청 규칙은 여전히 프롬프트를 표시합니다. 분류기는 범위 확대, 신뢰할 수 없는 인프라 및 [프롬프트 주입](#prompt-injection)을 차단합니다. 도구 결과를 보지 않으므로 주입된 지침이 결정에 영향을 미칠 수 없습니다.67백그라운드에서 별도의 분류기 모델이 각 작업을 검토하는 [권한 모드](#permission-mode)이므로, Claude Code는 대부분의 작업을 사용자에게 묻지 않고 실행합니다. Claude Code는 여전히 명시적 요청 규칙과 일치하는 작업 전에 사용자에게 묻습니다. Pro, Max 및 Team 플랜에서 auto mode는 대화형 터미널 및 VS Code 세션의 [기본 시작 권한 모드](/docs/ko/permission-modes#which-mode-a-session-starts-in)입니다. 분류기는 범위 확대, 신뢰할 수 없는 인프라 및 [프롬프트 주입](#prompt-injection)을 차단합니다. 도구 결과는 분류기가 보는 것에서 제거되므로, 파일이나 웹 페이지의 악의적인 콘텐츠가 직접 조작할 수 없습니다.
68 68
69자세히 알아보기: [프롬프트 제거 및 auto mode](/ko/permission-modes#eliminate-prompts-with-auto-mode)69자세히 알아보기: [Auto mode로 프롬프트 제거](/docs/ko/permission-modes#eliminate-prompts-with-auto-mode)
70 70
71<h2 id="b">71<h2 id="b">
72 B72 B
76 Bare mode76 Bare mode
77</h3>77</h3>
78 78
79자동 발견을 건너뛰는 시작 플래그 `--bare`입니다. 훅, 스킬, 플러그인, MCP 서버, auto memory 및 CLAUDE.md의 자동 발견을 건너뜁니다. 명시적으로 전달하는 플래그만 적용됩니다. CI 및 스크립트된 호출에 권장되며, 로컬 구성에 관계없이 머신 간에 동일한 동작이 필요합니다.79`--bare`를 사용하면 Claude Code는 `--add-dir`으로 전달하는 디렉터리의 스킬을 제외하고 훅, 스킬, 사용자 정의 명령, 서브에이전트, 플러그인, MCP 서버, auto memory 또는 CLAUDE.md를 로드하지 않고 시작합니다. CI 및 스크립트된 호출에 권장되며, 모든 머신에서 동일한 결과가 필요한 경우에 사용합니다.
80 80
81자세히 알아보기: [bare mode로 더 빠르게 시작](/ko/headless#start-faster-with-bare-mode)81자세히 알아보기: [bare mode로 더 빠르게 시작](/docs/ko/headless#start-faster-with-bare-mode)
82 82
83<h3 id="bundled-skills">83<h3 id="bundled-skills">
84 Bundled skills84 Bundled skills
86 86
87Claude Code에 포함된 프롬프트 기반 플레이북입니다. `/batch`, `/code-review`, `/debug`, `/loop` 등이 있습니다. 고정 로직을 실행하는 기본 제공 명령과 달리, 번들 스킬은 Claude에 상세한 프롬프트를 제공하고 작업을 조율하도록 하므로 에이전트를 생성하고, 파일을 읽고, 코드베이스에 적응할 수 있습니다.87Claude Code에 포함된 프롬프트 기반 플레이북입니다. `/batch`, `/code-review`, `/debug`, `/loop` 등이 있습니다. 고정 로직을 실행하는 기본 제공 명령과 달리, 번들 스킬은 Claude에 상세한 프롬프트를 제공하고 작업을 조율하도록 하므로 에이전트를 생성하고, 파일을 읽고, 코드베이스에 적응할 수 있습니다.
88 88
89자세히 알아보기: [번들 스킬](/ko/skills#bundled-skills)89자세히 알아보기: [번들 스킬](/docs/ko/skills#bundled-skills)
90 90
91<h2 id="c">91<h2 id="c">
92 C92 C
98 98
99실행 중인 세션에 이벤트를 푸시하는 [MCP 서버](#mcp-model-context-protocol)이므로 Claude는 터미널에서 떨어져 있을 때 발생하는 일에 반응할 수 있습니다. 채널은 양방향일 수 있습니다: Claude는 인바운드 이벤트를 읽고 동일한 채널을 통해 다시 응답합니다. Telegram, Discord 및 iMessage는 연구 미리보기에 포함됩니다.99실행 중인 세션에 이벤트를 푸시하는 [MCP 서버](#mcp-model-context-protocol)이므로 Claude는 터미널에서 떨어져 있을 때 발생하는 일에 반응할 수 있습니다. 채널은 양방향일 수 있습니다: Claude는 인바운드 이벤트를 읽고 동일한 채널을 통해 다시 응답합니다. Telegram, Discord 및 iMessage는 연구 미리보기에 포함됩니다.
100 100
101자세히 알아보기: [채널](/ko/channels)101자세히 알아보기: [채널](/docs/ko/channels)
102 102
103<h3 id="checkpoint">103<h3 id="checkpoint">
104 Checkpoint104 Checkpoint
106 106
107각 프롬프트를 전송할 때마다 생성되는 복원 지점입니다. Claude Code는 모든 편집 전에 파일을 스냅샷하므로 체크포인트가 파일을 되돌릴 수 있습니다. `Esc`를 두 번 누르거나 `/rewind`를 실행하여 코드, 대화 또는 둘 다를 이전 지점으로 복원하거나, 선택한 메시지에서 대화의 일부를 요약합니다. 체크포인트는 세션에 저장되므로 재개된 세션도 여전히 `/rewind`를 사용하여 이들로 돌아갈 수 있습니다. 이들은 git과 별개이며 Bash 도구를 통해 수행된 변경 사항을 추적하지 않습니다.107각 프롬프트를 전송할 때마다 생성되는 복원 지점입니다. Claude Code는 모든 편집 전에 파일을 스냅샷하므로 체크포인트가 파일을 되돌릴 수 있습니다. `Esc`를 두 번 누르거나 `/rewind`를 실행하여 코드, 대화 또는 둘 다를 이전 지점으로 복원하거나, 선택한 메시지에서 대화의 일부를 요약합니다. 체크포인트는 세션에 저장되므로 재개된 세션도 여전히 `/rewind`를 사용하여 이들로 돌아갈 수 있습니다. 이들은 git과 별개이며 Bash 도구를 통해 수행된 변경 사항을 추적하지 않습니다.
108 108
109자세히 알아보기: [체크포인팅](/ko/checkpointing)109자세히 알아보기: [체크포인팅](/docs/ko/checkpointing)
110 110
111<h3 id="claude-directory">111<h3 id="claude-directory">
112 `.claude` directory112 `.claude` directory
114 114
115Claude Code가 프로젝트 범위 구성을 읽는 디렉토리입니다: 설정, 훅, 스킬, 서브에이전트, 규칙 및 auto memory. 프로젝트는 루트에 `.claude/`를 가지며, 사용자 수준 기본값은 `~/.claude/`에 있습니다.115Claude Code가 프로젝트 범위 구성을 읽는 디렉토리입니다: 설정, 훅, 스킬, 서브에이전트, 규칙 및 auto memory. 프로젝트는 루트에 `.claude/`를 가지며, 사용자 수준 기본값은 `~/.claude/`에 있습니다.
116 116
117자세히 알아보기: [`.claude` 디렉토리](/ko/claude-directory)117자세히 알아보기: [`.claude` 디렉토리](/docs/ko/claude-directory)
118 118
119<h3 id="claude-md">119<h3 id="claude-md">
120 CLAUDE.md120 CLAUDE.md
124 124
125CLAUDE.md를 프로젝트 범위에서 `./CLAUDE.md` 또는 `./.claude/CLAUDE.md`에, 사용자 범위에서 `~/.claude/CLAUDE.md`에, 또는 조직의 [관리 정책](#managed-settings)으로 배치할 수 있습니다. 발견된 모든 파일은 서로를 재정의하지 않고 연결되며, 가장 광범위한 범위에서 가장 구체적인 범위로 정렬됩니다.125CLAUDE.md를 프로젝트 범위에서 `./CLAUDE.md` 또는 `./.claude/CLAUDE.md`에, 사용자 범위에서 `~/.claude/CLAUDE.md`에, 또는 조직의 [관리 정책](#managed-settings)으로 배치할 수 있습니다. 발견된 모든 파일은 서로를 재정의하지 않고 연결되며, 가장 광범위한 범위에서 가장 구체적인 범위로 정렬됩니다.
126 126
127자세히 알아보기: [CLAUDE.md 파일](/ko/memory#claude-md-files)127자세히 알아보기: [CLAUDE.md 파일](/docs/ko/memory#claude-md-files)
128 128
129<h3 id="command">129<h3 id="command">
130 Command130 Command
132 132
133프롬프트에 `/name`을 입력하여 호출하는 재사용 가능한 지침입니다. `/clear`, `/model`, `/compact`와 같은 기본 제공 명령은 세션을 제어합니다. `.claude/commands/`의 파일로 자신의 명령을 정의하거나 [플러그인](#plugin)에서 설치할 수 있습니다. [스킬](#skill)은 다단계 명령을 패키징하는 권장 방법입니다.133프롬프트에 `/name`을 입력하여 호출하는 재사용 가능한 지침입니다. `/clear`, `/model`, `/compact`와 같은 기본 제공 명령은 세션을 제어합니다. `.claude/commands/`의 파일로 자신의 명령을 정의하거나 [플러그인](#plugin)에서 설치할 수 있습니다. [스킬](#skill)은 다단계 명령을 패키징하는 권장 방법입니다.
134 134
135자세히 알아보기: [명령](/ko/commands) · [스킬](/ko/skills)135두 가지 다른 단어 사용은 관련이 없습니다: `claude` CLI 서브명령(예: `claude mcp add`)은 [CLI 참조](/docs/ko/cli-reference#cli-commands)에 나열되어 있으며, stdio [MCP 서버](#mcp-server) 항목의 `command` 필드는 Claude Code가 서버를 시작하기 위해 실행하는 실행 파일을 지정합니다.
136
137자세히 알아보기: [명령](/docs/ko/commands) · [스킬](/docs/ko/skills)
136 138
137<h3 id="compaction">139<h3 id="compaction">
138 Compaction140 Compaction
140 142
141[컨텍스트 윈도우](#context-window)가 한계에 접근할 때 대화의 자동 요약입니다. 이전 도구 출력이 먼저 지워지고, 그 다음 대화가 요약됩니다. 프로젝트 루트 CLAUDE.md 및 auto memory는 컴팩션을 견디고 디스크에서 다시 로드됩니다. 대화에서만 제공된 지침은 손실될 수 있습니다. `/compact`를 수동으로 트리거하거나, `/compact focus on the API changes`와 같은 포커스를 선택적으로 사용합니다.143[컨텍스트 윈도우](#context-window)가 한계에 접근할 때 대화의 자동 요약입니다. 이전 도구 출력이 먼저 지워지고, 그 다음 대화가 요약됩니다. 프로젝트 루트 CLAUDE.md 및 auto memory는 컴팩션을 견디고 디스크에서 다시 로드됩니다. 대화에서만 제공된 지침은 손실될 수 있습니다. `/compact`를 수동으로 트리거하거나, `/compact focus on the API changes`와 같은 포커스를 선택적으로 사용합니다.
142 144
143자세히 알아보기: [컴팩션에서 생존하는 것](/ko/context-window#what-survives-compaction) · [컨텍스트가 가득 찰 때](/ko/how-claude-code-works#when-context-fills-up)145자세히 알아보기: [컴팩션에서 생존하는 것](/docs/ko/context-window#what-survives-compaction) · [컨텍스트가 가득 찰 때](/docs/ko/how-claude-code-works#when-context-fills-up)
146
147<h3 id="connector">
148 Connector
149</h3>
150
151Claude Code가 아닌 claude.ai 계정에 추가된 [MCP 서버](#mcp-server)입니다. 해당 계정으로 Claude Code에 로그인하면, 커넥터가 로컬로 추가한 서버와 함께 `/mcp`에 나타납니다. 조직은 또한 커넥터를 프로비저닝하고 이들에 대한 도구별 제어를 설정할 수 있습니다.
152
153자세히 알아보기: [claude.ai에서 MCP 서버 사용](/docs/ko/mcp#use-mcp-servers-from-claude-ai)
144 154
145<h3 id="context-window">155<h3 id="context-window">
146 Context window156 Context window
148 158
149세션의 작업 메모리이며, 대화 기록, 파일 내용, 명령 출력, CLAUDE.md, auto memory, 로드된 스킬 및 시스템 지침을 보유합니다. 작업하면서 컨텍스트가 가득 찰 때까지 채워지고 [컴팩션](#compaction)이 요약합니다. `/context`를 실행하여 공간을 사용하는 것을 확인합니다. 기본 모델 개념은 [플랫폼 용어집](https://platform.claude.com/docs/ko/about-claude/glossary#context-window)을 참조하십시오.159세션의 작업 메모리이며, 대화 기록, 파일 내용, 명령 출력, CLAUDE.md, auto memory, 로드된 스킬 및 시스템 지침을 보유합니다. 작업하면서 컨텍스트가 가득 찰 때까지 채워지고 [컴팩션](#compaction)이 요약합니다. `/context`를 실행하여 공간을 사용하는 것을 확인합니다. 기본 모델 개념은 [플랫폼 용어집](https://platform.claude.com/docs/ko/about-claude/glossary#context-window)을 참조하십시오.
150 160
151자세히 알아보기: [컨텍스트 윈도우 탐색](/ko/context-window)161자세히 알아보기: [컨텍스트 윈도우 탐색](/docs/ko/context-window)
152 162
153<h2 id="d">163<h2 id="d">
154 D164 D
160 170
161Claude 모바일 앱에서 코딩 작업을 보낼 때 Desktop 앱에서 Claude Code 세션을 생성하는 휴대폰 시작 작업 라우터입니다. 프롬프트가 올바른 도구로 자동으로 라우팅됩니다. Pro 및 Max 플랜에서 사용 가능합니다.171Claude 모바일 앱에서 코딩 작업을 보낼 때 Desktop 앱에서 Claude Code 세션을 생성하는 휴대폰 시작 작업 라우터입니다. 프롬프트가 올바른 도구로 자동으로 라우팅됩니다. Pro 및 Max 플랜에서 사용 가능합니다.
162 172
163자세히 알아보기: [Dispatch의 세션](/ko/desktop#sessions-from-dispatch)173자세히 알아보기: [Dispatch의 세션](/docs/ko/desktop#sessions-from-dispatch)
164 174
165<h2 id="e">175<h2 id="e">
166 E176 E
170 Effort level180 Effort level
171</h3>181</h3>
172 182
173각 턴에서 Claude가 적응형 추론 사고 예산을 얼마나 사용할지 제어하는 설정입니다. 더 높은 노력은 더 많은 사고 토큰과 더 깊은 추론을 의미합니다. 더 낮은 노력은 더 빠르고 저렴합니다. Effort는 Fable 5, Opus 4.6 이상 및 Sonnet 4.6 이상에서 지원됩니다.183각 턴에서 모델이 적응형 추론을 사용할지 여부와 얼마나 사용할지를 제어하는 설정입니다. 더 높은 노력은 더 많은 사고 토큰과 더 깊은 추론을 의미합니다. 더 낮은 노력은 더 빠르고 저렴합니다. Effort는 Fable 모델, Opus 4.6 이상 및 Sonnet 4.6 이상에서 지원됩니다.
174 184
175자세히 알아보기: [노력 수준 조정](/ko/model-config#adjust-effort-level)185자세히 알아보기: [노력 수준 조정](/docs/ko/model-config#adjust-effort-level)
176 186
177<h3 id="extended-thinking">187<h3 id="extended-thinking">
178 Extended thinking188 Extended thinking
180 190
181모델이 응답하기 전에 수행하는 가시적인 단계별 추론입니다. [노력 수준](#effort-level)으로 조정하거나 고정된 사고 예산이 있는 모델에서 `MAX_THINKING_TOKENS`로 사고 토큰을 제한할 수 있습니다. 사고는 터미널에서 회색 이탤릭 텍스트로 나타납니다.191모델이 응답하기 전에 수행하는 가시적인 단계별 추론입니다. [노력 수준](#effort-level)으로 조정하거나 고정된 사고 예산이 있는 모델에서 `MAX_THINKING_TOKENS`로 사고 토큰을 제한할 수 있습니다. 사고는 터미널에서 회색 이탤릭 텍스트로 나타납니다.
182 192
183자세히 알아보기: [확장 사고 사용](/ko/model-config#extended-thinking)193자세히 알아보기: [확장 사고 사용](/docs/ko/model-config#extended-thinking)
184 194
185<h2 id="h">195<h2 id="h">
186 H196 H
198* **Matcher**: 어떤 이벤트가 발생하는지 필터링합니다208* **Matcher**: 어떤 이벤트가 발생하는지 필터링합니다
199* **Hook handler**: 실행되는 것209* **Hook handler**: 실행되는 것
200 210
201자세히 알아보기: [훅 시작하기](/ko/hooks-guide) · [훅 참조](/ko/hooks)211자세히 알아보기: [훅 시작하기](/docs/ko/hooks-guide) · [훅 참조](/docs/ko/hooks)
202 212
203<h2 id="m">213<h2 id="m">
204 M214 M
208 Managed settings218 Managed settings
209</h3>219</h3>
210 220
211IT 또는 DevOps에 의해 조직 전체에 적용되는 설정이며, Anthropic의 서버를 통해 관리 콘솔에서 전달되거나 `~/.claude` 외부의 OS 수준 경로에 배치됩니다. 사용자 및 프로젝트 설정은 관리 설정을 재정의할 수 없습니다. 서버 관리 전달은 [적격 구성](/ko/server-managed-settings#platform-availability)에 적용됩니다. [보안 고려 사항](/ko/server-managed-settings#security-considerations)을 참조하십시오. 보안 정책, 규정 준수 요구 사항 또는 플릿 전체의 표준화된 도구에 사용합니다.221IT 또는 DevOps에 의해 조직 전체에 적용되는 설정이며, Anthropic의 서버를 통해 관리 콘솔에서 전달되거나 `~/.claude` 외부의 OS 수준 경로에 배치됩니다. 사용자 및 프로젝트 설정은 관리 설정을 재정의할 수 없습니다. 서버 관리 전달은 [적격 구성](/docs/ko/server-managed-settings#platform-availability)에 적용됩니다. [보안 고려 사항](/docs/ko/server-managed-settings#security-considerations)을 참조하십시오. 보안 정책, 규정 준수 요구 사항 또는 플릿 전체의 표준화된 도구에 사용합니다.
212 222
213자세히 알아보기: [Server-managed settings](/ko/server-managed-settings) · [Settings files](/ko/settings#settings-files)223자세히 알아보기: [Server-managed settings](/docs/ko/server-managed-settings) · [Settings files](/docs/ko/settings#where-settings-live)
214 224
215<h3 id="mcp-model-context-protocol">225<h3 id="mcp-model-context-protocol">
216 MCP (Model Context Protocol)226 MCP (Model Context Protocol)
218 228
219AI 도구를 외부 데이터 소스 및 서비스에 연결하기 위한 개방형 표준입니다. MCP 서버는 Claude에 Slack, Jira, 데이터베이스, 브라우저 및 수백 개의 다른 통합을 위한 새로운 도구를 제공합니다. `/mcp`를 통해 또는 `.mcp.json`에 추가하여 서버를 연결합니다. 프로토콜 자체는 [플랫폼 용어집](https://platform.claude.com/docs/ko/about-claude/glossary#mcp-model-context-protocol)을 참조하십시오.229AI 도구를 외부 데이터 소스 및 서비스에 연결하기 위한 개방형 표준입니다. MCP 서버는 Claude에 Slack, Jira, 데이터베이스, 브라우저 및 수백 개의 다른 통합을 위한 새로운 도구를 제공합니다. `/mcp`를 통해 또는 `.mcp.json`에 추가하여 서버를 연결합니다. 프로토콜 자체는 [플랫폼 용어집](https://platform.claude.com/docs/ko/about-claude/glossary#mcp-model-context-protocol)을 참조하십시오.
220 230
221자세히 알아보기: [Model Context Protocol](/ko/mcp)231자세히 알아보기: [Model Context Protocol](/docs/ko/mcp)
232
233<h3 id="mcp-server">
234 MCP server
235</h3>
236
237Claude에 [MCP](#mcp-model-context-protocol)를 통해 도구, 프롬프트 또는 리소스를 제공하는 프로그램입니다. `claude mcp add`를 사용하여, `.mcp.json`에서, [플러그인](#plugin)을 통해, 또는 claude.ai [커넥터](#connector)로 서버를 추가합니다. 로컬 stdio 서버는 Claude Code가 구성의 `command` 및 `args` 필드에서 시작하는 프로세스로 실행되며, 이는 프롬프트에서 입력하는 [명령어](#command)와는 관계가 없습니다.
238
239자세히 알아보기: [Model Context Protocol](/docs/ko/mcp)
222 240
223<h3 id="mcp-tool-search">241<h3 id="mcp-tool-search">
224 MCP Tool Search242 MCP Tool Search
225</h3>243</h3>
226 244
227필요할 때까지 MCP 도구 스키마를 연기하는 컨텍스트 절약 메커니즘입니다. 시작 시 도구 이름만 로드됩니다. Claude는 특정 도구를 사용하기로 결정할 때 전체 스키마를 요청합니다. 이렇게 하면 유휴 MCP 서버가 많은 컨텍스트를 소비하지 않습니다.245필요할 때까지 MCP 도구 스키마를 연기하는 컨텍스트 절약 메커니즘입니다. 시작 시 도구 이름과 서버 지침만 로드됩니다. Claude는 특정 도구를 사용하기로 결정할 때 전체 스키마를 요청합니다. 이렇게 하면 유휴 MCP 서버가 많은 컨텍스트를 소비하지 않습니다.
228 246
229자세히 알아보기: [MCP Tool Search로 확장](/ko/mcp#scale-with-mcp-tool-search)247자세히 알아보기: [MCP Tool Search로 확장](/docs/ko/mcp#scale-with-mcp-tool-search)
230 248
231<h2 id="n">249<h2 id="n">
232 N250 N
236 Non-interactive mode254 Non-interactive mode
237</h3>255</h3>
238 256
239`-p` 또는 `--print`로 호출되는 단일 프롬프트를 실행하고 대화형 프롬프트 없이 종료하는 모드입니다. CI, 스크립트 및 파이핑에 사용됩니다. `--no-session-persistence`를 전달하지 않는 한 실행은 여전히 재개 가능한 세션으로 저장됩니다. [Agent SDK](/ko/agent-sdk/overview)는 Python 및 TypeScript 동등물입니다. 이전에는 headless mode라고 불렸습니다.257`-p` 또는 `--print`로 호출되는 단일 프롬프트를 실행하고 대화형 프롬프트 없이 종료하는 모드입니다. CI, 스크립트 및 파이핑에 사용됩니다. `--no-session-persistence`를 전달하지 않는 한 실행은 여전히 재개 가능한 세션으로 저장됩니다. [Agent SDK](/docs/ko/agent-sdk/overview)는 Python 및 TypeScript 동등물입니다. 이전에는 headless mode라고 불렸습니다.
240 258
241자세히 알아보기: [Claude Code를 프로그래밍 방식으로 실행](/ko/headless)259자세히 알아보기: [Claude Code를 프로그래밍 방식으로 실행](/docs/ko/headless)
242 260
243<h2 id="o">261<h2 id="o">
244 O262 O
248 Output style266 Output style
249</h3>267</h3>
250 268
251Claude의 시스템 프롬프트를 수정하여 응답 동작, 톤 또는 형식을 변경하는 구성입니다. 출력 스타일은 사용자 메시지로 전달되는 [CLAUDE.md](#claude-md)와 달리 기본 시스템 프롬프트의 소프트웨어 엔지니어링 관련 부분을 끕니다. 기본 제공 스타일에는 Default, Proactive, Explanatory 및 Learning이 포함됩니다.269Claude의 시스템 프롬프트를 수정하여 응답 동작, 톤 또는 형식을 변경하는 구성입니다. [CLAUDE.md](#claude-md)와 달리 Claude Code가 시스템 프롬프트 이후 사용자 메시지로 전달하는 것과 달리, 출력 스타일은 시스템 프롬프트 자체를 변경합니다.
252 270
253자세히 알아보기: [출력 스타일](/ko/output-styles)271자세히 알아보기: [출력 스타일](/docs/ko/output-styles)
254 272
255<h2 id="p">273<h2 id="p">
256 P274 P
264 282
265`default` 모드는 CLI 및 VS Code와 JetBrains 확장에서 Manual로 표시되며, Claude Code는 값에 대한 `manual`의 별칭을 허용합니다.283`default` 모드는 CLI 및 VS Code와 JetBrains 확장에서 Manual로 표시되며, Claude Code는 값에 대한 `manual`의 별칭을 허용합니다.
266 284
267자세히 알아보기: [권한 모드 선택](/ko/permission-modes)285자세히 알아보기: [권한 모드 선택](/docs/ko/permission-modes)
268 286
269<h3 id="permission-rule">287<h3 id="permission-rule">
270 Permission rule288 Permission rule
272 290
273도구 이름 및 인수 패턴을 기반으로 도구 호출을 허용, 질문 또는 거부하는 설정 항목입니다. 규칙은 deny→ask→allow로 평가되며, 첫 번째 일치가 우선합니다. 권한 규칙은 더 광범위한 [권한 모드](#permission-mode) 위에 계층화된 세밀한 제어입니다.291도구 이름 및 인수 패턴을 기반으로 도구 호출을 허용, 질문 또는 거부하는 설정 항목입니다. 규칙은 deny→ask→allow로 평가되며, 첫 번째 일치가 우선합니다. 권한 규칙은 더 광범위한 [권한 모드](#permission-mode) 위에 계층화된 세밀한 제어입니다.
274 292
275자세히 알아보기: [권한 구성](/ko/permissions)293자세히 알아보기: [권한 구성](/docs/ko/permissions)
276 294
277<h3 id="plan-mode">295<h3 id="plan-mode">
278 Plan mode296 Plan mode
280 298
281Claude가 소스 파일을 편집하지 않고 변경 사항을 연구하고 제안하는 [권한 모드](#permission-mode)입니다. 읽고, 검색하고, 탐색 명령을 실행할 수 있으며, 아무것도 건드리기 전에 승인을 위한 계획을 제시합니다. `/plan`을 입력하거나 `Shift+Tab`을 눌러 plan mode에 들어갑니다.299Claude가 소스 파일을 편집하지 않고 변경 사항을 연구하고 제안하는 [권한 모드](#permission-mode)입니다. 읽고, 검색하고, 탐색 명령을 실행할 수 있으며, 아무것도 건드리기 전에 승인을 위한 계획을 제시합니다. `/plan`을 입력하거나 `Shift+Tab`을 눌러 plan mode에 들어갑니다.
282 300
283자세히 알아보기: [plan mode로 편집 전에 분석](/ko/permission-modes#analyze-before-you-edit-with-plan-mode)301자세히 알아보기: [plan mode로 편집 전에 분석](/docs/ko/permission-modes#analyze-before-you-edit-with-plan-mode)
284 302
285<h3 id="plugin">303<h3 id="plugin">
286 Plugin304 Plugin
287</h3>305</h3>
288 306
289스킬, 훅, 서브에이전트 및 MCP 서버의 번들이며, 단일 설치 가능한 단위로 패키징됩니다. 플러그인 스킬은 `plugin-name:skill-name`으로 네임스페이스되므로 여러 플러그인이 공존합니다. [마켓플레이스](/ko/plugin-marketplaces)를 통해 팀 전체에 플러그인을 배포합니다.307스킬, 훅, 서브에이전트 및 MCP 서버의 번들이며, 단일 설치 가능한 단위로 패키징됩니다. 플러그인 스킬은 `plugin-name:skill-name`으로 네임스페이스되므로 여러 플러그인이 공존합니다. [마켓플레이스](/docs/ko/plugin-marketplaces)를 통해 팀 전체에 플러그인을 배포합니다.
290 308
291자세히 알아보기: [플러그인](/ko/plugins)309자세히 알아보기: [플러그인](/docs/ko/plugins)
292 310
293<h3 id="project-trust">311<h3 id="project-trust">
294 Project trust312 Project trust
295</h3>313</h3>
296 314
297Claude Code가 구성을 로드하기 전에 디렉토리를 수락하는 대화입니다. 수락은 프로젝트 디렉토리별로 저장되며, 홈 디렉토리는 제외되고, 여기서 신뢰는 현재 세션에만 유지되며 각 실행 시 프롬프트가 다시 나타납니다. 신뢰는 마켓플레이스 플러그인의 자동 설치 및 프로젝트 정의 훅의 실행을 게이팅합니다. 디렉토리를 신뢰하면 `.claude/settings.json`, `.mcp.json` 및 기타 구성 파일이 적용됩니다.315Claude Code가 구성을 로드하기 전에 디렉토리를 수락하는 대화입니다. 수락은 프로젝트 디렉토리별로 저장되며, 홈 디렉토리는 제외되고, 여기서 신뢰는 현재 세션에만 유지되며 각 실행 시 프롬프트가 다시 나타납니다. 디렉토리를 신뢰할 때까지 Claude Code는 저장소가 제공하는 일부 콘텐츠를 보류합니다. 예를 들어 `.claude/settings.json`의 프로젝트 허용 규칙 및 마켓플레이스입니다. [폴더를 신뢰하기 전에 실행되는 것](/docs/ko/permissions#what-runs-before-you-trust-a-folder)에서는 `-p` 세션이 대화 없이 실행하는 것을 포함하여 각 종류의 콘텐츠를 나열합니다.
298 316
299자세히 알아보기: [`.claude` 디렉토리](/ko/claude-directory)317자세히 알아보기: [`.claude` 디렉토리](/docs/ko/claude-directory)
300 318
301<h3 id="prompt-injection">319<h3 id="prompt-injection">
302 Prompt injection320 Prompt injection
303</h3>321</h3>
304 322
305파일, 웹 페이지 또는 도구 결과에 포함된 적대적 지침이며, Claude를 요청하지 않은 작업으로 리디렉션하려고 시도합니다. Claude Code의 방어에는 권한 시스템, 명령 주입 탐지 및 신뢰 확인이 포함됩니다. [Auto mode](#auto-mode)는 도구 결과에서 의심스러운 내용을 스캔하는 서버 측 프로브와 도구 결과를 보지 않는 분류기를 추가하므로 주입된 텍스트가 승인 결정에 영향을 미칠 수 없습니다.323파일, 웹 페이지 또는 도구 결과에 포함된 적대적 지침이며, Claude를 요청하지 않은 작업으로 리디렉션하려고 시도합니다. Claude Code의 방어에는 권한 시스템, 명령 주입 탐지 및 신뢰 확인이 포함됩니다. [Auto mode](#auto-mode)는 도구 결과에서 의심스러운 내용을 스캔하는 서버 측 프로브와 도구 결과를 제거한 상태에서 작업을 검토하는 분류기를 추가하므로 주입된 텍스트가 직접 이를 조작할 수 없습니다.
306 324
307자세히 알아보기: [프롬프트 주입으로부터 보호](/ko/security#protect-against-prompt-injection)325자세히 알아보기: [프롬프트 주입으로부터 보호](/docs/ko/security#protect-against-prompt-injection)
308 326
309<h2 id="r">327<h2 id="r">
310 R328 R
316 334
317claude.ai를 통해 휴대폰 또는 브라우저에서 로컬 Claude Code 세션을 계속하는 방법입니다. 코드 실행 및 파일은 머신에 남아 있습니다. 인터페이스만 원격입니다. 클라우드 샌드박스에서 실행되는 웹의 Claude Code와 다릅니다.335claude.ai를 통해 휴대폰 또는 브라우저에서 로컬 Claude Code 세션을 계속하는 방법입니다. 코드 실행 및 파일은 머신에 남아 있습니다. 인터페이스만 원격입니다. 클라우드 샌드박스에서 실행되는 웹의 Claude Code와 다릅니다.
318 336
319자세히 알아보기: [Remote Control](/ko/remote-control)337자세히 알아보기: [Remote Control](/docs/ko/remote-control)
320 338
321<h3 id="rules">339<h3 id="rules">
322 Rules340 Rules
324 342
325CLAUDE.md와 함께 로드되는 `.claude/rules/`의 모듈식 지침 파일입니다. 규칙은 YAML `paths:` frontmatter로 경로 범위를 지정할 수 있으므로 Claude가 일치하는 파일을 읽을 때만 로드되어 관련될 때까지 컨텍스트를 유지합니다.343CLAUDE.md와 함께 로드되는 `.claude/rules/`의 모듈식 지침 파일입니다. 규칙은 YAML `paths:` frontmatter로 경로 범위를 지정할 수 있으므로 Claude가 일치하는 파일을 읽을 때만 로드되어 관련될 때까지 컨텍스트를 유지합니다.
326 344
327자세히 알아보기: [`.claude/rules/`로 규칙 구성](/ko/memory#organize-rules-with-claude/rules/)345자세히 알아보기: [`.claude/rules/`로 규칙 구성](/docs/ko/memory#organize-rules-with-claude/rules/)
328 346
329<h2 id="s">347<h2 id="s">
330 S348 S
336 354
337Bash 도구에 대한 OS 수준 파일 시스템 및 네트워크 격리입니다. 명령은 미리 정의한 경계 내에서 실행되므로 Claude는 명령별 승인 프롬프트 없이 자유롭게 작업할 수 있습니다. 샌드박싱은 [권한 규칙](#permission-rule)과 별개의 계층입니다.355Bash 도구에 대한 OS 수준 파일 시스템 및 네트워크 격리입니다. 명령은 미리 정의한 경계 내에서 실행되므로 Claude는 명령별 승인 프롬프트 없이 자유롭게 작업할 수 있습니다. 샌드박싱은 [권한 규칙](#permission-rule)과 별개의 계층입니다.
338 356
339자세히 알아보기: [샌드박싱](/ko/sandboxing)357자세히 알아보기: [샌드박싱](/docs/ko/sandboxing)
340 358
341<h3 id="session">359<h3 id="session">
342 Session360 Session
344 362
345현재 디렉토리에 연결된 대화이며, 자신의 독립적인 [컨텍스트 윈도우](#context-window)를 가집니다. 세션은 `claude -c`로 재개할 수 있고, `--fork-session`으로 포크하여 새 세션 ID 아래에 기록을 보존하거나, 터미널 전체에서 병렬로 실행할 수 있습니다. `/clear`를 실행하면 새 세션이 시작됩니다. 이전 세션은 저장된 상태로 유지되며 `/resume`을 통해 사용 가능합니다. 각 세션의 기록은 `~/.claude/projects/` 아래에 저장됩니다.363현재 디렉토리에 연결된 대화이며, 자신의 독립적인 [컨텍스트 윈도우](#context-window)를 가집니다. 세션은 `claude -c`로 재개할 수 있고, `--fork-session`으로 포크하여 새 세션 ID 아래에 기록을 보존하거나, 터미널 전체에서 병렬로 실행할 수 있습니다. `/clear`를 실행하면 새 세션이 시작됩니다. 이전 세션은 저장된 상태로 유지되며 `/resume`을 통해 사용 가능합니다. 각 세션의 기록은 `~/.claude/projects/` 아래에 저장됩니다.
346 364
347자세히 알아보기: [세션으로 작업](/ko/how-claude-code-works#work-with-sessions)365자세히 알아보기: [세션으로 작업](/docs/ko/how-claude-code-works#work-with-sessions)
348 366
349<h3 id="settings-layers">367<h3 id="settings-layers">
350 Settings layers368 Settings layers
351</h3>369</h3>
352 370
353Claude Code가 구성을 읽는 계층 구조이며, 우선 순위 순서는 높음에서 낮음입니다: [관리 정책](#managed-settings), 명령줄 인수, `.claude/settings.local.json`의 로컬 설정, `.claude/settings.json`의 프로젝트 설정, 그 다음 `~/.claude/settings.json`의 사용자 설정. 배열은 계층 전체에서 병합됩니다. 스칼라는 더 높은 계층에서 더 낮은 계층을 재정의합니다.371Claude Code가 구성을 읽는 계층 구조이며, 우선 순위 순서는 높음에서 낮음입니다: [관리 정책](#managed-settings), 명령줄 인수, `.claude/settings.local.json`의 로컬 설정, `.claude/settings.json`의 프로젝트 설정, 그 다음 `~/.claude/settings.json`의 사용자 설정. 배열은 계층 전체에서 병합됩니다. 스칼라는 더 높은 계층에서 더 낮은 계층을 재정의합니다. [설정 우선 순위](/docs/ko/settings#settings-precedence)를 참조하십시오.
354 372
355자세히 알아보기: [설정 파일](/ko/settings#settings-files)373자세히 알아보기: [설정 파일](/docs/ko/settings#where-settings-live)
356 374
357<h3 id="skill">375<h3 id="skill">
358 Skill376 Skill
362 380
363스킬은 사용자 정의 명령의 권장 후속입니다. `.claude/commands/deploy.md`의 파일과 `.claude/skills/deploy/SKILL.md`의 파일은 모두 `/deploy`를 생성하고 동일하게 작동합니다. 기존 명령 파일은 계속 작동합니다.381스킬은 사용자 정의 명령의 권장 후속입니다. `.claude/commands/deploy.md`의 파일과 `.claude/skills/deploy/SKILL.md`의 파일은 모두 `/deploy`를 생성하고 동일하게 작동합니다. 기존 명령 파일은 계속 작동합니다.
364 382
365자세히 알아보기: [스킬로 Claude 확장](/ko/skills)383자세히 알아보기: [스킬로 Claude 확장](/docs/ko/skills)
366 384
367<h3 id="subagent">385<h3 id="subagent">
368 Subagent386 Subagent
369</h3>387</h3>
370 388
371자신의 컨텍스트 윈도우, 사용자 정의 시스템 프롬프트, 특정 도구 액세스 및 독립적인 권한으로 실행되는 특화된 AI 어시스턴트입니다. 위임된 작업을 수행하고 주 대화에 요약을 반환합니다. 서브에이전트를 사용하여 큰 탐색을 기본 컨텍스트 밖으로 유지하거나 병렬 연구를 실행합니다. 각 에이전트가 직접 대화할 수 있는 완전한 독립적인 세션인 [agent teams](#agent-teams)와 다릅니다.389자신의 컨텍스트 윈도우, 사용자 정의 시스템 프롬프트, 특정 도구 액세스 및 독립적인 권한으로 실행되는 특화된 AI 어시스턴트입니다. 위임된 작업을 수행하고 주 대화에 요약을 반환합니다. 서브에이전트를 사용하여 큰 탐색을 기본 컨텍스트 밖으로 유지하거나 병렬 연구를 실행합니다. 서브에이전트는 이를 생성한 세션 내에 머물러 있습니다. 직접 실행하는 별도의 세션 간에 발견 사항을 전달하려면 [세션 간 메시징](/docs/ko/cross-session-messaging)을 사용하십시오.
372 390
373기본 제공 서브에이전트에는 Explore, Plan 및 범용이 포함됩니다.391기본 제공 서브에이전트에는 Explore, Plan 및 범용이 포함됩니다.
374 392
375자세히 알아보기: [사용자 정의 서브에이전트 생성](/ko/sub-agents)393자세히 알아보기: [사용자 정의 서브에이전트 생성](/docs/ko/sub-agents)
376 394
377<h3 id="surface">395<h3 id="surface">
378 Surface396 Surface
379</h3>397</h3>
380 398
381Claude Code에 액세스하는 모든 장소입니다: CLI, VS Code, JetBrains, Desktop 또는 claude.ai. 모든 표면은 동일한 엔진을 공유하므로 CLAUDE.md, 설정 및 스킬이 모든 표면에서 동일하게 작동합니다. Slack 및 Chrome 확장 프로그램은 표면 자체가 아니라 표면에 연결하는 통합입니다.399Claude Code에 액세스하는 모든 장소입니다: CLI, VS Code, JetBrains, Desktop 또는 claude.ai. 모든 표면은 동일한 엔진을 공유합니다. 컴퓨터의 세션은 로컬 CLAUDE.md, 설정 및 스킬을 읽습니다. [클라우드 세션](/docs/ko/cloud-environments#what-carries-over-from-your-setup)은 저장소의 새로운 클론에서 시작되며 컴퓨터의 `~/.claude/`를 읽지 않습니다. Slack 및 Chrome 확장 프로그램은 표면 자체가 아니라 표면에 연결하는 통합입니다.
382 400
383자세히 알아보기: [플랫폼 및 통합](/ko/platforms)401자세히 알아보기: [플랫폼 및 통합](/docs/ko/platforms)
384 402
385<h2 id="t">403<h2 id="t">
386 T404 T
392 410
393클라우드 Claude Code 세션을 로컬 터미널로 가져오는 명령 `/teleport`입니다. Claude는 분기를 가져오고, 대화 기록을 로드하고, 웹 세션의 마지막 상태에서 재개합니다. 역방향은 `--cloud`이며, 로컬 작업을 웹에서 실행하도록 보냅니다.411클라우드 Claude Code 세션을 로컬 터미널로 가져오는 명령 `/teleport`입니다. Claude는 분기를 가져오고, 대화 기록을 로드하고, 웹 세션의 마지막 상태에서 재개합니다. 역방향은 `--cloud`이며, 로컬 작업을 웹에서 실행하도록 보냅니다.
394 412
395자세히 알아보기: [웹에서 터미널로](/ko/claude-code-on-the-web#from-web-to-terminal)413자세히 알아보기: [웹에서 터미널로](/docs/ko/claude-code-on-the-web#from-web-to-terminal)
396 414
397<h3 id="tool">415<h3 id="tool">
398 Tool416 Tool
400 418
401Claude가 수행할 수 있는 작업입니다: 파일 읽기, 코드 편집, 셸 명령 실행, 웹 검색, 서브에이전트 생성. 도구는 Claude Code를 에이전트로 만드는 것입니다. 도구 없이 Claude는 텍스트로만 응답할 수 있습니다. 각 도구 사용은 [에이전트 루프](#agentic-loop)에서 Claude의 다음 결정을 알려주는 결과를 반환합니다.419Claude가 수행할 수 있는 작업입니다: 파일 읽기, 코드 편집, 셸 명령 실행, 웹 검색, 서브에이전트 생성. 도구는 Claude Code를 에이전트로 만드는 것입니다. 도구 없이 Claude는 텍스트로만 응답할 수 있습니다. 각 도구 사용은 [에이전트 루프](#agentic-loop)에서 Claude의 다음 결정을 알려주는 결과를 반환합니다.
402 420
403자세히 알아보기: [Claude에서 사용 가능한 도구](/ko/tools-reference)421자세히 알아보기: [Claude에서 사용 가능한 도구](/docs/ko/tools-reference)
404 422
405<h3 id="turn">423<h3 id="turn">
406 Turn424 Turn
408 426
409[세션](#session) 내에서 Claude의 한 번의 완전한 응답입니다. 턴은 메시지를 보낼 때 시작되고 Claude가 응답을 마칠 때 끝나며, 그 사이에 여러 개의 [도구](#tool) 호출이 있을 수 있습니다. [Stop 훅](#hook)은 각 턴의 끝에서 실행됩니다. 세션은 많은 턴으로 구성되며, [에이전트 루프](#agentic-loop)는 한 턴 내에서 일어나는 일을 설명합니다.427[세션](#session) 내에서 Claude의 한 번의 완전한 응답입니다. 턴은 메시지를 보낼 때 시작되고 Claude가 응답을 마칠 때 끝나며, 그 사이에 여러 개의 [도구](#tool) 호출이 있을 수 있습니다. [Stop 훅](#hook)은 각 턴의 끝에서 실행됩니다. 세션은 많은 턴으로 구성되며, [에이전트 루프](#agentic-loop)는 한 턴 내에서 일어나는 일을 설명합니다.
410 428
411자세히 알아보기: [Claude Code 작동 방식](/ko/how-claude-code-works#the-agentic-loop)429자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works#the-agentic-loop)
412 430
413<h2 id="v">431<h2 id="v">
414 V432 V
418 Verification loop436 Verification loop
419</h3>437</h3>
420 438
421세션이 작업이 실제로 완료되었는지 아니면 그럴듯한지만 알 수 있는 방법입니다. 테스트 스위트, 빌드 또는 스크린샷 비교와 같이 Claude가 실행할 수 있는 검사를 제공하고, Claude는 한 번의 시도 후 중단하는 대신 검사가 통과할 때까지 반복합니다. 검증 루프는 [`/goal`](/ko/goal), 무인 실행 및 [동적 워크플로우](/ko/workflows)의 전제 조건입니다: 검증 루프 없이는 에이전트가 완료되었다고 결정하는 유일한 것은 에이전트 자체입니다.439세션이 작업이 실제로 완료되었는지 아니면 그럴듯한지만 알 수 있는 방법입니다. 테스트 스위트, 빌드 또는 스크린샷 비교와 같이 Claude가 실행할 수 있는 검사를 제공하고, Claude는 한 번의 시도 후 중단하는 대신 검사가 통과할 때까지 반복합니다. 검증 루프는 [`/goal`](/docs/ko/goal), 무인 실행 및 [동적 워크플로우](/docs/ko/workflows)의 전제 조건입니다: 검증 루프 없이는 에이전트가 완료되었다고 결정하는 유일한 것은 에이전트 자체입니다.
422 440
423자세히 알아보기: [Claude에 작업 확인 방법 제공](/ko/best-practices#give-claude-a-way-to-verify-its-work)441자세히 알아보기: [Claude에 작업 확인 방법 제공](/docs/ko/best-practices#give-claude-a-way-to-verify-its-work)
424 442
425<h2 id="w">443<h2 id="w">
426 W444 W
432 450
433`.claude/worktrees/` 아래의 별도 git worktree에서 Claude를 실행하는 격리 모드이며, `-w` 플래그 또는 서브에이전트 구성의 `isolation: worktree`로 활성화됩니다. 변경 사항은 별도 디렉토리의 별도 분기에 남아 있으므로 병렬 에이전트가 서로의 파일을 덮어쓰지 않습니다.451`.claude/worktrees/` 아래의 별도 git worktree에서 Claude를 실행하는 격리 모드이며, `-w` 플래그 또는 서브에이전트 구성의 `isolation: worktree`로 활성화됩니다. 변경 사항은 별도 디렉토리의 별도 분기에 남아 있으므로 병렬 에이전트가 서로의 파일을 덮어쓰지 않습니다.
434 452
435자세히 알아보기: [git worktrees로 병렬 세션 실행](/ko/worktrees)453자세히 알아보기: [git worktrees로 병렬 세션 실행](/docs/ko/worktrees)
436 454
437***455***
438 456