6 6 

7> Claude Code를 사용하여 코드베이스 탐색, 버그 수정, 리팩토링, 테스트 및 기타 일상적인 작업을 위한 단계별 가이드입니다.7> Claude Code를 사용하여 코드베이스 탐색, 버그 수정, 리팩토링, 테스트 및 기타 일상적인 작업을 위한 단계별 가이드입니다.

8 8 

9이 페이지는 일상적인 개발을 위한 짧은 레시피를 모아놓았습니다. 프롬프팅 및 컨텍스트 관리에 대한 더 높은 수준의 지침은 [모범 사례](/ko/best-practices)를 참조하십시오.9이 페이지는 일상적인 개발을 위한 짧은 레시피를 모아놓았습니다. 프롬프팅 및 컨텍스트 관리에 대한 더 높은 수준의 지침은 [모범 사례](/docs/ko/best-practices)를 참조하십시오.

10 10 

11이 페이지는 다음을 다룹니다:11이 페이지는 다음을 다룹니다:

12 12 

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

28</h3>28</h3>

29 29 

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

31 31 

32<h4 id="get-a-quick-codebase-overview">32<h4 id="get-a-quick-codebase-overview">

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

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

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

42 ```42 ```

43 

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

43 </Step>45 </Step>

44 46 

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

49 </Step>51 </Step>

50 52 

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

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

53 give me an overview of this codebase55 give me an overview of this codebase

54 ```56 ```

55 </Step>57 </Step>

56 58 

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

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

59 explain the main architecture patterns used here61 explain the main architecture patterns used here

60 ```62 ```

61 63 

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

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

64 ```66 ```

65 67 

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

67 how is authentication handled?69 how is authentication handled?

68 ```70 ```

69 </Step>71 </Step>

85 87 

86<Steps>88<Steps>

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

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

89 find the files that handle user authentication91 find the files that handle user authentication

90 ```92 ```

91 </Step>93 </Step>

92 94 

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

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

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

96 ```98 ```

97 </Step>99 </Step>

98 100 

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

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

101 trace the login process from front-end to database103 trace the login process from front-end to database

102 ```104 ```

103 </Step>105 </Step>

108 110 

109 * 찾고 있는 것에 대해 구체적으로 설명하기111 * 찾고 있는 것에 대해 구체적으로 설명하기

110 * 프로젝트의 도메인 언어 사용하기112 * 프로젝트의 도메인 언어 사용하기

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

112</Tip>114</Tip>

113 115 

114***116***

121 123 

122<Steps>124<Steps>

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

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

125 I'm seeing an error when I run npm test127 I'm seeing an error when I run npm test

126 ```128 ```

127 </Step>129 </Step>

128 130 

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

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

131 suggest a few ways to fix the @ts-ignore in user.ts133 suggest a few ways to fix the @ts-ignore in user.ts

132 ```134 ```

133 </Step>135 </Step>

134 136 

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

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

137 update user.ts to add the null check you suggested139 update user.ts to add the null check you suggested

138 ```140 ```

139 </Step>141 </Step>

155 157 

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

157 159 

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

161 

158<Steps>162<Steps>

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

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

161 find deprecated API usage in our codebase165 find deprecated API usage in our codebase

162 ```166 ```

163 </Step>167 </Step>

164 168 

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

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

167 suggest how to refactor utils.js to use modern JavaScript features171 suggest how to refactor utils.js to use modern JavaScript features

168 ```172 ```

169 </Step>173 </Step>

170 174 

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

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

173 refactor utils.js to use ES2024 features while maintaining the same behavior177 refactor utils.js to use ES2024 features while maintaining the same behavior

174 ```178 ```

175 </Step>179 </Step>

176 180 

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

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

179 run tests for the refactored code183 run tests for the refactored code

180 ```184 ```

181 </Step>185 </Step>

199 203 

200<Steps>204<Steps>

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

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

203 find functions in NotificationsService.swift that are not covered by tests207 find functions in NotificationsService.swift that are not covered by tests

204 ```208 ```

205 </Step>209 </Step>

206 210 

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

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

209 add tests for the notification service213 add tests for the notification service

210 ```214 ```

211 </Step>215 </Step>

212 216 

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

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

215 add test cases for edge conditions in the notification service219 add test cases for edge conditions in the notification service

216 ```220 ```

217 </Step>221 </Step>

218 222 

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

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

221 run the new tests and fix any failures225 run the new tests and fix any failures

