Claude Code는 개발자가 자연어로 코드를 작성하고, 테스트하고, 배포할 수 있게 해주는 Anthropic의 에이전트형 명령줄 인터페이스입니다. 터미널에서 직접 실행되고, 프로젝트 전체를 읽으며, 다단계 작업을 자율적으로 수행합니다 — 파일 편집, 테스트 실행, 커밋 생성, 풀 리퀘스트 열기까지, 파일 하나 건드리지 않아도 됩니다.
Claude Code란?
Claude Code는 Claude를 터미널로 직접 가져오는 Anthropic의 명령줄 도구입니다. 코드베이스를 읽고, 명령을 실행하고, 파일을 편집하고, 다단계 워크플로우를 관리합니다 — 모두 자연어로. 프로젝트 전체를 이해하는 시니어 엔지니어가 터미널에 상주한다고 생각하세요.
커리큘럼
배우게 될 내용
# Project Configuration
## Commands
- Build: `npm run build`
- Test: `npm test`
- Lint: `npm run lint`
## Style Guide
- Use TypeScript strict mode
- Prefer named exports
- Max line length: 100 chars모든 프로젝트에 맞게 Claude Code를 구성하는 방법을 배우세요
시작하기
Claude Code 사용 방법
npm install -g @anthropic-ai/claude-code 를 실행해 CLI를 전역으로 설치합니다. Node.js 18 이상이 필요합니다. claude login 으로 인증하거나 ANTHROPIC_API_KEY 환경 변수를 설정하세요.
프로젝트 루트에 CLAUDE.md 파일을 추가하세요. 기술 스택, 코딩 컨벤션, 주요 명령어, 프로젝트별 규칙을 Claude에게 알려주는 파일입니다. Claude는 매 세션 시작 시 자동으로 읽습니다.
프로젝트 디렉토리로 이동해 claude 뒤에 자연어 지시를 입력하세요. 예: "src/auth의 실패하는 테스트를 고쳐줘" 또는 "가입 폼에 입력 검증을 추가하고 테스트도 작성해줘"
Claude는 실행 전에 계획을 보여줍니다. 변경 사항을 승인, 수정, 거부할 수 있습니다. 신뢰할 수 있는 워크플로우에서는 --yes 로 비파괴적 작업을 자동 승인할 수 있습니다.
실전 활용
Claude Code의 일반적인 워크플로우
버그 수정
버그를 설명하면 Claude가 관련 코드를 읽고, 근본 원인을 찾고, 수정을 적용하고, 테스트 스위트를 실행해 검증합니다. 프롬프트 하나가 30분의 디버깅을 대체합니다.
코드 리뷰
PR diff를 붙여넣거나 변경된 파일을 Claude에게 지정하세요. 보안 문제, 성능 문제, 누락된 에러 처리, 스타일 위반을 점검하고 구체적인 수정안을 제안합니다.
기능 구현
만들고 싶은 것을 설명하세요. Claude가 파일을 스캐폴딩하고, 구현을 작성하고, 테스트를 추가하고, 관련 코드를 업데이트합니다. 결과를 검토하고 반복하면 됩니다.
리팩토링
가독성을 위한 모듈 리팩토링, 공통 로직 추출, 패턴 간 마이그레이션을 Claude에게 요청하세요. 코드베이스 전체 컨텍스트를 이해하므로 이름 변경도 올바르게 전파됩니다.
CLAUDE.md란?
CLAUDE.md는 Claude Code에 코드베이스에 대한 지속적인 컨텍스트를 제공하는 프로젝트 수준 설정 파일입니다. 시니어 엔지니어의 온보딩 문서처럼 작동하며 — 기술 스택, 코딩 표준, 주요 명령어, 매 세션 Claude가 따라야 할 프로젝트별 규칙을 기술합니다.
기술 스택과 프레임워크 버전, 빌드·테스트 명령어, 코딩 컨벤션, 파일 구조 개요, Claude가 따라야 할 규칙(예: "항상 매개변수화된 쿼리를 사용").
CLAUDE.md는 프로젝트 루트에 두세요. 전역 설정을 위한 ~/.claude/CLAUDE.md 와 모듈별 규칙을 위한 하위 디렉토리의 중첩 CLAUDE.md 파일도 지원됩니다.
CLAUDE.md를 살아있는 문서처럼 다루세요. 새 의존성을 추가하거나, 컨벤션을 바꾸거나, Claude가 따라야 할 패턴을 발견하면 파일을 업데이트하세요. 더 나은 CLAUDE.md가 더 나은 Claude 출력을 만듭니다.
자주 묻는 질문
Claude Code는 무료인가요?
Claude Code는 사용량 기반 과금의 Anthropic API 키 또는 Claude Pro/Max 구독이 필요합니다. CLI 자체에 별도 라이선스 비용은 없으며 — API 사용량에 대해서만 지불합니다.
Claude Code는 어떤 언어를 지원하나요?
Claude Code는 모든 프로그래밍 언어와 작동합니다. 특히 Python, TypeScript, JavaScript, Go, Rust, Java에 강하지만, 프로젝트의 모든 텍스트 기반 파일을 읽고 편집할 수 있습니다.
Claude Code를 원격 서버에서 실행할 수 있나요?
네. Claude Code는 bash가 실행되는 곳이면 어디서나 작동합니다 — 로컬 머신, SSH를 통한 원격 서버, Docker 컨테이너, GitHub Actions 같은 CI/CD 파이프라인까지. GUI가 필요 없습니다.
Claude Code는 Cursor와 어떻게 다른가요?
Claude Code는 자율적인 다단계 작업을 위해 만들어진 터미널 CLI입니다. Cursor는 인라인 편집과 코드 자동완성을 위한 VS Code 포크입니다. Claude Code는 에이전트형 워크플로우에, Cursor는 인터랙티브 코딩에 강합니다. 둘 다 쓰는 개발자도 많습니다.
Claude Code 배우는 방법?
실습. Track 3과 7이 다룹니다.
Claude Code vs GitHub Copilot?
Claude Code=터미널 네이티브. Copilot=인라인 보완.