4 4
5# 빠른 시작5# 빠른 시작
6 6
7> Claude Code에 오신 것을 환영합니다!7> 터미널에 Claude Code를 설치하고 로그인한 후, CLI를 사용하여 코드베이스를 탐색하고 첫 번째 코드 변경을 수행합니다.
8 8
9이 빠른 시작 가이드를 통해 몇 분 안에 AI 기반 코딩 지원을 사용할 수 있습니다. 이 가이드를 마치면 일반적인 개발 작업에 Claude Code를 사용하는 방법을 이해하게 됩니다.9이 빠른 시작 가이드에서는 터미널에서 Claude Code를 사용하는 방법을 다룹니다. CLI 설치, 첫 세션에서의 로그인, 그리고 자체 프로젝트에서 일반적인 개발 작업에 활용하는 방법을 설명합니다.
10 10
11<h2 id="before-you-begin">11<h2 id="before-you-begin">
12 시작하기 전에12 시작하기 전에
15다음을 확인하십시오:15다음을 확인하십시오:
16 16
17* 열려 있는 터미널 또는 명령 프롬프트17* 열려 있는 터미널 또는 명령 프롬프트
18 * 터미널을 처음 사용하는 경우 [터미널 가이드](/docs/ko/terminal-guide)를 확인하십시오
19* 작업할 코드 프로젝트18* 작업할 코드 프로젝트
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)를 통한 액세스19* [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 20
22<Note>21<Note>
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)를 참조하십시오.22 다음 경우는 다른 페이지에서 다룹니다:
23
24 * **터미널을 처음 사용하는 경우**: [터미널 가이드](/docs/ko/terminal-guide)부터 시작하십시오
25 * **터미널이 아닌 다른 곳에서 Claude Code를 사용하려는 경우**: 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>26</Note>
25 27
26<h2 id="step-1-install-claude-code">28<h2 id="step-1-install-claude-code">
33 <Tab title="기본 설치 (권장)">35 <Tab title="기본 설치 (권장)">
34 **macOS, Linux, WSL:**36 **macOS, Linux, WSL:**
35 37
36 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}38 ```bash theme={null}
37 curl -fsSL https://claude.ai/install.sh | bash39 curl -fsSL https://claude.ai/install.sh | bash
38 ```40 ```
39 41
42 Windows에서 PowerShell에 있을 때는 프롬프트에 `PS C:\`가 표시되고, CMD에 있을 때는 `PS` 없이 `C:\`만 표시됩니다.
43
40 **Windows PowerShell:**44 **Windows PowerShell:**
41 45
42 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}46 ```powershell theme={null}
43 irm https://claude.ai/install.ps1 | iex47 irm https://claude.ai/install.ps1 | iex
44 ```48 ```
45 49
46 **Windows CMD:**50 **Windows CMD:**
47 51
48 ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}52 ```batch theme={null}
49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd53 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
50 ```54 ```
51 55
52 설치 프로그램이 완료되면 새 터미널 창을 열고 `claude --version`을 실행하십시오. 설치가 제대로 되었으면 버전 번호가 출력됩니다. 셸에서 `claude`를 찾을 수 없거나 인식되지 않는다고 표시되면 설치 디렉토리가 아직 PATH에 없는 것입니다. [PATH 수정](/docs/ko/troubleshoot-install#command-not-found-claude-after-installation)을 참조하십시오.56 설치 프로그램이 완료되면 새 터미널 창을 열고 `claude --version`을 실행하십시오. 설치가 제대로 되었으면 버전 번호가 출력됩니다. 셸에서 `claude`를 찾을 수 없거나 인식되지 않는다고 표시되면 설치 디렉토리가 아직 PATH에 없는 것입니다. [PATH 수정](/docs/ko/troubleshoot-install#command-not-found-claude-after-installation)을 참조하십시오.
53 57
54 `The token '&&' is not a valid statement separator` 오류가 표시되면 CMD가 아닌 PowerShell에 있는 것입니다. `'irm' is not recognized as an internal or external command` 오류가 표시되면 PowerShell이 아닌 CMD에 있는 것입니다. PowerShell에 있을 때는 프롬프트에 `PS C:\`가 표시되고, CMD에 있을 때는 `PS` 없이 `C:\`만 표시됩니다.58 `The token '&&' is not a valid statement separator` 오류가 표시되면 CMD가 아닌 PowerShell에 있는 것입니다. `'irm' is not recognized as an internal or external command` 오류가 표시되면 PowerShell이 아닌 CMD에 있는 것입니다.
55 59
56 설치 명령이 `syntax error near unexpected token '<'`, `403` 또는 다른 curl 오류로 실패하면 [설치 문제 해결](/docs/ko/troubleshoot-install#find-your-error)을 참조하여 오류를 수정 방법과 일치시키고 대체 설치 방법을 확인하십시오.60 설치 명령이 `syntax error near unexpected token '<'`, `403` 또는 다른 오류로 실패하면 [설치 문제 해결](/docs/ko/troubleshoot-install#find-your-error)을 참조하여 오류를 수정 방법과 일치시키고 대체 설치 방법을 확인하십시오.
57 61
58 [Git for Windows](https://git-scm.com/downloads/win)는 Claude Code가 Bash 도구를 사용할 수 있도록 기본 Windows에서 권장됩니다. Git for Windows가 설치되지 않은 경우 Claude Code는 대신 PowerShell을 셸 도구로 사용합니다. WSL 설정에는 Git for Windows가 필요하지 않습니다.62 [Git for Windows](https://git-scm.com/downloads/win)는 Claude Code가 Bash 도구를 사용할 수 있도록 기본 Windows에서 권장됩니다. Git for Windows가 설치되지 않은 경우 Claude Code는 대신 PowerShell을 셸 도구로 사용합니다. WSL 설정에는 Git for Windows가 필요하지 않습니다.
59 63
63 </Tab>67 </Tab>
64 68
65 <Tab title="Homebrew">69 <Tab title="Homebrew">
66 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}70 ```bash theme={null}
67 brew install --cask claude-code71 brew install --cask claude-code
68 ```72 ```
69 73
75 </Tab>79 </Tab>
76 80
77 <Tab title="WinGet">81 <Tab title="WinGet">
78 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}82 ```powershell theme={null}
79 winget install Anthropic.ClaudeCode83 winget install Anthropic.ClaudeCode
80 ```84 ```
81 85
95 99
96이 명령어는 버전 번호 다음에 `(Claude Code)`를 출력합니다.100이 명령어는 버전 번호 다음에 `(Claude Code)`를 출력합니다.
97 101
98<h2 id="step-2-log-in-to-your-account">102<h2 id="step-2-start-your-first-session">
99 단계 2: 계정에 로그인103 2단계: 첫 번째 세션 시작하기
100</h2>104</h2>
101 105
102Claude Code를 사용하려면 계정이 필요합니다. `claude` 명령으로 대화형 세션을 시작하면 처음 사용할 때 로그인하라는 메시지가 표시됩니다:106아무 프로젝트 디렉터리에서 터미널을 열고 Claude Code를 시작합니다:
103 107
104```bash theme={null}108```bash theme={null}
109cd /path/to/your/project
105claude110claude
106```111```
107 112
108Claude 구독 또는 Console 계정의 경우 프롬프트를 따라 브라우저에서 인증을 완료하십시오. `ANTHROPIC_API_KEY` 환경 변수를 설정한 경우 Claude Code는 로그인 프롬프트를 건너뛰고 대신 키를 승인하도록 요청합니다. 나중에 계정을 전환하거나 다시 인증하려면 실행 중인 세션 내에서 `/login`을 입력하십시오:113`/path/to/your/project`를 작업하려는 프로젝트의 경로로 바꿉니다.
109
110```text wrap theme={null}
111/login
112```
113 114
114다음 계정 유형 중 하나를 사용하여 로그인할 수 있습니다:115Claude Code는 처음 사용할 때 로그인을 요청합니다. Claude 구독 또는 Console 계정의 경우 안내에 따라 브라우저에서 인증을 완료합니다. `ANTHROPIC_API_KEY` 환경 변수를 설정했고 Claude Code가 해당 키를 사용할지 물을 때 승인하면 Claude Code는 로그인 프롬프트를 건너뜁니다.
115 116
116* [Claude Pro, Max, Team 또는 Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (권장)117다음 계정 유형 중 하나로 로그인할 수 있습니다:
117* [Claude Console](https://platform.claude.com/) (선불 크레딧이 있는 API 액세스). 처음 로그인할 때 비용 추적을 위해 Console에서 "Claude Code" 워크스페이스가 자동으로 생성됩니다.
118* [Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry](/docs/ko/third-party-integrations) (엔터프라이즈 클라우드 제공자)
119* 조직에서 운영하는 자체 호스팅 [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway): 관리자가 게이트웨이 URL을 미리 구성하고, `/login`을 입력하면 **Cloud gateway** 화면에서 직접 열려 기업 SSO로 로그인할 수 있습니다.
120 118
121로그인하면 자격 증명이 저장되고 다시 로그인할 필요가 없습니다. [자격 증명 관리](/docs/ko/authentication#credential-management)에서 자세히 알아보십시오.119* [Claude Pro, Max, Team 또는 Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login)(권장)
122 120* [Claude Console](https://platform.claude.com/)(선불 크레딧을 사용하는 API 액세스). 처음 로그인하면 중앙 집중식 비용 추적을 위해 Console에 "Claude Code" 워크스페이스가 자동으로 생성됩니다.
123<h2 id="step-3-start-your-first-session">121* [Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry](/docs/ko/third-party-integrations)(엔터프라이즈 클라우드 제공업체)
124 단계 3: 첫 번째 세션 시작122* 조직에서 운영하는 경우 자체 호스팅 [Claude apps gateway](/docs/ko/claude-apps-gateway): 관리자가 게이트웨이 URL을 미리 구성하며, `/login`을 실행하면 바로 **Cloud gateway** 화면이 열려 회사 SSO로 로그인할 수 있습니다
125</h2>
126
127프로젝트 디렉토리에서 터미널을 열고 Claude Code를 시작하십시오:
128
129```bash theme={null}
130cd /path/to/your/project
131claude
132```
133 123
134`/path/to/your/project`를 작업하려는 프로젝트의 경로로 바꾸십시오.124로그인하면 자격 증명이 저장되므로 다시 로그인할 필요가 없습니다. 자세한 내용은 [자격 증명 관리](/docs/ko/authentication#credential-management)를 참조하세요.
135 125
136버전, 현재 모델 및 작업 디렉토리가 표시된 Claude Code 프롬프트가 나타납니다. 사용 가능한 명령을 보려면 `/help`를 입력하거나 이전 대화를 계속하려면 `/resume`을 입력하십시오.126Claude Code 프롬프트가 나타나며, 그 위에 버전, 현재 모델, 작업 디렉터리가 표시됩니다. 사용 가능한 명령을 보려면 `/help`를, 이전 대화를 이어가려면 `/resume`을 입력합니다. 나중에 계정을 전환하거나 다시 인증하려면 실행 중인 세션 안에서 `/login`을 입력합니다.
137 127
138<h2 id="step-4-ask-your-first-question">128<h2 id="step-3-ask-your-first-question">
139 단계 4: 첫 번째 질문 하기129 3단계: 첫 번째 질문하기
140</h2>130</h2>
141 131
142코드베이스를 이해하는 것부터 시작하겠습니다. 다음 명령 중 하나를 시도하십시오:132다음 명령 중 하나를 시도해 보세요:
143 133
144```text wrap theme={null}134```text wrap theme={null}
145what does this project do?135what does this project do?
159explain the folder structure149explain the folder structure
160```150```
161 151
162Claude의 기능에 대해 물어볼 수도 있습니다:152Claude에게 Claude 자체의 기능에 대해 물어볼 수도 있습니다:
163 153
164```text wrap theme={null}154```text wrap theme={null}
165what can Claude Code do?155what can Claude Code do?
174```164```
175 165
176<Note>166<Note>
177 Claude Code는 필요에 따라 프로젝트 파일을 읽습니다. 수동으로 컨텍스트를 추가할 필요가 없습니다.167 Claude Code는 필요에 따라 프로젝트 파일을 읽습니다. 컨텍스트를 수동으로 추가할 필요가 없습니다.
178</Note>168</Note>
179 169
180<h2 id="step-5-make-your-first-code-change">170<h2 id="step-4-make-your-first-code-change">
181 단계 5: 첫 번째 코드 변경 수행171 4단계: 첫 번째 코드 변경하기
182</h2>172</h2>
183 173
184이제 Claude Code가 실제 코딩을 하도록 해봅시다. 간단한 작업을 시도하십시오:174간단한 작업을 시도해 보세요:
185 175
186```text wrap theme={null}176```text wrap theme={null}
187주 파일에 hello world 함수 추가177add a hello world function to the main file
188```178```
189 179
190Claude Code는 적절한 파일을 찾고 변경 사항을 보여줍니다. 변경하기 전에 묻는 경우 **예**를 선택하여 승인하십시오.180Claude Code가 적절한 파일을 찾아 변경 사항을 보여 줍니다. 변경하기 전에 확인을 요청하면 **Yes**를 선택하여 승인합니다.
191 181
192Claude Code v2.1.283 이상에서는 자동 모드가 대화형 터미널 세션에 대한 [기본 제공 시작 권한 모드](/docs/ko/permission-modes#eliminate-prompts-with-auto-mode)입니다. 분류기가 사용자 대신 작업을 검토하며, Claude는 대부분의 파일을 편집하고 대부분의 명령을 묻지 않고 실행합니다. 이전 버전에서는 자동 모드가 Pro, Max 및 Team 플랜에서만 기본 제공 시작 권한 모드입니다. 설치 또는 업그레이드 직후에 시작하는 세션의 경우 [설치 또는 업그레이드 후 첫 번째 세션](/docs/ko/env-vars#first-session-after-an-install-or-upgrade)을 참조하십시오.182세션의 [권한 모드](/docs/ko/permission-modes)는 Claude가 먼저 묻지 않고 수행할 수 있는 작업을 결정합니다. 언제든지 `Shift+Tab`을 눌러 현재 세션의 권한 모드를 전환할 수 있습니다.
193
194<Note>
195 사용자의 설정 또는 조직에서 다른 시작 권한 모드를 설정할 수 있습니다. [세션이 시작되는 권한 모드](/docs/ko/permission-modes#which-mode-a-session-starts-in)에서 어떤 모드인지 확인할 수 있습니다. 언제든지 `Shift+Tab`을 눌러 현재 세션의 권한 모드를 전환할 수 있습니다.
196</Note>
197 183
198<h2 id="step-6-use-git-with-claude-code">184<h2 id="step-5-use-git-with-claude-code">
199 단계 6: Claude Code와 함께 Git 사용185 5단계: Claude Code로 Git 사용하기
200</h2>186</h2>
201 187
202Claude Code는 Git 작업을 대화형으로 만듭니다:188Claude Code를 사용하면 대화하듯이 Git 작업을 수행할 수 있습니다:
203 189
204```text wrap theme={null}190```text wrap theme={null}
205어떤 파일을 변경했나요?191what files have I changed?
206```192```
207 193
208```text wrap theme={null}194```text wrap theme={null}
209설명적인 메시지로 변경 사항 커밋195commit my changes with a descriptive message
210```196```
211 197
212더 복잡한 Git 작업을 요청할 수도 있습니다:198더 복잡한 Git 작업을 요청할 수도 있습니다:
213 199
214```text wrap theme={null}200```text wrap theme={null}
215feature/quickstart라는 새 브랜치 생성201create a new branch called feature/quickstart
216```202```
217 203
218```text wrap theme={null}204```text wrap theme={null}
219마지막 5개의 커밋 표시205show me the last 5 commits
220```206```
221 207
222```text wrap theme={null}208```text wrap theme={null}
223병합 충돌을 해결하는 데 도움을 주세요209help me resolve merge conflicts
224```210```
225 211
226<h2 id="step-7-fix-a-bug-or-add-a-feature">212<h2 id="step-6-fix-a-bug-or-add-a-feature">
227 단계 7: 버그 수정 또는 기능 추가213 6단계: 버그 수정 또는 기능 추가
228</h2>214</h2>
229 215
230Claude는 디버깅 및 기능 구현에 능숙합니다.216원하는 작업을 자연어로 설명합니다:
231
232자연어로 원하는 것을 설명하십시오:
233 217
234```text wrap theme={null}218```text wrap theme={null}
235사용자 등록 양식에 입력 유효성 검사 추가219add input validation to the user registration form
236```220```
237 221
238또는 기존 문제를 수정하십시오:222또는 기존 문제를 수정합니다:
239 223
240```text wrap theme={null}224```text wrap theme={null}
241사용자가 빈 양식을 제출할 수 있는 버그가 있습니다 - 수정하세요225there's a bug where users can submit empty forms - fix it
242```226```
243 227
244Claude Code는 다음을 수행합니다:228<h2 id="step-7-test-out-other-common-workflows">
245 229 7단계: 다른 일반적인 워크플로 테스트하기
246* 관련 코드 찾기
247* 컨텍스트 이해
248* 솔루션 구현
249* 사용 가능한 경우 테스트 실행
250
251<h2 id="step-8-test-out-other-common-workflows">
252 단계 8: 다른 일반적인 워크플로우 시도
253</h2>230</h2>
254 231
255Claude와 함께 작업하는 여러 가지 방법이 있습니다:232Claude와 함께 작업하는 방법은 다양합니다.
256 233
257**코드 리팩토링**234**코드 리팩터링**
258 235
259```text wrap theme={null}236```text wrap theme={null}
260인증 모듈을 콜백 대신 async/await를 사용하도록 리팩토링237refactor the authentication module to use async/await instead of callbacks
261```238```
262 239
263**테스트 작성**240**테스트 작성**
264 241
265```text wrap theme={null}242```text wrap theme={null}
266계산기 함수에 대한 단위 테스트 작성243write unit tests for the calculator functions
267```244```
268 245
269**문서 업데이트**246**문서 업데이트**
270 247
271```text wrap theme={null}248```text wrap theme={null}
272설치 지침으로 README 업데이트249update the README with installation instructions
273```250```
274 251
275**코드 검토**252**코드 리뷰**
276 253
277```text wrap theme={null}254```text wrap theme={null}
278내 변경 사항을 검토하고 개선 사항을 제안해주세요255review my changes and suggest improvements
279```256```
280 257
281<Tip>258<Tip>
282 도움이 되는 동료처럼 Claude와 대화하십시오. 달성하고 싶은 것을 설명하면 도움을 드릴 것입니다.259 유능한 동료에게 말하듯이 Claude에게 말해 보세요. 달성하고 싶은 목표를 설명하면 Claude가 그 목표에 도달할 수 있도록 도와줍니다.
283</Tip>260</Tip>
284 261
285<h2 id="essential-commands">262<h2 id="essential-commands">
357 334
358이제 기본 사항을 배웠으므로 더 고급 기능을 살펴보십시오:335이제 기본 사항을 배웠으므로 더 고급 기능을 살펴보십시오:
359 336
360<CardGroup cols={2}>337* [Claude Code 작동 방식](/docs/ko/how-claude-code-works): 에이전틱 루프, 기본 제공 도구 및 Claude Code가 프로젝트와 상호 작용하는 방식 이해
361 <Card title="Claude Code 작동 방식" icon="microchip" href="/docs/ko/how-claude-code-works">338* [모범 사례](/docs/ko/best-practices): 효과적인 프롬프팅 및 프로젝트 설정으로 더 나은 결과 얻기
362 에이전트 루프, 기본 제공 도구 및 Claude Code가 프로젝트와 상호 작용하는 방식 이해339* [일반적인 워크플로](/docs/ko/common-workflows): 일반적인 작업에 대한 단계별 가이드
363 </Card>340* [Claude Code 확장](/docs/ko/features-overview): CLAUDE.md, 스킬, 훅, MCP 등으로 사용자 정의
364
365 <Card title="모범 사례" icon="star" href="/docs/ko/best-practices">
366 효과적인 프롬프팅 및 프로젝트 설정으로 더 나은 결과 얻기
367 </Card>
368
369 <Card title="일반적인 워크플로우" icon="graduation-cap" href="/docs/ko/common-workflows">
370 일반적인 작업에 대한 단계별 가이드
371 </Card>
372 341
373 <Card title="Claude Code 확장" icon="puzzle-piece" href="/docs/ko/features-overview">342설치 옵션, 수동 업데이트 또는 제거 방법은 [고급 설정](/docs/ko/setup)을 참조하십시오.
374 CLAUDE.md, skills, hooks, MCP 등으로 사용자 정의
375 </Card>
376</CardGroup>
377 343
378<h2 id="getting-help">344<h2 id="getting-help">
379 도움 받기345 도움 받기
380</h2>346</h2>
381 347
382* **Claude Code에서**: `/help`를 입력하거나 "어떻게..."를 물어보기348* **Claude Code에서**: `/help`를 입력하거나 "어떻게..."를 물어보기
383* **문서**: 여기 있습니다! 다른 가이드 찾아보기349* **문서**: 이 사이트의 다른 가이드 찾아보기
384* **강좌**: [Claude Code 101](https://academy.claude.com/courses/claude-code-101)을 수강하고 [Claude Academy](https://academy.claude.com/)에서 다른 무료 자습형 강좌를 수강하기350* **강좌**: [Claude Code 101](https://academy.claude.com/courses/claude-code-101)을 수강하고 [Claude Academy](https://academy.claude.com/)에서 다른 무료 자습형 강좌를 수강하기
385* **커뮤니티**: 팁과 지원을 위해 [Discord 서버](https://www.anthropic.com/discord)에 참여하기351* **커뮤니티**: 팁과 지원을 위해 [Discord 서버](https://www.anthropic.com/discord)에 참여하기
