14 14
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).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).
16 16
17자세히 알아보기: [AGENTS.md](/docs/ko/memory#agents-md)17자세히 알아보기: [AGENTS.md](/docs/ko/memory.md#agents-md)
18 18
19### Agent teams19### Agent teams
20 20
21여러 개의 독립적인 Claude Code 세션이 팀 리더에 의해 조정되며, 공유 작업 목록과 피어 투 피어 메시징을 갖춘 구성입니다. 단일 세션 내에서 실행되고 부모에게만 보고하는 [서브에이전트](#subagent)와 달리, 팀원들은 각각 자신의 컨텍스트 윈도우를 가지며 어느 팀원과도 직접 상호작용할 수 있습니다. Agent teams는 실험적이며 비활성화되어 있습니다. [에이전트 팀 활성화](/docs/ko/agent-teams#enable-agent-teams)를 참조하세요.21여러 개의 독립적인 Claude Code 세션이 팀 리더에 의해 조정되며, 공유 작업 목록과 피어 투 피어 메시징을 갖춘 구성입니다. 단일 세션 내에서 실행되고 부모에게만 보고하는 [서브에이전트](#subagent)와 달리, 팀원들은 각각 자신의 컨텍스트 윈도우를 가지며 어느 팀원과도 직접 상호작용할 수 있습니다. Agent teams는 실험적이며 비활성화되어 있습니다. [에이전트 팀 활성화](/docs/ko/agent-teams.md#enable-agent-teams)를 참조하세요.
22 22
23자세히 알아보기: [에이전트 팀 실행](/docs/ko/agent-teams)23자세히 알아보기: [에이전트 팀 실행](/docs/ko/agent-teams.md)
24 24
25### Agentic coding25### Agentic coding
26 26
27AI가 파일을 읽고, 명령을 실행하고, 변경 사항을 자율적으로 만들 수 있는 워크플로우입니다. 사용자가 직접 적용해야 하는 텍스트만 응답하는 채팅 기반 어시스턴트와 달리, 사용자가 지켜보거나, 리디렉션하거나, 떠날 수 있습니다. Claude Code는 조언만 하는 것이 아니라 행동할 수 있게 해주는 [도구](#tool)를 가지고 있기 때문에 에이전트입니다.27AI가 파일을 읽고, 명령을 실행하고, 변경 사항을 자율적으로 만들 수 있는 워크플로우입니다. 사용자가 직접 적용해야 하는 텍스트만 응답하는 채팅 기반 어시스턴트와 달리, 사용자가 지켜보거나, 리디렉션하거나, 떠날 수 있습니다. Claude Code는 조언만 하는 것이 아니라 행동할 수 있게 해주는 [도구](#tool)를 가지고 있기 때문에 에이전트입니다.
28 28
29자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works)29자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works.md)
30 30
31### Agentic harness31### Agentic harness
32 32
33언어 모델을 능력 있는 코딩 에이전트로 변환하는 도구, 컨텍스트 관리 및 실행 환경입니다. Claude Code는 하네스이고, Claude는 그 안의 모델입니다. 하네스는 파일 액세스, 셸 실행, 권한 게이팅, 메모리 로딩 및 작업을 함께 연결하는 루프를 제공합니다.33언어 모델을 능력 있는 코딩 에이전트로 변환하는 도구, 컨텍스트 관리 및 실행 환경입니다. Claude Code는 하네스이고, Claude는 그 안의 모델입니다. 하네스는 파일 액세스, 셸 실행, 권한 게이팅, 메모리 로딩 및 작업을 함께 연결하는 루프를 제공합니다.
34 34
35자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works)35자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works.md)
36 36
37### Agentic loop37### Agentic loop
38 38
39Claude가 모든 작업을 수행하는 사이클입니다: 컨텍스트 수집, 작업 수행, 결과 확인 및 완료될 때까지 반복합니다. 각 도구 사용은 다음 단계를 알려주는 정보를 반환합니다. 언제든지 루프를 중단하여 리디렉션할 수 있습니다. [훅](#hook), [스킬](#skill), [MCP](#mcp-model-context-protocol)을 포함한 대부분의 확장 포인트는 이 루프의 특정 단계에 연결됩니다.39Claude가 모든 작업을 수행하는 사이클입니다: 컨텍스트 수집, 작업 수행, 결과 확인 및 완료될 때까지 반복합니다. 각 도구 사용은 다음 단계를 알려주는 정보를 반환합니다. 언제든지 루프를 중단하여 리디렉션할 수 있습니다. [훅](#hook), [스킬](#skill), [MCP](#mcp-model-context-protocol)을 포함한 대부분의 확장 포인트는 이 루프의 특정 단계에 연결됩니다.
40 40
41자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works#the-agentic-loop)41자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works.md#the-agentic-loop)
42 42
43### Artifact43### Artifact
44 44
45Claude 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.md#share-an-artifact)를 참조하세요.
46 46
47자세히 알아보기: [세션 출력을 Artifact로 공유](/docs/ko/artifacts)47자세히 알아보기: [세션 출력을 Artifact로 공유](/docs/ko/artifacts.md)
48 48
49### Auto memory49### Auto memory
50 50
51Claude가 사용자의 수정 및 선호도를 기반으로 자신을 위해 작성한 노트이며, `~/.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 작성 대응물입니다.
52 52
53자세히 알아보기: [Auto memory](/docs/ko/memory#auto-memory)53자세히 알아보기: [Auto memory](/docs/ko/memory.md#auto-memory)
54 54
55### Auto mode55### Auto mode
56 56
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)을 차단합니다. 도구 결과는 분류기가 보는 것에서 제거되므로, 파일이나 웹 페이지의 악의적인 콘텐츠가 직접 조작할 수 없습니다.57백그라운드에서 별도의 분류기 모델이 각 작업을 검토하는 [권한 모드](#permission-mode)이므로, Claude Code는 대부분의 작업을 사용자에게 묻지 않고 실행합니다. Claude Code는 여전히 명시적 요청 규칙과 일치하는 작업 전에 사용자에게 묻습니다. Claude Code v2.1.283 이상에서 auto mode는 대화형 터미널 및 VS Code 세션의 [기본 시작 권한 모드](/docs/ko/permission-modes.md#which-mode-a-session-starts-in)이며, 이전 버전에서는 Pro, Max 및 Team 플랜에서만 사용됩니다. 분류기는 범위 확대, 신뢰할 수 없는 인프라 및 [프롬프트 주입](#prompt-injection)을 차단합니다. 도구 결과는 분류기가 보는 것에서 제거되므로, 파일이나 웹 페이지의 악의적인 콘텐츠가 직접 조작할 수 없습니다.
58 58
59자세히 알아보기: [Auto mode로 프롬프트 제거](/docs/ko/permission-modes#eliminate-prompts-with-auto-mode)59자세히 알아보기: [Auto mode로 프롬프트 제거](/docs/ko/permission-modes.md#eliminate-prompts-with-auto-mode)
60 60
61## B61## B
62 62
64 64
65`--bare`를 사용하면 Claude Code는 `--add-dir`으로 전달하는 디렉터리의 스킬을 제외하고 훅, 스킬, 사용자 정의 명령, 서브에이전트, 설치된 플러그인, MCP 서버, auto memory 또는 CLAUDE.md를 로드하지 않고 시작합니다. CI 및 스크립트된 호출에 권장되며, 모든 머신에서 동일한 결과가 필요한 경우에 사용합니다.65`--bare`를 사용하면 Claude Code는 `--add-dir`으로 전달하는 디렉터리의 스킬을 제외하고 훅, 스킬, 사용자 정의 명령, 서브에이전트, 설치된 플러그인, MCP 서버, auto memory 또는 CLAUDE.md를 로드하지 않고 시작합니다. CI 및 스크립트된 호출에 권장되며, 모든 머신에서 동일한 결과가 필요한 경우에 사용합니다.
66 66
67자세히 알아보기: [bare mode로 더 빠르게 시작](/docs/ko/headless#start-faster-with-bare-mode)67자세히 알아보기: [bare mode로 더 빠르게 시작](/docs/ko/headless.md#start-faster-with-bare-mode)
68 68
69### Bundled skills69### Bundled skills
70 70
71Claude Code에 포함된 프롬프트 기반 플레이북입니다. `/batch`, `/code-review`, `/debug`, `/loop` 등이 있습니다. 고정 로직을 실행하는 기본 제공 명령과 달리, 번들 스킬은 Claude에 상세한 프롬프트를 제공하고 작업을 조율하도록 하므로 에이전트를 생성하고, 파일을 읽고, 코드베이스에 적응할 수 있습니다.71Claude Code에 포함된 프롬프트 기반 플레이북입니다. `/batch`, `/code-review`, `/debug`, `/loop` 등이 있습니다. 고정 로직을 실행하는 기본 제공 명령과 달리, 번들 스킬은 Claude에 상세한 프롬프트를 제공하고 작업을 조율하도록 하므로 에이전트를 생성하고, 파일을 읽고, 코드베이스에 적응할 수 있습니다.
72 72
73자세히 알아보기: [번들 스킬](/docs/ko/skills#bundled-skills)73자세히 알아보기: [번들 스킬](/docs/ko/skills.md#bundled-skills)
74 74
75## C75## C
76 76
78 78
79실행 중인 세션에 이벤트를 푸시하는 [MCP 서버](#mcp-model-context-protocol)이므로 Claude는 터미널에서 떨어져 있을 때 발생하는 일에 반응할 수 있습니다. 채널은 양방향일 수 있습니다: Claude는 인바운드 이벤트를 읽고 동일한 채널을 통해 다시 응답합니다. Telegram, Discord 및 iMessage는 연구 미리보기에 포함됩니다.79실행 중인 세션에 이벤트를 푸시하는 [MCP 서버](#mcp-model-context-protocol)이므로 Claude는 터미널에서 떨어져 있을 때 발생하는 일에 반응할 수 있습니다. 채널은 양방향일 수 있습니다: Claude는 인바운드 이벤트를 읽고 동일한 채널을 통해 다시 응답합니다. Telegram, Discord 및 iMessage는 연구 미리보기에 포함됩니다.
80 80
81자세히 알아보기: [채널](/docs/ko/channels)81자세히 알아보기: [채널](/docs/ko/channels.md)
82 82
83### Checkpoint83### Checkpoint
84 84
85각 프롬프트를 전송할 때마다 생성되는 복원 지점입니다. Claude Code는 모든 편집 전에 파일을 스냅샷하므로 체크포인트가 파일을 되돌릴 수 있습니다. `Esc`를 두 번 누르거나 `/rewind`를 실행하여 코드, 대화 또는 둘 다를 이전 지점으로 복원하거나, 선택한 메시지에서 대화의 일부를 요약합니다. 체크포인트는 세션에 저장되므로 재개된 세션도 여전히 `/rewind`를 사용하여 이들로 돌아갈 수 있습니다. 이들은 git과 별개이며 Bash 도구를 통해 수행된 변경 사항을 추적하지 않습니다.85각 프롬프트를 전송할 때마다 생성되는 복원 지점입니다. Claude Code는 모든 편집 전에 파일을 스냅샷하므로 체크포인트가 파일을 되돌릴 수 있습니다. `Esc`를 두 번 누르거나 `/rewind`를 실행하여 코드, 대화 또는 둘 다를 이전 지점으로 복원하거나, 선택한 메시지에서 대화의 일부를 요약합니다. 체크포인트는 세션에 저장되므로 재개된 세션도 여전히 `/rewind`를 사용하여 이들로 돌아갈 수 있습니다. 이들은 git과 별개이며 Bash 도구를 통해 수행된 변경 사항을 추적하지 않습니다.
86 86
87자세히 알아보기: [체크포인팅](/docs/ko/checkpointing)87자세히 알아보기: [체크포인팅](/docs/ko/checkpointing.md)
88 88
89### `.claude` directory89### `.claude` directory
90 90
98 98
99CLAUDE.md를 프로젝트 범위에서 `./CLAUDE.md` 또는 `./.claude/CLAUDE.md`에, 사용자 범위에서 `~/.claude/CLAUDE.md`에, 또는 조직의 [관리형 정책](#managed-settings)으로 배치할 수 있습니다. 발견된 모든 파일은 서로를 재정의하지 않고 컨텍스트에 연결되며, 가장 광범위한 범위에서 가장 구체적인 범위로 정렬됩니다. Claude Code는 또한 CLAUDE.md 대신 프로젝트의 [AGENTS.md](#agents-md) 파일을 로드할 수 있습니다.99CLAUDE.md를 프로젝트 범위에서 `./CLAUDE.md` 또는 `./.claude/CLAUDE.md`에, 사용자 범위에서 `~/.claude/CLAUDE.md`에, 또는 조직의 [관리형 정책](#managed-settings)으로 배치할 수 있습니다. 발견된 모든 파일은 서로를 재정의하지 않고 컨텍스트에 연결되며, 가장 광범위한 범위에서 가장 구체적인 범위로 정렬됩니다. Claude Code는 또한 CLAUDE.md 대신 프로젝트의 [AGENTS.md](#agents-md) 파일을 로드할 수 있습니다.
100 100
101자세히 알아보기: [CLAUDE.md 파일](/docs/ko/memory#claude-md-files)101자세히 알아보기: [CLAUDE.md 파일](/docs/ko/memory.md#claude-md-files)
102 102
103### Cloud session103### Cloud session
104 104
105사용자의 머신 대신 클라우드 인프라에서 실행되므로 노트북을 닫은 후에도 계속 실행되는 Claude Code 세션입니다. 이 인프라는 기본적으로 Anthropic에서 관리하며, 조직이 운영하는 [자체 호스팅 환경](/docs/ko/self-hosted-environments)일 수도 있습니다. 클라우드 세션은 claude.ai/code, Claude 모바일 앱, **Cloud**가 선택된 Desktop 앱, `claude --cloud` 또는 [클라우드 예약 작업](/docs/ko/routines)에서 시작합니다.105사용자의 머신 대신 클라우드 인프라에서 실행되므로 노트북을 닫은 후에도 계속 실행되는 Claude Code 세션입니다. 이 인프라는 기본적으로 Anthropic에서 관리하며, 조직이 운영하는 [자체 호스팅 환경](/docs/ko/self-hosted-environments)일 수도 있습니다. 클라우드 세션은 claude.ai/code, Claude 모바일 앱, **Cloud**가 선택된 Desktop 앱, `claude --cloud` 또는 [클라우드 예약 작업](/docs/ko/routines.md)에서 시작합니다.
106 106
107터미널, IDE 또는 **Local**이 선택된 Desktop 앱의 세션은 로컬 세션입니다. 다른 디바이스에서 로컬 세션에 접근하려면 [Remote Control](#remote-control)을 사용합니다.107터미널, IDE 또는 **Local**이 선택된 Desktop 앱의 세션은 로컬 세션입니다. 다른 디바이스에서 로컬 세션에 접근하려면 [Remote Control](#remote-control)을 사용합니다.
108 108
109자세히 알아보기: [클라우드에서 Claude Code 사용](/docs/ko/claude-code-on-the-web)109자세히 알아보기: [클라우드에서 Claude Code 사용](/docs/ko/claude-code-on-the-web.md)
110 110
111### Command111### Command
112 112
113프롬프트에 `/name`을 입력하여 호출하는 재사용 가능한 지침입니다. `/clear`, `/model`, `/compact`와 같은 기본 제공 명령은 세션을 제어합니다. `.claude/commands/`의 파일로 자신의 명령을 정의하거나 [플러그인](#plugin)에서 설치할 수 있습니다. [스킬](#skill)은 다단계 명령을 패키징하는 권장 방법입니다.113프롬프트에 `/name`을 입력하여 호출하는 재사용 가능한 지침입니다. `/clear`, `/model`, `/compact`와 같은 기본 제공 명령은 세션을 제어합니다. `.claude/commands/`의 파일로 자신의 명령을 정의하거나 [플러그인](#plugin)에서 설치할 수 있습니다. [스킬](#skill)은 다단계 명령을 패키징하는 권장 방법입니다.
114 114
115두 가지 다른 단어 사용은 관련이 없습니다: `claude` CLI 서브명령(예: `claude mcp add`)은 [CLI 참조](/docs/ko/cli-reference#cli-commands)에 나열되어 있으며, stdio [MCP 서버](#mcp-server) 항목의 `command` 필드는 Claude Code가 서버를 시작하기 위해 실행하는 실행 파일을 지정합니다.115두 가지 다른 단어 사용은 관련이 없습니다: `claude` CLI 서브명령(예: `claude mcp add`)은 [CLI 참조](/docs/ko/cli-reference.md#cli-commands)에 나열되어 있으며, stdio [MCP 서버](#mcp-server) 항목의 `command` 필드는 Claude Code가 서버를 시작하기 위해 실행하는 실행 파일을 지정합니다.
116 116
117자세히 알아보기: [명령](/docs/ko/commands) · [스킬](/docs/ko/skills)117자세히 알아보기: [명령](/docs/ko/commands.md) · [스킬](/docs/ko/skills.md)
118 118
119### Compaction119### Compaction
120 120
121[컨텍스트 윈도우](#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`와 같은 포커스를 선택적으로 사용합니다.
122 122
123자세히 알아보기: [컴팩션에서 생존하는 것](/docs/ko/context-window#what-survives-compaction) · [컨텍스트가 가득 찰 때](/docs/ko/how-claude-code-works#when-context-fills-up)123자세히 알아보기: [컴팩션에서 생존하는 것](/docs/ko/context-window.md#what-survives-compaction) · [컨텍스트가 가득 찰 때](/docs/ko/how-claude-code-works.md#when-context-fills-up)
124 124
125### Connector125### Connector
126 126
127Claude Code가 아닌 claude.ai 계정에 추가된 [MCP 서버](#mcp-server)입니다. 해당 계정으로 Claude Code에 로그인하면, 커넥터가 로컬로 추가한 서버와 함께 `/mcp`에 나타납니다. 조직은 또한 커넥터를 프로비저닝하고 이들에 대한 도구별 제어를 설정할 수 있습니다.127Claude Code가 아닌 claude.ai 계정에 추가된 [MCP 서버](#mcp-server)입니다. 해당 계정으로 Claude Code에 로그인하면, 커넥터가 로컬로 추가한 서버와 함께 `/mcp`에 나타납니다. 조직은 또한 커넥터를 프로비저닝하고 이들에 대한 도구별 제어를 설정할 수 있습니다.
128 128
129자세히 알아보기: [claude.ai에서 MCP 서버 사용](/docs/ko/mcp#use-mcp-servers-from-claude-ai)129자세히 알아보기: [claude.ai에서 MCP 서버 사용](/docs/ko/mcp.md#use-mcp-servers-from-claude-ai)
130 130
131### Context window131### Context window
132 132
133세션의 작업 메모리이며, 대화 기록, 파일 내용, 명령 출력, 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)을 참조하십시오.
134 134
135자세히 알아보기: [컨텍스트 윈도우 탐색](/docs/ko/context-window)135자세히 알아보기: [컨텍스트 윈도우 탐색](/docs/ko/context-window.md)
136 136
137## D137## D
138 138
140 140
141Claude 모바일 앱에서 코딩 작업을 보낼 때 Desktop 앱에서 Claude Code 세션을 생성하는 휴대폰 시작 작업 라우터입니다. 프롬프트가 올바른 도구로 자동으로 라우팅됩니다. Pro 및 Max 플랜에서 사용 가능합니다.141Claude 모바일 앱에서 코딩 작업을 보낼 때 Desktop 앱에서 Claude Code 세션을 생성하는 휴대폰 시작 작업 라우터입니다. 프롬프트가 올바른 도구로 자동으로 라우팅됩니다. Pro 및 Max 플랜에서 사용 가능합니다.
142 142
143자세히 알아보기: [Dispatch의 세션](/docs/ko/desktop#sessions-from-dispatch)143자세히 알아보기: [Dispatch의 세션](/docs/ko/desktop.md#sessions-from-dispatch)
144 144
145## E145## E
146 146
148 148
149적응형 추론을 제어하는 설정으로, 모델이 각 단계에서 사고할지 여부와 얼마나 사고할지를 스스로 결정하도록 합니다. 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에서 지원됩니다.
150 150
151자세히 알아보기: [노력 수준 조정](/docs/ko/model-config#adjust-effort-level)151자세히 알아보기: [노력 수준 조정](/docs/ko/model-config.md#adjust-effort-level)
152 152
153### Extended thinking153### Extended thinking
154 154
155모델이 응답하기 전에 수행하는 가시적인 단계별 추론입니다. [노력 수준](#effort-level)으로 조정하거나 고정된 사고 예산이 있는 모델에서 `MAX_THINKING_TOKENS`로 사고 토큰을 제한할 수 있습니다. 사고는 터미널에서 회색 이탤릭 텍스트로 나타납니다.155모델이 응답하기 전에 수행하는 가시적인 단계별 추론입니다. [노력 수준](#effort-level)으로 조정하거나 고정된 사고 예산이 있는 모델에서 `MAX_THINKING_TOKENS`로 사고 토큰을 제한할 수 있습니다. 사고는 터미널에서 회색 이탤릭 텍스트로 나타납니다.
156 156
157자세히 알아보기: [확장 사고 사용](/docs/ko/model-config#extended-thinking)157자세히 알아보기: [확장 사고 사용](/docs/ko/model-config.md#extended-thinking)
158 158
159## F159## F
160 160
162 162
163Markdown 파일의 맨 위에 있는 YAML 설정 블록으로, 여는 `---` 줄과 닫는 `---` 줄 사이에 위치합니다. 스킬, 서브에이전트, 출력 스타일 및 규칙은 각각 frontmatter에서 구성을 읽습니다. 예를 들어 스킬의 `description` 또는 서브에이전트의 `tools`와 같은 설정을 읽으며, 닫는 `---` 이후의 모든 내용을 지시사항으로 처리합니다. 여는 `---`은 파일의 첫 번째 줄이어야 합니다. 각 파일 유형은 자신의 필드 집합을 허용합니다.163Markdown 파일의 맨 위에 있는 YAML 설정 블록으로, 여는 `---` 줄과 닫는 `---` 줄 사이에 위치합니다. 스킬, 서브에이전트, 출력 스타일 및 규칙은 각각 frontmatter에서 구성을 읽습니다. 예를 들어 스킬의 `description` 또는 서브에이전트의 `tools`와 같은 설정을 읽으며, 닫는 `---` 이후의 모든 내용을 지시사항으로 처리합니다. 여는 `---`은 파일의 첫 번째 줄이어야 합니다. 각 파일 유형은 자신의 필드 집합을 허용합니다.
164 164
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)165자세히 알아보기: [스킬 frontmatter](/docs/ko/skills.md#frontmatter-reference), [서브에이전트 frontmatter](/docs/ko/sub-agents.md#supported-frontmatter-fields), [출력 스타일 frontmatter](/docs/ko/output-styles.md#frontmatter), [규칙 frontmatter](/docs/ko/memory.md#rules-frontmatter-reference)
166 166
167## H167## H
168 168
176* **Matcher**: 어떤 이벤트가 발생하는지 필터링합니다176* **Matcher**: 어떤 이벤트가 발생하는지 필터링합니다
177* **Hook handler**: 실행되는 것177* **Hook handler**: 실행되는 것
178 178
179자세히 알아보기: [훅 시작하기](/docs/ko/hooks-guide) · [훅 참조](/docs/ko/hooks)179자세히 알아보기: [훅 시작하기](/docs/ko/hooks-guide.md) · [훅 참조](/docs/ko/hooks.md)
180 180
181## M181## M
182 182
183### Managed settings183### Managed settings
184 184
185IT 또는 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.md#platform-availability)에 적용됩니다. [보안 고려 사항](/docs/ko/server-managed-settings.md#security-considerations)을 참조하십시오. 보안 정책, 규정 준수 요구 사항 또는 플릿 전체의 표준화된 도구에 사용합니다.
186 186
187자세히 알아보기: [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.md) · [Settings files](/docs/ko/settings.md#where-settings-live)
188 188
189### MCP (Model Context Protocol)189### MCP (Model Context Protocol)
190 190
191AI 도구를 외부 데이터 소스 및 서비스에 연결하기 위한 개방형 표준입니다. 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)을 참조하십시오.
192 192
193자세히 알아보기: [Model Context Protocol](/docs/ko/mcp)193자세히 알아보기: [Model Context Protocol](/docs/ko/mcp.md)
194 194
195### MCP server195### MCP server
196 196
197Claude에 [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)와는 관계가 없습니다.
198 198
199자세히 알아보기: [Model Context Protocol](/docs/ko/mcp)199자세히 알아보기: [Model Context Protocol](/docs/ko/mcp.md)
200 200
201### MCP Tool Search201### MCP Tool Search
202 202
203필요할 때까지 MCP 도구 스키마를 연기하는 컨텍스트 절약 메커니즘입니다. 시작 시 도구 이름과 서버 지침만 로드됩니다. Claude는 특정 도구를 사용하기로 결정할 때 전체 스키마를 요청합니다. 이렇게 하면 유휴 MCP 서버가 많은 컨텍스트를 소비하지 않습니다.203필요할 때까지 MCP 도구 스키마를 연기하는 컨텍스트 절약 메커니즘입니다. 시작 시 도구 이름과 서버 지침만 로드됩니다. Claude는 특정 도구를 사용하기로 결정할 때 전체 스키마를 요청합니다. 이렇게 하면 유휴 MCP 서버가 많은 컨텍스트를 소비하지 않습니다.
204 204
205자세히 알아보기: [MCP Tool Search로 확장](/docs/ko/mcp#scale-with-mcp-tool-search)205자세히 알아보기: [MCP Tool Search로 확장](/docs/ko/mcp.md#scale-with-mcp-tool-search)
206 206
207## N207## N
208 208
209### Non-interactive mode209### Non-interactive mode
210 210
211`-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.md)는 Python 및 TypeScript 동등물입니다. 이전에는 headless mode라고 불렸습니다.
212 212
213자세히 알아보기: [Claude Code를 프로그래밍 방식으로 실행](/docs/ko/headless)213자세히 알아보기: [Claude Code를 프로그래밍 방식으로 실행](/docs/ko/headless.md)
214 214
215## O215## O
216 216
218 218
219Claude Code가 Claude에 제공하는 지시사항을 변경하여 응답 동작, 톤 또는 형식을 설정하는 구성입니다. 프로젝트 컨텍스트를 Claude Code의 기본 지시사항과 함께 추가하는 [CLAUDE.md](#claude-md)와 달리, 사용자 정의 출력 스타일은 자체 지시사항을 추가하며 기본 소프트웨어 엔지니어링 지시사항을 제외할 수 있습니다.219Claude Code가 Claude에 제공하는 지시사항을 변경하여 응답 동작, 톤 또는 형식을 설정하는 구성입니다. 프로젝트 컨텍스트를 Claude Code의 기본 지시사항과 함께 추가하는 [CLAUDE.md](#claude-md)와 달리, 사용자 정의 출력 스타일은 자체 지시사항을 추가하며 기본 소프트웨어 엔지니어링 지시사항을 제외할 수 있습니다.
220 220
221자세히 알아보기: [출력 스타일](/docs/ko/output-styles)221자세히 알아보기: [출력 스타일](/docs/ko/output-styles.md)
222 222
223## P223## P
224 224
228 228
229`default` 모드는 CLI 및 VS Code와 JetBrains 확장에서 Manual로 표시되며, Claude Code는 값에 대한 `manual`의 별칭을 허용합니다.229`default` 모드는 CLI 및 VS Code와 JetBrains 확장에서 Manual로 표시되며, Claude Code는 값에 대한 `manual`의 별칭을 허용합니다.
230 230
231자세히 알아보기: [권한 모드 선택](/docs/ko/permission-modes)231자세히 알아보기: [권한 모드 선택](/docs/ko/permission-modes.md)
232 232
233### Permission rule233### Permission rule
234 234
235도구 이름 및 인수 패턴을 기반으로 도구 호출을 허용, 질문 또는 거부하는 설정 항목입니다. 규칙은 deny→ask→allow로 평가되며, 첫 번째 일치가 우선합니다. 권한 규칙은 더 광범위한 [권한 모드](#permission-mode) 위에 계층화된 세밀한 제어입니다.235도구 이름 및 인수 패턴을 기반으로 도구 호출을 허용, 질문 또는 거부하는 설정 항목입니다. 규칙은 deny→ask→allow로 평가되며, 첫 번째 일치가 우선합니다. 권한 규칙은 더 광범위한 [권한 모드](#permission-mode) 위에 계층화된 세밀한 제어입니다.
236 236
237자세히 알아보기: [권한 구성](/docs/ko/permissions)237자세히 알아보기: [권한 구성](/docs/ko/permissions.md)
238 238
239### Plan mode239### Plan mode
240 240
241Claude가 소스 파일을 편집하지 않고 변경 사항을 연구하고 제안하는 [권한 모드](#permission-mode)입니다. 읽고, 검색하고, 탐색 명령을 실행할 수 있으며, 아무것도 건드리기 전에 승인을 위한 계획을 제시합니다. `/plan`을 입력하거나 `Shift+Tab`을 눌러 plan mode에 들어갑니다.241Claude가 소스 파일을 편집하지 않고 변경 사항을 연구하고 제안하는 [권한 모드](#permission-mode)입니다. 읽고, 검색하고, 탐색 명령을 실행할 수 있으며, 아무것도 건드리기 전에 승인을 위한 계획을 제시합니다. `/plan`을 입력하거나 `Shift+Tab`을 눌러 plan mode에 들어갑니다.
242 242
243자세히 알아보기: [plan mode로 편집 전에 분석](/docs/ko/permission-modes#analyze-before-you-edit-with-plan-mode)243자세히 알아보기: [plan mode로 편집 전에 분석](/docs/ko/permission-modes.md#analyze-before-you-edit-with-plan-mode)
244 244
245### Plugin245### Plugin
246 246
247스킬, 훅, 서브에이전트 및 MCP 서버의 번들이며, 단일 설치 가능한 단위로 패키징됩니다. 플러그인 스킬은 `plugin-name:skill-name`으로 네임스페이스되므로 여러 플러그인이 공존합니다. [마켓플레이스](/docs/ko/plugins/overview)를 통해 팀 전체에 플러그인을 배포합니다.247스킬, 훅, 서브에이전트 및 MCP 서버의 번들이며, 단일 설치 가능한 단위로 패키징됩니다. 플러그인 스킬은 `plugin-name:skill-name`으로 네임스페이스되므로 여러 플러그인이 공존합니다. [마켓플레이스](/docs/ko/plugins/overview.md)를 통해 팀 전체에 플러그인을 배포합니다.
248 248
249자세히 알아보기: [플러그인](/docs/ko/plugins/overview)249자세히 알아보기: [플러그인](/docs/ko/plugins/overview.md)
250 250
251### Project trust251### Project trust
252 252
253Claude 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.md#what-runs-before-you-trust-a-folder)에서는 `-p` 세션이 대화 없이 실행하는 것을 포함하여 각 종류의 콘텐츠를 나열합니다.
254 254
255자세히 알아보기: [`.claude` 디렉토리](/docs/ko/claude-directory)255자세히 알아보기: [`.claude` 디렉토리](/docs/ko/claude-directory)
256 256
258 258
259파일, 웹 페이지 또는 도구 결과에 포함된 적대적 지침이며, Claude를 요청하지 않은 작업으로 리디렉션하려고 시도합니다. Claude Code의 방어에는 권한 시스템, 명령 주입 탐지 및 신뢰 확인이 포함됩니다. [Auto mode](#auto-mode)는 도구 결과에서 의심스러운 내용을 스캔하는 서버 측 프로브와 도구 결과를 제거한 상태에서 작업을 검토하는 분류기를 추가하므로 주입된 텍스트가 직접 이를 조작할 수 없습니다.259파일, 웹 페이지 또는 도구 결과에 포함된 적대적 지침이며, Claude를 요청하지 않은 작업으로 리디렉션하려고 시도합니다. Claude Code의 방어에는 권한 시스템, 명령 주입 탐지 및 신뢰 확인이 포함됩니다. [Auto mode](#auto-mode)는 도구 결과에서 의심스러운 내용을 스캔하는 서버 측 프로브와 도구 결과를 제거한 상태에서 작업을 검토하는 분류기를 추가하므로 주입된 텍스트가 직접 이를 조작할 수 없습니다.
260 260
261자세히 알아보기: [프롬프트 주입으로부터 보호](/docs/ko/security#protect-against-prompt-injection)261자세히 알아보기: [프롬프트 주입으로부터 보호](/docs/ko/security.md#protect-against-prompt-injection)
262 262
263## R263## R
264 264
265### Remote Control265### Remote Control
266 266
267claude.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.md)와 다릅니다.
268 268
269자세히 알아보기: [Remote Control](/docs/ko/remote-control)269자세히 알아보기: [Remote Control](/docs/ko/remote-control.md)
270 270
271### Rules271### Rules
272 272
280 280
281Bash 도구에 대한 OS 수준 파일 시스템 및 네트워크 격리입니다. 명령은 미리 정의한 경계 내에서 실행되므로 Claude는 명령별 승인 프롬프트 없이 그 안에서 자유롭게 작업할 수 있습니다. 샌드박싱은 [권한 규칙](#permission-rule)과 별개의 계층입니다.281Bash 도구에 대한 OS 수준 파일 시스템 및 네트워크 격리입니다. 명령은 미리 정의한 경계 내에서 실행되므로 Claude는 명령별 승인 프롬프트 없이 그 안에서 자유롭게 작업할 수 있습니다. 샌드박싱은 [권한 규칙](#permission-rule)과 별개의 계층입니다.
282 282
283자세히 알아보기: [샌드박싱](/docs/ko/sandboxing)283자세히 알아보기: [샌드박싱](/docs/ko/sandboxing.md)
284 284
285### Session285### Session
286 286
287현재 디렉토리에 연결된 대화이며, 자신의 독립적인 [컨텍스트 윈도우](#context-window)를 가집니다. 세션은 `claude -c`로 재개할 수 있고, `--fork-session`으로 포크하여 새 세션 ID 아래에 기록을 보존하거나, 여러 터미널에서 병렬로 실행할 수 있습니다. `/clear`를 실행하면 새 세션이 시작됩니다. 이전 세션은 저장된 상태로 유지되며 `/resume`을 통해 사용할 수 있습니다. 각 세션의 트랜스크립트는 `~/.claude/projects/` 아래에 저장됩니다.287현재 디렉토리에 연결된 대화이며, 자신의 독립적인 [컨텍스트 윈도우](#context-window)를 가집니다. 세션은 `claude -c`로 재개할 수 있고, `--fork-session`으로 포크하여 새 세션 ID 아래에 기록을 보존하거나, 여러 터미널에서 병렬로 실행할 수 있습니다. `/clear`를 실행하면 새 세션이 시작됩니다. 이전 세션은 저장된 상태로 유지되며 `/resume`을 통해 사용할 수 있습니다. 각 세션의 트랜스크립트는 `~/.claude/projects/` 아래에 저장됩니다.
288 288
289자세히 알아보기: [세션으로 작업](/docs/ko/how-claude-code-works#work-with-sessions)289자세히 알아보기: [세션으로 작업](/docs/ko/how-claude-code-works.md#work-with-sessions)
290 290
291### Settings layers291### Settings layers
292 292
293Claude 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.md#settings-precedence)를 참조하십시오.
294 294
295자세히 알아보기: [설정 파일](/docs/ko/settings#where-settings-live)295자세히 알아보기: [설정 파일](/docs/ko/settings.md#where-settings-live)
296 296
297### Skill297### Skill
298 298
300 300
301스킬은 사용자 정의 명령의 권장 후속 기능입니다. `.claude/commands/deploy.md`의 파일과 `.claude/skills/deploy/SKILL.md`의 파일은 모두 `/deploy`를 생성하고 동일하게 작동합니다. 기존 명령 파일은 계속 작동합니다.301스킬은 사용자 정의 명령의 권장 후속 기능입니다. `.claude/commands/deploy.md`의 파일과 `.claude/skills/deploy/SKILL.md`의 파일은 모두 `/deploy`를 생성하고 동일하게 작동합니다. 기존 명령 파일은 계속 작동합니다.
302 302
303자세히 알아보기: [스킬로 Claude 확장](/docs/ko/skills)303자세히 알아보기: [스킬로 Claude 확장](/docs/ko/skills.md)
304 304
305### Subagent305### Subagent
306 306
307자신의 컨텍스트 윈도우, 사용자 정의 시스템 프롬프트, 특정 도구 액세스 및 독립적인 권한으로 실행되는 특화된 AI 어시스턴트입니다. 위임된 작업을 수행하고 주 대화에 요약을 반환합니다. 서브에이전트를 사용하여 큰 탐색을 기본 컨텍스트 밖으로 유지하거나 병렬 연구를 실행합니다. 서브에이전트는 이를 생성한 세션 내에 머물러 있습니다. 직접 실행하는 별도의 세션 간에 발견 사항을 전달하려면 [세션 간 메시징](/docs/ko/cross-session-messaging)을 사용하십시오.307자신의 컨텍스트 윈도우, 사용자 정의 시스템 프롬프트, 특정 도구 액세스 및 독립적인 권한으로 실행되는 특화된 AI 어시스턴트입니다. 위임된 작업을 수행하고 주 대화에 요약을 반환합니다. 서브에이전트를 사용하여 큰 탐색을 기본 컨텍스트 밖으로 유지하거나 병렬 연구를 실행합니다. 서브에이전트는 이를 생성한 세션 내에 머물러 있습니다. 직접 실행하는 별도의 세션 간에 발견 사항을 전달하려면 [세션 간 메시징](/docs/ko/cross-session-messaging.md)을 사용하십시오.
308 308
309기본 제공 서브에이전트에는 Explore, Plan 및 범용이 포함됩니다.309기본 제공 서브에이전트에는 Explore, Plan 및 범용이 포함됩니다.
310 310
311자세히 알아보기: [사용자 정의 서브에이전트 생성](/docs/ko/sub-agents)311자세히 알아보기: [사용자 정의 서브에이전트 생성](/docs/ko/sub-agents.md)
312 312
313### Surface313### Surface
314 314
315Claude 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.md#what-carries-over-from-your-setup)은 저장소의 새로운 클론에서 시작되며 컴퓨터의 `~/.claude/`를 읽지 않습니다. Slack 및 Chrome 확장 프로그램은 사용 환경 자체가 아니라 사용 환경에 연결되는 통합입니다.
316 316
317자세히 알아보기: [플랫폼 및 통합](/docs/ko/platforms)317자세히 알아보기: [플랫폼 및 통합](/docs/ko/platforms.md)
318 318
319### System prompt319### System prompt
320 320
321Claude 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.md#how-the-cache-is-organized)의 첫 번째 계층입니다.
322 322
323[CLAUDE.md](#claude-md) 파일과 [출력 스타일](#output-style)의 지침은 시스템 프롬프트의 일부가 아닙니다. Claude Code는 이를 [시스템 리마인더](#system-reminder)로 대화에 전달합니다.323[CLAUDE.md](#claude-md) 파일과 [출력 스타일](#output-style)의 지침은 시스템 프롬프트의 일부가 아닙니다. Claude Code는 이를 [시스템 리마인더](#system-reminder)로 대화에 전달합니다.
324 324
325자세히 알아보기: [시스템 프롬프트 플래그](/docs/ko/cli-reference#system-prompt-flags)325자세히 알아보기: [시스템 프롬프트 플래그](/docs/ko/cli-reference.md#system-prompt-flags)
326 326
327### System reminder327### System reminder
328 328
337 337
338로깅된 API 요청에서 시스템 리마인더는 사용자 메시지 내의 `<system-reminder>` 태그로 래핑되거나 일부 모델에서는 `system` 역할을 가진 별도의 메시지로 나타납니다.338로깅된 API 요청에서 시스템 리마인더는 사용자 메시지 내의 `<system-reminder>` 태그로 래핑되거나 일부 모델에서는 `system` 역할을 가진 별도의 메시지로 나타납니다.
339 339
340자세히 알아보기: [시스템 프롬프트 외부에서 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.md#context-claude-code-adds-outside-the-system-prompt)
341 341
342## T342## T
343 343
345 345
346클라우드 Claude Code 세션을 로컬 터미널로 가져오는 명령 `/teleport`입니다. Claude는 분기를 가져오고, 대화 기록을 로드하고, 클라우드 세션의 마지막 상태에서 재개합니다. 역방향은 `--cloud`이며, 로컬 작업을 클라우드에서 실행하도록 보냅니다.346클라우드 Claude Code 세션을 로컬 터미널로 가져오는 명령 `/teleport`입니다. Claude는 분기를 가져오고, 대화 기록을 로드하고, 클라우드 세션의 마지막 상태에서 재개합니다. 역방향은 `--cloud`이며, 로컬 작업을 클라우드에서 실행하도록 보냅니다.
347 347
348자세히 알아보기: [터미널에서 클라우드 세션 계속하기](/docs/ko/claude-code-on-the-web#from-cloud-to-terminal)348자세히 알아보기: [터미널에서 클라우드 세션 계속하기](/docs/ko/claude-code-on-the-web.md#from-cloud-to-terminal)
349 349
350### Tool350### Tool
351 351
352Claude가 수행할 수 있는 작업입니다: 파일 읽기, 코드 편집, 셸 명령 실행, 웹 검색, 서브에이전트 생성. 도구는 Claude Code를 에이전트로 만드는 것입니다. 도구 없이 Claude는 텍스트로만 응답할 수 있습니다. 각 도구 사용은 [에이전트 루프](#agentic-loop)에서 Claude의 다음 결정을 알려주는 결과를 반환합니다.352Claude가 수행할 수 있는 작업입니다: 파일 읽기, 코드 편집, 셸 명령 실행, 웹 검색, 서브에이전트 생성. 도구는 Claude Code를 에이전트로 만드는 것입니다. 도구 없이 Claude는 텍스트로만 응답할 수 있습니다. 각 도구 사용은 [에이전트 루프](#agentic-loop)에서 Claude의 다음 결정을 알려주는 결과를 반환합니다.
353 353
354자세히 알아보기: [Claude에서 사용 가능한 도구](/docs/ko/tools-reference)354자세히 알아보기: [Claude에서 사용 가능한 도구](/docs/ko/tools-reference.md)
355 355
356### Transcript356### Transcript
357 357
358[세션](#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.md#transcript-viewer)를 참조하십시오.
359 359
360자세히 알아보기: [트랜스크립트가 저장되는 위치](/docs/ko/sessions#where-transcripts-are-stored)360자세히 알아보기: [트랜스크립트가 저장되는 위치](/docs/ko/sessions.md#where-transcripts-are-stored)
361 361
362### Turn362### Turn
363 363
364[세션](#session) 내에서 Claude의 한 번의 완전한 응답입니다. 턴은 메시지를 보낼 때 시작되고 Claude가 응답을 마칠 때 끝나며, 그 사이에 여러 개의 [도구](#tool) 호출이 있을 수 있습니다. [Stop 훅](#hook)은 각 턴의 끝에서 실행됩니다. 세션은 많은 턴으로 구성되며, [에이전트 루프](#agentic-loop)는 한 턴 내에서 일어나는 일을 설명합니다.364[세션](#session) 내에서 Claude의 한 번의 완전한 응답입니다. 턴은 메시지를 보낼 때 시작되고 Claude가 응답을 마칠 때 끝나며, 그 사이에 여러 개의 [도구](#tool) 호출이 있을 수 있습니다. [Stop 훅](#hook)은 각 턴의 끝에서 실행됩니다. 세션은 많은 턴으로 구성되며, [에이전트 루프](#agentic-loop)는 한 턴 내에서 일어나는 일을 설명합니다.
365 365
366자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works#the-agentic-loop)366자세히 알아보기: [Claude Code 작동 방식](/docs/ko/how-claude-code-works.md#the-agentic-loop)
367 367
368## V368## V
369 369
370### Verification loop370### Verification loop
371 371
372그럴듯해 보이는 결과를 그대로 받아들이는 대신 세션이 작업이 실제로 완료되었는지 확인하는 방법입니다. 테스트 스위트, 빌드 또는 스크린샷 비교와 같이 Claude가 실행할 수 있는 검사를 제공하면, Claude는 한 번의 시도 후 중단하는 대신 검사가 통과할 때까지 반복합니다. 검증 루프는 [`/goal`](/docs/ko/goal), 무인 실행 및 [동적 워크플로](/docs/ko/workflows)의 사전 요구 사항입니다. 검증 루프가 없으면 에이전트가 완료되었는지 판단하는 주체는 에이전트 자신뿐입니다.372그럴듯해 보이는 결과를 그대로 받아들이는 대신 세션이 작업이 실제로 완료되었는지 확인하는 방법입니다. 테스트 스위트, 빌드 또는 스크린샷 비교와 같이 Claude가 실행할 수 있는 검사를 제공하면, Claude는 한 번의 시도 후 중단하는 대신 검사가 통과할 때까지 반복합니다. 검증 루프는 [`/goal`](/docs/ko/goal), 무인 실행 및 [동적 워크플로](/docs/ko/workflows.md)의 사전 요구 사항입니다. 검증 루프가 없으면 에이전트가 완료되었는지 판단하는 주체는 에이전트 자신뿐입니다.
373 373
374자세히 알아보기: [Claude에 작업 확인 방법 제공](/docs/ko/best-practices#give-claude-a-way-to-verify-its-work)374자세히 알아보기: [Claude에 작업 확인 방법 제공](/docs/ko/best-practices.md#give-claude-a-way-to-verify-its-work)
375 375
376## W376## W
377 377
379 379
380`.claude/worktrees/` 아래의 별도 git worktree에서 Claude를 실행하는 격리 모드이며, `-w` 플래그 또는 서브에이전트 구성의 `isolation: worktree`로 활성화됩니다. 변경 사항은 별도 디렉토리의 별도 브랜치에 남아 있으므로 병렬 에이전트는 각자 자신의 파일 사본을 편집합니다.380`.claude/worktrees/` 아래의 별도 git worktree에서 Claude를 실행하는 격리 모드이며, `-w` 플래그 또는 서브에이전트 구성의 `isolation: worktree`로 활성화됩니다. 변경 사항은 별도 디렉토리의 별도 브랜치에 남아 있으므로 병렬 에이전트는 각자 자신의 파일 사본을 편집합니다.
381 381
382자세히 알아보기: [git worktrees로 병렬 세션 실행](/docs/ko/worktrees)382자세히 알아보기: [git worktrees로 병렬 세션 실행](/docs/ko/worktrees.md)
383 383
384***384***
385 385