[ Claude Code #3 ] 핵심 명령어 (Command) & 단축키(Short cut) 완벽 정리

Claude Code를 사용하면서 마우스에 손을 대는 순간 생산성은 저하됩니다.

터미널 환경에 최적화된 Claude Code는 수많은 커맨드(Command)와 단축키(Short cut)를 제공하며, 이를 숙달하는 것이 ‘AI 협업’의 핵심입니다.

핵심 카테고리별로 필수 명령어 및 단축키 들을 딥다이브 해보겠습니다.

Table of Contents

1. 공통 관리 및 기본 조작 (Common)

세션 관리, 인증, 화면 제어 등 Claude Code 환경 자체를 다루는 가장 기본적인 기능들입니다.

명령어	설명	단축키 / 도구	비고
`/help`	사용 가능한 모든 명령어를 출력합니다.	–	막힐 때 가장 먼저 입력
`/clear`	대화 기록을 완전히 삭제하고 초기화합니다.	`Ctrl + L`	주제 전환 시 컨텍스트 꼬임 방지
`/exit`	Claude Code 세션을 안전하게 종료합니다.	`Ctrl + D`	작업 종료 후 쉘 복귀
`/config`	CLI 설정(색상, 권한, 에디터 등)을 수정합니다.	–	프로젝트 환경에 맞게 튜닝 가능
`/login`, `/logout`	Anthropic 계정 인증을 관리합니다.	–	세션 만료 시 재인증용
`/doctor`	설치 상태 및 환경 오류를 진단합니다.	–	실행이 원활하지 않을 때 필수 체크
`/powerup`	인터랙티브 레슨을 통해 기능을 배웁니다.	–	최신 기능 애니메이션 튜토리얼
`/status`	버전, 모델, 계정 상태를 확인합니다.	–	현재 가동 환경 및 연결성 점검
`/usage`	플랜 제한 및 속도 제한 상태를 체크합니다.	–	API 호출 할당량 및 속도 관리
중단	수행 중인 작업을 즉시 멈춥니다.	`Ctrl + C`	잘못된 코드 생성을 끊을 때 필수

새로운 구조를 짜거나 파일을 직접 수정하고, 실수를 되돌리는 단계에서 사용합니다.

명령어 / 액션	설명	관련 도구	활용 팁
`/undo`	Claude가 수행한 마지막 파일 변경을 취소합니다.	–	“아까 그게 더 나았어” 할 때 롤백용
`/plan [설명]`	구현 전 설계 모드에 진입하여 구조를 확정합니다.	`SPEC.md`	코드를 쓰기 전 계획서를 먼저 검토
`write_to_file`	특정 기능이나 클래스 파일을 새롭게 생성합니다.	내부 Tool	“~~ 패턴으로 API 핸들러 만들어줘”
`edit_file`	기존 파일의 특정 라인을 찾아 정밀 수정합니다.	내부 Tool	자연어로 수정 범위를 지정해도 정확히 파악
리와인드	대화와 코드를 특정 시점으로 통째로 되감습니다.	`Esc` `Esc`	단순 취소보다 강력한 체크포인트 복구
아키텍처 설계	전체 폴더 구조나 모듈 간 의존성을 설계합니다.	`ls -R`	프로젝트 루트에서 구조 분석 후 요청
병렬 워크트리	격리된 Git Worktree에서 독립 작업을 수행합니다.	`--worktree`	메인 브랜치 오염 없이 병렬 기능 구현

코드를 수정하기 전, 프로젝트의 전체적인 흐름과 특정 로직의 위치를 찾을 때 유용합니다.

명령어 / 도구	설명	단축키	활용 예시
`/add`	분석이 필요한 특정 파일/폴더를 컨텍스트에 추가합니다.	–	필요한 파일만 골라 넣어 토큰 절약
`/search`	코드 베이스 전체에서 문구나 패턴을 찾습니다.	`grep` 유사	“사용자 인증 로직이 어디에 있어?”
`/explain`	선택한 코드나 현재 파일의 동작 원리를 설명합니다.	`view_file`	레거시 분석이나 복잡한 알고리즘 파악
파일 읽기	파일을 열어서 내용을 실시간으로 확인합니다.	`cat`, `view`	Claude가 스스로 읽고 판단하는 근거
자동 완성	경로명이나 파일명을 입력할 때 사용합니다.	`Tab`	오타를 줄이고 입력 속도 비약적 향상
참조 지정	인라인 대화 중 특정 파일을 직접 지목합니다.	`@filename`	“이 파일(@app.ts)의 에러 핸들러 수정해줘”
히스토리 검색	과거에 입력했던 복잡한 프롬프트를 검색합니다.	`Ctrl + R`	반복되는 긴 프롬프트를 재사용할 때

작성된 코드의 품질을 높이고, 발생한 버그를 추적하여 해결하는 과정입니다.

명령어	설명	분석 대상	비고
`/review`	변경 사항의 품질, 보안성, 컨벤션을 검토합니다.	Diff 기록	PR 올리기 전 최종 검문소 역할
`/bug`	발생한 에러를 분석하고 해결 전략을 제안합니다.	Stack Trace	에러 로그를 복사해서 주면 정확도 상승
`/compact`	대화 내역을 요약하여 컨텍스트 창을 최적화합니다.	토큰 사용량	대화가 길어질 때 성능 저하 방지 필수
`/simplify`	코드를 분석하여 더 간결하게 개선할 점을 제안합니다.	코드 복잡도	가독성 향상 및 리팩토링 포인트 발견
`/security-review`	보안 이슈나 비효율적인 로직을 찾아냅니다.	보안 취약점	“이 코드에서 메모리 누수 위험 있어?”
`/release-notes`	Claude Code의 버전별 변경 사항을 확인합니다.	업데이트 로그	신기능 도입 및 버그 수정 여부 확인

Harness Engineering의 핵심인 테스트 실행과 외부 도구 연동을 담당합니다.

명령어 / 액션	설명	활용 도구	활용 예시
`/test`	프로젝트 내 테스트를 실행하거나 새 테스트를 생성합니다.	Jest, Pytest	“방금 수정한 함수 유닛 테스트 짜줘”
쉘 커맨드 실행	터미널 명령어를 직접 입력하여 결과를 확인합니다.	`run_command`	`npm install`이나 빌드 스크립트 실행
MCP 연동	외부 데이터나 도구(MCP)를 연결합니다.	`mcp_tools`	DB 조회나 Slack 연동 시 활용
Hooks 설정	특정 액션 전후에 자동 명령을 실행합니다.	`.claude/settings`	파일 저장 시 자동 린트(`eslint --fix`)
환경 진단	시스템 연결 및 설치 오류를 체크합니다.	`/doctor`	Claude Code 실행이 꼬였을 때 진단
GUI 검증	네이티브 앱을 열어 UI 동작을 직접 테스트합니다.	`computer-use`	API가 없는 GUI 앱의 E2E 테스트 수행