222 ```226 ```

223 </Step>227 </Step>

237 241 

238<Steps>242<Steps>

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

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

241 summarize the changes I've made to the authentication module245 summarize the changes I've made to the authentication module

242 ```246 ```

243 </Step>247 </Step>

244 248 

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

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

247 create a pr251 create a pr

248 ```252 ```

249 </Step>253 </Step>

250 254 

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

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

253 enhance the PR description with more context about the security improvements257 enhance the PR description with more context about the security improvements

254 ```258 ```

255 </Step>259 </Step>

256</Steps>260</Steps>

257 261 

258`gh pr create`를 사용하여 PR을 만들면 세션이 자동으로 해당 PR에 연결됩니다. 나중에 `claude --from-pr 123`으로 재개하거나 (123을 PR 번호로 바꾸기), [`/resume` 선택기](/ko/sessions#use-the-session-picker)에 PR URL을 붙여넣어 재개할 수 있습니다.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에 연결합니다.

259 263 

260<Tip>264<Tip>

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

269 273 

270<Steps>274<Steps>

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

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

273 find functions without proper JSDoc comments in the auth module277 find functions without proper JSDoc comments in the auth module

274 ```278 ```

275 </Step>279 </Step>

276 280 

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

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

279 add JSDoc comments to the undocumented functions in auth.js283 add JSDoc comments to the undocumented functions in auth.js

280 ```284 ```

281 </Step>285 </Step>

282 286 

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

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

285 improve the generated documentation with more context and examples289 improve the generated documentation with more context and examples

286 ```290 ```

287 </Step>291 </Step>

288 292 

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

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

291 check if the documentation follows our project standards295 check if the documentation follows our project standards

292 ```296 ```

293 </Step>297 </Step>

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

325 329 

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

327 2. 이미지를 복사하고 Ctrl+V로 CLI에 붙여넣기. macOS에서는 iTerm2에서도 Cmd+V가 작동합니다.331 2. 이미지를 복사하고 `Ctrl+V`로 CLI에 붙여넣기, 또는 [`Alt+V` (Windows 및 WSL)](/docs/ko/interactive-mode#general-controls)로 붙여넣기

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

329 </Step>333 </Step>

330 334 

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

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

333 What does this image show?337 What does this image show?

334 ```338 ```

335 339 

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

337 Describe the UI elements in this screenshot341 Describe the UI elements in this screenshot

338 ```342 ```

339 343 

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

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

342 ```346 ```

343 </Step>347 </Step>

344 348 

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

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

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

348 ```352 ```

349 353 

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

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

352 ```356 ```

353 </Step>357 </Step>

354 358 

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

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

357 Generate CSS to match this design mockup361 Generate CSS to match this design mockup

358 ```362 ```

359 363 

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

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

362 ```366 ```

363 </Step>367 </Step>

383 387 

384<Steps>388<Steps>

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

386 ```text theme={null}390 ```text wrap theme={null}

387 Explain the logic in @src/utils/auth.js391 Explain the logic in @src/utils/auth.js

388 ```392 ```

389 393 

391 </Step>395 </Step>

392 396 

393 <Step title="디렉토리 참조하기">397 <Step title="디렉토리 참조하기">

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

395 What's the structure of @src/components?399 What's the structure of @src/components?

396 ```400 ```

397 

398 이것은 파일 정보가 있는 디렉토리 목록을 제공합니다.

399 </Step>401 </Step>

400 402 

401 <Step title="MCP 리소스 참조하기">403 <Step title="MCP 리소스 참조하기">

402 ```text theme={null}404 ```text wrap theme={null}

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

404 ```406 ```

405 407 

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

407 </Step>409 </Step>

408</Steps>410</Steps>

409 411 

411 팁:413 팁:

412 414 

413 * 파일 경로는 상대 또는 절대 경로일 수 있습니다415 * 파일 경로는 상대 또는 절대 경로일 수 있습니다

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

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

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

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

427작업을 실행할 위치에 따라 일정 옵션을 선택합니다:430작업을 실행할 위치에 따라 일정 옵션을 선택합니다:

428 431 

429| 옵션 | 실행 위치 | 최적 사용 |432| 옵션 | 실행 위치 | 최적 사용 |

430| :---------------------------------------- | :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |433| :---------------------------------------- | :--------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |

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

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

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

434| [`/loop`](/ko/scheduled-tasks) | 현재 CLI 세션 | 세션이 열려 있는 동안 빠른 폴링. 새 대화를 시작하면 작업이 중지됩니다. `--resume` 및 `--continue`는 만료되지 않은 것을 복원합니다. |437| [`/loop`](/docs/ko/scheduled-tasks) | 현재 CLI 세션 | 세션이 열려 있는 동안 빠른 폴링. 새 대화를 시작하면 작업이 중지됩니다. `--resume` 및 `--continue`는 만료되지 않은 것을 복원합니다. |

435 438 

436<Tip>439<Tip>

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

449 예제 질문452 예제 질문

450</h4>453</h4>

451 454 

452```text theme={null}455```text wrap theme={null}

453can Claude Code create pull requests?456can Claude Code create pull requests?

454```457```

455 458 

456```text theme={null}459```text wrap theme={null}

457how does Claude Code handle permissions?460how does Claude Code handle permissions?

458```461```

459 462 

460```text theme={null}463```text wrap theme={null}

461what skills are available?464what skills are available?

462```465```

463 466 

464```text theme={null}467```text wrap theme={null}

465how do I use MCP with Claude Code?468how do I use MCP with Claude Code?

466```469```

467 470 

468```text theme={null}471```text wrap theme={null}

469how do I configure Claude Code for Amazon Bedrock?472how do I configure Claude Code for Amazon Bedrock?

470```473```

471 474 

472```text theme={null}475```text wrap theme={null}

473what are the limitations of Claude Code?476what are the limitations of Claude Code?

474```477```

475 478 

497claude --continue500claude --continue

498```501```

499 502 

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

501 504 

502<h2 id="run-parallel-sessions-with-worktrees">505<h2 id="run-parallel-sessions-with-worktrees">

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

504</h2>507</h2>

505 508 

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

507 510 

508```bash theme={null}511```bash theme={null}

509claude --worktree feature-auth512claude --worktree feature-auth

510```513```

511 514 

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

513 516 

514<h2 id="plan-before-editing">517<h2 id="plan-before-editing">

515 편집 전에 계획하기518 편집 전에 계획하기

516</h2>519</h2>

517 520 

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

519 522 

520```bash theme={null}523```bash theme={null}

521claude --permission-mode plan524claude --permission-mode plan

522```525```

523 526 

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

525 528 

526<h2 id="delegate-research-to-subagents">529<h2 id="delegate-research-to-subagents">

527 subagent에게 연구 위임하기530 subagent에게 연구 위임하기

529 532 

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

531 534 

532```text theme={null}535```text wrap theme={null}

533use a subagent to investigate how our auth system handles token refresh536use a subagent to investigate how our auth system handles token refresh

534```537```

535 538 

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

537 540 

538<h2 id="pipe-claude-into-scripts">541<h2 id="pipe-claude-into-scripts">

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

545git log --oneline -20 | claude -p "summarize these recent commits"548git log --oneline -20 | claude -p "summarize these recent commits"

546```549```

547 550 

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

549 552 

550<h2 id="next-steps">553<h2 id="next-steps">

551 다음 단계554 다음 단계

552</h2>555</h2>

553 556 

554<CardGroup cols={2}>557<CardGroup cols={2}>

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

556 Claude Code에서 최대한 활용하기 위한 패턴559 Claude Code에서 최대한 활용하기 위한 패턴

557 </Card>560 </Card>

558 561 

559 <Card title="세션 관리" icon="rotate-left" href="/ko/sessions">562 <Card title="세션 관리" icon="rotate-left" href="/docs/ko/sessions">

560 대화 재개, 이름 지정 및 분기563 대화 재개, 이름 지정 및 분기

561 </Card>564 </Card>

562 565 

563 <Card title="Worktrees" icon="code-branch" href="/ko/worktrees">566 <Card title="Worktrees" icon="code-branch" href="/docs/ko/worktrees">

564 격리된 병렬 세션 실행567 격리된 병렬 세션 실행

565 </Card>568 </Card>

566 569 

567 <Card title="Claude Code 확장하기" icon="puzzle-piece" href="/ko/features-overview">570 <Card title="Claude Code 확장하기" icon="puzzle-piece" href="/docs/ko/features-overview">

568 skill, hook, MCP, subagent 및 플러그인 추가571 skill, hook, MCP, subagent 및 플러그인 추가

569 </Card>572 </Card>

570</CardGroup>573</CardGroup>