클로드 코드 유용한 명령어

명령어를 알아야 하는 이유

나는 처음에 Claude Code를 그냥 대화창으로만 썼다. "이거 고쳐줘", "테스트 돌려줘" 식으로 말하면 알아서 해주니까 그걸로 충분하다고 생각했다.

근데 명령어를 알고 나서 쓰는 방식이 달라졌다. 컨텍스트가 차오를 때 /compact로 정리하고, 실수한 응답은 /rewind로 되돌린다. 비용이 궁금하면 /cost를 친다. 대화로 부탁하는 것보다 빠르고 정확하다.

Claude Code에는 60개 이상의 빌트인 슬래시 커맨드와 5개의 번들 스킬이 있다. 전부 외울 필요는 없다. 매일 쓰는 10개 정도만 알면 작업 흐름이 확실히 바뀐다.

매일 쓰는 기본 명령어

카테고리별로 나눠서 정리한다. 설치만 끝났으면 바로 쓸 수 있는 것들이다.

세션 관리

내가 가장 많이 쓰는 카테고리다.

• /clear — 컨텍스트를 완전히 비우고 새로 시작한다. 주제가 바뀔 때 유용하다.
• /compact — 대화 내용을 요약해서 컨텍스트를 줄여준다. 컨텍스트가 95%에 도달하면 자동으로 실행된다. 하지만 수동으로 미리 돌리는 게 낫다. 인자를 넣으면 유지할 정보를 지정할 수 있다.

/compact 현재 리팩토링 중인 파일 목록과 변경 방향 유지

• /resume — 이전 세션을 이어서 작업한다. 어제 하던 작업을 오늘 계속할 때 쓴다.
• /rewind — 마지막 응답을 되감는다. Esc 두 번으로도 실행 가능하다. 복원 옵션은 4가지다: 코드+대화 모두 되돌리기, 대화만 되돌리기, 코드만 되돌리기, 요약 후 되돌리기.

모델 & 성능

• /model — 모델을 전환한다. Opus가 필요한 복잡한 작업과 Sonnet으로 충분한 단순 작업을 구분해서 쓰면 비용을 절약할 수 있다.
• /effort — 사고 수준을 조절한다. low, medium, high, max, auto 5단계가 있다. max는 Opus 전용이고 세션 한정이다. 간단한 질문에는 low, 복잡한 아키텍처 결정에는 high를 쓴다.

/effort high

개발 환경

• /permissions — 도구 권한을 확인하고 변경한다. 파일 쓰기, 명령어 실행 등의 권한을 세밀하게 제어할 수 있다.
• /config — 설정 파일을 열거나 편집한다.
• Shift+Tab — 모드를 순환한다. default → acceptEdits → plan → auto 순서로 바뀐다. 코드 변경을 자동 수락하고 싶을 때 acceptEdits, 계획만 보고 싶을 때 plan으로 전환한다.

비용 & 확인

• /cost — 현재 세션의 토큰 사용량과 비용을 보여준다. Statusline에 비용을 표시해두면 이 명령어를 덜 쓰게 된다.
• /diff — 세션 중 변경된 파일의 diff를 확인한다. 커밋 전에 한 번 돌려보는 습관을 들이면 좋다.
• /doctor — 설치 상태를 진단한다. 뭔가 이상할 때 가장 먼저 실행한다.

알아두면 편한 숨은 기능

슬래시 커맨드 외에도 알아두면 편한 기능들이 있다. 이걸 모르고 쓰면 손해다.

! 접두사로 터미널 명령어 직접 실행

! 뒤에 터미널 명령어를 입력하면 Claude를 거치지 않고 바로 실행된다. 토큰 비용이 0이다. 대신 출력 결과가 컨텍스트에 주입되기 때문에, 실행 결과를 바탕으로 바로 대화를 이어갈 수 있다.

!npm test | tail -20
!git log --oneline -5
!cat package.json | head -10

나는 테스트 결과 확인이나 파일 내용 조회에 자주 쓴다. "npm test 돌려줘"라고 말하는 것보다 빠르다.

@ 파일 참조

