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)์ ์ฐธ์กฐํ์ญ์์ค.
10 10
11## A11<h2 id="a">
12 A
13</h2>
12 14
13### Agent teams15<h3 id="agent-teams">
16 Agent teams
17</h3>
14 18
15์ฌ๋ฌ ๊ฐ์ ๋
๋ฆฝ์ ์ธ Claude Code ์ธ์
์ด ํ ๋ฆฌ๋์ ์ํด ์กฐ์ ๋๋ฉฐ, ๊ณต์ ์์
๋ชฉ๋ก๊ณผ ํผ์ด ํฌ ํผ์ด ๋ฉ์์ง์ ๊ฐ์ถ ๊ตฌ์ฑ์
๋๋ค. ๋จ์ผ ์ธ์
๋ด์์ ์คํ๋๊ณ ๋ถ๋ชจ์๊ฒ๋ง ๋ณด๊ณ ํ๋ [์๋ธ์์ด์ ํธ](#subagent)์ ๋ฌ๋ฆฌ, ํ์๋ค์ ๊ฐ๊ฐ ์์ ์ ์ปจํ
์คํธ ์๋์ฐ๋ฅผ ๊ฐ์ง๋ฉฐ ์ด๋ ํ์๊ณผ๋ ์ง์ ์ํธ์์ฉํ ์ ์์ต๋๋ค. Agent teams๋ ์คํ์ ์ด๋ฉฐ `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`์ ์ค์ ํ์ฌ ํ์ฑํํด์ผ ํฉ๋๋ค.19์ฌ๋ฌ ๊ฐ์ ๋
๋ฆฝ์ ์ธ Claude Code ์ธ์
์ด ํ ๋ฆฌ๋์ ์ํด ์กฐ์ ๋๋ฉฐ, ๊ณต์ ์์
๋ชฉ๋ก๊ณผ ํผ์ด ํฌ ํผ์ด ๋ฉ์์ง์ ๊ฐ์ถ ๊ตฌ์ฑ์
๋๋ค. ๋จ์ผ ์ธ์
๋ด์์ ์คํ๋๊ณ ๋ถ๋ชจ์๊ฒ๋ง ๋ณด๊ณ ํ๋ [์๋ธ์์ด์ ํธ](#subagent)์ ๋ฌ๋ฆฌ, ํ์๋ค์ ๊ฐ๊ฐ ์์ ์ ์ปจํ
์คํธ ์๋์ฐ๋ฅผ ๊ฐ์ง๋ฉฐ ์ด๋ ํ์๊ณผ๋ ์ง์ ์ํธ์์ฉํ ์ ์์ต๋๋ค. Agent teams๋ ์คํ์ ์ด๋ฉฐ `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`์ ์ค์ ํ์ฌ ํ์ฑํํด์ผ ํฉ๋๋ค.
16 20
17์์ธํ ์์๋ณด๊ธฐ: [์์ด์ ํธ ํ ์คํ](/ko/agent-teams)21์์ธํ ์์๋ณด๊ธฐ: [์์ด์ ํธ ํ ์คํ](/ko/agent-teams)
18 22
19### Agentic coding23<h3 id="agentic-coding">
24 Agentic coding
25</h3>
20 26
21AI๊ฐ ํ์ผ์ ์ฝ๊ณ , ๋ช
๋ น์ ์คํํ๊ณ , ๋ณ๊ฒฝ ์ฌํญ์ ์์จ์ ์ผ๋ก ๋ง๋ค ์ ์๋ ์ํฌํ๋ก์ฐ์
๋๋ค. ์ฌ์ฉ์๊ฐ ์ง์ ์ ์ฉํด์ผ ํ๋ ํ
์คํธ๋ง ์๋ตํ๋ ์ฑํ
๊ธฐ๋ฐ ์ด์์คํดํธ์ ๋ฌ๋ฆฌ, ์ฌ์ฉ์๊ฐ ์ง์ผ๋ณด๊ฑฐ๋, ๋ฆฌ๋๋ ์
ํ๊ฑฐ๋, ๋ ๋ ์ ์์ต๋๋ค. Claude Code๋ ์กฐ์ธ๋ง ํ๋ ๊ฒ์ด ์๋๋ผ ํ๋ํ ์ ์๊ฒ ํด์ฃผ๋ [๋๊ตฌ](#tool)๋ฅผ ๊ฐ์ง๊ณ ์๊ธฐ ๋๋ฌธ์ ์์ด์ ํธ์
๋๋ค.27AI๊ฐ ํ์ผ์ ์ฝ๊ณ , ๋ช
๋ น์ ์คํํ๊ณ , ๋ณ๊ฒฝ ์ฌํญ์ ์์จ์ ์ผ๋ก ๋ง๋ค ์ ์๋ ์ํฌํ๋ก์ฐ์
๋๋ค. ์ฌ์ฉ์๊ฐ ์ง์ ์ ์ฉํด์ผ ํ๋ ํ
์คํธ๋ง ์๋ตํ๋ ์ฑํ
๊ธฐ๋ฐ ์ด์์คํดํธ์ ๋ฌ๋ฆฌ, ์ฌ์ฉ์๊ฐ ์ง์ผ๋ณด๊ฑฐ๋, ๋ฆฌ๋๋ ์
ํ๊ฑฐ๋, ๋ ๋ ์ ์์ต๋๋ค. Claude Code๋ ์กฐ์ธ๋ง ํ๋ ๊ฒ์ด ์๋๋ผ ํ๋ํ ์ ์๊ฒ ํด์ฃผ๋ [๋๊ตฌ](#tool)๋ฅผ ๊ฐ์ง๊ณ ์๊ธฐ ๋๋ฌธ์ ์์ด์ ํธ์
๋๋ค.
22 28
23์์ธํ ์์๋ณด๊ธฐ: [Claude Code ์๋ ๋ฐฉ์](/ko/how-claude-code-works)29์์ธํ ์์๋ณด๊ธฐ: [Claude Code ์๋ ๋ฐฉ์](/ko/how-claude-code-works)
24 30
25### Agentic harness31<h3 id="agentic-harness">
32 Agentic harness
33</h3>
26 34
27์ธ์ด ๋ชจ๋ธ์ ๋ฅ๋ ฅ ์๋ ์ฝ๋ฉ ์์ด์ ํธ๋ก ๋ณํํ๋ ๋๊ตฌ, ์ปจํ
์คํธ ๊ด๋ฆฌ ๋ฐ ์คํ ํ๊ฒฝ์
๋๋ค. Claude Code๋ ํ๋ค์ค์ด๊ณ , Claude๋ ๊ทธ ์์ ๋ชจ๋ธ์
๋๋ค. ํ๋ค์ค๋ ํ์ผ ์ก์ธ์ค, ์
ธ ์คํ, ๊ถํ ๊ฒ์ดํ
, ๋ฉ๋ชจ๋ฆฌ ๋ก๋ฉ ๋ฐ ์์
์ ํจ๊ป ์ฐ๊ฒฐํ๋ ๋ฃจํ๋ฅผ ์ ๊ณตํฉ๋๋ค.35์ธ์ด ๋ชจ๋ธ์ ๋ฅ๋ ฅ ์๋ ์ฝ๋ฉ ์์ด์ ํธ๋ก ๋ณํํ๋ ๋๊ตฌ, ์ปจํ
์คํธ ๊ด๋ฆฌ ๋ฐ ์คํ ํ๊ฒฝ์
๋๋ค. Claude Code๋ ํ๋ค์ค์ด๊ณ , Claude๋ ๊ทธ ์์ ๋ชจ๋ธ์
๋๋ค. ํ๋ค์ค๋ ํ์ผ ์ก์ธ์ค, ์
ธ ์คํ, ๊ถํ ๊ฒ์ดํ
, ๋ฉ๋ชจ๋ฆฌ ๋ก๋ฉ ๋ฐ ์์
์ ํจ๊ป ์ฐ๊ฒฐํ๋ ๋ฃจํ๋ฅผ ์ ๊ณตํฉ๋๋ค.
28 36
29์์ธํ ์์๋ณด๊ธฐ: [Claude Code ์๋ ๋ฐฉ์](/ko/how-claude-code-works)37์์ธํ ์์๋ณด๊ธฐ: [Claude Code ์๋ ๋ฐฉ์](/ko/how-claude-code-works)
30 38
31### Agentic loop39<h3 id="agentic-loop">
40 Agentic loop
41</h3>
32 42
33Claude๊ฐ ๋ชจ๋ ์์
์ ์ํํ๋ ์ฌ์ดํด์
๋๋ค: ์ปจํ
์คํธ ์์ง, ์์
์ํ, ๊ฒฐ๊ณผ ํ์ธ ๋ฐ ์๋ฃ๋ ๋๊น์ง ๋ฐ๋ณตํฉ๋๋ค. ๊ฐ ๋๊ตฌ ์ฌ์ฉ์ ๋ค์ ๋จ๊ณ๋ฅผ ์๋ ค์ฃผ๋ ์ ๋ณด๋ฅผ ๋ฐํํฉ๋๋ค. ์ธ์ ๋ ์ง ๋ฃจํ๋ฅผ ์ค๋จํ์ฌ ๋ฆฌ๋๋ ์
ํ ์ ์์ต๋๋ค. [ํ
](#hook), [์คํฌ](#skill), [MCP](#mcp-model-context-protocol)์ ํฌํจํ ๋๋ถ๋ถ์ ํ์ฅ ํฌ์ธํธ๋ ์ด ๋ฃจํ์ ํน์ ๋จ๊ณ์ ์ฐ๊ฒฐ๋ฉ๋๋ค.43Claude๊ฐ ๋ชจ๋ ์์
์ ์ํํ๋ ์ฌ์ดํด์
๋๋ค: ์ปจํ
์คํธ ์์ง, ์์
์ํ, ๊ฒฐ๊ณผ ํ์ธ ๋ฐ ์๋ฃ๋ ๋๊น์ง ๋ฐ๋ณตํฉ๋๋ค. ๊ฐ ๋๊ตฌ ์ฌ์ฉ์ ๋ค์ ๋จ๊ณ๋ฅผ ์๋ ค์ฃผ๋ ์ ๋ณด๋ฅผ ๋ฐํํฉ๋๋ค. ์ธ์ ๋ ์ง ๋ฃจํ๋ฅผ ์ค๋จํ์ฌ ๋ฆฌ๋๋ ์
ํ ์ ์์ต๋๋ค. [ํ
](#hook), [์คํฌ](#skill), [MCP](#mcp-model-context-protocol)์ ํฌํจํ ๋๋ถ๋ถ์ ํ์ฅ ํฌ์ธํธ๋ ์ด ๋ฃจํ์ ํน์ ๋จ๊ณ์ ์ฐ๊ฒฐ๋ฉ๋๋ค.
34 44
35์์ธํ ์์๋ณด๊ธฐ: [Claude Code ์๋ ๋ฐฉ์](/ko/how-claude-code-works#the-agentic-loop)45์์ธํ ์์๋ณด๊ธฐ: [Claude Code ์๋ ๋ฐฉ์](/ko/how-claude-code-works#the-agentic-loop)
36 46
37### Auto memory47<h3 id="auto-memory">
48 Auto memory
49</h3>
38 50
39Claude๊ฐ ์ฌ์ฉ์์ ์์ ๋ฐ ์ ํธ๋๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ์์ ์ ์ํด ์์ฑํ ๋
ธํธ์ด๋ฉฐ, `~/.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 ์์ฑ ๋์๋ฌผ์
๋๋ค.
40 52
41์์ธํ ์์๋ณด๊ธฐ: [Auto memory](/ko/memory#auto-memory)53์์ธํ ์์๋ณด๊ธฐ: [Auto memory](/ko/memory#auto-memory)
42 54
43### Auto mode55<h3 id="auto-mode">
56 Auto mode
57</h3>
44 58
45๋ฐฑ๊ทธ๋ผ์ด๋์์ ๋ณ๋์ ๋ถ๋ฅ๊ธฐ ๋ชจ๋ธ์ด ๊ฐ ์์
์ ๊ฒํ ํ๋ [๊ถํ ๋ชจ๋](#permission-mode)์ด๋ฉฐ, ์น์ธ ํ๋กฌํํธ๋ฅผ ํ์ํ๋ ๋์ ์
๋๋ค. ๋ถ๋ฅ๊ธฐ๋ ๋ฒ์ ํ๋, ์ ๋ขฐํ ์ ์๋ ์ธํ๋ผ ๋ฐ [ํ๋กฌํํธ ์ฃผ์
](#prompt-injection)์ ์ฐจ๋จํฉ๋๋ค. ๋๊ตฌ ๊ฒฐ๊ณผ๋ฅผ ๋ณด์ง ์์ผ๋ฏ๋ก ์ฃผ์
๋ ์ง์นจ์ด ๊ฒฐ์ ์ ์ํฅ์ ๋ฏธ์น ์ ์์ต๋๋ค. Auto mode๋ Max, Team, Enterprise ๋ฐ API ํ๋์์ ์ฌ์ฉ ๊ฐ๋ฅํ ์ฐ๊ตฌ ๋ฏธ๋ฆฌ๋ณด๊ธฐ์
๋๋ค.59๋ฐฑ๊ทธ๋ผ์ด๋์์ ๋ณ๋์ ๋ถ๋ฅ๊ธฐ ๋ชจ๋ธ์ด ๊ฐ ์์
์ ๊ฒํ ํ๋ [๊ถํ ๋ชจ๋](#permission-mode)์ด๋ฉฐ, ์น์ธ ํ๋กฌํํธ๋ฅผ ํ์ํ๋ ๋์ ์
๋๋ค. ๋ถ๋ฅ๊ธฐ๋ ๋ฒ์ ํ๋, ์ ๋ขฐํ ์ ์๋ ์ธํ๋ผ ๋ฐ [ํ๋กฌํํธ ์ฃผ์
](#prompt-injection)์ ์ฐจ๋จํฉ๋๋ค. ๋๊ตฌ ๊ฒฐ๊ณผ๋ฅผ ๋ณด์ง ์์ผ๋ฏ๋ก ์ฃผ์
๋ ์ง์นจ์ด ๊ฒฐ์ ์ ์ํฅ์ ๋ฏธ์น ์ ์์ต๋๋ค. Auto mode๋ ์ฐ๊ตฌ ๋ฏธ๋ฆฌ๋ณด๊ธฐ์
๋๋ค.
46 60
47์์ธํ ์์๋ณด๊ธฐ: [ํ๋กฌํํธ ์ ๊ฑฐ ๋ฐ auto mode](/ko/permission-modes#eliminate-prompts-with-auto-mode)61์์ธํ ์์๋ณด๊ธฐ: [ํ๋กฌํํธ ์ ๊ฑฐ ๋ฐ auto mode](/ko/permission-modes#eliminate-prompts-with-auto-mode)
48 62
49## B63<h2 id="b">
64 B
65</h2>
50 66
51### Bare mode67<h3 id="bare-mode">
68 Bare mode
69</h3>
52 70
53์๋ ๋ฐ๊ฒฌ์ ๊ฑด๋๋ฐ๋ ์์ ํ๋๊ทธ `--bare`์
๋๋ค. ํ
, ์คํฌ, ํ๋ฌ๊ทธ์ธ, MCP ์๋ฒ, auto memory ๋ฐ CLAUDE.md์ ์๋ ๋ฐ๊ฒฌ์ ๊ฑด๋๋๋๋ค. ๋ช
์์ ์ผ๋ก ์ ๋ฌํ๋ ํ๋๊ทธ๋ง ์ ์ฉ๋ฉ๋๋ค. CI ๋ฐ ์คํฌ๋ฆฝํธ๋ ํธ์ถ์ ๊ถ์ฅ๋๋ฉฐ, ๋ก์ปฌ ๊ตฌ์ฑ์ ๊ด๊ณ์์ด ๋จธ์ ๊ฐ์ ๋์ผํ ๋์์ด ํ์ํฉ๋๋ค.71์๋ ๋ฐ๊ฒฌ์ ๊ฑด๋๋ฐ๋ ์์ ํ๋๊ทธ `--bare`์
๋๋ค. ํ
, ์คํฌ, ํ๋ฌ๊ทธ์ธ, MCP ์๋ฒ, auto memory ๋ฐ CLAUDE.md์ ์๋ ๋ฐ๊ฒฌ์ ๊ฑด๋๋๋๋ค. ๋ช
์์ ์ผ๋ก ์ ๋ฌํ๋ ํ๋๊ทธ๋ง ์ ์ฉ๋ฉ๋๋ค. CI ๋ฐ ์คํฌ๋ฆฝํธ๋ ํธ์ถ์ ๊ถ์ฅ๋๋ฉฐ, ๋ก์ปฌ ๊ตฌ์ฑ์ ๊ด๊ณ์์ด ๋จธ์ ๊ฐ์ ๋์ผํ ๋์์ด ํ์ํฉ๋๋ค.
54 72
55์์ธํ ์์๋ณด๊ธฐ: [bare mode๋ก ๋ ๋น ๋ฅด๊ฒ ์์](/ko/headless#start-faster-with-bare-mode)73์์ธํ ์์๋ณด๊ธฐ: [bare mode๋ก ๋ ๋น ๋ฅด๊ฒ ์์](/ko/headless#start-faster-with-bare-mode)
56 74
57### Bundled skills75<h3 id="bundled-skills">
76 Bundled skills
77</h3>
58 78
59Claude Code์ ํฌํจ๋ ํ๋กฌํํธ ๊ธฐ๋ฐ ํ๋ ์ด๋ถ์
๋๋ค. `/batch`, `/simplify`, `/debug`, `/loop` ๋ฑ์ด ์์ต๋๋ค. ๊ณ ์ ๋ก์ง์ ์คํํ๋ ๊ธฐ๋ณธ ์ ๊ณต ๋ช
๋ น๊ณผ ๋ฌ๋ฆฌ, ๋ฒ๋ค ์คํฌ์ Claude์ ์์ธํ ํ๋กฌํํธ๋ฅผ ์ ๊ณตํ๊ณ ์์
์ ์กฐ์จํ๋๋ก ํ๋ฏ๋ก ์์ด์ ํธ๋ฅผ ์์ฑํ๊ณ , ํ์ผ์ ์ฝ๊ณ , ์ฝ๋๋ฒ ์ด์ค์ ์ ์ํ ์ ์์ต๋๋ค.79Claude Code์ ํฌํจ๋ ํ๋กฌํํธ ๊ธฐ๋ฐ ํ๋ ์ด๋ถ์
๋๋ค. `/batch`, `/code-review`, `/debug`, `/loop` ๋ฑ์ด ์์ต๋๋ค. ๊ณ ์ ๋ก์ง์ ์คํํ๋ ๊ธฐ๋ณธ ์ ๊ณต ๋ช
๋ น๊ณผ ๋ฌ๋ฆฌ, ๋ฒ๋ค ์คํฌ์ Claude์ ์์ธํ ํ๋กฌํํธ๋ฅผ ์ ๊ณตํ๊ณ ์์
์ ์กฐ์จํ๋๋ก ํ๋ฏ๋ก ์์ด์ ํธ๋ฅผ ์์ฑํ๊ณ , ํ์ผ์ ์ฝ๊ณ , ์ฝ๋๋ฒ ์ด์ค์ ์ ์ํ ์ ์์ต๋๋ค.
60 80
61์์ธํ ์์๋ณด๊ธฐ: [๋ฒ๋ค ์คํฌ](/ko/skills#bundled-skills)81์์ธํ ์์๋ณด๊ธฐ: [๋ฒ๋ค ์คํฌ](/ko/skills#bundled-skills)
62 82
63## C83<h2 id="c">
84 C
85</h2>
64 86
65### Channel87<h3 id="channel">
88 Channel
89</h3>
66 90
67์คํ ์ค์ธ ์ธ์
์ ์ด๋ฒคํธ๋ฅผ ํธ์ํ๋ [MCP ์๋ฒ](#mcp-model-context-protocol)์ด๋ฏ๋ก Claude๋ ํฐ๋ฏธ๋์์ ๋จ์ด์ ธ ์์ ๋ ๋ฐ์ํ๋ ์ผ์ ๋ฐ์ํ ์ ์์ต๋๋ค. ์ฑ๋์ ์๋ฐฉํฅ์ผ ์ ์์ต๋๋ค: Claude๋ ์ธ๋ฐ์ด๋ ์ด๋ฒคํธ๋ฅผ ์ฝ๊ณ ๋์ผํ ์ฑ๋์ ํตํด ๋ค์ ์๋ตํฉ๋๋ค. Telegram, Discord ๋ฐ iMessage๋ ์ฐ๊ตฌ ๋ฏธ๋ฆฌ๋ณด๊ธฐ์ ํฌํจ๋ฉ๋๋ค.91์คํ ์ค์ธ ์ธ์
์ ์ด๋ฒคํธ๋ฅผ ํธ์ํ๋ [MCP ์๋ฒ](#mcp-model-context-protocol)์ด๋ฏ๋ก Claude๋ ํฐ๋ฏธ๋์์ ๋จ์ด์ ธ ์์ ๋ ๋ฐ์ํ๋ ์ผ์ ๋ฐ์ํ ์ ์์ต๋๋ค. ์ฑ๋์ ์๋ฐฉํฅ์ผ ์ ์์ต๋๋ค: Claude๋ ์ธ๋ฐ์ด๋ ์ด๋ฒคํธ๋ฅผ ์ฝ๊ณ ๋์ผํ ์ฑ๋์ ํตํด ๋ค์ ์๋ตํฉ๋๋ค. Telegram, Discord ๋ฐ iMessage๋ ์ฐ๊ตฌ ๋ฏธ๋ฆฌ๋ณด๊ธฐ์ ํฌํจ๋ฉ๋๋ค.
68 92
69์์ธํ ์์๋ณด๊ธฐ: [์ฑ๋](/ko/channels)93์์ธํ ์์๋ณด๊ธฐ: [์ฑ๋](/ko/channels)
70 94
71### Checkpoint95<h3 id="checkpoint">
96 Checkpoint
97</h3>
72 98
73๊ฐ ํ๋กฌํํธ๋ฅผ ์ ์กํ ๋๋ง๋ค ์์ฑ๋๋ ๋ณต์ ์ง์ ์
๋๋ค. Claude Code๋ ๋ชจ๋ ํธ์ง ์ ์ ํ์ผ์ ์ค๋
์ทํ๋ฏ๋ก ์ฒดํฌํฌ์ธํธ๊ฐ ํ์ผ์ ๋๋๋ฆด ์ ์์ต๋๋ค. `Esc`๋ฅผ ๋ ๋ฒ ๋๋ฅด๊ฑฐ๋ `/rewind`๋ฅผ ์คํํ์ฌ ์ฝ๋, ๋ํ ๋๋ ๋ ๋ค๋ฅผ ์ด์ ์ง์ ์ผ๋ก ๋ณต์ํ๊ฑฐ๋, ์ ํํ ๋ฉ์์ง์์ ๋ํ์ ์ผ๋ถ๋ฅผ ์์ฝํฉ๋๋ค. ์ฒดํฌํฌ์ธํธ๋ ์ธ์
์ ๋ก์ปฌ์ด๋ฉฐ, git๊ณผ ๋ณ๊ฐ์ด๊ณ , Bash ๋๊ตฌ๋ฅผ ํตํด ์ํ๋ ๋ณ๊ฒฝ ์ฌํญ์ ์ถ์ ํ์ง ์์ต๋๋ค.99๊ฐ ํ๋กฌํํธ๋ฅผ ์ ์กํ ๋๋ง๋ค ์์ฑ๋๋ ๋ณต์ ์ง์ ์
๋๋ค. Claude Code๋ ๋ชจ๋ ํธ์ง ์ ์ ํ์ผ์ ์ค๋
์ทํ๋ฏ๋ก ์ฒดํฌํฌ์ธํธ๊ฐ ํ์ผ์ ๋๋๋ฆด ์ ์์ต๋๋ค. `Esc`๋ฅผ ๋ ๋ฒ ๋๋ฅด๊ฑฐ๋ `/rewind`๋ฅผ ์คํํ์ฌ ์ฝ๋, ๋ํ ๋๋ ๋ ๋ค๋ฅผ ์ด์ ์ง์ ์ผ๋ก ๋ณต์ํ๊ฑฐ๋, ์ ํํ ๋ฉ์์ง์์ ๋ํ์ ์ผ๋ถ๋ฅผ ์์ฝํฉ๋๋ค. ์ฒดํฌํฌ์ธํธ๋ ์ธ์
์ ๋ก์ปฌ์ด๋ฉฐ, git๊ณผ ๋ณ๊ฐ์ด๊ณ , Bash ๋๊ตฌ๋ฅผ ํตํด ์ํ๋ ๋ณ๊ฒฝ ์ฌํญ์ ์ถ์ ํ์ง ์์ต๋๋ค.
74 100
75์์ธํ ์์๋ณด๊ธฐ: [์ฒดํฌํฌ์ธํ
](/ko/checkpointing)101์์ธํ ์์๋ณด๊ธฐ: [์ฒดํฌํฌ์ธํ
](/ko/checkpointing)
76 102
77### `.claude` directory103<h3 id="claude-directory">
104 `.claude` directory
105</h3>
78 106
79Claude Code๊ฐ ํ๋ก์ ํธ ๋ฒ์ ๊ตฌ์ฑ์ ์ฝ๋ ๋๋ ํ ๋ฆฌ์
๋๋ค: ์ค์ , ํ
, ์คํฌ, ์๋ธ์์ด์ ํธ, ๊ท์น ๋ฐ auto memory. ํ๋ก์ ํธ๋ ๋ฃจํธ์ `.claude/`๋ฅผ ๊ฐ์ง๋ฉฐ, ์ฌ์ฉ์ ์์ค ๊ธฐ๋ณธ๊ฐ์ `~/.claude/`์ ์์ต๋๋ค.107Claude Code๊ฐ ํ๋ก์ ํธ ๋ฒ์ ๊ตฌ์ฑ์ ์ฝ๋ ๋๋ ํ ๋ฆฌ์
๋๋ค: ์ค์ , ํ
, ์คํฌ, ์๋ธ์์ด์ ํธ, ๊ท์น ๋ฐ auto memory. ํ๋ก์ ํธ๋ ๋ฃจํธ์ `.claude/`๋ฅผ ๊ฐ์ง๋ฉฐ, ์ฌ์ฉ์ ์์ค ๊ธฐ๋ณธ๊ฐ์ `~/.claude/`์ ์์ต๋๋ค.
80 108
81์์ธํ ์์๋ณด๊ธฐ: [`.claude` ๋๋ ํ ๋ฆฌ](/ko/claude-directory)109์์ธํ ์์๋ณด๊ธฐ: [`.claude` ๋๋ ํ ๋ฆฌ](/ko/claude-directory)
82 110
83### CLAUDE.md111<h3 id="claude-md">
112 CLAUDE.md
113</h3>
84 114
85Claude๋ฅผ ์ํด ์์ฑํ๋ ์ง์์ ์ธ ์ง์นจ์ ๋งํฌ๋ค์ด ํ์ผ์ด๋ฉฐ, ์์คํ
ํ๋กฌํํธ ์ดํ ์ฌ์ฉ์ ๋ฉ์์ง๋ก ๋ชจ๋ ์ธ์
์ ์์ ์ ๋ก๋๋ฉ๋๋ค. ํ๋ก์ ํธ ๊ท์น, ์ํคํ
์ฒ ๋
ธํธ ๋ฐ "ํญ์ X๋ฅผ ์ํ" ๊ท์น์ ์ฌ๊ธฐ์ ๋ฃ์ต๋๋ค. CLAUDE.md๋ [์ปดํฉ์
](#compaction)์ ๊ฒฌ๋๊ณ ์ดํ ๋์คํฌ์์ ์๋ก ๋ค์ ์ฝ์ต๋๋ค.115Claude๋ฅผ ์ํด ์์ฑํ๋ ์ง์์ ์ธ ์ง์นจ์ ๋งํฌ๋ค์ด ํ์ผ์ด๋ฉฐ, ์์คํ
ํ๋กฌํํธ ์ดํ ์ฌ์ฉ์ ๋ฉ์์ง๋ก ๋ชจ๋ ์ธ์
์ ์์ ์ ๋ก๋๋ฉ๋๋ค. ํ๋ก์ ํธ ๊ท์น, ์ํคํ
์ฒ ๋
ธํธ ๋ฐ "ํญ์ X๋ฅผ ์ํ" ๊ท์น์ ์ฌ๊ธฐ์ ๋ฃ์ต๋๋ค. ํ๋ก์ ํธ ๋ฃจํธ CLAUDE.md๋ [์ปดํฉ์
](#compaction)์ ๊ฒฌ๋๊ณ ์ดํ ๋์คํฌ์์ ์๋ก ๋ค์ ์ฝ์ต๋๋ค.
86 116
87CLAUDE.md๋ฅผ ํ๋ก์ ํธ ๋ฒ์์์ `./CLAUDE.md` ๋๋ `./.claude/CLAUDE.md`์, ์ฌ์ฉ์ ๋ฒ์์์ `~/.claude/CLAUDE.md`์, ๋๋ ์กฐ์ง์ [๊ด๋ฆฌ ์ ์ฑ
](#managed-settings)์ผ๋ก ๋ฐฐ์นํ ์ ์์ต๋๋ค. ๋ ๊ตฌ์ฒด์ ์ธ ์์น๊ฐ ์ฐ์ ํฉ๋๋ค.117CLAUDE.md๋ฅผ ํ๋ก์ ํธ ๋ฒ์์์ `./CLAUDE.md` ๋๋ `./.claude/CLAUDE.md`์, ์ฌ์ฉ์ ๋ฒ์์์ `~/.claude/CLAUDE.md`์, ๋๋ ์กฐ์ง์ [๊ด๋ฆฌ ์ ์ฑ
](#managed-settings)์ผ๋ก ๋ฐฐ์นํ ์ ์์ต๋๋ค. ๋ฐ๊ฒฌ๋ ๋ชจ๋ ํ์ผ์ ์๋ก๋ฅผ ์ฌ์ ์ํ์ง ์๊ณ ์ฐ๊ฒฐ๋๋ฉฐ, ๊ฐ์ฅ ๊ด๋ฒ์ํ ๋ฒ์์์ ๊ฐ์ฅ ๊ตฌ์ฒด์ ์ธ ๋ฒ์๋ก ์ ๋ ฌ๋ฉ๋๋ค.
88 118
89์์ธํ ์์๋ณด๊ธฐ: [CLAUDE.md ํ์ผ](/ko/memory#claude-md-files)119์์ธํ ์์๋ณด๊ธฐ: [CLAUDE.md ํ์ผ](/ko/memory#claude-md-files)
90 120
91### Command121<h3 id="command">
122 Command
123</h3>
92 124
93ํ๋กฌํํธ์ `/name`์ ์
๋ ฅํ์ฌ ํธ์ถํ๋ ์ฌ์ฌ์ฉ ๊ฐ๋ฅํ ์ง์นจ์
๋๋ค. `/clear`, `/model`, `/compact`์ ๊ฐ์ ๊ธฐ๋ณธ ์ ๊ณต ๋ช
๋ น์ ์ธ์
์ ์ ์ดํฉ๋๋ค. `.claude/commands/`์ ํ์ผ๋ก ์์ ์ ๋ช
๋ น์ ์ ์ํ๊ฑฐ๋ [ํ๋ฌ๊ทธ์ธ](#plugin)์์ ์ค์นํ ์ ์์ต๋๋ค. [์คํฌ](#skill)์ ๋ค๋จ๊ณ ๋ช
๋ น์ ํจํค์งํ๋ ๊ถ์ฅ ๋ฐฉ๋ฒ์
๋๋ค.125ํ๋กฌํํธ์ `/name`์ ์
๋ ฅํ์ฌ ํธ์ถํ๋ ์ฌ์ฌ์ฉ ๊ฐ๋ฅํ ์ง์นจ์
๋๋ค. `/clear`, `/model`, `/compact`์ ๊ฐ์ ๊ธฐ๋ณธ ์ ๊ณต ๋ช
๋ น์ ์ธ์
์ ์ ์ดํฉ๋๋ค. `.claude/commands/`์ ํ์ผ๋ก ์์ ์ ๋ช
๋ น์ ์ ์ํ๊ฑฐ๋ [ํ๋ฌ๊ทธ์ธ](#plugin)์์ ์ค์นํ ์ ์์ต๋๋ค. [์คํฌ](#skill)์ ๋ค๋จ๊ณ ๋ช
๋ น์ ํจํค์งํ๋ ๊ถ์ฅ ๋ฐฉ๋ฒ์
๋๋ค.
94 126
95์์ธํ ์์๋ณด๊ธฐ: [๋ช
๋ น](/ko/commands) ยท [์คํฌ](/ko/skills)127์์ธํ ์์๋ณด๊ธฐ: [๋ช
๋ น](/ko/commands) ยท [์คํฌ](/ko/skills)
96 128
97### Compaction129<h3 id="compaction">
130 Compaction
131</h3>
98 132
99[์ปจํ
์คํธ ์๋์ฐ](#context-window)๊ฐ ํ๊ณ์ ์ ๊ทผํ ๋ ๋ํ์ ์๋ ์์ฝ์
๋๋ค. ์ด์ ๋๊ตฌ ์ถ๋ ฅ์ด ๋จผ์ ์ง์์ง๊ณ , ๊ทธ ๋ค์ ๋ํ๊ฐ ์์ฝ๋ฉ๋๋ค. ํ๋ก์ ํธ ๋ฃจํธ CLAUDE.md ๋ฐ auto memory๋ ์ปดํฉ์
์ ๊ฒฌ๋๊ณ ๋์คํฌ์์ ๋ค์ ๋ก๋๋ฉ๋๋ค. ๋ํ์์๋ง ์ ๊ณต๋ ์ง์นจ์ ์์ค๋ ์ ์์ต๋๋ค. `/compact`๋ฅผ ์๋์ผ๋ก ํธ๋ฆฌ๊ฑฐํ๊ฑฐ๋, `/compact focus on the API changes`์ ๊ฐ์ ํฌ์ปค์ค๋ฅผ ์ ํ์ ์ผ๋ก ์ฌ์ฉํฉ๋๋ค.133[์ปจํ
์คํธ ์๋์ฐ](#context-window)๊ฐ ํ๊ณ์ ์ ๊ทผํ ๋ ๋ํ์ ์๋ ์์ฝ์
๋๋ค. ์ด์ ๋๊ตฌ ์ถ๋ ฅ์ด ๋จผ์ ์ง์์ง๊ณ , ๊ทธ ๋ค์ ๋ํ๊ฐ ์์ฝ๋ฉ๋๋ค. ํ๋ก์ ํธ ๋ฃจํธ CLAUDE.md ๋ฐ auto memory๋ ์ปดํฉ์
์ ๊ฒฌ๋๊ณ ๋์คํฌ์์ ๋ค์ ๋ก๋๋ฉ๋๋ค. ๋ํ์์๋ง ์ ๊ณต๋ ์ง์นจ์ ์์ค๋ ์ ์์ต๋๋ค. `/compact`๋ฅผ ์๋์ผ๋ก ํธ๋ฆฌ๊ฑฐํ๊ฑฐ๋, `/compact focus on the API changes`์ ๊ฐ์ ํฌ์ปค์ค๋ฅผ ์ ํ์ ์ผ๋ก ์ฌ์ฉํฉ๋๋ค.
100 134
101์์ธํ ์์๋ณด๊ธฐ: [์ปดํฉ์
์์ ์์กดํ๋ ๊ฒ](/ko/context-window#what-survives-compaction) ยท [์ปจํ
์คํธ๊ฐ ๊ฐ๋ ์ฐฐ ๋](/ko/how-claude-code-works#when-context-fills-up)135์์ธํ ์์๋ณด๊ธฐ: [์ปดํฉ์
์์ ์์กดํ๋ ๊ฒ](/ko/context-window#what-survives-compaction) ยท [์ปจํ
์คํธ๊ฐ ๊ฐ๋ ์ฐฐ ๋](/ko/how-claude-code-works#when-context-fills-up)
102 136
103### Context window137<h3 id="context-window">
138 Context window
139</h3>
104 140
105์ธ์
์ ์์
๋ฉ๋ชจ๋ฆฌ์ด๋ฉฐ, ๋ํ ๊ธฐ๋ก, ํ์ผ ๋ด์ฉ, ๋ช
๋ น ์ถ๋ ฅ, CLAUDE.md, auto memory, ๋ก๋๋ ์คํฌ ๋ฐ ์์คํ
์ง์นจ์ ๋ณด์ ํฉ๋๋ค. ์์
ํ๋ฉด์ ์ปจํ
์คํธ๊ฐ ๊ฐ๋ ์ฐฐ ๋๊น์ง ์ฑ์์ง๊ณ [์ปดํฉ์
](#compaction)์ด ์์ฝํฉ๋๋ค. `/context`๋ฅผ ์คํํ์ฌ ๊ณต๊ฐ์ ์ฌ์ฉํ๋ ๊ฒ์ ํ์ธํฉ๋๋ค. ๊ธฐ๋ณธ ๋ชจ๋ธ ๊ฐ๋
์ [ํ๋ซํผ ์ฉ์ด์ง](https://platform.claude.com/docs/ko/about-claude/glossary#context-window)์ ์ฐธ์กฐํ์ญ์์ค.141์ธ์
์ ์์
๋ฉ๋ชจ๋ฆฌ์ด๋ฉฐ, ๋ํ ๊ธฐ๋ก, ํ์ผ ๋ด์ฉ, ๋ช
๋ น ์ถ๋ ฅ, CLAUDE.md, auto memory, ๋ก๋๋ ์คํฌ ๋ฐ ์์คํ
์ง์นจ์ ๋ณด์ ํฉ๋๋ค. ์์
ํ๋ฉด์ ์ปจํ
์คํธ๊ฐ ๊ฐ๋ ์ฐฐ ๋๊น์ง ์ฑ์์ง๊ณ [์ปดํฉ์
](#compaction)์ด ์์ฝํฉ๋๋ค. `/context`๋ฅผ ์คํํ์ฌ ๊ณต๊ฐ์ ์ฌ์ฉํ๋ ๊ฒ์ ํ์ธํฉ๋๋ค. ๊ธฐ๋ณธ ๋ชจ๋ธ ๊ฐ๋
์ [ํ๋ซํผ ์ฉ์ด์ง](https://platform.claude.com/docs/ko/about-claude/glossary#context-window)์ ์ฐธ์กฐํ์ญ์์ค.
106 142
107์์ธํ ์์๋ณด๊ธฐ: [์ปจํ
์คํธ ์๋์ฐ ํ์](/ko/context-window)143์์ธํ ์์๋ณด๊ธฐ: [์ปจํ
์คํธ ์๋์ฐ ํ์](/ko/context-window)
108 144
109## D145<h2 id="d">
146 D
147</h2>
110 148
111### Dispatch149<h3 id="dispatch">
150 Dispatch
151</h3>
112 152
113Claude ๋ชจ๋ฐ์ผ ์ฑ์์ ์ฝ๋ฉ ์์
์ ๋ณด๋ผ ๋ Desktop ์ฑ์์ Claude Code ์ธ์
์ ์์ฑํ๋ ํด๋ํฐ ์์ ์์
๋ผ์ฐํฐ์
๋๋ค. ํ๋กฌํํธ๊ฐ ์ฌ๋ฐ๋ฅธ ๋๊ตฌ๋ก ์๋์ผ๋ก ๋ผ์ฐํ
๋ฉ๋๋ค. Pro ๋ฐ Max ํ๋์์ ์ฌ์ฉ ๊ฐ๋ฅํฉ๋๋ค.153Claude ๋ชจ๋ฐ์ผ ์ฑ์์ ์ฝ๋ฉ ์์
์ ๋ณด๋ผ ๋ Desktop ์ฑ์์ Claude Code ์ธ์
์ ์์ฑํ๋ ํด๋ํฐ ์์ ์์
๋ผ์ฐํฐ์
๋๋ค. ํ๋กฌํํธ๊ฐ ์ฌ๋ฐ๋ฅธ ๋๊ตฌ๋ก ์๋์ผ๋ก ๋ผ์ฐํ
๋ฉ๋๋ค. Pro ๋ฐ Max ํ๋์์ ์ฌ์ฉ ๊ฐ๋ฅํฉ๋๋ค.
114 154
115์์ธํ ์์๋ณด๊ธฐ: [Dispatch์ ์ธ์
](/ko/desktop#sessions-from-dispatch)155์์ธํ ์์๋ณด๊ธฐ: [Dispatch์ ์ธ์
](/ko/desktop#sessions-from-dispatch)
116 156
117## E157<h2 id="e">
158 E
159</h2>
118 160
119### Effort level161<h3 id="effort-level">
162 Effort level
163</h3>
120 164
121๊ฐ ํด์์ Claude๊ฐ ์ ์ํ ์ถ๋ก ์ฌ๊ณ ์์ฐ์ ์ผ๋ง๋ ์ฌ์ฉํ ์ง ์ ์ดํ๋ ์ค์ ์
๋๋ค. ๋ ๋์ ๋
ธ๋ ฅ์ ๋ ๋ง์ ์ฌ๊ณ ํ ํฐ๊ณผ ๋ ๊น์ ์ถ๋ก ์ ์๋ฏธํฉ๋๋ค. ๋ ๋ฎ์ ๋
ธ๋ ฅ์ ๋ ๋น ๋ฅด๊ณ ์ ๋ ดํฉ๋๋ค. Effort๋ Opus 4.7, Opus 4.6 ๋ฐ Sonnet 4.6์์ ์ง์๋ฉ๋๋ค.165๊ฐ ํด์์ Claude๊ฐ ์ ์ํ ์ถ๋ก ์ฌ๊ณ ์์ฐ์ ์ผ๋ง๋ ์ฌ์ฉํ ์ง ์ ์ดํ๋ ์ค์ ์
๋๋ค. ๋ ๋์ ๋
ธ๋ ฅ์ ๋ ๋ง์ ์ฌ๊ณ ํ ํฐ๊ณผ ๋ ๊น์ ์ถ๋ก ์ ์๋ฏธํฉ๋๋ค. ๋ ๋ฎ์ ๋
ธ๋ ฅ์ ๋ ๋น ๋ฅด๊ณ ์ ๋ ดํฉ๋๋ค. Effort๋ Opus 4.6 ์ด์ ๋ฐ Sonnet 4.6์์ ์ง์๋ฉ๋๋ค.
122 166
123์์ธํ ์์๋ณด๊ธฐ: [๋
ธ๋ ฅ ์์ค ์กฐ์ ](/ko/model-config#adjust-effort-level)167์์ธํ ์์๋ณด๊ธฐ: [๋
ธ๋ ฅ ์์ค ์กฐ์ ](/ko/model-config#adjust-effort-level)
124 168
125### Extended thinking169<h3 id="extended-thinking">
170 Extended thinking
171</h3>
126 172
127๋ชจ๋ธ์ด ์๋ตํ๊ธฐ ์ ์ ์ํํ๋ ๊ฐ์์ ์ธ ๋จ๊ณ๋ณ ์ถ๋ก ์
๋๋ค. `MAX_THINKING_TOKENS`๋ก ์ฌ๊ณ ํ ํฐ์ ์ ํํ๊ฑฐ๋ [๋
ธ๋ ฅ ์์ค](#effort-level)์ ์กฐ์ ํ ์ ์์ต๋๋ค. ์ฌ๊ณ ๋ ํฐ๋ฏธ๋์์ ํ์ ์ดํค๋ฆญ ํ
์คํธ๋ก ๋ํ๋ฉ๋๋ค.173๋ชจ๋ธ์ด ์๋ตํ๊ธฐ ์ ์ ์ํํ๋ ๊ฐ์์ ์ธ ๋จ๊ณ๋ณ ์ถ๋ก ์
๋๋ค. `MAX_THINKING_TOKENS`๋ก ์ฌ๊ณ ํ ํฐ์ ์ ํํ๊ฑฐ๋ [๋
ธ๋ ฅ ์์ค](#effort-level)์ ์กฐ์ ํ ์ ์์ต๋๋ค. ์ฌ๊ณ ๋ ํฐ๋ฏธ๋์์ ํ์ ์ดํค๋ฆญ ํ
์คํธ๋ก ๋ํ๋ฉ๋๋ค.
128 174
129์์ธํ ์์๋ณด๊ธฐ: [ํ์ฅ ์ฌ๊ณ ์ฌ์ฉ](/ko/model-config#extended-thinking)175์์ธํ ์์๋ณด๊ธฐ: [ํ์ฅ ์ฌ๊ณ ์ฌ์ฉ](/ko/model-config#extended-thinking)
130 176
131## H177<h2 id="h">
178 H
179</h2>
132 180
133### Hook181<h3 id="hook">
182 Hook
183</h3>
134 184
135Claude Code์ ๋ผ์ดํ์ฌ์ดํด์ ํน์ ์ง์ ์์ ์๋์ผ๋ก ์คํ๋๋ ์ฌ์ฉ์ ์ ์ ํธ๋ค๋ฌ์
๋๋ค. ๋๊ตฌ ์คํ ์ , ํ์ผ ํธ์ง ํ ๋๋ ์ธ์
์์ ์ ๋ฑ์
๋๋ค. ํธ๋ค๋ฌ๋ ์
ธ ๋ช
๋ น, HTTP ์๋ํฌ์ธํธ, MCP ๋๊ตฌ, LLM ํ๋กฌํํธ ๋๋ ์๋ธ์์ด์ ํธ์ผ ์ ์์ต๋๋ค. ํ
์ ๊ฒฐ์ ๋ก ์ ์
๋๋ค: ๋ชจ๋ธ์ ์ฌ๋์ด ์๋๋ผ ๊ณ ์ ๋ ๋ผ์ดํ์ฌ์ดํด ํฌ์ธํธ์์ ๋ฐ์ํฉ๋๋ค.185Claude Code์ ๋ผ์ดํ์ฌ์ดํด์ ํน์ ์ง์ ์์ ์๋์ผ๋ก ์คํ๋๋ ์ฌ์ฉ์ ์ ์ ํธ๋ค๋ฌ์
๋๋ค. ๋๊ตฌ ์คํ ์ , ํ์ผ ํธ์ง ํ ๋๋ ์ธ์
์์ ์ ๋ฑ์
๋๋ค. ํธ๋ค๋ฌ๋ ์
ธ ๋ช
๋ น, HTTP ์๋ํฌ์ธํธ, MCP ๋๊ตฌ, LLM ํ๋กฌํํธ ๋๋ ์๋ธ์์ด์ ํธ์ผ ์ ์์ต๋๋ค. ํ
์ ๊ฒฐ์ ๋ก ์ ์
๋๋ค: ๋ชจ๋ธ์ ์ฌ๋์ด ์๋๋ผ ๊ณ ์ ๋ ๋ผ์ดํ์ฌ์ดํด ํฌ์ธํธ์์ ๋ฐ์ํฉ๋๋ค.
136 186
142 192
143์์ธํ ์์๋ณด๊ธฐ: [ํ
์์ํ๊ธฐ](/ko/hooks-guide) ยท [ํ
์ฐธ์กฐ](/ko/hooks)193์์ธํ ์์๋ณด๊ธฐ: [ํ
์์ํ๊ธฐ](/ko/hooks-guide) ยท [ํ
์ฐธ์กฐ](/ko/hooks)
144 194
145## M195<h2 id="m">
196 M
197</h2>
146 198
147### Managed settings199<h3 id="managed-settings">
200 Managed settings
201</h3>
148 202
149IT ๋๋ DevOps์ ์ํด ์กฐ์ง ์ ์ฒด์ ์ ์ฉ๋๋ ์ค์ ํ์ผ์ด๋ฉฐ, `~/.claude` ์ธ๋ถ์ OS ์์ค ๊ฒฝ๋ก์ ๋ฐฐ์น๋ฉ๋๋ค. ์ฌ์ฉ์๋ ๊ด๋ฆฌ ์ค์ ์ ์ฌ์ ์ํ๊ฑฐ๋ ์ ์ธํ ์ ์์ต๋๋ค. ๋ณด์ ์ ์ฑ
, ๊ท์ ์ค์ ์๊ตฌ ์ฌํญ ๋๋ ํ๋ฆฟ ์ ์ฒด์ ํ์คํ๋ ๋๊ตฌ์ ์ฌ์ฉํฉ๋๋ค.203IT ๋๋ DevOps์ ์ํด ์กฐ์ง ์ ์ฒด์ ์ ์ฉ๋๋ ์ค์ ํ์ผ์ด๋ฉฐ, `~/.claude` ์ธ๋ถ์ OS ์์ค ๊ฒฝ๋ก์ ๋ฐฐ์น๋ฉ๋๋ค. ์ฌ์ฉ์๋ ๊ด๋ฆฌ ์ค์ ์ ์ฌ์ ์ํ๊ฑฐ๋ ์ ์ธํ ์ ์์ต๋๋ค. ๋ณด์ ์ ์ฑ
, ๊ท์ ์ค์ ์๊ตฌ ์ฌํญ ๋๋ ํ๋ฆฟ ์ ์ฒด์ ํ์คํ๋ ๋๊ตฌ์ ์ฌ์ฉํฉ๋๋ค.
150 204
151์์ธํ ์์๋ณด๊ธฐ: [์๋ฒ ๊ด๋ฆฌ ์ค์ ](/ko/server-managed-settings)205์์ธํ ์์๋ณด๊ธฐ: [์๋ฒ ๊ด๋ฆฌ ์ค์ ](/ko/server-managed-settings)
152 206
153### MCP (Model Context Protocol)207<h3 id="mcp-model-context-protocol">
208 MCP (Model Context Protocol)
209</h3>
154 210
155AI ๋๊ตฌ๋ฅผ ์ธ๋ถ ๋ฐ์ดํฐ ์์ค ๋ฐ ์๋น์ค์ ์ฐ๊ฒฐํ๊ธฐ ์ํ ๊ฐ๋ฐฉํ ํ์ค์
๋๋ค. MCP ์๋ฒ๋ Claude์ Slack, Jira, ๋ฐ์ดํฐ๋ฒ ์ด์ค, ๋ธ๋ผ์ฐ์ ๋ฐ ์๋ฐฑ ๊ฐ์ ๋ค๋ฅธ ํตํฉ์ ์ํ ์๋ก์ด ๋๊ตฌ๋ฅผ ์ ๊ณตํฉ๋๋ค. `/mcp`๋ฅผ ํตํด ๋๋ `.mcp.json`์ ์ถ๊ฐํ์ฌ ์๋ฒ๋ฅผ ์ฐ๊ฒฐํฉ๋๋ค. ํ๋กํ ์ฝ ์์ฒด๋ [ํ๋ซํผ ์ฉ์ด์ง](https://platform.claude.com/docs/ko/about-claude/glossary#mcp-model-context-protocol)์ ์ฐธ์กฐํ์ญ์์ค.211AI ๋๊ตฌ๋ฅผ ์ธ๋ถ ๋ฐ์ดํฐ ์์ค ๋ฐ ์๋น์ค์ ์ฐ๊ฒฐํ๊ธฐ ์ํ ๊ฐ๋ฐฉํ ํ์ค์
๋๋ค. MCP ์๋ฒ๋ Claude์ Slack, Jira, ๋ฐ์ดํฐ๋ฒ ์ด์ค, ๋ธ๋ผ์ฐ์ ๋ฐ ์๋ฐฑ ๊ฐ์ ๋ค๋ฅธ ํตํฉ์ ์ํ ์๋ก์ด ๋๊ตฌ๋ฅผ ์ ๊ณตํฉ๋๋ค. `/mcp`๋ฅผ ํตํด ๋๋ `.mcp.json`์ ์ถ๊ฐํ์ฌ ์๋ฒ๋ฅผ ์ฐ๊ฒฐํฉ๋๋ค. ํ๋กํ ์ฝ ์์ฒด๋ [ํ๋ซํผ ์ฉ์ด์ง](https://platform.claude.com/docs/ko/about-claude/glossary#mcp-model-context-protocol)์ ์ฐธ์กฐํ์ญ์์ค.
156 212
157์์ธํ ์์๋ณด๊ธฐ: [Model Context Protocol](/ko/mcp)213์์ธํ ์์๋ณด๊ธฐ: [Model Context Protocol](/ko/mcp)
158 214
159### MCP Tool Search215<h3 id="mcp-tool-search">
216 MCP Tool Search
217</h3>
160 218
161ํ์ํ ๋๊น์ง MCP ๋๊ตฌ ์คํค๋ง๋ฅผ ์ฐ๊ธฐํ๋ ์ปจํ
์คํธ ์ ์ฝ ๋ฉ์ปค๋์ฆ์
๋๋ค. ์์ ์ ๋๊ตฌ ์ด๋ฆ๋ง ๋ก๋๋ฉ๋๋ค. Claude๋ ํน์ ๋๊ตฌ๋ฅผ ์ฌ์ฉํ๊ธฐ๋ก ๊ฒฐ์ ํ ๋ ์ ์ฒด ์คํค๋ง๋ฅผ ์์ฒญํฉ๋๋ค. ์ด๋ ๊ฒ ํ๋ฉด ์ ํด MCP ์๋ฒ๊ฐ ๋ง์ ์ปจํ
์คํธ๋ฅผ ์๋นํ์ง ์์ต๋๋ค.219ํ์ํ ๋๊น์ง MCP ๋๊ตฌ ์คํค๋ง๋ฅผ ์ฐ๊ธฐํ๋ ์ปจํ
์คํธ ์ ์ฝ ๋ฉ์ปค๋์ฆ์
๋๋ค. ์์ ์ ๋๊ตฌ ์ด๋ฆ๋ง ๋ก๋๋ฉ๋๋ค. Claude๋ ํน์ ๋๊ตฌ๋ฅผ ์ฌ์ฉํ๊ธฐ๋ก ๊ฒฐ์ ํ ๋ ์ ์ฒด ์คํค๋ง๋ฅผ ์์ฒญํฉ๋๋ค. ์ด๋ ๊ฒ ํ๋ฉด ์ ํด MCP ์๋ฒ๊ฐ ๋ง์ ์ปจํ
์คํธ๋ฅผ ์๋นํ์ง ์์ต๋๋ค.
162 220
163์์ธํ ์์๋ณด๊ธฐ: [MCP Tool Search๋ก ํ์ฅ](/ko/mcp#scale-with-mcp-tool-search)221์์ธํ ์์๋ณด๊ธฐ: [MCP Tool Search๋ก ํ์ฅ](/ko/mcp#scale-with-mcp-tool-search)
164 222
165## N223<h2 id="n">
224 N
225</h2>
166 226
167### Non-interactive mode227<h3 id="non-interactive-mode">
228 Non-interactive mode
229</h3>
168 230
169`-p` ๋๋ `--print`๋ก ํธ์ถ๋๋ ๋จ์ผ ํ๋กฌํํธ๋ฅผ ์คํํ๊ณ ๋ํํ ์ธ์
์์ด ์ข
๋ฃํ๋ ๋ชจ๋์
๋๋ค. CI, ์คํฌ๋ฆฝํธ ๋ฐ ํ์ดํ์ ์ฌ์ฉ๋ฉ๋๋ค. [Agent SDK](/ko/agent-sdk/overview)๋ Python ๋ฐ TypeScript ๋๋ฑ๋ฌผ์
๋๋ค. ์ด์ ์๋ headless mode๋ผ๊ณ ๋ถ๋ ธ์ต๋๋ค.231`-p` ๋๋ `--print`๋ก ํธ์ถ๋๋ ๋จ์ผ ํ๋กฌํํธ๋ฅผ ์คํํ๊ณ ๋ํํ ์ธ์
์์ด ์ข
๋ฃํ๋ ๋ชจ๋์
๋๋ค. CI, ์คํฌ๋ฆฝํธ ๋ฐ ํ์ดํ์ ์ฌ์ฉ๋ฉ๋๋ค. [Agent SDK](/ko/agent-sdk/overview)๋ Python ๋ฐ TypeScript ๋๋ฑ๋ฌผ์
๋๋ค. ์ด์ ์๋ headless mode๋ผ๊ณ ๋ถ๋ ธ์ต๋๋ค.
170 232
171์์ธํ ์์๋ณด๊ธฐ: [Claude Code๋ฅผ ํ๋ก๊ทธ๋๋ฐ ๋ฐฉ์์ผ๋ก ์คํ](/ko/headless)233์์ธํ ์์๋ณด๊ธฐ: [Claude Code๋ฅผ ํ๋ก๊ทธ๋๋ฐ ๋ฐฉ์์ผ๋ก ์คํ](/ko/headless)
172 234
173## O235<h2 id="o">
236 O
237</h2>
174 238
175### ์ถ๋ ฅ ์คํ์ผ239<h3 id="output-style">
240 Output style
241</h3>
176 242
177Claude์ ์์คํ
ํ๋กฌํํธ๋ฅผ ์์ ํ์ฌ ์๋ต ๋์, ํค ๋๋ ํ์์ ๋ณ๊ฒฝํ๋ ๊ตฌ์ฑ์
๋๋ค. ์ถ๋ ฅ ์คํ์ผ์ ์ฌ์ฉ์ ๋ฉ์์ง๋ก ์ ๋ฌ๋๋ [CLAUDE.md](#claude-md)์ ๋ฌ๋ฆฌ ๊ธฐ๋ณธ ์์คํ
ํ๋กฌํํธ์ ์ํํธ์จ์ด ์์ง๋์ด๋ง ๊ด๋ จ ๋ถ๋ถ์ ๋๋๋ค. ๊ธฐ๋ณธ ์ ๊ณต ์คํ์ผ์๋ Default, Proactive, Explanatory ๋ฐ Learning์ด ํฌํจ๋ฉ๋๋ค.243Claude์ ์์คํ
ํ๋กฌํํธ๋ฅผ ์์ ํ์ฌ ์๋ต ๋์, ํค ๋๋ ํ์์ ๋ณ๊ฒฝํ๋ ๊ตฌ์ฑ์
๋๋ค. ์ถ๋ ฅ ์คํ์ผ์ ์ฌ์ฉ์ ๋ฉ์์ง๋ก ์ ๋ฌ๋๋ [CLAUDE.md](#claude-md)์ ๋ฌ๋ฆฌ ๊ธฐ๋ณธ ์์คํ
ํ๋กฌํํธ์ ์ํํธ์จ์ด ์์ง๋์ด๋ง ๊ด๋ จ ๋ถ๋ถ์ ๋๋๋ค. ๊ธฐ๋ณธ ์ ๊ณต ์คํ์ผ์๋ Default, Proactive, Explanatory ๋ฐ Learning์ด ํฌํจ๋ฉ๋๋ค.
178 244
179์์ธํ ์์๋ณด๊ธฐ: [์ถ๋ ฅ ์คํ์ผ](/ko/output-styles)245์์ธํ ์์๋ณด๊ธฐ: [์ถ๋ ฅ ์คํ์ผ](/ko/output-styles)
180 246
181## P247<h2 id="p">
248 P
249</h2>
182 250
183### Permission mode251<h3 id="permission-mode">
252 Permission mode
253</h3>
184 254
185์ธ์
์ ๊ธฐ๋ณธ ์น์ธ ๋์์
๋๋ค. CLI์์ `Shift+Tab`์ผ๋ก ์ํํ๊ฑฐ๋ VS Code, Desktop ๋ฐ claude.ai์ ๋ชจ๋ ์ ํ๊ธฐ๋ฅผ ์ฌ์ฉํฉ๋๋ค. ์ฌ์ฉ ๊ฐ๋ฅํ ๋ชจ๋๋ `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` ๋ฐ `bypassPermissions`์
๋๋ค.255์ธ์
์ ๊ธฐ๋ณธ ์น์ธ ๋์์
๋๋ค. CLI์์ `Shift+Tab`์ผ๋ก ์ํํ๊ฑฐ๋ VS Code, Desktop ๋ฐ claude.ai์ ๋ชจ๋ ์ ํ๊ธฐ๋ฅผ ์ฌ์ฉํฉ๋๋ค. ์ฌ์ฉ ๊ฐ๋ฅํ ๋ชจ๋๋ `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` ๋ฐ `bypassPermissions`์
๋๋ค.
186 256
187์์ธํ ์์๋ณด๊ธฐ: [๊ถํ ๋ชจ๋ ์ ํ](/ko/permission-modes)257์์ธํ ์์๋ณด๊ธฐ: [๊ถํ ๋ชจ๋ ์ ํ](/ko/permission-modes)
188 258
189### Permission rule259<h3 id="permission-rule">
260 Permission rule
261</h3>
190 262
191๋๊ตฌ ์ด๋ฆ ๋ฐ ์ธ์ ํจํด์ ๊ธฐ๋ฐ์ผ๋ก ๋๊ตฌ ํธ์ถ์ ํ์ฉ, ์ง๋ฌธ ๋๋ ๊ฑฐ๋ถํ๋ ์ค์ ํญ๋ชฉ์
๋๋ค. ๊ท์น์ denyโaskโallow๋ก ํ๊ฐ๋๋ฉฐ, ์ฒซ ๋ฒ์งธ ์ผ์น๊ฐ ์ฐ์ ํฉ๋๋ค. ๊ถํ ๊ท์น์ ๋ ๊ด๋ฒ์ํ [๊ถํ ๋ชจ๋](#permission-mode) ์์ ๊ณ์ธตํ๋ ์ธ๋ฐํ ์ ์ด์
๋๋ค.263๋๊ตฌ ์ด๋ฆ ๋ฐ ์ธ์ ํจํด์ ๊ธฐ๋ฐ์ผ๋ก ๋๊ตฌ ํธ์ถ์ ํ์ฉ, ์ง๋ฌธ ๋๋ ๊ฑฐ๋ถํ๋ ์ค์ ํญ๋ชฉ์
๋๋ค. ๊ท์น์ denyโaskโallow๋ก ํ๊ฐ๋๋ฉฐ, ์ฒซ ๋ฒ์งธ ์ผ์น๊ฐ ์ฐ์ ํฉ๋๋ค. ๊ถํ ๊ท์น์ ๋ ๊ด๋ฒ์ํ [๊ถํ ๋ชจ๋](#permission-mode) ์์ ๊ณ์ธตํ๋ ์ธ๋ฐํ ์ ์ด์
๋๋ค.
192 264
193์์ธํ ์์๋ณด๊ธฐ: [๊ถํ ๊ตฌ์ฑ](/ko/permissions)265์์ธํ ์์๋ณด๊ธฐ: [๊ถํ ๊ตฌ์ฑ](/ko/permissions)
194 266
195### Plan mode267<h3 id="plan-mode">
268 Plan mode
269</h3>
196 270
197Claude๊ฐ ์์ค ํ์ผ์ ํธ์งํ์ง ์๊ณ ๋ณ๊ฒฝ ์ฌํญ์ ์ฐ๊ตฌํ๊ณ ์ ์ํ๋ [๊ถํ ๋ชจ๋](#permission-mode)์
๋๋ค. ์ฝ๊ณ , ๊ฒ์ํ๊ณ , ํ์ ๋ช
๋ น์ ์คํํ ์ ์์ผ๋ฉฐ, ์๋ฌด๊ฒ๋ ๊ฑด๋๋ฆฌ๊ธฐ ์ ์ ์น์ธ์ ์ํ ๊ณํ์ ์ ์ํฉ๋๋ค. `/plan`์ ์
๋ ฅํ๊ฑฐ๋ `Shift+Tab`์ ๋๋ฌ plan mode์ ๋ค์ด๊ฐ๋๋ค.271Claude๊ฐ ์์ค ํ์ผ์ ํธ์งํ์ง ์๊ณ ๋ณ๊ฒฝ ์ฌํญ์ ์ฐ๊ตฌํ๊ณ ์ ์ํ๋ [๊ถํ ๋ชจ๋](#permission-mode)์
๋๋ค. ์ฝ๊ณ , ๊ฒ์ํ๊ณ , ํ์ ๋ช
๋ น์ ์คํํ ์ ์์ผ๋ฉฐ, ์๋ฌด๊ฒ๋ ๊ฑด๋๋ฆฌ๊ธฐ ์ ์ ์น์ธ์ ์ํ ๊ณํ์ ์ ์ํฉ๋๋ค. `/plan`์ ์
๋ ฅํ๊ฑฐ๋ `Shift+Tab`์ ๋๋ฌ plan mode์ ๋ค์ด๊ฐ๋๋ค.
198 272
199์์ธํ ์์๋ณด๊ธฐ: [plan mode๋ก ํธ์ง ์ ์ ๋ถ์](/ko/permission-modes#analyze-before-you-edit-with-plan-mode)273์์ธํ ์์๋ณด๊ธฐ: [plan mode๋ก ํธ์ง ์ ์ ๋ถ์](/ko/permission-modes#analyze-before-you-edit-with-plan-mode)
200 274
201### Plugin275<h3 id="plugin">
276 Plugin
277</h3>
202 278
203์คํฌ, ํ
, ์๋ธ์์ด์ ํธ ๋ฐ MCP ์๋ฒ์ ๋ฒ๋ค์ด๋ฉฐ, ๋จ์ผ ์ค์น ๊ฐ๋ฅํ ๋จ์๋ก ํจํค์ง๋ฉ๋๋ค. ํ๋ฌ๊ทธ์ธ ์คํฌ์ `plugin-name:skill-name`์ผ๋ก ๋ค์์คํ์ด์ค๋๋ฏ๋ก ์ฌ๋ฌ ํ๋ฌ๊ทธ์ธ์ด ๊ณต์กดํฉ๋๋ค. [๋ง์ผํ๋ ์ด์ค](/ko/plugin-marketplaces)๋ฅผ ํตํด ํ ์ ์ฒด์ ํ๋ฌ๊ทธ์ธ์ ๋ฐฐํฌํฉ๋๋ค.279์คํฌ, ํ
, ์๋ธ์์ด์ ํธ ๋ฐ MCP ์๋ฒ์ ๋ฒ๋ค์ด๋ฉฐ, ๋จ์ผ ์ค์น ๊ฐ๋ฅํ ๋จ์๋ก ํจํค์ง๋ฉ๋๋ค. ํ๋ฌ๊ทธ์ธ ์คํฌ์ `plugin-name:skill-name`์ผ๋ก ๋ค์์คํ์ด์ค๋๋ฏ๋ก ์ฌ๋ฌ ํ๋ฌ๊ทธ์ธ์ด ๊ณต์กดํฉ๋๋ค. [๋ง์ผํ๋ ์ด์ค](/ko/plugin-marketplaces)๋ฅผ ํตํด ํ ์ ์ฒด์ ํ๋ฌ๊ทธ์ธ์ ๋ฐฐํฌํฉ๋๋ค.
204 280
205์์ธํ ์์๋ณด๊ธฐ: [ํ๋ฌ๊ทธ์ธ](/ko/plugins)281์์ธํ ์์๋ณด๊ธฐ: [ํ๋ฌ๊ทธ์ธ](/ko/plugins)
206 282
207### Project trust283<h3 id="project-trust">
284 Project trust
285</h3>
208 286
209Claude Code๊ฐ ๊ตฌ์ฑ์ ๋ก๋ํ๊ธฐ ์ ์ ๋๋ ํ ๋ฆฌ๋ฅผ ์๋ฝํ๋ ์ผํ์ฑ ๋ํ์
๋๋ค. ์๋ฝ์ ํ๋ก์ ํธ ๋๋ ํ ๋ฆฌ๋ณ๋ก ์ ์ฅ๋๋ฉฐ, ํ ๋๋ ํ ๋ฆฌ๋ ์ ์ธ๋๊ณ , ์ฌ๊ธฐ์ ์ ๋ขฐ๋ ํ์ฌ ์ธ์
์๋ง ์ ์ง๋๋ฉฐ ๊ฐ ์คํ ์ ํ๋กฌํํธ๊ฐ ๋ค์ ๋ํ๋ฉ๋๋ค. ์ ๋ขฐ๋ ๋ง์ผํ๋ ์ด์ค ํ๋ฌ๊ทธ์ธ์ ์๋ ์ค์น ๋ฐ ํ๋ก์ ํธ ์ ์ ํ
์ ์คํ์ ๊ฒ์ดํ
ํฉ๋๋ค. ๋๋ ํ ๋ฆฌ๋ฅผ ์ ๋ขฐํ๋ฉด `.claude/settings.json`, `.mcp.json` ๋ฐ ๊ธฐํ ๊ตฌ์ฑ ํ์ผ์ด ์ ์ฉ๋ฉ๋๋ค.287Claude Code๊ฐ ๊ตฌ์ฑ์ ๋ก๋ํ๊ธฐ ์ ์ ๋๋ ํ ๋ฆฌ๋ฅผ ์๋ฝํ๋ ์ผํ์ฑ ๋ํ์
๋๋ค. ์๋ฝ์ ํ๋ก์ ํธ ๋๋ ํ ๋ฆฌ๋ณ๋ก ์ ์ฅ๋๋ฉฐ, ํ ๋๋ ํ ๋ฆฌ๋ ์ ์ธ๋๊ณ , ์ฌ๊ธฐ์ ์ ๋ขฐ๋ ํ์ฌ ์ธ์
์๋ง ์ ์ง๋๋ฉฐ ๊ฐ ์คํ ์ ํ๋กฌํํธ๊ฐ ๋ค์ ๋ํ๋ฉ๋๋ค. ์ ๋ขฐ๋ ๋ง์ผํ๋ ์ด์ค ํ๋ฌ๊ทธ์ธ์ ์๋ ์ค์น ๋ฐ ํ๋ก์ ํธ ์ ์ ํ
์ ์คํ์ ๊ฒ์ดํ
ํฉ๋๋ค. ๋๋ ํ ๋ฆฌ๋ฅผ ์ ๋ขฐํ๋ฉด `.claude/settings.json`, `.mcp.json` ๋ฐ ๊ธฐํ ๊ตฌ์ฑ ํ์ผ์ด ์ ์ฉ๋ฉ๋๋ค.
210 288
211์์ธํ ์์๋ณด๊ธฐ: [`.claude` ๋๋ ํ ๋ฆฌ](/ko/claude-directory)289์์ธํ ์์๋ณด๊ธฐ: [`.claude` ๋๋ ํ ๋ฆฌ](/ko/claude-directory)
212 290
213### Prompt injection291<h3 id="prompt-injection">
292 Prompt injection
293</h3>
214 294
215ํ์ผ, ์น ํ์ด์ง ๋๋ ๋๊ตฌ ๊ฒฐ๊ณผ์ ํฌํจ๋ ์ ๋์ ์ง์นจ์ด๋ฉฐ, Claude๋ฅผ ์์ฒญํ์ง ์์ ์์
์ผ๋ก ๋ฆฌ๋๋ ์
ํ๋ ค๊ณ ์๋ํฉ๋๋ค. Claude Code์ ๋ฐฉ์ด์๋ ๊ถํ ์์คํ
, ๋ช
๋ น ์ฐจ๋จ ๋ชฉ๋ก ๋ฐ ์ ๋ขฐ ํ์ธ์ด ํฌํจ๋ฉ๋๋ค. [Auto mode](#auto-mode)๋ ๋๊ตฌ ๊ฒฐ๊ณผ์์ ์์ฌ์ค๋ฌ์ด ๋ด์ฉ์ ์ค์บํ๋ ์๋ฒ ์ธก ํ๋ก๋ธ์ ๋๊ตฌ ๊ฒฐ๊ณผ๋ฅผ ๋ณด์ง ์๋ ๋ถ๋ฅ๊ธฐ๋ฅผ ์ถ๊ฐํ๋ฏ๋ก ์ฃผ์
๋ ํ
์คํธ๊ฐ ์น์ธ ๊ฒฐ์ ์ ์ํฅ์ ๋ฏธ์น ์ ์์ต๋๋ค.295ํ์ผ, ์น ํ์ด์ง ๋๋ ๋๊ตฌ ๊ฒฐ๊ณผ์ ํฌํจ๋ ์ ๋์ ์ง์นจ์ด๋ฉฐ, Claude๋ฅผ ์์ฒญํ์ง ์์ ์์
์ผ๋ก ๋ฆฌ๋๋ ์
ํ๋ ค๊ณ ์๋ํฉ๋๋ค. Claude Code์ ๋ฐฉ์ด์๋ ๊ถํ ์์คํ
, ๋ช
๋ น ์ฐจ๋จ ๋ชฉ๋ก ๋ฐ ์ ๋ขฐ ํ์ธ์ด ํฌํจ๋ฉ๋๋ค. [Auto mode](#auto-mode)๋ ๋๊ตฌ ๊ฒฐ๊ณผ์์ ์์ฌ์ค๋ฌ์ด ๋ด์ฉ์ ์ค์บํ๋ ์๋ฒ ์ธก ํ๋ก๋ธ์ ๋๊ตฌ ๊ฒฐ๊ณผ๋ฅผ ๋ณด์ง ์๋ ๋ถ๋ฅ๊ธฐ๋ฅผ ์ถ๊ฐํ๋ฏ๋ก ์ฃผ์
๋ ํ
์คํธ๊ฐ ์น์ธ ๊ฒฐ์ ์ ์ํฅ์ ๋ฏธ์น ์ ์์ต๋๋ค.
216 296
217์์ธํ ์์๋ณด๊ธฐ: [ํ๋กฌํํธ ์ฃผ์
์ผ๋ก๋ถํฐ ๋ณดํธ](/ko/security#protect-against-prompt-injection)297์์ธํ ์์๋ณด๊ธฐ: [ํ๋กฌํํธ ์ฃผ์
์ผ๋ก๋ถํฐ ๋ณดํธ](/ko/security#protect-against-prompt-injection)
218 298
219## R299<h2 id="r">
300 R
301</h2>
220 302
221### Remote Control303<h3 id="remote-control">
304 Remote Control
305</h3>
222 306
223claude.ai๋ฅผ ํตํด ํด๋ํฐ ๋๋ ๋ธ๋ผ์ฐ์ ์์ ๋ก์ปฌ Claude Code ์ธ์
์ ๊ณ์ํ๋ ๋ฐฉ๋ฒ์
๋๋ค. ์ฝ๋๋ ๋จธ์ ์ ๋จ์ ์์ต๋๋ค. UI๋ง ์๊ฒฉ์
๋๋ค. ํด๋ผ์ฐ๋ ์๋๋ฐ์ค์์ ์คํ๋๋ ์น์ Claude Code์ ๋ค๋ฆ
๋๋ค.307claude.ai๋ฅผ ํตํด ํด๋ํฐ ๋๋ ๋ธ๋ผ์ฐ์ ์์ ๋ก์ปฌ Claude Code ์ธ์
์ ๊ณ์ํ๋ ๋ฐฉ๋ฒ์
๋๋ค. ์ฝ๋๋ ๋จธ์ ์ ๋จ์ ์์ต๋๋ค. UI๋ง ์๊ฒฉ์
๋๋ค. ํด๋ผ์ฐ๋ ์๋๋ฐ์ค์์ ์คํ๋๋ ์น์ Claude Code์ ๋ค๋ฆ
๋๋ค.
224 308
225์์ธํ ์์๋ณด๊ธฐ: [Remote Control](/ko/remote-control)309์์ธํ ์์๋ณด๊ธฐ: [Remote Control](/ko/remote-control)
226 310
227### Rules311<h3 id="rules">
312 Rules
313</h3>
228 314
229CLAUDE.md์ ํจ๊ป ๋ก๋๋๋ `.claude/rules/`์ ๋ชจ๋์ ์ง์นจ ํ์ผ์
๋๋ค. ๊ท์น์ YAML `paths:` frontmatter๋ก ๊ฒฝ๋ก ๋ฒ์๋ฅผ ์ง์ ํ ์ ์์ผ๋ฏ๋ก Claude๊ฐ ์ผ์นํ๋ ํ์ผ์ ์ฝ์ ๋๋ง ๋ก๋๋์ด ๊ด๋ จ๋ ๋๊น์ง ์ปจํ
์คํธ๋ฅผ ์ ์งํฉ๋๋ค.315CLAUDE.md์ ํจ๊ป ๋ก๋๋๋ `.claude/rules/`์ ๋ชจ๋์ ์ง์นจ ํ์ผ์
๋๋ค. ๊ท์น์ YAML `paths:` frontmatter๋ก ๊ฒฝ๋ก ๋ฒ์๋ฅผ ์ง์ ํ ์ ์์ผ๋ฏ๋ก Claude๊ฐ ์ผ์นํ๋ ํ์ผ์ ์ฝ์ ๋๋ง ๋ก๋๋์ด ๊ด๋ จ๋ ๋๊น์ง ์ปจํ
์คํธ๋ฅผ ์ ์งํฉ๋๋ค.
230 316
231์์ธํ ์์๋ณด๊ธฐ: [`.claude/rules/`๋ก ๊ท์น ๊ตฌ์ฑ](/ko/memory#organize-rules-with-claude/rules/)317์์ธํ ์์๋ณด๊ธฐ: [`.claude/rules/`๋ก ๊ท์น ๊ตฌ์ฑ](/ko/memory#organize-rules-with-claude/rules/)
232 318
233## S319<h2 id="s">
320 S
321</h2>
234 322
235### Sandboxing323<h3 id="sandboxing">
324 Sandboxing
325</h3>
236 326
237Bash ๋๊ตฌ์ ๋ํ OS ์์ค ํ์ผ ์์คํ
๋ฐ ๋คํธ์ํฌ ๊ฒฉ๋ฆฌ์
๋๋ค. ๋ช
๋ น์ ๋ฏธ๋ฆฌ ์ ์ํ ๊ฒฝ๊ณ ๋ด์์ ์คํ๋๋ฏ๋ก Claude๋ ๋ช
๋ น๋ณ ์น์ธ ํ๋กฌํํธ ์์ด ์์ ๋กญ๊ฒ ์์
ํ ์ ์์ต๋๋ค. ์๋๋ฐ์ฑ์ [๊ถํ ๊ท์น](#permission-rule)๊ณผ ๋ณ๊ฐ์ ๊ณ์ธต์
๋๋ค.327Bash ๋๊ตฌ์ ๋ํ OS ์์ค ํ์ผ ์์คํ
๋ฐ ๋คํธ์ํฌ ๊ฒฉ๋ฆฌ์
๋๋ค. ๋ช
๋ น์ ๋ฏธ๋ฆฌ ์ ์ํ ๊ฒฝ๊ณ ๋ด์์ ์คํ๋๋ฏ๋ก Claude๋ ๋ช
๋ น๋ณ ์น์ธ ํ๋กฌํํธ ์์ด ์์ ๋กญ๊ฒ ์์
ํ ์ ์์ต๋๋ค. ์๋๋ฐ์ฑ์ [๊ถํ ๊ท์น](#permission-rule)๊ณผ ๋ณ๊ฐ์ ๊ณ์ธต์
๋๋ค.
238 328
239์์ธํ ์์๋ณด๊ธฐ: [์๋๋ฐ์ฑ](/ko/sandboxing)329์์ธํ ์์๋ณด๊ธฐ: [์๋๋ฐ์ฑ](/ko/sandboxing)
240 330
241### Session331<h3 id="session">
332 Session
333</h3>
242 334
243ํ์ฌ ๋๋ ํ ๋ฆฌ์ ์ฐ๊ฒฐ๋ ๋ํ์ด๋ฉฐ, ์์ ์ ๋
๋ฆฝ์ ์ธ [์ปจํ
์คํธ ์๋์ฐ](#context-window)๋ฅผ ๊ฐ์ง๋๋ค. ์ธ์
์ `claude -c`๋ก ์ฌ๊ฐํ ์ ์๊ณ , `--fork-session`์ผ๋ก ํฌํฌํ์ฌ ์ ์ธ์
ID ์๋์ ๊ธฐ๋ก์ ๋ณด์กดํ๊ฑฐ๋, ํฐ๋ฏธ๋ ์ ์ฒด์์ ๋ณ๋ ฌ๋ก ์คํํ ์ ์์ต๋๋ค. `/clear`๋ฅผ ์คํํ๋ฉด ์ ์ธ์
์ด ์์๋ฉ๋๋ค. ์ด์ ์ธ์
์ ์ ์ฅ๋ ์ํ๋ก ์ ์ง๋๋ฉฐ `/resume`์ ํตํด ์ฌ์ฉ ๊ฐ๋ฅํฉ๋๋ค. ๊ฐ ์ธ์
์ ๊ธฐ๋ก์ `~/.claude/projects/` ์๋์ ์ ์ฅ๋ฉ๋๋ค.335ํ์ฌ ๋๋ ํ ๋ฆฌ์ ์ฐ๊ฒฐ๋ ๋ํ์ด๋ฉฐ, ์์ ์ ๋
๋ฆฝ์ ์ธ [์ปจํ
์คํธ ์๋์ฐ](#context-window)๋ฅผ ๊ฐ์ง๋๋ค. ์ธ์
์ `claude -c`๋ก ์ฌ๊ฐํ ์ ์๊ณ , `--fork-session`์ผ๋ก ํฌํฌํ์ฌ ์ ์ธ์
ID ์๋์ ๊ธฐ๋ก์ ๋ณด์กดํ๊ฑฐ๋, ํฐ๋ฏธ๋ ์ ์ฒด์์ ๋ณ๋ ฌ๋ก ์คํํ ์ ์์ต๋๋ค. `/clear`๋ฅผ ์คํํ๋ฉด ์ ์ธ์
์ด ์์๋ฉ๋๋ค. ์ด์ ์ธ์
์ ์ ์ฅ๋ ์ํ๋ก ์ ์ง๋๋ฉฐ `/resume`์ ํตํด ์ฌ์ฉ ๊ฐ๋ฅํฉ๋๋ค. ๊ฐ ์ธ์
์ ๊ธฐ๋ก์ `~/.claude/projects/` ์๋์ ์ ์ฅ๋ฉ๋๋ค.
244 336
245์์ธํ ์์๋ณด๊ธฐ: [์ธ์
์ผ๋ก ์์
](/ko/how-claude-code-works#work-with-sessions)337์์ธํ ์์๋ณด๊ธฐ: [์ธ์
์ผ๋ก ์์
](/ko/how-claude-code-works#work-with-sessions)
246 338
247### Settings layers339<h3 id="settings-layers">
340 Settings layers
341</h3>
248 342
249Claude Code๊ฐ ๊ตฌ์ฑ์ ์ฝ๋ ๊ณ์ธต ๊ตฌ์กฐ์ด๋ฉฐ, ์ฐ์ ์์ ์์๋ ๋์์์ ๋ฎ์์
๋๋ค: [๊ด๋ฆฌ ์ ์ฑ
](#managed-settings), ๋ช
๋ น์ค ์ธ์, `.claude/settings.local.json`์ ๋ก์ปฌ ์ค์ , `.claude/settings.json`์ ํ๋ก์ ํธ ์ค์ , ๊ทธ ๋ค์ `~/.claude/settings.json`์ ์ฌ์ฉ์ ์ค์ . ๋ฐฐ์ด์ ๊ณ์ธต ์ ์ฒด์์ ๋ณํฉ๋ฉ๋๋ค. ์ค์นผ๋ผ๋ ๋ ๋์ ๊ณ์ธต์์ ๋ ๋ฎ์ ๊ณ์ธต์ ์ฌ์ ์ํฉ๋๋ค.343Claude Code๊ฐ ๊ตฌ์ฑ์ ์ฝ๋ ๊ณ์ธต ๊ตฌ์กฐ์ด๋ฉฐ, ์ฐ์ ์์ ์์๋ ๋์์์ ๋ฎ์์
๋๋ค: [๊ด๋ฆฌ ์ ์ฑ
](#managed-settings), ๋ช
๋ น์ค ์ธ์, `.claude/settings.local.json`์ ๋ก์ปฌ ์ค์ , `.claude/settings.json`์ ํ๋ก์ ํธ ์ค์ , ๊ทธ ๋ค์ `~/.claude/settings.json`์ ์ฌ์ฉ์ ์ค์ . ๋ฐฐ์ด์ ๊ณ์ธต ์ ์ฒด์์ ๋ณํฉ๋ฉ๋๋ค. ์ค์นผ๋ผ๋ ๋ ๋์ ๊ณ์ธต์์ ๋ ๋ฎ์ ๊ณ์ธต์ ์ฌ์ ์ํฉ๋๋ค.
250 344
251์์ธํ ์์๋ณด๊ธฐ: [์ค์ ํ์ผ](/ko/settings#settings-files)345์์ธํ ์์๋ณด๊ธฐ: [์ค์ ํ์ผ](/ko/settings#settings-files)
252 346
253### Skill347<h3 id="skill">
348 Skill
349</h3>
254 350
255์ง์นจ, ์ง์ ๋๋ Claude๊ฐ ๋๊ตฌ ํคํธ์ ์ถ๊ฐํ๋ ์ํฌํ๋ก์ฐ๋ฅผ ํฌํจํ๋ `SKILL.md` ํ์ผ์
๋๋ค. Claude๋ ๊ด๋ จ์ด ์์ ๋ ์คํฌ์ ์๋์ผ๋ก ๋ก๋ํ๊ฑฐ๋ `/skill-name`์ผ๋ก ์ง์ ํธ์ถํฉ๋๋ค. ์คํฌ์ Agent Skills ๊ฐ๋ฐฉํ ํ์ค์ ๋ฐ๋ฆ
๋๋ค. Claude Code๋ ํธ์ถ ์ ์ด ๋ฐ ์๋ธ์์ด์ ํธ ์คํ์ผ๋ก ํ์ฅํฉ๋๋ค.351์ง์นจ, ์ง์ ๋๋ Claude๊ฐ ๋๊ตฌ ํคํธ์ ์ถ๊ฐํ๋ ์ํฌํ๋ก์ฐ๋ฅผ ํฌํจํ๋ `SKILL.md` ํ์ผ์
๋๋ค. Claude๋ ๊ด๋ จ์ด ์์ ๋ ์คํฌ์ ์๋์ผ๋ก ๋ก๋ํ๊ฑฐ๋ `/skill-name`์ผ๋ก ์ง์ ํธ์ถํฉ๋๋ค. ์คํฌ์ Agent Skills ๊ฐ๋ฐฉํ ํ์ค์ ๋ฐ๋ฆ
๋๋ค. Claude Code๋ ํธ์ถ ์ ์ด ๋ฐ ์๋ธ์์ด์ ํธ ์คํ์ผ๋ก ํ์ฅํฉ๋๋ค.
256 352
258 354
259์์ธํ ์์๋ณด๊ธฐ: [์คํฌ๋ก Claude ํ์ฅ](/ko/skills)355์์ธํ ์์๋ณด๊ธฐ: [์คํฌ๋ก Claude ํ์ฅ](/ko/skills)
260 356
261### Subagent357<h3 id="subagent">
358 Subagent
359</h3>
262 360
263์์ ์ ์ปจํ
์คํธ ์๋์ฐ, ์ฌ์ฉ์ ์ ์ ์์คํ
ํ๋กฌํํธ, ํน์ ๋๊ตฌ ์ก์ธ์ค ๋ฐ ๋
๋ฆฝ์ ์ธ ๊ถํ์ผ๋ก ์คํ๋๋ ํนํ๋ AI ์ด์์คํดํธ์
๋๋ค. ์์๋ ์์
์ ์ํํ๊ณ ์ฃผ ๋ํ์ ์์ฝ์ ๋ฐํํฉ๋๋ค. ์๋ธ์์ด์ ํธ๋ฅผ ์ฌ์ฉํ์ฌ ํฐ ํ์์ ๊ธฐ๋ณธ ์ปจํ
์คํธ ๋ฐ์ผ๋ก ์ ์งํ๊ฑฐ๋ ๋ณ๋ ฌ ์ฐ๊ตฌ๋ฅผ ์คํํฉ๋๋ค. ๊ฐ ์์ด์ ํธ๊ฐ ์ง์ ๋ํํ ์ ์๋ ์์ ํ ๋
๋ฆฝ์ ์ธ ์ธ์
์ธ [agent teams](#agent-teams)์ ๋ค๋ฆ
๋๋ค.361์์ ์ ์ปจํ
์คํธ ์๋์ฐ, ์ฌ์ฉ์ ์ ์ ์์คํ
ํ๋กฌํํธ, ํน์ ๋๊ตฌ ์ก์ธ์ค ๋ฐ ๋
๋ฆฝ์ ์ธ ๊ถํ์ผ๋ก ์คํ๋๋ ํนํ๋ AI ์ด์์คํดํธ์
๋๋ค. ์์๋ ์์
์ ์ํํ๊ณ ์ฃผ ๋ํ์ ์์ฝ์ ๋ฐํํฉ๋๋ค. ์๋ธ์์ด์ ํธ๋ฅผ ์ฌ์ฉํ์ฌ ํฐ ํ์์ ๊ธฐ๋ณธ ์ปจํ
์คํธ ๋ฐ์ผ๋ก ์ ์งํ๊ฑฐ๋ ๋ณ๋ ฌ ์ฐ๊ตฌ๋ฅผ ์คํํฉ๋๋ค. ๊ฐ ์์ด์ ํธ๊ฐ ์ง์ ๋ํํ ์ ์๋ ์์ ํ ๋
๋ฆฝ์ ์ธ ์ธ์
์ธ [agent teams](#agent-teams)์ ๋ค๋ฆ
๋๋ค.
264 362
266 364
267์์ธํ ์์๋ณด๊ธฐ: [์ฌ์ฉ์ ์ ์ ์๋ธ์์ด์ ํธ ์์ฑ](/ko/sub-agents)365์์ธํ ์์๋ณด๊ธฐ: [์ฌ์ฉ์ ์ ์ ์๋ธ์์ด์ ํธ ์์ฑ](/ko/sub-agents)
268 366
269### Surface367<h3 id="surface">
368 Surface
369</h3>
270 370
271Claude Code์ ์ก์ธ์คํ๋ ๋ชจ๋ ์ฅ์์
๋๋ค: CLI, VS Code, JetBrains, Desktop ๋๋ claude.ai. ๋ชจ๋ ํ๋ฉด์ ๋์ผํ ์์ง์ ๊ณต์ ํ๋ฏ๋ก CLAUDE.md, ์ค์ ๋ฐ ์คํฌ์ด ๋ชจ๋ ํ๋ฉด์์ ๋์ผํ๊ฒ ์๋ํฉ๋๋ค. Slack ๋ฐ Chrome ํ์ฅ ํ๋ก๊ทธ๋จ์ ํ๋ฉด ์์ฒด๊ฐ ์๋๋ผ ํ๋ฉด์ ์ฐ๊ฒฐํ๋ ํตํฉ์
๋๋ค.371Claude Code์ ์ก์ธ์คํ๋ ๋ชจ๋ ์ฅ์์
๋๋ค: CLI, VS Code, JetBrains, Desktop ๋๋ claude.ai. ๋ชจ๋ ํ๋ฉด์ ๋์ผํ ์์ง์ ๊ณต์ ํ๋ฏ๋ก CLAUDE.md, ์ค์ ๋ฐ ์คํฌ์ด ๋ชจ๋ ํ๋ฉด์์ ๋์ผํ๊ฒ ์๋ํฉ๋๋ค. Slack ๋ฐ Chrome ํ์ฅ ํ๋ก๊ทธ๋จ์ ํ๋ฉด ์์ฒด๊ฐ ์๋๋ผ ํ๋ฉด์ ์ฐ๊ฒฐํ๋ ํตํฉ์
๋๋ค.
272 372
273์์ธํ ์์๋ณด๊ธฐ: [ํ๋ซํผ ๋ฐ ํตํฉ](/ko/platforms)373์์ธํ ์์๋ณด๊ธฐ: [ํ๋ซํผ ๋ฐ ํตํฉ](/ko/platforms)
274 374
275## T375<h2 id="t">
376 T
377</h2>
276 378
277### Teleport379<h3 id="teleport">
380 Teleport
381</h3>
278 382
279ํด๋ผ์ฐ๋ Claude Code ์ธ์
์ ๋ก์ปฌ ํฐ๋ฏธ๋๋ก ๊ฐ์ ธ์ค๋ ๋ช
๋ น `/teleport`์
๋๋ค. Claude๋ ๋ถ๊ธฐ๋ฅผ ๊ฐ์ ธ์ค๊ณ , ๋ํ ๊ธฐ๋ก์ ๋ก๋ํ๊ณ , ์น ์ธ์
์ ๋ง์ง๋ง ์ํ์์ ์ฌ๊ฐํฉ๋๋ค. ์ญ๋ฐฉํฅ์ `--remote`์ด๋ฉฐ, ๋ก์ปฌ ์์
์ ์น์์ ์คํํ๋๋ก ๋ณด๋
๋๋ค.383ํด๋ผ์ฐ๋ Claude Code ์ธ์
์ ๋ก์ปฌ ํฐ๋ฏธ๋๋ก ๊ฐ์ ธ์ค๋ ๋ช
๋ น `/teleport`์
๋๋ค. Claude๋ ๋ถ๊ธฐ๋ฅผ ๊ฐ์ ธ์ค๊ณ , ๋ํ ๊ธฐ๋ก์ ๋ก๋ํ๊ณ , ์น ์ธ์
์ ๋ง์ง๋ง ์ํ์์ ์ฌ๊ฐํฉ๋๋ค. ์ญ๋ฐฉํฅ์ `--remote`์ด๋ฉฐ, ๋ก์ปฌ ์์
์ ์น์์ ์คํํ๋๋ก ๋ณด๋
๋๋ค.
280 384
281์์ธํ ์์๋ณด๊ธฐ: [์น์์ ํฐ๋ฏธ๋๋ก](/ko/claude-code-on-the-web#from-web-to-terminal)385์์ธํ ์์๋ณด๊ธฐ: [์น์์ ํฐ๋ฏธ๋๋ก](/ko/claude-code-on-the-web#from-web-to-terminal)
282 386
283### Tool387<h3 id="tool">
388 Tool
389</h3>
284 390
285Claude๊ฐ ์ํํ ์ ์๋ ์์
์
๋๋ค: ํ์ผ ์ฝ๊ธฐ, ์ฝ๋ ํธ์ง, ์
ธ ๋ช
๋ น ์คํ, ์น ๊ฒ์, ์๋ธ์์ด์ ํธ ์์ฑ. ๋๊ตฌ๋ Claude Code๋ฅผ ์์ด์ ํธ๋ก ๋ง๋๋ ๊ฒ์
๋๋ค. ๋๊ตฌ ์์ด Claude๋ ํ
์คํธ๋ก๋ง ์๋ตํ ์ ์์ต๋๋ค. ๊ฐ ๋๊ตฌ ์ฌ์ฉ์ [์์ด์ ํธ ๋ฃจํ](#agentic-loop)์์ Claude์ ๋ค์ ๊ฒฐ์ ์ ์๋ ค์ฃผ๋ ๊ฒฐ๊ณผ๋ฅผ ๋ฐํํฉ๋๋ค.391Claude๊ฐ ์ํํ ์ ์๋ ์์
์
๋๋ค: ํ์ผ ์ฝ๊ธฐ, ์ฝ๋ ํธ์ง, ์
ธ ๋ช
๋ น ์คํ, ์น ๊ฒ์, ์๋ธ์์ด์ ํธ ์์ฑ. ๋๊ตฌ๋ Claude Code๋ฅผ ์์ด์ ํธ๋ก ๋ง๋๋ ๊ฒ์
๋๋ค. ๋๊ตฌ ์์ด Claude๋ ํ
์คํธ๋ก๋ง ์๋ตํ ์ ์์ต๋๋ค. ๊ฐ ๋๊ตฌ ์ฌ์ฉ์ [์์ด์ ํธ ๋ฃจํ](#agentic-loop)์์ Claude์ ๋ค์ ๊ฒฐ์ ์ ์๋ ค์ฃผ๋ ๊ฒฐ๊ณผ๋ฅผ ๋ฐํํฉ๋๋ค.
286 392
287์์ธํ ์์๋ณด๊ธฐ: [Claude์์ ์ฌ์ฉ ๊ฐ๋ฅํ ๋๊ตฌ](/ko/tools-reference)393์์ธํ ์์๋ณด๊ธฐ: [Claude์์ ์ฌ์ฉ ๊ฐ๋ฅํ ๋๊ตฌ](/ko/tools-reference)
288 394
289### Turn395<h3 id="turn">
396 Turn
397</h3>
290 398
291[์ธ์
](#session) ๋ด์์ Claude์ ํ ๋ฒ์ ์์ ํ ์๋ต์
๋๋ค. ํด์ ๋ฉ์์ง๋ฅผ ๋ณด๋ผ ๋ ์์๋๊ณ Claude๊ฐ ์๋ต์ ๋ง์น ๋ ๋๋๋ฉฐ, ๊ทธ ์ฌ์ด์ ์ฌ๋ฌ ๊ฐ์ [๋๊ตฌ](#tool) ํธ์ถ์ด ์์ ์ ์์ต๋๋ค. [Stop ํ
](#hook)์ ๊ฐ ํด์ ๋์์ ์คํ๋ฉ๋๋ค. ์ธ์
์ ๋ง์ ํด์ผ๋ก ๊ตฌ์ฑ๋๋ฉฐ, [์์ด์ ํธ ๋ฃจํ](#agentic-loop)๋ ํ ํด ๋ด์์ ์ผ์ด๋๋ ์ผ์ ์ค๋ช
ํฉ๋๋ค.399[์ธ์
](#session) ๋ด์์ Claude์ ํ ๋ฒ์ ์์ ํ ์๋ต์
๋๋ค. ํด์ ๋ฉ์์ง๋ฅผ ๋ณด๋ผ ๋ ์์๋๊ณ Claude๊ฐ ์๋ต์ ๋ง์น ๋ ๋๋๋ฉฐ, ๊ทธ ์ฌ์ด์ ์ฌ๋ฌ ๊ฐ์ [๋๊ตฌ](#tool) ํธ์ถ์ด ์์ ์ ์์ต๋๋ค. [Stop ํ
](#hook)์ ๊ฐ ํด์ ๋์์ ์คํ๋ฉ๋๋ค. ์ธ์
์ ๋ง์ ํด์ผ๋ก ๊ตฌ์ฑ๋๋ฉฐ, [์์ด์ ํธ ๋ฃจํ](#agentic-loop)๋ ํ ํด ๋ด์์ ์ผ์ด๋๋ ์ผ์ ์ค๋ช
ํฉ๋๋ค.
292 400
293์์ธํ ์์๋ณด๊ธฐ: [Claude Code ์๋ ๋ฐฉ์](/ko/how-claude-code-works#the-agentic-loop)401์์ธํ ์์๋ณด๊ธฐ: [Claude Code ์๋ ๋ฐฉ์](/ko/how-claude-code-works#the-agentic-loop)
294 402
295## W403<h2 id="v">
404 V
405</h2>
296 406
297### Worktree isolation407<h3 id="verification-loop">
408 Verification loop
409</h3>
410
411์ธ์
์ด ์์
์ด ์ค์ ๋ก ์๋ฃ๋์๋์ง ์๋๋ฉด ๊ทธ๋ด๋ฏํ์ง๋ง ์ ์ ์๋ ๋ฐฉ๋ฒ์
๋๋ค. ํ
์คํธ ์ค์ํธ, ๋น๋ ๋๋ ์คํฌ๋ฆฐ์ท ๋น๊ต์ ๊ฐ์ด Claude๊ฐ ์คํํ ์ ์๋ ๊ฒ์ฌ๋ฅผ ์ ๊ณตํ๊ณ , Claude๋ ํ ๋ฒ์ ์๋ ํ ์ค๋จํ๋ ๋์ ๊ฒ์ฌ๊ฐ ํต๊ณผํ ๋๊น์ง ๋ฐ๋ณตํฉ๋๋ค. ๊ฒ์ฆ ๋ฃจํ๋ [`/goal`](/ko/goal), ๋ฌด์ธ ์คํ ๋ฐ [๋์ ์ํฌํ๋ก์ฐ](/ko/workflows)์ ์ ์ ์กฐ๊ฑด์
๋๋ค: ๊ฒ์ฆ ๋ฃจํ ์์ด๋ ์์ด์ ํธ๊ฐ ์๋ฃ๋์๋ค๊ณ ๊ฒฐ์ ํ๋ ์ ์ผํ ๊ฒ์ ์์ด์ ํธ ์์ฒด์
๋๋ค.
412
413์์ธํ ์์๋ณด๊ธฐ: [Claude์ ์์
ํ์ธ ๋ฐฉ๋ฒ ์ ๊ณต](/ko/best-practices#give-claude-a-way-to-verify-its-work)
414
415<h2 id="w">
416 W
417</h2>
418
419<h3 id="worktree-isolation">
420 Worktree isolation
421</h3>
298 422
299`.claude/worktrees/` ์๋์ ๋ณ๋ git worktree์์ Claude๋ฅผ ์คํํ๋ ๊ฒฉ๋ฆฌ ๋ชจ๋์ด๋ฉฐ, `-w` ํ๋๊ทธ ๋๋ ์๋ธ์์ด์ ํธ ๊ตฌ์ฑ์ `isolation: worktree`๋ก ํ์ฑํ๋ฉ๋๋ค. ๋ณ๊ฒฝ ์ฌํญ์ ๋ณ๋ ๋๋ ํ ๋ฆฌ์ ๋ณ๋ ๋ถ๊ธฐ์ ๋จ์ ์์ผ๋ฏ๋ก ๋ณ๋ ฌ ์์ด์ ํธ๊ฐ ์๋ก์ ํ์ผ์ ๋ฎ์ด์ฐ์ง ์์ต๋๋ค.423`.claude/worktrees/` ์๋์ ๋ณ๋ git worktree์์ Claude๋ฅผ ์คํํ๋ ๊ฒฉ๋ฆฌ ๋ชจ๋์ด๋ฉฐ, `-w` ํ๋๊ทธ ๋๋ ์๋ธ์์ด์ ํธ ๊ตฌ์ฑ์ `isolation: worktree`๋ก ํ์ฑํ๋ฉ๋๋ค. ๋ณ๊ฒฝ ์ฌํญ์ ๋ณ๋ ๋๋ ํ ๋ฆฌ์ ๋ณ๋ ๋ถ๊ธฐ์ ๋จ์ ์์ผ๋ฏ๋ก ๋ณ๋ ฌ ์์ด์ ํธ๊ฐ ์๋ก์ ํ์ผ์ ๋ฎ์ด์ฐ์ง ์์ต๋๋ค.
300 424
302 426
303***427***
304 428
305## ๋ ์ด์ ์ฌ์ฉ๋์ง ์๋ ์ฉ์ด ๋ฐ ์ด๋ฆ์ด ๋ณ๊ฒฝ๋ ์ฉ์ด429<h2 id="deprecated-and-renamed-terms">
430 ๋ ์ด์ ์ฌ์ฉ๋์ง ์๋ ์ฉ์ด ๋ฐ ์ด๋ฆ์ด ๋ณ๊ฒฝ๋ ์ฉ์ด
431</h2>
306 432
307์ด ์ฉ์ด๋ ์ด์ ๋ฌธ์, ๋ธ๋ก๊ทธ ๊ฒ์๋ฌผ ๋ฐ ์ปค๋ฎค๋ํฐ ์ฝํ
์ธ ์ ๋ํ๋ฉ๋๋ค. ์ด ์ฌ์ดํธ๋ฅผ ๊ฒ์ํ ๋ ํ์ฌ ์ด๋ฆ์ ์ฌ์ฉํฉ๋๋ค.433์ด ์ฉ์ด๋ ์ด์ ๋ฌธ์, ๋ธ๋ก๊ทธ ๊ฒ์๋ฌผ ๋ฐ ์ปค๋ฎค๋ํฐ ์ฝํ
์ธ ์ ๋ํ๋ฉ๋๋ค. ์ด ์ฌ์ดํธ๋ฅผ ๊ฒ์ํ ๋ ํ์ฌ ์ด๋ฆ์ ์ฌ์ฉํฉ๋๋ค.
308 434