④ Claude Code 시작하기 — 터미널·에디터에서 Claude 쓰기
공식 네이티브 설치 스크립트 한 줄로 끝. VS Code·JetBrains·Desktop·Web 연동까지 정리.
참고: Claude Code는 유료 Claude 구독(Pro/Max/Team/Enterprise)이 필요합니다. 공식 문서는 code.claude.com 입니다.
Claude Code가 뭐냐
에디터나 터미널에서 Claude에게 **"이 레포 읽고 이것 고쳐줘"**라고 시키면 실제로 파일을 읽고·수정하고·커밋까지 할 수 있는 공식 도구입니다.
사용 가능한 서피스(표면):
- Terminal (CLI)
- Desktop 앱 (claude.ai 데스크톱 클라이언트 내부)
- VS Code 확장
- JetBrains 플러그인
- Web (claude.ai/code)
1. 설치 — 공식 방법
사실 체크: 과거에 돌던
npm install -g @anthropic-ai/claude-code는 현재 공식 설치 방식이 아닙니다. 네이티브 설치 스크립트를 써야 합니다.
macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Homebrew (macOS)
brew install --cask claude-code
WinGet (Windows)
winget install Anthropic.ClaudeCode
설치가 끝나면 터미널에서:
claude --version
2. 처음 실행 — 로그인
claude
최초 실행 시 브라우저가 열리고 Claude 계정으로 로그인하면 됩니다. 한 번만 해두면 토큰이 저장돼요.
3. 첫 작업 — 레포 이해부터
프로젝트 폴더로 이동한 뒤:
cd my-project
claude
세션이 시작되면 이렇게 물어보세요:
이 레포를 처음 보는 개발자야.
폴더 구조와 핵심 파일 5개를 간단히 설명해줘.
Claude가 실제로 파일을 읽고 요약해 줍니다.
4. 실전 명령 3가지
(1) 파일 수정 지시
app/page.tsx 의 헤더 컴포넌트 여백이 너무 좁아.
상하 패딩을 py-10 으로 바꾸고 반응형도 챙겨줘.
(2) 버그 추적
`npm run build` 가 실패해. 에러 메시지 보고 원인 찾아서 고쳐줘.
필요하면 직접 빌드 돌려봐.
(3) 커밋까지
방금 수정분으로 깔끔한 커밋 하나 만들어줘.
메시지는 Conventional Commits 형식.
5. VS Code에서 쓰기
VS Code 확장 마켓플레이스에서 Claude Code 설치 → 좌측 사이드바 아이콘 → 같은 계정으로 로그인.
편집기 내 파일 선택 상태에서 우클릭 → Claude에 질문하면 현재 파일이 자동 컨텍스트로 들어갑니다.
6. 알아두면 좋은 몇 가지
CLAUDE.md— 프로젝트 루트에 두면 Claude Code가 매번 참고하는 프로젝트 지시서가 됩니다. 프로젝트 규칙·톤·금지 사항을 여기 적어두세요.- 위험 명령 확인 — 파일 삭제·네트워크 요청·커밋 푸시 같은 행동 직전엔 확인을 요청합니다. "전부 자동 승인" 같은 옵션은 꼭 필요할 때만 쓰세요.
- 사용량 — 긴 세션은 Max 플랜의 기준이 되는 이유가 됩니다. Pro도 충분히 쓰지만 하루 여러 시간 돌린다면 한도 관리 필요.
다음 편(마지막): Claude API — 앱에 Claude를 심는 법. 현재 라인업(Opus 4.7 / Sonnet 4.6 / Haiku 4.5)과 선택 기준.