Claude Code 첫 날 | Anthropic 지원 센터

목표: 약 15분 안에 Claude Code를 열고, 로그인한 후, 첫 번째 AI 지원 변경을 완료하게 됩니다. 이 가이드는 첫 날에 필요한 내용만 다루며, 더 깊은 자료로의 링크는 끝에 나타납니다.

1단계: Claude Code 열기 (2분)

권장: Claude Desktop을 다운로드하고, 유료 플랜으로 로그인한 후, "Code" 탭을 엽니다. Claude Desktop에는 Claude Code가 포함되어 있으므로 추가로 설치할 것이 없습니다. Claude Code 문서에서 첫 세션을 위한 데스크톱 빠른 시작을 따른 후, 3단계로 건너뜁니다.

대신 터미널을 사용하려면 컴퓨터와 일치하는 명령을 선택하여 터미널에 붙여넣습니다.

설정	명령
macOS / Linux / WSL	`curl -fsSL https://claude.ai/install.sh
Windows (PowerShell)	`irm https://claude.ai/install.ps1
Homebrew	`brew install --cask claude-code`
npm (Node 18+)	`npm install -g @anthropic-ai/claude-code`

팁: npm install을 sudo로 실행하지 마세요. 나중에 파일 권한 문제가 발생합니다.

설치 확인:

claude --version

2단계: 로그인 (2분)

Claude Desktop을 사용 중이면 이미 로그인되어 있으며 Claude Code는 동일한 계정을 사용합니다. 3단계로 건너뜁니다.

터미널에서 인증 방식은 조직이 액세스를 프로비저닝한 방식에 따라 다릅니다. 다음 중 하나를 선택하세요:

조직에서 사용하는 경우…	이렇게 하세요
유료 Claude 플랜	`claude`를 실행한 후 `/login`을 실행하고 브라우저에서 요청을 승인합니다(필요한 경우 SSO 포함). 이것이 가장 일반적인 경로입니다.
Anthropic Console API 키	`export ANTHROPIC_API_KEY=sk-ant-…`를 실행한 후 `claude`를 실행합니다.
Amazon Bedrock	`export CLAUDE_CODE_USE_BEDROCK=1`을 실행하고, AWS 자격 증명을 구성한 후, `claude`를 실행합니다.
Google Vertex AI	`export CLAUDE_CODE_USE_VERTEX=1`을 실행하고, GCP 자격 증명을 구성한 후, `claude`를 실행합니다.

어떤 방법이 적용되는지 확실하지 않으면 관리자에게 확인하거나 먼저 /login을 시도하세요. 이것이 대부분의 조직에서 기본값입니다.

3단계: 프로젝트 열기 (1분)

Claude Desktop에서 "Code" 탭에서 새 세션을 시작하고 작업할 저장소의 폴더를 선택합니다. 터미널에서 저장소 내부에서 Claude Code를 시작합니다:

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, 내장 명령, 및 대화형 모드 단축키를 자세히 다룹니다.

설치 또는 로그인 중에 문제가 발생하면 문제 해결 가이드를 참조하세요.