Claude Code 자주 쓰는 명령어 모음과 사용법

Claude Code 명령어를 알아야 하는 이유

Claude Code는 터미널에서 동작하는 AI 코딩 도구입니다. 마우스로 버튼을 클릭하는 방식이 아니라, 텍스트 명령어를 입력해서 기능을 실행하는 구조입니다. 그래서 어떤 명령어가 있는지 아는 것이 곧 Claude Code 활용 능력과 직결됩니다.

처음 Claude Code를 설치하고 나면 "이제 뭘 입력해야 하지?"라는 막막함이 생기기 마련입니다. 인터페이스가 텍스트 기반이다 보니, 시작점을 찾기 어렵다고 느끼는 분들이 많습니다. 하지만 자주 쓰는 명령어 몇 가지만 외워두면 대부분의 작업을 바로 시작할 수 있습니다.

Claude Code의 명령어는 크게 두 종류로 나뉩니다. 대화 중에 쓰는 슬래시 명령어와, 터미널에서 Claude Code 자체를 실행할 때 쓰는 CLI 옵션입니다. 슬래시 명령어는 /help처럼 슬래시로 시작하고, CLI 옵션은 claude --version처럼 대시(-)로 시작합니다. 이 두 종류를 구분해서 알아두면 상황에 맞는 명령어를 빠르게 찾을 수 있습니다.

 

 

명령어를 모른 채 Claude Code를 쓰면, 대화가 꼬였을 때 리셋하는 법도 모르고, 토큰이 얼마나 소모됐는지 확인하는 법도 모르게 됩니다. 결국 비효율적으로 사용하다가 포기하는 경우가 많습니다. 이 글에서 소개하는 명령어만 익혀두면 그런 상황을 피할 수 있습니다.

 

대화 중 꼭 알아야 할 슬래시 명령어 정리

Claude Code와 대화하는 도중에 슬래시(/)로 시작하는 특수 명령어를 입력하면, 일반 질문과는 다른 시스템 기능을 실행할 수 있습니다. 입문자가 가장 자주 쓰게 될 슬래시 명령어를 하나씩 살펴보겠습니다.

/help 는 사용 가능한 모든 명령어 목록과 간단한 설명을 보여줍니다. 어떤 명령어가 있었는지 기억이 안 날 때 가장 먼저 입력해 보면 됩니다. 입문자에게 가장 유용한 명령어라고 할 수 있습니다.

/clear 는 현재까지의 대화 내용을 한꺼번에 초기화하는 명령어입니다. 이전 대화 맥락이 꼬여서 엉뚱한 답변이 나올 때 깔끔하게 리셋할 수 있습니다. 새로운 주제로 넘어갈 때도 /clear를 먼저 실행하면 이전 대화의 영향을 받지 않습니다.

/compact 는 대화 내용을 요약해서 컨텍스트 윈도우(context window) 사용량을 줄여주는 명령어입니다. 컨텍스트 윈도우란 Claude Code가 한 번에 기억할 수 있는 대화 분량의 한계를 말합니다. 긴 작업 중간에 "컨텍스트가 부족합니다" 같은 경고가 뜨기 전에 미리 실행하면 대화가 끊기는 일을 막을 수 있습니다. /clear와 다른 점은, /clear는 대화를 완전히 삭제하지만 /compact는 핵심 내용을 유지한 채 분량만 줄인다는 것입니다.

/init 은 현재 프로젝트 폴더에 CLAUDE.md 파일을 자동으로 생성해 주는 명령어입니다. CLAUDE.md는 Claude Code에게 "이 프로젝트에서는 이런 규칙을 따라줘"라고 알려주는 설정 파일입니다. 프로젝트를 처음 시작할 때 한 번 실행해 두면, 매번 같은 설명을 반복하지 않아도 됩니다.

/cost 는 현재 세션에서 사용한 토큰(token) 양과 예상 비용을 확인할 수 있는 명령어입니다. API 요금이 걱정되는 분이라면 작업 중간중간 이 명령어로 과금 현황을 체크하는 습관을 들이는 것이 좋습니다. 특히 큰 파일을 분석하거나 긴 코드를 생성할 때는 토큰 소모가 빠르게 늘어나므로, /cost로 수시로 확인하는 것을 권장합니다.

/status 는 현재 Claude Code의 상태 정보를 확인할 수 있습니다. 어떤 모델을 사용하고 있는지, 컨텍스트 윈도우를 얼마나 사용했는지, 현재 작업 디렉토리가 어디인지 등을 한눈에 파악할 수 있습니다.

 

 

제가 실제로 사용하면서 느낀 점은, /compact와 /cost 두 명령어만 습관적으로 쓰면 대부분의 불편함이 해소된다는 것입니다. /compact는 대화가 10분 이상 길어질 때마다, /cost는 작업 시작 전후에 실행하면 적당합니다.

 

터미널에서 Claude Code를 실행하는 다양한 방법

슬래시 명령어가 대화 안에서 쓰는 것이라면, 이번에 소개할 명령어는 터미널에서 Claude Code 자체를 실행할 때 사용하는 CLI 옵션들입니다. 상황에 맞게 실행 방식을 바꾸면 훨씬 효율적으로 작업할 수 있습니다.

가장 기본은 터미널에 claude만 입력하는 것입니다. 이렇게 하면 대화형 모드가 시작되고, 질문과 답변을 주고받으며 작업을 진행할 수 있습니다. 대부분의 작업은 이 모드에서 처리합니다.

