Claude Code는 Anthropic이 만든 터미널 기반 AI 코딩 도구임. ChatGPT나 Claude 웹과 다른 점은, 브라우저가 아니라 터미널에서 직접 실행되면서 로컬 파일을 읽고, 수정하고, 명령어까지 실행한다는 것. IDE 플러그인처럼 에디터에 붙는 보조 도구가 아니라, 터미널 자체가 AI 개발자가 됨.
Copilot 같은 자동완성 도구와도 다름. Claude Code는 프로젝트 전체 구조를 파악하고, 파일 여러 개를 동시에 수정하고, 테스트까지 돌려줌. 코드 한 줄 추천해주는 수준이 아니라, “이 버그 고쳐줘”라고 하면 알아서 원인 찾고 수정안 만들어서 보여줌.
직접 몇 달째 쓰고 있는데, 특히 혼자 개발할 때 체감이 큼. 새 코드베이스 파악할 때, 반복 작업 처리할 때, 리팩토링할 때 시간이 확 줄어듦. 설치부터 실전 적용까지 정리함.
설치부터 첫 실행까지
설치 전 확인할 것부터 정리함.
| 운영체제 | macOS 13.0+, Ubuntu 20.04+, Windows 10+ (WSL 또는 Git Bash) |
| RAM | 4GB 이상 (8GB 권장) |
| 네트워크 | 인터넷 연결 필수 |
| 계정 | Claude Pro ($20/월) 이상 구독 필요. 무료 플랜에서는 사용 불가. |
요구사항 충족하면 설치는 터미널에서 한 줄이면 끝남.
macOS / Linux:
curl -fsSL https://claude.ai/install.sh | bashWindows (PowerShell):
irm https://claude.ai/install.ps1 | iexWindows는 Git for Windows를 먼저 설치해야 함. Homebrew 쓰는 사람은 brew install --cask claude-code도 가능한데, 이 경우 자동 업데이트가 안 되니 Native 설치를 권장함.
설치 끝나면 프로젝트 폴더로 이동해서 claude 입력하면 됨.
cd my-project
claude첫 실행 시 브라우저가 열리면서 Anthropic 계정 로그인을 요청함. Claude.ai 계정으로 로그인하면 인증 완료. 이후에는 자동 로그인되니까 매번 할 필요 없음.
설치가 제대로 됐는지 확인하려면 claude doctor 실행하면 됨. 버전, 설치 방식, 인증 상태를 한눈에 보여줌.
여기까지 하면 준비 끝. 2분이면 충분함.
실전 사용법
사용법은 간단함. 터미널에서 자연어로 말하면 됨. 한국어도 잘 알아들음.
프로젝트에 처음 들어가면 이렇게 시작하는 게 좋음.
이 프로젝트 뭐 하는 거야?파일 구조, 기술 스택, 주요 기능을 분석해서 요약해줌. README 읽고 코드 뒤지는 시간을 확 줄여줌. 신규 입사자가 코드베이스 파악할 때 특히 유용함.
코드 수정도 자연어로 요청하면 됨.
로그인할 때 빈 화면 나오는 버그 고쳐줘Claude Code가 관련 파일을 찾고, 원인을 분석하고, 수정안을 보여줌. 중요한 건, 파일을 바로 수정하지 않고 반드시 승인을 먼저 받음. 변경 내용을 확인하고 OK 해야 실제로 적용됨. 실수로 코드 날아갈 걱정은 안 해도 됨.
자주 쓰는 패턴을 정리하면 이런 식임.
- 코드 리뷰 — “내가 바꾼 거 리뷰해줘” → git diff 기반으로 리뷰해줌
- Git 커밋 — “커밋해줘” → 변경사항 분석해서 메시지 만들고 커밋
- 리팩토링 — “이 모듈 async/await로 바꿔줘” → 관련 파일 여러 개 동시 수정
- 테스트 작성 — “이 함수 테스트 작성해줘” → 테스트 파일 생성
- 디버깅 — 에러 메시지 붙여넣고 “이거 왜 나는 거야?” → 원인 분석 + 해결책
대화 안 하고 한 번에 실행하고 싶으면 이렇게도 됨.
claude "빌드 에러 고쳐줘"
claude -p "이 함수 설명해줘"claude -p는 답변만 출력하고 바로 종료함. 스크립트에서 쓸 때 유용함.
이전 대화를 이어가고 싶으면 claude -c (가장 최근 대화) 또는 claude -r (대화 선택)을 쓰면 됨. 어제 하던 작업 이어서 할 때 편함.
팁 하나 추가하면, 요청할 때 구체적으로 말할수록 결과가 좋음. “버그 고쳐줘”보다 “로그인 페이지에서 잘못된 비밀번호 입력하면 빈 화면 나오는 버그 고쳐줘”가 훨씬 정확한 결과 나옴.
알아두면 좋은 것들
CLAUDE.md — 프로젝트 규칙 파일
프로젝트 루트에 CLAUDE.md 파일을 만들어두면, Claude Code가 매 세션 시작할 때 자동으로 읽음. 코딩 컨벤션, 빌드 명령어, 프로젝트 구조 같은 걸 적어두면 매번 설명 안 해도 알아서 따름.
# 프로젝트 규칙
- TypeScript strict mode
- pnpm 사용 (npm 금지)
- 테스트는 jest로 실행
- 커밋 전 lint 필수
- API 응답은 { data, message, statusCode } 형식 통일이거 하나 만들어두면 체감이 확 다름. 안 만들면 Claude가 npm 쓰기도 하고 yarn 쓰기도 하는데, CLAUDE.md에 pnpm 쓰라고 적어두면 무조건 pnpm만 씀. 팀 프로젝트에서도 이 파일을 커밋해두면 팀원 전체가 같은 규칙으로 Claude Code를 쓸 수 있음.
MCP — 외부 서비스 연결
MCP(Model Context Protocol)를 쓰면 Claude Code에 외부 도구를 연결할 수 있음. 데이터베이스 조회, Slack 메시지 전송, GitHub 이슈 관리 같은 걸 터미널 안에서 바로 할 수 있게 됨. 프로젝트 루트에 .mcp.json 파일로 설정함.
처음부터 MCP까지 쓸 필요는 없음. 기본 기능만으로도 충분히 강력하고, 필요해지면 그때 붙이면 됨.
슬래시 명령어
Claude Code 안에서 /를 입력하면 사용 가능한 명령어 목록이 나옴. 자주 쓰는 것만 정리함.
/help— 도움말/clear— 대화 초기화/config— 설정 변경/login— 계정 전환/compact— 대화 내용 압축 (컨텍스트 절약)
키보드 단축키도 있음. Tab으로 자동완성, Ctrl+C로 종료. 세션 중에 ? 누르면 전체 단축키를 볼 수 있음.
요금제
Claude Code는 무료 플랜에서 사용 불가함. 최소 Pro 구독이 필요함.
| Pro | $20/월 | 하루 몇 시간 쓰기에 충분. 대부분의 개발자는 이걸로 됨. |
| Max 5x | $100/월 | Pro의 5배 사용량. 하루 종일 쓰면 이것. |
| Max 20x | $200/월 | 헤비 유저용. 팀 전체가 쓰는 수준. |
Anthropic 공식 데이터에 따르면 평균 개발자가 하루에 쓰는 비용이 약 $6 수준이라고 함. Pro 플랜이면 대부분 충분함. 부족하다 싶으면 그때 Max로 올리면 됨.
VS Code / JetBrains 연동
터미널이 익숙하지 않은 사람은 VS Code나 JetBrains IDE에서도 Claude Code를 쓸 수 있음. 확장 프로그램 설치하면 IDE 안에서 바로 사용 가능함. 다만 터미널에서 쓰는 게 가장 기능이 풍부하고, IDE 연동은 보조 수단 정도로 생각하면 됨.
Claude Code는 “터미널에 앉아있는 AI 개발자”임. 처음엔 좀 낯설 수 있는데, 하루만 써보면 없이 못 살게 됨. 특히 1인 개발이나 소규모 팀에서 생산성 차이가 큼. 설치 2분, 러닝커브 거의 없음. 그냥 말하면 됨.