Claude Code 치트시트: 개발자 완전 초보 가이드

Claude Code란?

Claude Code는 Anthropic이 개발한 AI 코딩 어시스턴트입니다. 터미널에서 직접 실행되며, 코드 작성, 디버깅, 리팩토링, 문서화 등 다양한 개발 작업을 도와줍니다.

Code Editor

설치 방법

macOS/Linux

터미널에서 npm을 통해 전역으로 설치합니다. Node.js 18 이상이 필요합니다.

Windows

Windows에서도 동일하게 npm으로 설치 가능하며, WSL 환경에서 사용하는 것을 권장합니다.

기본 명령어

세션 시작

프로젝트 폴더에서 claude 명령어로 세션을 시작합니다. 처음 실행 시 Anthropic API 키를 입력해야 합니다.

자주 쓰는 명령어

/help: 도움말 보기
/clear: 대화 내용 지우기
/compact: 컨텍스트 압축
/cost: 현재 세션 비용 확인
/exit: 세션 종료

GitHub

핵심 기능 활용법

1. 코드 작성 요청

자연어로 원하는 기능을 설명하면 Claude가 코드를 작성합니다. 기존 코드를 참조하여 프로젝트 스타일에 맞는 코드를 생성합니다.

2. 버그 수정

에러 메시지를 붙여넣으면 원인을 분석하고 수정 방법을 제안합니다. 관련 파일을 자동으로 찾아 컨텍스트를 파악합니다.

3. 코드 리뷰

작성한 코드에 대한 리뷰를 요청할 수 있습니다. 잠재적 버그, 성능 이슈, 보안 취약점 등을 찾아냅니다.

4. 리팩토링

기존 코드를 더 깔끔하고 효율적으로 개선해달라고 요청할 수 있습니다.

Developer Desk

고급 팁

CLAUDE.md 활용

프로젝트 루트에 CLAUDE.md 파일을 만들면 Claude가 프로젝트 컨텍스트를 더 잘 이해합니다.

파일에 포함할 내용:

프로젝트 개요
기술 스택
코딩 컨벤션
자주 사용하는 명령어
알려진 이슈

컨텍스트 관리

긴 세션에서는 /compact 명령어로 컨텍스트를 압축하여 토큰을 절약하세요. 중요한 내용은 CLAUDE.md에 기록해두면 세션이 바뀌어도 유지됩니다.

파일 지정

특정 파일에 대해 작업하려면 파일 경로를 명시적으로 언급하세요. "@" 기호로 파일을 참조할 수도 있습니다.

Terminal

실전 워크플로우 예시

새 기능 개발

요구사항 설명
Claude가 구현 계획 제안
코드 작성 요청
테스트 코드 작성 요청
코드 리뷰 요청
수정사항 반영

버그 수정

에러 메시지/증상 공유
Claude가 원인 분석
수정 코드 제안
테스트 후 확인

비용 최적화

Claude Code는 API 사용량에 따라 과금됩니다.

비용 절약 팁

명확하고 구체적인 요청하기
불필요한 대화 줄이기
/compact로 컨텍스트 정리
큰 파일은 필요한 부분만 참조

마무리

Claude Code는 개발 생산성을 크게 향상시키는 강력한 도구입니다. 처음에는 어색할 수 있지만, 익숙해지면 페어 프로그래밍하는 것처럼 자연스럽게 활용할 수 있습니다. SpacePlanning은 AI 도구 활용 컨설팅을 제공합니다.