AI 코딩 에이전트의 시대, Claude Code는 단순한 코드 완성을 넘어 터미널에서 전체 코드베이스를 읽고, 파일을 편집하며, 테스트와 명령어를 직접 실행하는 혁신적인 도구입니다. 개발 생산성을 극대화하기 위해 실무에서 즉시 활용 가능한 핵심 명령어 요약본(Cheat Sheet)을 정리해 드립니다.
1. 설치 및 세션 시작
Claude Code를 시작하려면 먼저 계정 인증이 필요합니다. 터미널에서 claude login을 입력해 Anthropic 계정이나 Console 계정으로 로그인하세요.
인터랙티브 모드: claude를 입력하여 대화형 세션을 시작합니다.
일회성 작업 실행: claude "기능 구현해줘"처럼 터미널에서 바로 명령을 내릴 수도 있습니다.
세션 재개: claude -c는 현재 디렉토리의 마지막 대화를 이어가고, claude -r은 이전 세션 목록을 불러와 선택할 수 있게 합니다.
2. 세션 내부 핵심 명령어 (슬래시 명령어)
세션 중에는 /를 입력하여 강력한 내장 기능들을 호출할 수 있습니다.
프로젝트 초기화 (/init): 프로젝트의 가이드 역할을 하는 CLAUDE.md 파일을 생성합니다. 이는 AI가 프로젝트의 코딩 표준과 아키텍처를 이해하는 ‘장기 기억’이 됩니다.
설계 및 계획 (/plan): 대규모 수정 전에는 이 모드를 활성화하여 AI가 먼저 구현 전략을 세우도록 유도하세요.
코드 검토 (/review / /security-review): 구현된 코드의 품질을 체크하거나 보안 취약점을 분석합니다.
상태 진단 (/doctor): 설치 문제나 환경 설정 오류가 발생했을 때 진단과 수정을 돕습니다.
3. 효율적인 컨텍스트 및 리소스 관리
AI의 성능은 제한된 컨텍스트 윈도우를 얼마나 잘 관리하느냐에 달려 있습니다.
사용량 시각화 (/context): 현재 토큰 사용량을 그리드 형태로 확인하여 컨텍스트 낭비를 방지합니다.
대화 압축 (/compact): 대화가 길어져 성능이 저하될 때 기존 내용을 요약하여 공간을 확보합니다.
리소스 참조 (@): @파일명을 입력하여 특정 파일이나 MCP 리소스를 명시적으로 참조해 정확도를 높일 수 있습니다.
4. 생산성을 높이는 단축키와 팁
즉시 실행 (!): AI의 해석 과정을 거치지 않고 직접 쉘 명령을 실행하려면 앞에 !를 붙이세요 (예: !git status).
작업 중단 및 롤백 (ESC): ESC 한 번은 현재 작업을 중단하고, 두 번 연속 입력은 코드와 대화를 이전 체크포인트로 되돌립니다(Rewind).
자동 승인 전환 (Shift + Tab): 일일이 권한을 승인하기 귀찮을 때 권한 모드를 빠르게 순환하여 ‘모두 수락’ 모드로 바꿀 수 있습니다.
주의 사항: 프로젝트 환경 변수(.env)에 ANTHROPIC_API_KEY가 설정되어 있으면 구독 플랜 대신 API 크레딧에서 비용이 지출될 수 있으므로, 의도치 않은 과금을 피하려면 이를 확인해야 합니다. 이 치트 시트를 터미널 옆에 두고 Claude Code의 강력한 에이전트 기능을 100% 활용해 보세요!