15다음을 확인하십시오:15다음을 확인하십시오:

16 16 

17* 열려 있는 터미널 또는 명령 프롬프트17* 열려 있는 터미널 또는 명령 프롬프트

18 * 터미널을 처음 사용하는 경우 [터미널 가이드](/ko/terminal-guide)를 확인하십시오18 * 터미널을 처음 사용하는 경우 [터미널 가이드](/docs/ko/terminal-guide)를 확인하십시오

19* 작업할 코드 프로젝트19* 작업할 코드 프로젝트

20* [Claude 구독](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_prereq) (Pro, Max, Team 또는 Enterprise), [Claude Console](https://console.anthropic.com/) 계정 또는 [지원되는 클라우드 제공자](/ko/third-party-integrations)를 통한 액세스20* [Claude 구독](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_prereq) (Pro, Max, Team 또는 Enterprise), [Claude Console](https://platform.claude.com/) 계정 또는 [지원되는 클라우드 제공자](/docs/ko/third-party-integrations)를 통한 액세스

21 21 

22<Note>22<Note>

23 이 가이드는 터미널 CLI를 다룹니다. Claude Code는 [웹](https://claude.ai/code), [데스크톱 앱](/ko/desktop), [VS Code](/ko/vs-code) 및 [JetBrains IDE](/ko/jetbrains), [Slack](/ko/slack), [GitHub Actions](/ko/github-actions) 및 [GitLab](/ko/gitlab-ci-cd)의 CI/CD에서도 사용할 수 있습니다. [모든 인터페이스](/ko/overview#use-claude-code-everywhere)를 참조하십시오.23 이 가이드는 터미널 CLI를 다룹니다. Claude Code는 [웹](https://claude.ai/code), [데스크톱 앱](/docs/ko/desktop), [VS Code](/docs/ko/vs-code) 및 [JetBrains IDE](/docs/ko/jetbrains), [Slack](/docs/ko/slack), [GitHub Actions](/docs/ko/github-actions) 및 [GitLab](/docs/ko/gitlab-ci-cd)의 CI/CD에서도 사용할 수 있습니다. [모든 인터페이스](/docs/ko/overview#use-claude-code-everywhere)를 참조하십시오.

24</Note>24</Note>

25 25 

26<h2 id="step-1-install-claude-code">26<h2 id="step-1-install-claude-code">

33 <Tab title="Native Install (Recommended)">33 <Tab title="Native Install (Recommended)">

34 **macOS, Linux, WSL:**34 **macOS, Linux, WSL:**

35 35 

36 ```bash theme={null}36 ```bash theme={null} theme={null} theme={null} theme={null}

37 curl -fsSL https://claude.ai/install.sh | bash37 curl -fsSL https://claude.ai/install.sh | bash

38 ```38 ```

39 39 

40 **Windows PowerShell:**40 **Windows PowerShell:**

41 41 

42 ```powershell theme={null}42 ```powershell theme={null} theme={null} theme={null} theme={null}

43 irm https://claude.ai/install.ps1 | iex43 irm https://claude.ai/install.ps1 | iex

44 ```44 ```

45 45 

46 **Windows CMD:**46 **Windows CMD:**

47 47 

48 ```batch theme={null}48 ```batch theme={null} theme={null} theme={null} theme={null}

49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50 ```50 ```

51 51 

52 If you see `The token '&&' is not a valid statement separator`, you're in PowerShell, not CMD. If you see `'irm' is not recognized as an internal or external command`, you're in CMD, not PowerShell. Your prompt shows `PS C:\` when you're in PowerShell and `C:\` without the `PS` when you're in CMD.52 If you see `The token '&&' is not a valid statement separator`, you're in PowerShell, not CMD. If you see `'irm' is not recognized as an internal or external command`, you're in CMD, not PowerShell. Your prompt shows `PS C:\` when you're in PowerShell and `C:\` without the `PS` when you're in CMD.

53 53 

54 If the install command fails with `syntax error near unexpected token '<'`, a `403`, or another curl error, see [Troubleshoot installation](/en/troubleshoot-install#find-your-error) to match the error to a fix and for alternative install methods.54 If the install command fails with `syntax error near unexpected token '<'`, a `403`, or another curl error, see [Troubleshoot installation](/docs/en/troubleshoot-install#find-your-error) to match the error to a fix and for alternative install methods.

55 55 

56 [Git for Windows](https://git-scm.com/downloads/win) is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.56 [Git for Windows](https://git-scm.com/downloads/win) is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.

57 57 

61 </Tab>61 </Tab>

62 62 

63 <Tab title="Homebrew">63 <Tab title="Homebrew">

64 ```bash theme={null}64 ```bash theme={null} theme={null} theme={null} theme={null}

65 brew install --cask claude-code65 brew install --cask claude-code

66 ```66 ```

67 67 

73 </Tab>73 </Tab>

74 74 

75 <Tab title="WinGet">75 <Tab title="WinGet">

76 ```powershell theme={null}76 ```powershell theme={null} theme={null} theme={null} theme={null}

77 winget install Anthropic.ClaudeCode77 winget install Anthropic.ClaudeCode

78 ```78 ```

79 79 

83 </Tab>83 </Tab>

84</Tabs>84</Tabs>

85 85 

86You can also install with [apt, dnf, or apk](/en/setup#install-with-linux-package-managers) on Debian, Fedora, RHEL, and Alpine.86You can also install with [apt, dnf, or apk](/docs/en/setup#install-with-linux-package-managers) on Debian, Fedora, RHEL, and Alpine.

87 

88설치가 제대로 작동했는지 확인하려면 다음을 실행하세요:

89 

90```bash theme={null}

91claude --version

92```

93 

94이 명령어는 버전 번호 다음에 `(Claude Code)`를 출력합니다.

87 95 

88<h2 id="step-2-log-in-to-your-account">96<h2 id="step-2-log-in-to-your-account">

89 단계 2: 계정에 로그인97 단계 2: 계정에 로그인

95claude103claude

96```104```

97 105 

98Claude 구독 또는 Console 계정의 경우 프롬프트를 따라 브라우저에서 인증을 완료하십시오. 나중에 계정을 전환하거나 다시 인증하려면 실행 중인 세션 내에서 `/login`을 입력하십시오:106Claude 구독 또는 Console 계정의 경우 프롬프트를 따라 브라우저에서 인증을 완료하십시오. `ANTHROPIC_API_KEY` 환경 변수를 설정한 경우 Claude Code는 로그인 프롬프트를 건너뛰고 대신 키를 승인하도록 요청합니다. 나중에 계정을 전환하거나 다시 인증하려면 실행 중인 세션 내에서 `/login`을 입력하십시오:

99 107 

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

101/login109/login

102```110```

103 111 

104다음 계정 유형 중 하나를 사용하여 로그인할 수 있습니다:112다음 계정 유형 중 하나를 사용하여 로그인할 수 있습니다:

105 113 

106* [Claude Pro, Max, Team 또는 Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (권장)114* [Claude Pro, Max, Team 또는 Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (권장)

107* [Claude Console](https://console.anthropic.com/) (선불 크레딧이 있는 API 액세스). 처음 로그인할 때 비용 추적을 위해 Console에서 "Claude Code" 워크스페이스가 자동으로 생성됩니다.115* [Claude Console](https://platform.claude.com/) (선불 크레딧이 있는 API 액세스). 처음 로그인할 때 비용 추적을 위해 Console에서 "Claude Code" 워크스페이스가 자동으로 생성됩니다.

108* [Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry](/ko/third-party-integrations) (엔터프라이즈 클라우드 제공자)116* [Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry](/docs/ko/third-party-integrations) (엔터프라이즈 클라우드 제공자)

109* 조직에서 운영하는 자체 호스팅 [Claude 앱 게이트웨이](/ko/claude-apps-gateway): 관리자가 게이트웨이 URL을 미리 구성하고, `/login`을 입력하면 **Cloud gateway** 화면에서 직접 열려 기업 SSO로 로그인할 수 있습니다.117* 조직에서 운영하는 자체 호스팅 [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway): 관리자가 게이트웨이 URL을 미리 구성하고, `/login`을 입력하면 **Cloud gateway** 화면에서 직접 열려 기업 SSO로 로그인할 수 있습니다.

110 118 

111로그인하면 자격 증명이 저장되고 다시 로그인할 필요가 없습니다.119로그인하면 자격 증명이 저장되고 다시 로그인할 필요가 없습니다. [자격 증명 관리](/docs/ko/authentication#credential-management)에서 자세히 알아보십시오.

112 120 

113<h2 id="step-3-start-your-first-session">121<h2 id="step-3-start-your-first-session">

114 단계 3: 첫 번째 세션 시작122 단계 3: 첫 번째 세션 시작

121claude129claude

122```130```

123 131 

124버전, 현재 모델 및 작업 디렉토리가 표시된 Claude Code 프롬프트가 나타납니다. 사용 가능한 명령을 보려면 `/help`를 입력하거나 이전 대화를 계속하려면 `/resume`을 입력하십시오.132`/path/to/your/project`를 작업하려는 프로젝트의 경로로 바꾸십시오.

125 133 

126<Tip>134버전, 현재 모델 및 작업 디렉토리가 표시된 Claude Code 프롬프트가 나타납니다. 사용 가능한 명령을 보려면 `/help`를 입력하거나 이전 대화를 계속하려면 `/resume`을 입력하십시오.

127 로그인(단계 2) 후 자격 증명이 시스템에 저장됩니다. [자격 증명 관리](/ko/authentication#credential-management)에서 자세히 알아보십시오.

128</Tip>

129 135 

130<h2 id="step-4-ask-your-first-question">136<h2 id="step-4-ask-your-first-question">

131 단계 4: 첫 번째 질문 하기137 단계 4: 첫 번째 질문 하기

133 139 

134코드베이스를 이해하는 것부터 시작하겠습니다. 다음 명령 중 하나를 시도하십시오:140코드베이스를 이해하는 것부터 시작하겠습니다. 다음 명령 중 하나를 시도하십시오:

135 141 

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

137이 프로젝트는 무엇을 하나요?143what does this project do?

138```144```

139 145 

140Claude가 파일을 분석하고 요약을 제공합니다. 더 구체적인 질문을 할 수도 있습니다:146Claude가 파일을 분석하고 요약을 제공합니다. 더 구체적인 질문을 할 수도 있습니다:

141 147 

142```text theme={null}148```text wrap theme={null}

143이 프로젝트는 어떤 기술을 사용하나요?149what technologies does this project use?

144```150```

145 151 

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

147주요 진입점은 어디인가요?153where is the main entry point?

148```154```

149 155 

150```text theme={null}156```text wrap theme={null}

151폴더 구조를 설명해주세요157explain the folder structure

152```158```

153 159 

154Claude의 기능에 대해 물어볼 수도 있습니다:160Claude의 기능에 대해 물어볼 수도 있습니다:

155 161 

156```text theme={null}162```text wrap theme={null}

157Claude Code는 무엇을 할 수 있나요?163what can Claude Code do?

158```164```

159 165 

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

161Claude Code에서 사용자 정의 skills를 만드는 방법은?167how do I create custom skills in Claude Code?

162```168```

163 169 

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

165Claude Code는 Docker와 함께 작동할 수 있나요?171can Claude Code work with Docker?

166```172```

167 173 

168<Note>174<Note>

175 181 

176이제 Claude Code가 실제 코딩을 하도록 해봅시다. 간단한 작업을 시도하십시오:182이제 Claude Code가 실제 코딩을 하도록 해봅시다. 간단한 작업을 시도하십시오:

177 183 

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

179주 파일에 hello world 함수 추가185주 파일에 hello world 함수 추가

180```186```

181 187 

182Claude Code는 다음을 수행합니다:188Claude Code는 적절한 파일을 찾고 변경 사항을 보여줍니다. 변경하기 전에 묻는 경우 **예**를 선택하여 승인하십시오.

183 189 

1841. 적절한 파일 찾기190자동 모드는 Pro, Max 및 Team 플랜의 대화형 터미널 세션에 대한 [기본 제공 시작 권한 모드](/docs/ko/permission-modes#eliminate-prompts-with-auto-mode)입니다. 분류기가 사용자 대신 작업을 검토하며, Claude는 대부분의 파일을 편집하고 대부분의 명령을 묻지 않고 실행합니다. 다른 플랜에서는 수동 모드가 기본 제공 시작 권한 모드입니다. 설치 또는 업그레이드 직후에 시작하는 세션의 경우 [설치 또는 업그레이드 후 첫 번째 세션](/docs/ko/env-vars#first-session-after-an-install-or-upgrade)을 참조하십시오.

1852. 제안된 변경 사항 표시

1863. 승인 요청

1874. 편집 수행

188 191 

189<Note>192<Note>

190 Claude Code는 파일을 수정하기 전에 항상 권한을 요청합니다. 개별 변경 사항을 승인하거나 세션에 대해 "모두 수락" 모드를 활성화할 수 있습니다.193 사용자의 설정 또는 조직에서 다른 시작 권한 모드를 설정할 수 있습니다. [세션이 시작되는 권한 모드](/docs/ko/permission-modes#which-mode-a-session-starts-in)에서 어떤 모드인지 확인할 수 있습니다. 언제든지 `Shift+Tab`을 눌러 현재 세션의 권한 모드를 전환할 수 있습니다.

191</Note>194</Note>

192 195 

193<h2 id="step-6-use-git-with-claude-code">196<h2 id="step-6-use-git-with-claude-code">

196 199 

197Claude Code는 Git 작업을 대화형으로 만듭니다:200Claude Code는 Git 작업을 대화형으로 만듭니다:

198 201 

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

200어떤 파일을 변경했나요?203어떤 파일을 변경했나요?

201```204```

202 205 

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

204설명적인 메시지로 변경 사항 커밋207설명적인 메시지로 변경 사항 커밋

205```208```

206 209 

207더 복잡한 Git 작업을 요청할 수도 있습니다:210더 복잡한 Git 작업을 요청할 수도 있습니다:

208 211 

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

210feature/quickstart라는 새 브랜치 생성213feature/quickstart라는 새 브랜치 생성

211```214```

212 215 

213```text theme={null}216```text wrap theme={null}

214마지막 5개의 커밋 표시217마지막 5개의 커밋 표시

215```218```

216 219 

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

218병합 충돌을 해결하는 데 도움을 주세요221병합 충돌을 해결하는 데 도움을 주세요

219```222```

220 223 

226 229 

227자연어로 원하는 것을 설명하십시오:230자연어로 원하는 것을 설명하십시오:

228 231 

229```text theme={null}232```text wrap theme={null}

230사용자 등록 양식에 입력 유효성 검사 추가233사용자 등록 양식에 입력 유효성 검사 추가

231```234```

232 235 

233또는 기존 문제를 수정하십시오:236또는 기존 문제를 수정하십시오:

234 237 

235```text theme={null}238```text wrap theme={null}

236사용자가 빈 양식을 제출할 수 있는 버그가 있습니다 - 수정하세요239사용자가 빈 양식을 제출할 수 있는 버그가 있습니다 - 수정하세요

237```240```

238 241 

251 254 

252**코드 리팩토링**255**코드 리팩토링**

253 256 

254```text theme={null}257```text wrap theme={null}

255인증 모듈을 콜백 대신 async/await를 사용하도록 리팩토링258인증 모듈을 콜백 대신 async/await를 사용하도록 리팩토링

256```259```

257 260 

258**테스트 작성**261**테스트 작성**

259 262 

260```text theme={null}263```text wrap theme={null}

261계산기 함수에 대한 단위 테스트 작성264계산기 함수에 대한 단위 테스트 작성

262```265```

263 266 

264**문서 업데이트**267**문서 업데이트**

265 268 

266```text theme={null}269```text wrap theme={null}

267설치 지침으로 README 업데이트270설치 지침으로 README 업데이트

268```271```

269 272 

270**코드 검토**273**코드 검토**

271 274 

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

273내 변경 사항을 검토하고 개선 사항을 제안해주세요276내 변경 사항을 검토하고 개선 사항을 제안해주세요

274```277```

275 278 

286**셸 명령**289**셸 명령**

287 290 

288| 명령 | 기능 | 예시 |291| 명령 | 기능 | 예시 |

289| ------------------- | --------------------- | ----------------------------------- |292| ------------------- | ----------------------- | ----------------------------------- |

290| `claude` | 대화형 모드 시작 | `claude` |293| `claude` | 대화형 모드 시작 | `claude` |

291| `claude "task"` | 일회성 작업 실행 | `claude "fix the build error"` |294| `claude "task"` | 초기 프롬프트를 사용하여 대화형 모드 시작 | `claude "fix the build error"` |

292| `claude -p "query"` | 일회성 쿼리 실행 후 종료 | `claude -p "explain this function"` |295| `claude -p "query"` | 일회성 쿼리 실행 후 종료 | `claude -p "explain this function"` |

293| `claude -c` | 현재 디렉토리에서 가장 최근 대화 계속 | `claude -c` |296| `claude -c` | 현재 디렉토리에서 가장 최근 대화 계속 | `claude -c` |

294| `claude -r` | 이전 대화 재개 | `claude -r` |297| `claude -r` | 이전 대화 재개 | `claude -r` |

296**세션 명령**299**세션 명령**

297 300 

298| 명령 | 기능 | 예시 |301| 명령 | 기능 | 예시 |

299| ----------------- | -------------- | -------- |302| --------------------- | -------------- | -------- |

300| `/clear` | 대화 기록 지우기 | `/clear` |303| `/clear` | 대화 기록 지우기 | `/clear` |

301| `/help` | 사용 가능한 명령 표시 | `/help` |304| `/help` | 사용 가능한 명령 표시 | `/help` |

302| `/exit` 또는 Ctrl+D | Claude Code 종료 | `/exit` |305| `/exit` 또는 Ctrl+D 두 번 | Claude Code 종료 | `/exit` |

303 306 

304전체 셸 명령 목록은 [CLI 참조](/ko/cli-reference)를 참조하고 전체 세션 명령 목록은 [명령 참조](/ko/commands)를 참조하십시오.307전체 셸 명령 목록은 [CLI 참조](/docs/ko/cli-reference)를 참조하고 전체 세션 명령 목록은 [명령 참조](/docs/ko/commands)를 참조하십시오.

305 308 

306<h2 id="pro-tips-for-beginners">309<h2 id="pro-tips-for-beginners">

307 초보자를 위한 팁310 초보자를 위한 팁

308</h2>311</h2>

309 312 

310자세한 내용은 [모범 사례](/ko/best-practices) 및 [일반적인 워크플로우](/ko/common-workflows)를 참조하십시오.313자세한 내용은 [모범 사례](/docs/ko/best-practices) 및 [일반적인 워크플로우](/docs/ko/common-workflows)를 참조하십시오.

311 314 

312<AccordionGroup>315<AccordionGroup>

313 <Accordion title="요청을 구체적으로 하기">316 <Accordion title="요청을 구체적으로 하기">

319 <Accordion title="단계별 지침 사용">322 <Accordion title="단계별 지침 사용">

320 복잡한 작업을 단계로 나누기:323 복잡한 작업을 단계로 나누기:

321 324 

322 ```text theme={null}325 ```text wrap theme={null}

323 1. 사용자 프로필을 위한 새 데이터베이스 테이블 생성326 1. 사용자 프로필을 위한 새 데이터베이스 테이블 생성

324 2. 사용자 프로필을 가져오고 업데이트하는 API 엔드포인트 생성327 2. 사용자 프로필을 가져오고 업데이트하는 API 엔드포인트 생성

325 3. 사용자가 자신의 정보를 보고 편집할 수 있는 웹페이지 구축328 3. 사용자가 자신의 정보를 보고 편집할 수 있는 웹페이지 구축

329 <Accordion title="Claude가 먼저 탐색하도록 하기">332 <Accordion title="Claude가 먼저 탐색하도록 하기">

330 변경하기 전에 Claude가 코드를 이해하도록 하기:333 변경하기 전에 Claude가 코드를 이해하도록 하기:

331 334 

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

333 데이터베이스 스키마 분석336 데이터베이스 스키마 분석

334 ```337 ```

335 338 

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

337 영국 고객이 가장 자주 반품하는 제품을 보여주는 대시보드 구축340 영국 고객이 가장 자주 반품하는 제품을 보여주는 대시보드 구축

338 ```341 ```

339 </Accordion>342 </Accordion>

353이제 기본 사항을 배웠으므로 더 고급 기능을 살펴보십시오:356이제 기본 사항을 배웠으므로 더 고급 기능을 살펴보십시오:

354 357 

355<CardGroup cols={2}>358<CardGroup cols={2}>

356 <Card title="Claude Code 작동 방식" icon="microchip" href="/ko/how-claude-code-works">359 <Card title="Claude Code 작동 방식" icon="microchip" href="/docs/ko/how-claude-code-works">

357 에이전트 루프, 기본 제공 도구 및 Claude Code가 프로젝트와 상호 작용하는 방식 이해360 에이전트 루프, 기본 제공 도구 및 Claude Code가 프로젝트와 상호 작용하는 방식 이해

358 </Card>361 </Card>

359 362 

360 <Card title="모범 사례" icon="star" href="/ko/best-practices">363 <Card title="모범 사례" icon="star" href="/docs/ko/best-practices">

361 효과적인 프롬프팅 및 프로젝트 설정으로 더 나은 결과 얻기364 효과적인 프롬프팅 및 프로젝트 설정으로 더 나은 결과 얻기

362 </Card>365 </Card>

363 366 

364 <Card title="일반적인 워크플로우" icon="graduation-cap" href="/ko/common-workflows">367 <Card title="일반적인 워크플로우" icon="graduation-cap" href="/docs/ko/common-workflows">

365 일반적인 작업에 대한 단계별 가이드368 일반적인 작업에 대한 단계별 가이드

366 </Card>369 </Card>

367 370 

368 <Card title="Claude Code 확장" icon="puzzle-piece" href="/ko/features-overview">371 <Card title="Claude Code 확장" icon="puzzle-piece" href="/docs/ko/features-overview">

369 CLAUDE.md, skills, hooks, MCP 등으로 사용자 정의372 CLAUDE.md, skills, hooks, MCP 등으로 사용자 정의

370 </Card>373 </Card>

371</CardGroup>374</CardGroup>