@ 뒤에 파일명을 입력하면 해당 파일을 컨텍스트에 추가한다. 퍼지 매칭을 지원해서 정확한 경로를 몰라도 된다. 라인 범위를 지정할 수도 있다.

@utils.ts 이 파일에서 중복 로직 정리해줘
@components/Header.tsx#5-10 이 부분 수정해줘

Esc 한 번 vs Esc 두 번

• Esc 한 번 — 현재 진행 중인 응답을 중단한다. 방향이 잘못됐다 싶으면 바로 누른다.
• Esc 두 번 — /rewind와 같다. 마지막 턴을 되감으면서 4가지 옵션을 보여준다. 코드 변경까지 되돌릴 수 있어서 실수 복구에 좋다.

이미지 붙여넣기

macOS에서 이미지를 붙여넣으려면 Ctrl+V를 써야 한다. Cmd+V가 아니다. 처음에 이걸 몰라서 한참 헤맸다. 스크린샷을 찍고 바로 붙여넣으면 UI 버그를 설명하기가 훨씬 쉬워진다.

기타 단축키

• Ctrl+R — 이전에 입력했던 프롬프트를 검색한다. 비슷한 작업을 반복할 때 유용하다.
• Ctrl+G — 외부 에디터(VS Code, Vim 등)에서 긴 프롬프트를 작성할 수 있다. 복잡한 지시사항을 여러 줄로 쓸 때 편하다.

커스텀 명령어 만들기

빌트인 명령어만으로 부족하면 직접 만들 수 있다. 현재 권장 방식은 .claude/skills/에 마크다운 파일을 만드는 것이다. .claude/commands/도 동작하지만 레거시로 분류된다.

.claude/skills/ (권장)

프로젝트 루트에 .claude/skills/ 디렉토리를 만들고 마크다운 파일을 넣는다.

---
description: "코드 리뷰를 수행한다"
---
 
# 코드 리뷰 스킬
 
$ARGUMENTS에 대해 다음을 수행한다:
1. 변경된 파일 확인
2. 버그 가능성 체크
3. 개선 사항 제안

$ARGUMENTS는 사용자가 명령어 뒤에 입력하는 텍스트로 치환된다. frontmatter의 description은 스킬 목록에 표시되는 설명이다.

번들 스킬

Claude Code에는 기본 제공되는 5개의 번들 스킬이 있다. Superpowers를 설치하면 더 많은 스킬을 사용할 수 있다. OMC로 확장하면 /autopilot, /team 같은 고급 워크플로우도 쓸 수 있다.

실전 시나리오

명령어를 조합해서 쓰는 실전 예시 3가지를 소개한다.

레거시 코드 리팩토링

/effort high
@legacy-service.ts 이 파일 구조를 분석해줘

분석 결과를 보고 리팩토링을 시작한다. 중간에 방향이 틀어지면 Esc 두 번으로 되감고, /diff로 변경 사항을 확인한 뒤 다시 진행한다.

긴 작업 여러 세션 이어가기

/rename auth-refactor
/compact 현재까지 변경한 파일 목록과 남은 작업 유지

다음 날 이어서 할 때:

/resume

/rename으로 세션 이름을 지어두면 /resume할 때 목록에서 찾기 쉽다. /compact에 유지할 정보를 명시하면 맥락이 잘 보존된다.

빠른 디버깅

!npm test | tail -20

실패한 테스트 결과가 컨텍스트에 들어간다. 바로 "이 에러 원인 분석하고 수정해줘"라고 이어가면 된다. 수정 후 다시 !npm test로 확인하는 루프를 반복한다. 터미널 환경이 잘 갖춰져 있으면 이 흐름이 더 매끄럽다.

정리

Claude Code의 명령어는 크게 세 종류다: 슬래시 커맨드(/compact, /rewind 등), 접두사(!, @), 단축키(Esc, Shift+Tab, Ctrl+V 등). 전부 외울 필요 없이 자주 쓰는 것부터 손에 익히면 된다.

나는 /compact, /rewind, ! 접두사 이 세 가지를 가장 많이 쓴다. 이것만 알아도 작업 흐름이 꽤 달라진다. 아직 Claude Code를 대화로만 쓰고 있다면, 오늘 /compact부터 써보자.