17* [subagent에게 연구 위임](#delegate-research-to-subagents) - 주 컨텍스트를 깨끗하게 유지17* [subagent에게 연구 위임](#delegate-research-to-subagents) - 주 컨텍스트를 깨끗하게 유지

18* [Claude를 스크립트로 파이프](#pipe-claude-into-scripts) - CI 및 배치 처리용18* [Claude를 스크립트로 파이프](#pipe-claude-into-scripts) - CI 및 배치 처리용

19 19 

20<h2 id="prompt-recipes">20## 프롬프트 레시피

21 프롬프트 레시피

22</h2>

23 21 

24이는 낯선 코드 탐색, 디버깅, 리팩토링, 테스트 작성, PR 생성과 같은 일상적인 작업을 위한 프롬프트 패턴입니다. 각각은 모든 Claude Code 표면에서 작동하며, 프로젝트에 맞게 표현을 조정하십시오.22이는 낯선 코드 탐색, 디버깅, 리팩토링, 테스트 작성, PR 생성과 같은 일상적인 작업을 위한 프롬프트 패턴입니다. 각각은 모든 Claude Code 표면에서 작동하며, 프로젝트에 맞게 표현을 조정하십시오.

25 23 

26<h3 id="understand-new-codebases">24### 새로운 코드베이스 이해하기

27 새로운 코드베이스 이해하기

28</h3>

29 25 

30모노레포 또는 대규모 코드베이스에서 Claude Code를 구성하는 방법은 [모노레포 및 대규모 저장소](/docs/ko/large-codebases)를 참조하십시오.26모노레포 또는 대규모 코드베이스에서 Claude Code를 구성하는 방법은 [모노레포 및 대규모 저장소](/docs/ko/large-codebases)를 참조하십시오.

31 27 

32<h4 id="get-a-quick-codebase-overview">28#### 코드베이스의 빠른 개요 얻기

33 코드베이스의 빠른 개요 얻기

34</h4>

35 29 

36새로운 프로젝트에 방금 참여했고 그 구조를 빠르게 이해해야 한다고 가정해봅시다.30새로운 프로젝트에 방금 참여했고 그 구조를 빠르게 이해해야 한다고 가정해봅시다.

37 31 

38<Steps>32**1. 프로젝트 루트 디렉토리로 이동**

39 <Step title="프로젝트 루트 디렉토리로 이동">33 

40 ```bash theme={null}34```bash theme={null}

41 cd /path/to/project 35cd /path/to/project

42 ```36```

43 37 

44 `/path/to/project`를 프로젝트의 경로로 바꾸십시오.38`/path/to/project`를 프로젝트의 경로로 바꾸십시오.

45 </Step>39 

46 40**2. Claude Code 시작**

47 <Step title="Claude Code 시작">41 

48 ```bash theme={null}42```bash theme={null}

49 claude 43claude

50 ```44```

51 </Step>45 

52 46**3. 높은 수준의 개요 요청**

53 <Step title="높은 수준의 개요 요청">47 

54 ```text wrap theme={null}48```text wrap theme={null}

55 give me an overview of this codebase49give me an overview of this codebase

56 ```50```

57 </Step>51 

58 52**4. 특정 구성 요소에 대해 더 깊이 있게 살펴보기**

59 <Step title="특정 구성 요소에 대해 더 깊이 있게 살펴보기">53 

60 ```text wrap theme={null}54```text wrap theme={null}

61 explain the main architecture patterns used here55explain the main architecture patterns used here

62 ```56```

63 57 

64 ```text wrap theme={null}58```text wrap theme={null}

65 what are the key data models?59what are the key data models?

66 ```60```

67 61 

68 ```text wrap theme={null}62```text wrap theme={null}

69 how is authentication handled?63how is authentication handled?

70 ```64```

71 </Step>65 

72</Steps>66> [!TIP]

73 67>

74<Tip>68> 팁:

75 팁:69>

76 70> * 광범위한 질문으로 시작한 다음 특정 영역으로 좁혀나가기

77 * 광범위한 질문으로 시작한 다음 특정 영역으로 좁혀나가기71> * 프로젝트에서 사용되는 코딩 규칙과 패턴에 대해 질문하기

78 * 프로젝트에서 사용되는 코딩 규칙과 패턴에 대해 질문하기72> * 프로젝트별 용어의 용어집 요청하기

79 * 프로젝트별 용어의 용어집 요청하기73 

80</Tip>74#### 관련 코드 찾기

81 

82<h4 id="find-relevant-code">

83 관련 코드 찾기

84</h4>

85 75 

86특정 기능이나 기능과 관련된 코드를 찾아야 한다고 가정해봅시다.76특정 기능이나 기능과 관련된 코드를 찾아야 한다고 가정해봅시다.

87 77 

88<Steps>78**1. Claude에게 관련 파일을 찾도록 요청**

89 <Step title="Claude에게 관련 파일을 찾도록 요청">79 

90 ```text wrap theme={null}80```text wrap theme={null}

91 find the files that handle user authentication81find the files that handle user authentication

92 ```82```

93 </Step>83 

94 84**2. 구성 요소가 어떻게 상호작용하는지에 대한 컨텍스트 얻기**

95 <Step title="구성 요소가 어떻게 상호작용하는지에 대한 컨텍스트 얻기">85 

96 ```text wrap theme={null}86```text wrap theme={null}

97 how do these authentication files work together?87how do these authentication files work together?

98 ```88```

99 </Step>89 

100 90**3. 실행 흐름 이해하기**

101 <Step title="실행 흐름 이해하기">91 

102 ```text wrap theme={null}92```text wrap theme={null}

103 trace the login process from front-end to database93trace the login process from front-end to database

104 ```94```

105 </Step>95 

106</Steps>96> [!TIP]

107 97>

108<Tip>98> 팁:

109 팁:99>

110 100> * 찾고 있는 것에 대해 구체적으로 설명하기

111 * 찾고 있는 것에 대해 구체적으로 설명하기101> * 프로젝트의 도메인 언어 사용하기

112 * 프로젝트의 도메인 언어 사용하기102> * 언어에 대한 [코드 인텔리전스 플러그인](/docs/ko/plugins/code-intelligence)을 설치하여 Claude에게 정확한 "정의로 이동" 및 "참조 찾기" 네비게이션 제공하기

113 * 언어에 대한 [코드 인텔리전스 플러그인](/docs/ko/plugins/code-intelligence)을 설치하여 Claude에게 정확한 "정의로 이동" 및 "참조 찾기" 네비게이션 제공하기

114</Tip>

115 103 

116***104***

117 105 

118<h3 id="fix-bugs-efficiently">106### 효율적으로 버그 수정하기

119 효율적으로 버그 수정하기

120</h3>

121 107 

122오류 메시지가 나타났고 그 원인을 찾아 수정해야 한다고 가정해봅시다.108오류 메시지가 나타났고 그 원인을 찾아 수정해야 한다고 가정해봅시다.

123 109 

124<Steps>110**1. Claude와 오류 공유하기**

125 <Step title="Claude와 오류 공유하기">111 

126 ```text wrap theme={null}112```text wrap theme={null}

127 I'm seeing an error when I run npm test113I'm seeing an error when I run npm test

128 ```114```

129 </Step>115 

130 116**2. 수정 권장사항 요청하기**

131 <Step title="수정 권장사항 요청하기">117 

132 ```text wrap theme={null}118```text wrap theme={null}

133 suggest a few ways to fix the @ts-ignore in user.ts119suggest a few ways to fix the @ts-ignore in user.ts

134 ```120```

135 </Step>121 

136 122**3. 수정 적용하기**

137 <Step title="수정 적용하기">123 

138 ```text wrap theme={null}124```text wrap theme={null}

139 update user.ts to add the null check you suggested125update user.ts to add the null check you suggested

140 ```126```

141 </Step>127 

142</Steps>128> [!TIP]

143 129>

144<Tip>130> 팁:

145 팁:131>

146 132> * Claude에게 문제를 재현하는 명령과 스택 추적을 알려주기

147 * Claude에게 문제를 재현하는 명령과 스택 추적을 알려주기133> * 오류를 재현하는 단계 언급하기

148 * 오류를 재현하는 단계 언급하기134> * 오류가 간헐적인지 일관적인지 Claude에게 알려주기

149 * 오류가 간헐적인지 일관적인지 Claude에게 알려주기

150</Tip>

151 135 

152***136***

153 137 

154<h3 id="refactor-code">138### 코드 리팩토링

155 코드 리팩토링

156</h3>

157 139 

158오래된 코드를 최신 패턴과 관행을 사용하도록 업데이트해야 한다고 가정해봅시다.140오래된 코드를 최신 패턴과 관행을 사용하도록 업데이트해야 한다고 가정해봅시다.

159 141 

160전체 코드베이스를 새로운 언어로 이식하는 방법은 블로그의 [Anthropic이 Claude Code로 대규모 코드 마이그레이션을 실행하는 방법](https://claude.com/blog/ai-code-migration)을 참조하십시오.142전체 코드베이스를 새로운 언어로 이식하는 방법은 블로그의 [Anthropic이 Claude Code로 대규모 코드 마이그레이션을 실행하는 방법](https://claude.com/blog/ai-code-migration)을 참조하십시오.

161 143 

162<Steps>144**1. 리팩토링할 레거시 코드 식별**

163 <Step title="리팩토링할 레거시 코드 식별">145 

164 ```text wrap theme={null}146```text wrap theme={null}

165 find deprecated API usage in our codebase147find deprecated API usage in our codebase

166 ```148```

167 </Step>149 

168 150**2. 리팩토링 권장사항 얻기**

169 <Step title="리팩토링 권장사항 얻기">151 

170 ```text wrap theme={null}152```text wrap theme={null}

171 suggest how to refactor utils.js to use modern JavaScript features153suggest how to refactor utils.js to use modern JavaScript features

172 ```154```

173 </Step>155 

174 156**3. 안전하게 변경사항 적용하기**

175 <Step title="안전하게 변경사항 적용하기">157 

176 ```text wrap theme={null}158```text wrap theme={null}

177 refactor utils.js to use ES2024 features while maintaining the same behavior159refactor utils.js to use ES2024 features while maintaining the same behavior

178 ```160```

179 </Step>161 

180 162**4. 리팩토링 검증하기**

181 <Step title="리팩토링 검증하기">163 

182 ```text wrap theme={null}164```text wrap theme={null}

183 run tests for the refactored code165run tests for the refactored code

184 ```166```

185 </Step>167 

186</Steps>168> [!TIP]

187 169>

188<Tip>170> 팁:

189 팁:171>

190 172> * Claude에게 최신 접근 방식의 이점을 설명하도록 요청하기

191 * Claude에게 최신 접근 방식의 이점을 설명하도록 요청하기173> * 필요할 때 변경사항이 하위 호환성을 유지하도록 요청하기

192 * 필요할 때 변경사항이 하위 호환성을 유지하도록 요청하기174> * 작고 테스트 가능한 증분으로 리팩토링 수행하기

193 * 작고 테스트 가능한 증분으로 리팩토링 수행하기

194</Tip>

195 175 

196***176***

197 177 

198<h3 id="work-with-tests">178### 테스트 작업하기

199 테스트 작업하기

200</h3>

201 179 

202적용되지 않은 코드에 대한 테스트를 추가해야 한다고 가정해봅시다.180적용되지 않은 코드에 대한 테스트를 추가해야 한다고 가정해봅시다.

203 181 

204<Steps>182**1. 테스트되지 않은 코드 식별**

205 <Step title="테스트되지 않은 코드 식별">183 

206 ```text wrap theme={null}184```text wrap theme={null}

207 find functions in NotificationsService.swift that are not covered by tests185find functions in NotificationsService.swift that are not covered by tests

208 ```186```

209 </Step>187 

210 188**2. 테스트 스캐폴딩 생성**

211 <Step title="테스트 스캐폴딩 생성">189 

212 ```text wrap theme={null}190```text wrap theme={null}

213 add tests for the notification service191add tests for the notification service

214 ```192```

215 </Step>193 

216 194**3. 의미 있는 테스트 케이스 추가**

217 <Step title="의미 있는 테스트 케이스 추가">195 

218 ```text wrap theme={null}196```text wrap theme={null}

219 add test cases for edge conditions in the notification service197add test cases for edge conditions in the notification service

220 ```198```

221 </Step>199 

222 200**4. 테스트 실행 및 검증**

223 <Step title="테스트 실행 및 검증">201 

224 ```text wrap theme={null}202```text wrap theme={null}

225 run the new tests and fix any failures203run the new tests and fix any failures

226 ```204```

227 </Step>

228</Steps>

229 205 

230Claude는 프로젝트의 기존 패턴과 규칙을 따르는 테스트를 생성할 수 있습니다. 테스트를 요청할 때 검증하려는 동작에 대해 구체적으로 설명하십시오. Claude는 기존 테스트 파일을 검토하여 이미 사용 중인 스타일, 프레임워크 및 어설션 패턴을 일치시킵니다.206Claude는 프로젝트의 기존 패턴과 규칙을 따르는 테스트를 생성할 수 있습니다. 테스트를 요청할 때 검증하려는 동작에 대해 구체적으로 설명하십시오. Claude는 기존 테스트 파일을 검토하여 이미 사용 중인 스타일, 프레임워크 및 어설션 패턴을 일치시킵니다.

231 207 

233 209 

234***210***

235 211 

236<h3 id="create-pull-requests">212### 풀 요청 만들기

237 풀 요청 만들기

238</h3>

239 213 

240Claude에게 직접 풀 요청을 만들도록 요청하거나 ("create a pr for my changes"), 단계별로 Claude를 안내할 수 있습니다:214Claude에게 직접 풀 요청을 만들도록 요청하거나 ("create a pr for my changes"), 단계별로 Claude를 안내할 수 있습니다:

241 215 

242<Steps>216**1. 변경사항 요약하기**

243 <Step title="변경사항 요약하기">217 

244 ```text wrap theme={null}218```text wrap theme={null}

245 summarize the changes I've made to the authentication module219summarize the changes I've made to the authentication module

246 ```220```

247 </Step>221 

248 222**2. 풀 요청 생성하기**

249 <Step title="풀 요청 생성하기">223 

250 ```text wrap theme={null}224```text wrap theme={null}

251 create a pr225create a pr

252 ```226```

253 </Step>227 

254 228**3. 검토 및 정제하기**

255 <Step title="검토 및 정제하기">229 

256 ```text wrap theme={null}230```text wrap theme={null}

257 enhance the PR description with more context about the security improvements231enhance the PR description with more context about the security improvements

258 ```232```

259 </Step>

260</Steps>

261 233 

262나중에 세션을 찾으려면 `claude --from-pr 1234`를 자신의 PR 번호로 실행하여 해당 PR에 연결된 세션으로 필터링된 세션 선택기를 열거나, [`/resume` 선택기](/docs/ko/sessions#use-the-session-picker) 검색에 PR URL을 붙여넣으십시오. Claude Code는 Claude가 `gh pr create` 또는 `glab mr create`로 생성할 때, 그리고 Claude가 [기존 PR에서 작업할](/docs/ko/agent-view#pull-request-status) 때 세션을 PR에 연결합니다.234나중에 세션을 찾으려면 `claude --from-pr 1234`를 자신의 PR 번호로 실행하여 해당 PR에 연결된 세션으로 필터링된 세션 선택기를 열거나, [`/resume` 선택기](/docs/ko/sessions#use-the-session-picker) 검색에 PR URL을 붙여넣으십시오. Claude Code는 Claude가 `gh pr create` 또는 `glab mr create`로 생성할 때, 그리고 Claude가 [기존 PR에서 작업할](/docs/ko/agent-view#pull-request-status) 때 세션을 PR에 연결합니다.

263 235 

264<Tip>236> [!TIP]

265 Claude가 생성한 PR을 제출하기 전에 검토하고 Claude에게 잠재적 위험이나 고려사항을 강조하도록 요청하십시오.237>

266</Tip>238> Claude가 생성한 PR을 제출하기 전에 검토하고 Claude에게 잠재적 위험이나 고려사항을 강조하도록 요청하십시오.

267 239 

268<h3 id="handle-documentation">240### 문서 처리하기

269 문서 처리하기

270</h3>

271 241 

272코드에 대한 문서를 추가하거나 업데이트해야 한다고 가정해봅시다.242코드에 대한 문서를 추가하거나 업데이트해야 한다고 가정해봅시다.

273 243 

274<Steps>244**1. 문서화되지 않은 코드 식별**

275 <Step title="문서화되지 않은 코드 식별">245 

276 ```text wrap theme={null}246```text wrap theme={null}

277 find functions without proper JSDoc comments in the auth module247find functions without proper JSDoc comments in the auth module

278 ```248```

279 </Step>249 

280 250**2. 문서 생성하기**

281 <Step title="문서 생성하기">251 

282 ```text wrap theme={null}252```text wrap theme={null}

283 add JSDoc comments to the undocumented functions in auth.js253add JSDoc comments to the undocumented functions in auth.js

284 ```254```

285 </Step>255 

286 256**3. 검토 및 개선하기**

287 <Step title="검토 및 개선하기">257 

288 ```text wrap theme={null}258```text wrap theme={null}

289 improve the generated documentation with more context and examples259improve the generated documentation with more context and examples

290 ```260```

291 </Step>261 

292 262**4. 문서 검증하기**

293 <Step title="문서 검증하기">263 

294 ```text wrap theme={null}264```text wrap theme={null}

295 check if the documentation follows our project standards265check if the documentation follows our project standards

296 ```266```

297 </Step>267 

298</Steps>268> [!TIP]

299 269>

300<Tip>270> 팁:

301 팁:271>

302 272> * 원하는 문서 스타일 지정하기 (JSDoc, docstring 등)

303 * 원하는 문서 스타일 지정하기 (JSDoc, docstring 등)273> * 문서에 예제 요청하기

304 * 문서에 예제 요청하기274> * 공개 API, 인터페이스 및 복잡한 로직에 대한 문서 요청하기

305 * 공개 API, 인터페이스 및 복잡한 로직에 대한 문서 요청하기

306</Tip>

307 275 

308***276***

309 277 

310<h3 id="work-in-notes-and-non-code-folders">278### 노트 및 비코드 폴더에서 작업하기

311 노트 및 비코드 폴더에서 작업하기

312</h3>

313 279 

314Claude Code는 모든 디렉토리에서 작동합니다. 노트 저장소, 문서 폴더 또는 마크다운 파일의 모든 컬렉션 내에서 실행하여 코드처럼 콘텐츠를 검색, 편집 및 재구성합니다.280Claude Code는 모든 디렉토리에서 작동합니다. 노트 저장소, 문서 폴더 또는 마크다운 파일의 모든 컬렉션 내에서 실행하여 코드처럼 콘텐츠를 검색, 편집 및 재구성합니다.

315 281 

317 283 

318***284***

319 285 

320<h3 id="work-with-images">286### 이미지 작업하기

321 이미지 작업하기

322</h3>

323 287 

324코드베이스에서 이미지를 작업해야 하고 Claude의 이미지 콘텐츠 분석 도움을 원한다고 가정해봅시다.288코드베이스에서 이미지를 작업해야 하고 Claude의 이미지 콘텐츠 분석 도움을 원한다고 가정해봅시다.

325 289 

326<Steps>290**1. 대화에 이미지 추가하기**

327 <Step title="대화에 이미지 추가하기">291 

328 다음 방법 중 하나를 사용할 수 있습니다:292다음 방법 중 하나를 사용할 수 있습니다:

329 293 

330 1. Claude Code 창으로 이미지를 드래그 앤 드롭하기2941. Claude Code 창으로 이미지를 드래그 앤 드롭하기

331 2. 이미지를 복사하고 `Ctrl+V`로 CLI에 붙여넣기, 또는 [`Alt+V` (Windows 및 WSL)](/docs/ko/interactive-mode#general-controls)로 붙여넣기2952. 이미지를 복사하고 `Ctrl+V`로 CLI에 붙여넣기, 또는 [`Alt+V` (Windows 및 WSL)](/docs/ko/interactive-mode#general-controls)로 붙여넣기

332 3. Claude에 이미지 경로 제공하기. 예: "Analyze this image: /path/to/your/image.png"2963. Claude에 이미지 경로 제공하기. 예: "Analyze this image: /path/to/your/image.png"

333 </Step>297 

334 298**2. Claude에게 이미지 분석 요청하기**

335 <Step title="Claude에게 이미지 분석 요청하기">299 

336 ```text wrap theme={null}300```text wrap theme={null}

337 What does this image show?301What does this image show?

338 ```302```

339 303 

340 ```text wrap theme={null}304```text wrap theme={null}

341 Describe the UI elements in this screenshot305Describe the UI elements in this screenshot

342 ```306```

343 307 

344 ```text wrap theme={null}308```text wrap theme={null}

345 Are there any problematic elements in this diagram?309Are there any problematic elements in this diagram?

346 ```310```

347 </Step>311 

348 312**3. 컨텍스트를 위해 이미지 사용하기**

349 <Step title="컨텍스트를 위해 이미지 사용하기">313 

350 ```text wrap theme={null}314```text wrap theme={null}

351 Here's a screenshot of the error. What's causing it?315Here's a screenshot of the error. What's causing it?

352 ```316```

353 317 

354 ```text wrap theme={null}318```text wrap theme={null}

355 This is our current database schema. How should we modify it for the new feature?319This is our current database schema. How should we modify it for the new feature?

356 ```320```

357 </Step>321 

358 322**4. 시각적 콘텐츠에서 코드 제안 얻기**

359 <Step title="시각적 콘텐츠에서 코드 제안 얻기">323 

360 ```text wrap theme={null}324```text wrap theme={null}

361 Generate CSS to match this design mockup325Generate CSS to match this design mockup

362 ```326```

363 327 

364 ```text wrap theme={null}328```text wrap theme={null}

365 What HTML structure would recreate this component?329What HTML structure would recreate this component?

366 ```330```

367 </Step>331 

368</Steps>332> [!TIP]

369 333>

370<Tip>334> 팁:

371 팁:335>

372 336> * 텍스트 설명이 불명확하거나 번거로울 때 이미지 사용하기

373 * 텍스트 설명이 불명확하거나 번거로울 때 이미지 사용하기337> * 더 나은 컨텍스트를 위해 오류, UI 디자인 또는 다이어그램의 스크린샷 포함하기

374 * 더 나은 컨텍스트를 위해 오류, UI 디자인 또는 다이어그램의 스크린샷 포함하기338> * 대화에서 여러 이미지를 작업할 수 있습니다

375 * 대화에서 여러 이미지를 작업할 수 있습니다339> * 이미지 분석은 다이어그램, 스크린샷, 목업 등과 함께 작동합니다

376 * 이미지 분석은 다이어그램, 스크린샷, 목업 등과 함께 작동합니다340> * Claude가 이미지를 참조할 때 (예: `[Image #1]`), `Cmd+Click` (Mac) 또는 `Ctrl+Click` (Windows/Linux)을 클릭하여 기본 뷰어에서 이미지를 엽니다

377 * Claude가 이미지를 참조할 때 (예: `[Image #1]`), `Cmd+Click` (Mac) 또는 `Ctrl+Click` (Windows/Linux)을 클릭하여 기본 뷰어에서 이미지를 엽니다

378</Tip>

379 341 

380***342***

381 343 

382<h3 id="reference-files-and-directories">344### 파일 및 디렉토리 참조하기

383 파일 및 디렉토리 참조하기

384</h3>

385 345 

386@를 사용하여 Claude가 읽을 때까지 기다리지 않고 파일이나 디렉토리를 빠르게 포함합니다.346@를 사용하여 Claude가 읽을 때까지 기다리지 않고 파일이나 디렉토리를 빠르게 포함합니다.

387 347 

388<Steps>348**1. 단일 파일 참조하기**

389 <Step title="단일 파일 참조하기">

390 ```text wrap theme={null}

391 Explain the logic in @src/utils/auth.js

392 ```

393 349 

394 파일이 [Read 도구](/docs/ko/tools-reference#read-tool-behavior)의 토큰 한도(기본값 25,000 토큰) 내에 들어가는 경우 파일의 내용이 대화에 포함됩니다. 256KB보다 큰 텍스트 파일은 포함되지 않습니다.350```text wrap theme={null}

395 </Step>351Explain the logic in @src/utils/auth.js

352```

353 

354파일이 [Read 도구](/docs/ko/tools-reference#read-tool-behavior)의 토큰 한도(기본값 25,000 토큰) 내에 들어가는 경우 파일의 내용이 대화에 포함됩니다. 256KB보다 큰 텍스트 파일은 포함되지 않습니다.

396 355 

397 <Step title="디렉토리 참조하기">356**2. 디렉토리 참조하기**

398 ```text wrap theme={null}357 

399 What's the structure of @src/components?358```text wrap theme={null}

400 ```359What's the structure of @src/components?

401 </Step>360```

402 361 

403 <Step title="MCP 리소스 참조하기">362**3. MCP 리소스 참조하기**

404 ```text wrap theme={null}

405 Show me the data from @github:repos/owner/repo/issues

406 ```

407 363 

408 이것은 @server:resource 형식을 사용하여 연결된 MCP 서버에서 데이터를 가져옵니다. 자세한 내용은 [MCP 리소스](/docs/ko/mcp#use-mcp-resources)를 참조하십시오.364```text wrap theme={null}

409 </Step>365Show me the data from @github:repos/owner/repo/issues

410</Steps>366```

411 367 

412<Tip>368이것은 @server:resource 형식을 사용하여 연결된 MCP 서버에서 데이터를 가져옵니다. 자세한 내용은 [MCP 리소스](/docs/ko/mcp#use-mcp-resources)를 참조하십시오.

413 팁:

414 369 

415 * 파일 경로는 상대 또는 절대 경로일 수 있습니다370> [!TIP]

416 * `@`를 입력하여 경로 제안 메뉴를 열고, Enter 또는 Tab을 눌러 강조 표시된 경로를 수락한 다음 다시 Enter를 눌러 메시지를 보내기371>

417 * @ 파일 참조는 파일의 디렉토리 및 상위 디렉토리에 `CLAUDE.md`를 추가합니다372> 팁:

418 * 디렉토리 참조는 내용이 아닌 파일 목록을 표시합니다373>

419 * 단일 메시지에서 여러 파일을 참조할 수 있습니다 (예: "@file1.js and @file2.js")374> * 파일 경로는 상대 또는 절대 경로일 수 있습니다

420</Tip>375> * `@`를 입력하여 경로 제안 메뉴를 열고, Enter 또는 Tab을 눌러 강조 표시된 경로를 수락한 다음 다시 Enter를 눌러 메시지를 보내기

376> * @ 파일 참조는 파일의 디렉토리 및 상위 디렉토리에 `CLAUDE.md`를 추가합니다

377> * 디렉토리 참조는 내용이 아닌 파일 목록을 표시합니다

378> * 단일 메시지에서 여러 파일을 참조할 수 있습니다 (예: "@file1.js and @file2.js")

421 379 

422`@` 참조가 메시지에 파일 내용과 디렉토리 목록을 포함하지 않도록 하려면 셸 또는 사용자 설정에서 [`CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`](/docs/ko/env-vars#variables)을 설정하십시오. 그러면 Claude는 참조된 경로를 받으며, 파일 도구를 사용해 해당 경로를 읽으라는 안내도 함께 받습니다. 이 변수는 Claude Code v2.1.299 이상이 필요하며, Claude Code는 프로젝트 및 로컬 설정에서는 이 변수를 무시합니다.380`@` 참조가 메시지에 파일 내용과 디렉토리 목록을 포함하지 않도록 하려면 셸 또는 사용자 설정에서 [`CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`](/docs/ko/env-vars#variables)을 설정하십시오. 그러면 Claude는 참조된 경로를 받으며, 파일 도구를 사용해 해당 경로를 읽으라는 안내도 함께 받습니다. 이 변수는 Claude Code v2.1.299 이상이 필요하며, Claude Code는 프로젝트 및 로컬 설정에서는 이 변수를 무시합니다.

423 381 

424***382***

425 383 

426<h3 id="run-claude-on-a-schedule">384### 일정에 따라 Claude 실행하기

427 일정에 따라 Claude 실행하기

428</h3>

429 385 

430Claude가 정기적으로 작업을 자동으로 처리하도록 하고 싶다고 가정해봅시다. 예를 들어 매일 아침 열린 PR을 검토하거나, 매주 종속성을 감사하거나, 밤새 CI 실패를 확인합니다.386Claude가 정기적으로 작업을 자동으로 처리하도록 하고 싶다고 가정해봅시다. 예를 들어 매일 아침 열린 PR을 검토하거나, 매주 종속성을 감사하거나, 밤새 CI 실패를 확인합니다.

431 387 

433 389 

434| 옵션 | 실행 위치 | 최적 사용 |390| 옵션 | 실행 위치 | 최적 사용 |

435| :- | :- | :- |391| :- | :- | :- |

436| [Routines](/docs/ko/routines) | 클라우드, Anthropic 관리 기본값 | 컴퓨터가 꺼져 있어도 실행되어야 하는 작업. API 호출 또는 GitHub 이벤트 외에도 일정에 따라 트리거될 수 있습니다. [claude.ai/code/routines](https://claude.ai/code/routines)에서 구성합니다. |392| [클라우드 예약 작업](/docs/ko/routines) | 클라우드, 기본적으로 Anthropic 관리 | 컴퓨터가 꺼져 있어도 실행되어야 하는 작업. 일정 외에도 API 호출 또는 GitHub 이벤트에 따라 트리거될 수 있습니다. [claude.ai/code/routines](https://claude.ai/code/routines)에서 구성합니다. |

437| [데스크톱 예약 작업](/docs/ko/desktop-scheduled-tasks) | 데스크톱 앱을 통한 컴퓨터 | 로컬 파일, 도구 또는 커밋되지 않은 변경사항에 직접 액세스해야 하는 작업. |393| [데스크톱 예약 작업](/docs/ko/desktop-scheduled-tasks) | 데스크톱 앱을 통한 컴퓨터 | 로컬 파일, 도구 또는 커밋되지 않은 변경사항에 직접 액세스해야 하는 작업. |

438| [GitHub Actions](/docs/ko/github-actions) | CI 파이프라인 | 열린 PR 또는 cron 일정과 같은 저장소 이벤트와 연결된 작업. 워크플로우 구성과 함께 있어야 합니다. |394| [GitHub Actions](/docs/ko/github-actions) | CI 파이프라인 | 열린 PR 또는 cron 일정과 같은 저장소 이벤트와 연결된 작업. 워크플로우 구성과 함께 있어야 합니다. |

439| [`/loop`](/docs/ko/scheduled-tasks) | 현재 CLI 세션 | 세션이 열려 있는 동안 빠른 폴링. `--resume` 및 `--continue`는 만료되지 않은 것을 복원합니다. |395| [`/loop`](/docs/ko/scheduled-tasks) | 현재 CLI 세션 | 세션이 열려 있는 동안 빠른 폴링. `--resume` 및 `--continue`는 만료되지 않은 것을 복원합니다. |

440 396 

441<Tip>397> [!TIP]

442 예약된 작업을 위한 프롬프트를 작성할 때 성공이 무엇인지, 결과를 어떻게 처리할지 명시적으로 설명하십시오. 작업이 자동으로 실행되므로 명확한 질문을 할 수 없습니다. 예를 들어: "Review open PRs labeled `needs-review`, leave inline comments on any issues, and post a summary in the `#eng-reviews` Slack channel."398>

443</Tip>399> 예약된 작업을 위한 프롬프트를 작성할 때 성공이 무엇인지, 결과를 어떻게 처리할지 명시적으로 설명하십시오. 작업이 자동으로 실행되므로 명확한 질문을 할 수 없습니다. 예를 들어: "Review open PRs labeled `needs-review`, leave inline comments on any issues, and post a summary in the `#eng-reviews` Slack channel."

444 400 

445***401***

446 402 

447<h3 id="ask-claude-about-its-capabilities">403### Claude의 기능에 대해 Claude에게 물어보기

448 Claude의 기능에 대해 Claude에게 물어보기

449</h3>

450 404 

451Claude는 자신의 기능과 제한사항에 대한 질문에 답할 수 있습니다. 최신 Claude Code 문서에서 답변을 찾으므로, 답변이 사용 중인 버전에 국한되지 않습니다.405Claude는 자신의 기능과 제한사항에 대한 질문에 답할 수 있습니다. 최신 Claude Code 문서에서 답변을 찾으므로, 답변이 사용 중인 버전에 국한되지 않습니다.

452 406 

453<h4 id="example-questions">407#### 예제 질문

454 예제 질문

455</h4>

456 408 

457```text wrap theme={null}409```text wrap theme={null}

458can Claude Code create pull requests?410can Claude Code create pull requests?

478what are the limitations of Claude Code?430what are the limitations of Claude Code?

479```431```

480 432 

481<Note>433> [!NOTE]

482 Claude는 이러한 질문에 대해 문서 기반 답변을 제공합니다. 실행 가능한 예제 및 실습 시연을 위해 `/powerup`을 실행하여 애니메이션 데모가 있는 대화형 수업을 받거나 위의 특정 워크플로우 섹션을 참조하십시오.434>

483</Note>435> Claude는 이러한 질문에 대해 문서 기반 답변을 제공합니다. 실행 가능한 예제 및 실습 시연을 위해 `/powerup`을 실행하여 애니메이션 데모가 있는 대화형 수업을 받거나 위의 특정 워크플로우 섹션을 참조하십시오.

484 

485<Tip>

486 팁:

487 436 

488 * 자세한 답변을 얻으려면 구체적인 질문을 하십시오437> [!TIP]

489 * Claude는 MCP 통합, 엔터프라이즈 구성 및 고급 워크플로우와 같은 복잡한 기능을 설명할 수 있습니다438>

490</Tip>439> 팁:

440>

441> * 자세한 답변을 얻으려면 구체적인 질문을 하십시오

442> * Claude는 MCP 통합, 엔터프라이즈 구성 및 고급 워크플로우와 같은 복잡한 기능을 설명할 수 있습니다

491 443 

492***444***

493 445 

494<h2 id="resume-previous-conversations">446## 이전 대화 재개하기

495 이전 대화 재개하기

496</h2>

497 447 

498작업이 여러 세션에 걸쳐 진행될 때 컨텍스트를 다시 설명하는 대신 중단한 부분부터 계속합니다. Claude Code는 모든 대화를 로컬에 저장합니다.448작업이 여러 세션에 걸쳐 진행될 때 컨텍스트를 다시 설명하는 대신 중단한 부분부터 계속합니다. Claude Code는 모든 대화를 로컬에 저장합니다.

499 449 

503 453 

504이것은 현재 디렉토리에서 가장 최근 세션을 재개합니다. 아직 없으면 `No conversation found to continue`를 출력하고 종료합니다. `claude --resume`을 사용하여 목록에서 선택하거나 실행 중인 세션 내에서 `/resume`을 사용합니다. [세션 관리](/docs/ko/sessions)에서 이름 지정, 분기 및 전체 선택기 참조를 참조하십시오.454이것은 현재 디렉토리에서 가장 최근 세션을 재개합니다. 아직 없으면 `No conversation found to continue`를 출력하고 종료합니다. `claude --resume`을 사용하여 목록에서 선택하거나 실행 중인 세션 내에서 `/resume`을 사용합니다. [세션 관리](/docs/ko/sessions)에서 이름 지정, 분기 및 전체 선택기 참조를 참조하십시오.

505 455 

506<h2 id="run-parallel-sessions-with-worktrees">456## worktree를 사용하여 병렬 세션 실행하기

507 worktree를 사용하여 병렬 세션 실행하기

508</h2>

509 457 

510한 터미널에서 기능을 작업하는 동안 Claude가 다른 터미널에서 버그를 수정하며, 편집이 충돌하지 않습니다. 각 [git worktree](https://git-scm.com/docs/git-worktree)는 기존 커밋에서 생성된 자체 분기의 별도 체크아웃이므로, 저장소는 먼저 최소한 하나의 커밋이 필요합니다.458한 터미널에서 기능을 작업하는 동안 Claude가 다른 터미널에서 버그를 수정하며, 편집이 충돌하지 않습니다. 각 [git worktree](https://git-scm.com/docs/git-worktree)는 기존 커밋에서 생성된 자체 분기의 별도 체크아웃이므로, 저장소는 먼저 최소한 하나의 커밋이 필요합니다.

511 459 

515 463 

516다른 이름으로 두 번째 터미널에서 동일한 명령을 실행하여 격리된 병렬 세션을 시작합니다. 커밋이 없는 저장소에서는 명령이 `Failed to resolve base branch "HEAD": git rev-parse failed` 오류로 실패합니다. 정리, `.worktreeinclude` 및 비git VCS 지원에 대해서는 [Worktrees](/docs/ko/worktrees)를 참조하십시오. 별도의 터미널 대신 한 화면에서 병렬 세션을 모니터링하려면 [백그라운드 에이전트](/docs/ko/agent-view)를 참조하십시오.464다른 이름으로 두 번째 터미널에서 동일한 명령을 실행하여 격리된 병렬 세션을 시작합니다. 커밋이 없는 저장소에서는 명령이 `Failed to resolve base branch "HEAD": git rev-parse failed` 오류로 실패합니다. 정리, `.worktreeinclude` 및 비git VCS 지원에 대해서는 [Worktrees](/docs/ko/worktrees)를 참조하십시오. 별도의 터미널 대신 한 화면에서 병렬 세션을 모니터링하려면 [백그라운드 에이전트](/docs/ko/agent-view)를 참조하십시오.

517 465 

518<h2 id="plan-before-editing">466## 편집 전에 계획하기

519 편집 전에 계획하기

520</h2>

521 467 

522변경사항이 디스크에 닿기 전에 검토하려는 경우 계획 모드로 전환합니다. Claude는 파일을 읽고 계획을 제안하지만 승인할 때까지 편집하지 않습니다. 상태 표시줄에 `⏸ plan mode on`이 표시되어 계획 모드가 활성화되어 있음을 나타냅니다.468변경사항이 디스크에 닿기 전에 검토하려는 경우 계획 모드로 전환합니다. Claude는 파일을 읽고 계획을 제안하지만 승인할 때까지 편집하지 않습니다. 상태 표시줄에 `⏸ plan mode on`이 표시되어 계획 모드가 활성화되어 있음을 나타냅니다.

523 469 

527 473 

528세션 중에 `Shift+Tab`을 눌러 상태 표시줄에 `⏸ plan mode on`이 표시될 때까지 계획 모드로 전환할 수도 있습니다. 승인 흐름 및 텍스트 편집기에서 계획 편집에 대해서는 [계획 모드](/docs/ko/permission-modes#analyze-before-you-edit-with-plan-mode)를 참조하십시오.474세션 중에 `Shift+Tab`을 눌러 상태 표시줄에 `⏸ plan mode on`이 표시될 때까지 계획 모드로 전환할 수도 있습니다. 승인 흐름 및 텍스트 편집기에서 계획 편집에 대해서는 [계획 모드](/docs/ko/permission-modes#analyze-before-you-edit-with-plan-mode)를 참조하십시오.

529 475 

530<h2 id="delegate-research-to-subagents">476## subagent에게 연구 위임하기

531 subagent에게 연구 위임하기

532</h2>

533 477 

534큰 코드베이스를 탐색하면 컨텍스트가 파일 읽기로 채워집니다. 탐색을 위임하여 결과만 돌아오도록 합니다.478큰 코드베이스를 탐색하면 컨텍스트가 파일 읽기로 채워집니다. 탐색을 위임하여 결과만 돌아오도록 합니다.

535 479 

539 483 

540subagent는 자체 컨텍스트 윈도우에서 파일을 읽고 요약을 보고합니다. [Subagents](/docs/ko/sub-agents)에서 자체 도구 및 프롬프트가 있는 사용자 정의 에이전트 정의를 참조하십시오.484subagent는 자체 컨텍스트 윈도우에서 파일을 읽고 요약을 보고합니다. [Subagents](/docs/ko/sub-agents)에서 자체 도구 및 프롬프트가 있는 사용자 정의 에이전트 정의를 참조하십시오.

541 485 

542<h2 id="pipe-claude-into-scripts">486## Claude를 스크립트로 파이프하기

543 Claude를 스크립트로 파이프하기

544</h2>

545 487 

546CI, 사전 커밋 훅 또는 배치 처리를 위해 Claude를 비대화형으로 실행합니다. stdin 및 stdout은 모든 Unix 도구처럼 작동합니다.488CI, 사전 커밋 훅 또는 배치 처리를 위해 Claude를 비대화형으로 실행합니다. stdin 및 stdout은 모든 Unix 도구처럼 작동합니다.

547 489 

551 493 

552[비대화형 모드](/docs/ko/headless)에서 출력 형식, 권한 플래그 및 팬아웃 패턴을 참조하십시오.494[비대화형 모드](/docs/ko/headless)에서 출력 형식, 권한 플래그 및 팬아웃 패턴을 참조하십시오.

553 495 

554<h2 id="next-steps">496## 다음 단계

555 다음 단계

556</h2>

557 497 

558<CardGroup cols={2}>498> **[모범 사례](/docs/ko/best-practices)**

559 <Card title="모범 사례" icon="lightbulb" href="/docs/ko/best-practices">499>

560 Claude Code에서 최대한 활용하기 위한 패턴500> Claude Code에서 최대한 활용하기 위한 패턴

561 </Card>

562 501 

563 <Card title="세션 관리" icon="rotate-left" href="/docs/ko/sessions">502> **[세션 관리](/docs/ko/sessions)**

564 대화 재개, 이름 지정 및 분기503>

565 </Card>504> 대화 재개, 이름 지정 및 분기

566 505 

567 <Card title="Worktrees" icon="code-branch" href="/docs/ko/worktrees">506> **[Worktrees](/docs/ko/worktrees)**

568 격리된 병렬 세션 실행507>

569 </Card>508> 격리된 병렬 세션 실행

570 509 

571 <Card title="Claude Code 확장하기" icon="puzzle-piece" href="/docs/ko/features-overview">510> **[Claude Code 확장하기](/docs/ko/features-overview)**

572 skill, hook, MCP, subagent 및 플러그인 추가511>

573 </Card>512> skill, hook, MCP, subagent 및 플러그인 추가

574</CardGroup>