목표: 약 15분 안에 Claude Code를 설치하고, 로그인한 후 첫 번째 AI 지원 변경을 완료합니다. 이 가이드는 첫 날에 필요한 내용만 다루며, 더 자세한 자료로의 링크는 끝에 나타납니다.
1단계: Claude Code 설치 (2분)
당신의 머신과 일치하는 명령을 선택하고 터미널에 붙여넣으세요.
당신의 설정 | 명령 |
macOS / Linux / WSL | `curl -fsSL https://claude.ai/install.sh |
Windows (PowerShell) | |
Homebrew |
|
npm (Node 18+) |
|
팁: sudo로 npm install을 실행하지 마세요. 나중에 파일 권한 문제가 발생합니다.
설치 확인:
claude --version
2단계: 로그인 (2분)
인증 방식은 조직에서 액세스를 프로비저닝한 방식에 따라 다릅니다. 다음 중 하나를 선택하세요:
조직에서 사용하는 경우… | 이렇게 하세요 |
Claude Enterprise 시트 |
|
Anthropic Console API 키 |
|
Amazon Bedrock |
|
Google Vertex AI |
|
어느 방법이 적용되는지 확실하지 않으면 관리자에게 확인하거나 먼저 /login을 시도하세요. 이것이 대부분의 조직에서 기본값입니다.
3단계: 프로젝트 열기 (1분)
cd path/to/your/project claude
Claude Code는 필요에 따라 파일을 읽으므로 업로드하거나 첨부할 것이 없습니다. 작업하려는 저장소 내에서 시작하기만 하면 됩니다.
4단계: 하나의 안전 규칙 이해하기 (1분)
Claude는 파일을 변경하거나 명령을 실행하기 전에 항상 물어봅니다. 변경을 제안할 때 diff와 세 가지 선택지가 표시됩니다:
예 — 이 단일 변경을 적용합니다.
예, 편집에 대해 다시 묻지 마세요 — 세션의 나머지 동안 파일 편집을 자동 승인합니다.
아니오 — 변경을 거부하고 이유를 설명하세요.
언제든지 Shift+Tab을 눌러 모드 간에 순환할 수 있습니다 (계획 → 편집 수락 → 기본값). 변경으로 인해 예상치 못한 결과가 발생하면 커밋할 때까지 git 기록은 그대로 유지되므로 git checkout으로 실행 취소할 수 있습니다.
5단계: 먼저 시도할 다섯 가지
이들을 프롬프트에 한 번에 하나씩 복사하여 붙여넣으세요. 각 예제는 다른 핵심 기능을 보여줍니다.
1. 방향 파악하기
Give me a 5-bullet summary of what this codebase does and where the entry point is.
이것이 유용한 이유: Claude가 특정 경로를 지정받지 않고도 파일을 자체적으로 탐색하는 방법을 보여줍니다.
2. 뭔가 찾기
Where is user authentication handled? Show me the file and the key function.
이것이 유용한 이유: 정확한 기호나 파일명을 모를 때 grep보다 빠른 경우가 많습니다.
3. 안전한 편집 만들기
Add a docstring to the function <name> in <file>. Keep it to 2 lines.
이것이 유용한 이유: 낮은 위험도의 변경에 대해 diff를 검토하고 승인하는 연습을 할 수 있습니다.
4. 실제 문제 해결하기
This test is failing: <paste the error>. Find the cause and fix it.
이것이 유용한 이유: 이것이 주요 워크플로우입니다. 증상을 설명하면 Claude가 조사하고 수정을 제안합니다.
5. git 처리하도록 하기
Stage my changes and write a commit message that follows our existing style.
이것이 유용한 이유: Claude는 (승인 후) 당신을 대신하여 git을 실행할 수 있으며 저장소의 기존 커밋 규칙과 일치합니다.
6단계: 하루를 마치기 전에
프로젝트당 한 번 실행하세요:
/init
이것은 코드베이스의 규칙을 캡처하는 프로젝트 루트에 CLAUDE.md 파일을 생성합니다. Claude는 모든 세션의 시작 시 자동으로 읽으므로 향후 응답은 이미 프로젝트에 맞게 조정됩니다. 이것이 당신이 할 수 있는 가장 높은 가치의 설정 단계입니다.
다음 단계
이제 Claude Code를 설치하고, 인증하고, 편집을 만들고, 프로젝트 메모리를 설정했습니다. 더 나아갈 준비가 되면 공식 문서에서 메모리 및 CLAUDE.md, 슬래시 명령, 그리고 대화형 모드 단축키를 자세히 다룹니다.
설치 또는 로그인 중에 문제가 발생하면 문제 해결 가이드를 참조하세요.