# 기본 대화형 모드
claude

# 특정 질문 하나만 물어보기
claude "이 폴더의 파일 구조를 알려줘"

# 출력 전용 모드 (파이프/리다이렉트 가능)
claude -p "README를 요약해줘" > summary.txt

# 이전 대화 이어서 계속하기
claude --resume

claude "질문 내용" 형태는 간단한 질문 하나만 물어보고 싶을 때 사용합니다. 대화형 모드에 진입하지 않고, 답변을 바로 출력한 뒤 종료합니다. 예를 들어 claude "이 폴더의 파일 구조를 알려줘"라고 입력하면 결과가 즉시 출력되고 끝납니다.

claude -p "질문"은 출력 전용(print) 모드입니다. 결과를 파일에 저장하거나 다른 명령어와 파이프(|)로 연결할 때 사용합니다. 일반 모드와 달리 대화형 인터페이스 없이 순수한 텍스트만 출력하기 때문에, 자동화 스크립트에서 Claude Code를 호출할 때 유용합니다.

claude --resume 옵션은 이전에 중단된 대화를 이어서 계속할 수 있는 기능입니다. 터미널을 실수로 닫았거나 컴퓨터를 재부팅한 뒤에도 이전 작업 맥락을 불러올 수 있습니다. 긴 작업을 진행할 때 매우 유용합니다.

claude --version은 설치된 Claude Code의 버전을 확인하는 명령어입니다. 오류가 발생했을 때 현재 버전을 확인하고, 최신 버전인지 비교할 때 쓰입니다. 버전이 오래된 경우 npm update -g @anthropic-ai/claude-code로 업데이트하면 됩니다.

 

 

이 중에서 가장 많이 쓰게 되는 것은 기본 claude 명령과 claude --resume입니다. 특히 --resume은 작업 중 터미널이 닫혀도 이전 맥락을 복원할 수 있어서, 긴 코딩 세션에서 안전망 역할을 합니다.

 

명령어 조합으로 실전 작업 효율을 높이는 방법

기본 명령어를 익혔다면, 이제 상황에 맞게 조합해서 쓰는 방법을 알아보겠습니다. 실제 작업 흐름에서 바로 적용할 수 있는 패턴 몇 가지를 소개합니다.

패턴 1: 새 프로젝트 시작 루틴

새 프로젝트를 시작할 때 추천하는 순서가 있습니다.

1. 프로젝트 폴더로 이동: cd 프로젝트경로

2. Claude Code 실행: claude

3. CLAUDE.md 생성: /init

4. 프로젝트 규칙과 기술 스택 정보를 CLAUDE.md에 추가

이렇게 해두면 다음에 Claude Code를 실행할 때 자동으로 프로젝트 맥락을 파악해서, 매번 처음부터 설명할 필요가 없어집니다. CLAUDE.md에는 프로젝트에서 사용하는 프로그래밍 언어, 프레임워크, 코딩 스타일 규칙 등을 적어두면 됩니다.

패턴 2: 긴 작업 중 컨텍스트 관리

대화가 길어지면 Claude Code가 초반에 했던 지시사항을 잊어버리는 경우가 생깁니다. 이럴 때 /compact 명령어를 중간에 한 번씩 실행해 주면, 핵심 내용만 남기고 불필요한 대화를 정리해서 컨텍스트 윈도우를 확보할 수 있습니다. 체감상 작업 10분마다 한 번씩 실행하면 적당합니다. 만약 주제가 완전히 바뀌는 경우에는 /compact 대신 /clear를 쓰는 것이 더 깔끔합니다.

패턴 3: 자동화 스크립트에서 Claude Code 활용

claude -p 옵션을 활용하면 셸 스크립트에서 Claude Code를 자동화 도구로 사용할 수 있습니다.

# 코드 리뷰 자동화 예시
git diff | claude -p "이 변경 사항을 리뷰해줘" > review.txt

# README 자동 생성
claude -p "이 프로젝트의 README.md를 작성해줘" > README.md

# 커밋 메시지 자동 생성
git diff --staged | claude -p "이 변경에 맞는 커밋 메시지를 한 줄로 작성해줘"

이런 자동화 패턴은 반복 작업의 시간을 크게 줄여줍니다. 특히 커밋 메시지 자동 생성은 매일 쓰게 되는 기능입니다.

패턴 4: 비용 관리 루틴

/cost 명령어를 작업 전후에 확인하는 습관을 들이면 예상치 못한 과금을 방지할 수 있습니다. 큰 파일을 분석하거나 긴 코드를 생성하면 토큰 사용량이 빠르게 늘어납니다. 작업 시작 시 /cost를 확인하고, 큰 요청을 보내기 전에 한 번 더 확인하면 비용을 효과적으로 관리할 수 있습니다.

 

 

정리하면, Claude Code를 처음 시작할 때 외워야 할 명령어는 슬래시 명령어 6개(/help, /clear, /compact, /init, /cost, /status)와 CLI 옵션 4개(claude, claude "질문", claude -p, claude --resume)입니다. 총 10개입니다. 이 10개만 익혀두면 Claude Code의 핵심 기능은 모두 활용할 수 있습니다. 나머지 고급 명령어는 필요할 때 /help로 찾아서 쓰면 충분합니다.