핵심 명령어

매일 사용하는 명령어

Claude Code에는 다양한 명령어가 있어요. 하지만 대부분의 세션에서는 같은 몇 가지를 반복해서 쓰게 돼요. 이것들부터 확실히 익혀볼게요.

파일 컨텍스트 명령어

/add

파일을 Claude의 컨텍스트에 추가해요. 가장 많이 사용하게 될 명령어예요.

기본 사용법:

/add src/auth.js

여러 파일:

/add src/auth.js src/user.js src/session.js

Glob 패턴:

/add src/components/**/*.tsx    # components의 모든 TSX 파일
/add tests/*.test.js           # 모든 테스트 파일
/add **/*.md                   # 모든 마크다운 파일

사용 타이밍:

• 특정 코드에 대해 질문하기 전
• 파일 수정을 요청하기 전
• Claude가 파일들이 어떻게 함께 작동하는지 이해해야 할 때

꿀팁: 질문하기 전에 파일을 먼저 추가하세요. Claude가 실제 코드를 본 상태에서 더 좋은 답변을 해요.

/ls

컨텍스트에 있는 파일 목록을 보여줘요.

/ls

Claude가 현재 무엇을 알고 있는지 확인해요. /add 명령어가 제대로 작동했는지 검증하거나, 컨텍스트에 무엇이 쌓여 있는지 확인할 때 쓰세요.

대화 관리

/clear

대화 기록을 완전히 삭제해요.

/clear

사용 타이밍:

• 완전히 새로운 작업을 시작할 때
• 관련 없는 히스토리로 컨텍스트가 어수선해졌을 때
• Claude가 혼란스럽거나 일관성 없는 응답을 할 때
• Claude Code를 재시작하지 않고 새로 시작하고 싶을 때

주의: 되돌릴 수 없어요. 현재 세션의 모든 것이 사라져요.

/compact

핵심 정보를 유지하면서 컨텍스트 크기를 줄여요.

/compact

사용 타이밍:

• 컨텍스트가 커지고 있지만 작업을 계속하고 싶을 때
• Claude가 컨텍스트 한계에 가까워졌다고 할 때
• 응답 속도가 느려질 때

/clear와의 차이: Compact은 논의한 내용의 핵심을 보존해요. Clear는 모든 것을 지워요.

/undo

Claude의 마지막 동작을 되돌려요.

/undo

사용 타이밍:

• Claude가 원치 않는 수정을 했을 때
• 다른 접근법을 시도하고 싶을 때
• 무언가 잘못됐을 때

수동으로 되돌리는 것보다 훨씬 빨라요.

도움말 및 탐색

/help

사용 가능한 명령어를 보여줘요.

/help

명령어는 업데이트될 때마다 바뀌어요. /help는 항상 현재 사용 가능한 것을 보여줘요.

/status

현재 세션 상태를 보여줘요.

/status

컨텍스트 사용량, 활성 파일 등의 세션 정보를 표시해요.

실전 패턴

새 작업 시작하기

/clear
/add src/feature-im-working-on/*
> 데이터 fetching 레이어에 캐싱을 추가하자

깨끗한 상태. 관련 파일. 구체적인 작업.

작업 중간에 컨텍스트 갱신하기

/compact
/add src/new-file-i-need.js
> 캐싱 구현을 계속하자. 이 새 파일과 통합해줘.

Compact으로 히스토리를 유지하고, 새 컨텍스트를 추가하고, 중단한 곳에서 계속해요.

낯선 코드베이스 탐색하기

/add README.md package.json
> 이 프로젝트가 무엇을 하는지, 기술 스택은 무엇인지 알려줘

/add src/index.js src/app.js
> 메인 진입점을 안내해줘

넓은 범위에서 시작해 좁혀가요.

커밋 전 리뷰하기

/add $(git diff --name-only)
> 이 변경사항들을 리뷰해줘. 버그나 이슈가 있어?

변경된 파일만 추가해요. 집중된 리뷰.

흔한 실수

너무 많이 추가하기:

/add src/**/*

전체 코드베이스를 추가하지 마세요. 컨텍스트에는 한계가 있어요. 선별적으로 하세요.

충분히 추가하지 않기:

> 이 함수가 왜 작동 안 하지?

Claude가 함수를 볼 수 없어요. 먼저 파일을 추가하세요.

컨텍스트에 뭐가 있는지 잊기:

# 여러 번의 /add 명령어 후...
> 왜 그 오래된 파일을 참조하고 있어?

/ls로 실제로 컨텍스트에 무엇이 있는지 확인하세요. 어수선하면 /clear를 사용하세요.

/compact이면 충분할 때 /clear 사용하기:

/clear
# 이제 모든 것을 다시 추가하고 작업을 다시 설명해야 해요

세션 컨텍스트는 유지하면서 크기만 줄이고 싶다면 /compact을 쓰세요.

명령어 빠른 참조

실습

프로젝트에서 Claude Code를 열고 연습하세요:

1. /add로 소스 파일 몇 개 추가
2. /ls로 컨텍스트에 있는지 확인
3. 코드에 대해 질문하기
4. /compact으로 어떻게 요약하는지 확인
5. /clear를 사용해서 차이를 느끼기

다음으로 넘어가기 전에 이것들에 익숙해지세요. 나머지 모든 것의 기초예요.

핵심 정리

• /add가 가장 중요한 명령어 — Claude에게 올바른 파일을 제공하세요
• /clear는 새로 시작할 때, /compact은 컨텍스트를 유지하면서 크기를 줄일 때
• 혼란스러울 때 /ls로 컨텍스트에 뭐가 있는지 확인하세요
• /undo는 수동 되돌리기보다 빨라요
• 적은 게 나아요: 모든 것을 쏟아붓는 것보다 선별적인 컨텍스트가 효과적

다음에는 더 나은 결과를 위한 전략적 컨텍스트 관리를 배워요.

다음 레슨: 컨텍스트 관리를 심층적으로 다뤄요.