Claude Code를 사용하면서 마우스에 손을 대는 순간 생산성은 저하됩니다.
터미널 환경에 최적화된 Claude Code는 수많은 커맨드(Command)와 단축키(Short cut)를 제공하며, 이를 숙달하는 것이 ‘AI 협업’의 핵심입니다.
핵심 카테고리별로 필수 명령어 및 단축키 들을 딥다이브 해보겠습니다.
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 | 잘못된 코드 생성을 끊을 때 필수 |
2. 설계 및 구현 (Design & Implementation)
새로운 구조를 짜거나 파일을 직접 수정하고, 실수를 되돌리는 단계에서 사용합니다.
| 명령어 / 액션 | 설명 | 관련 도구 | 활용 팁 |
|---|---|---|---|
/undo | Claude가 수행한 마지막 파일 변경을 취소합니다. | – | “아까 그게 더 나았어” 할 때 롤백용 |
/plan [설명] | 구현 전 설계 모드에 진입하여 구조를 확정합니다. | SPEC.md | 코드를 쓰기 전 계획서를 먼저 검토 |
write_to_file | 특정 기능이나 클래스 파일을 새롭게 생성합니다. | 내부 Tool | “~~ 패턴으로 API 핸들러 만들어줘” |
edit_file | 기존 파일의 특정 라인을 찾아 정밀 수정합니다. | 내부 Tool | 자연어로 수정 범위를 지정해도 정확히 파악 |
| 리와인드 | 대화와 코드를 특정 시점으로 통째로 되감습니다. | Esc Esc | 단순 취소보다 강력한 체크포인트 복구 |
| 아키텍처 설계 | 전체 폴더 구조나 모듈 간 의존성을 설계합니다. | ls -R | 프로젝트 루트에서 구조 분석 후 요청 |
| 병렬 워크트리 | 격리된 Git Worktree에서 독립 작업을 수행합니다. | --worktree | 메인 브랜치 오염 없이 병렬 기능 구현 |
3. 탐색 및 컨텍스트 파악 (Exploration)
코드를 수정하기 전, 프로젝트의 전체적인 흐름과 특정 로직의 위치를 찾을 때 유용합니다.
| 명령어 / 도구 | 설명 | 단축키 | 활용 예시 |
|---|---|---|---|
/add | 분석이 필요한 특정 파일/폴더를 컨텍스트에 추가합니다. | – | 필요한 파일만 골라 넣어 토큰 절약 |
/search | 코드 베이스 전체에서 문구나 패턴을 찾습니다. | grep 유사 | “사용자 인증 로직이 어디에 있어?” |
/explain | 선택한 코드나 현재 파일의 동작 원리를 설명합니다. | view_file | 레거시 분석이나 복잡한 알고리즘 파악 |
| 파일 읽기 | 파일을 열어서 내용을 실시간으로 확인합니다. | cat, view | Claude가 스스로 읽고 판단하는 근거 |
| 자동 완성 | 경로명이나 파일명을 입력할 때 사용합니다. | Tab | 오타를 줄이고 입력 속도 비약적 향상 |
| 참조 지정 | 인라인 대화 중 특정 파일을 직접 지목합니다. | @filename | “이 파일(@app.ts)의 에러 핸들러 수정해줘” |
| 히스토리 검색 | 과거에 입력했던 복잡한 프롬프트를 검색합니다. | Ctrl + R | 반복되는 긴 프롬프트를 재사용할 때 |
4. 리뷰 및 오류 분석 (Review & Analysis)
작성된 코드의 품질을 높이고, 발생한 버그를 추적하여 해결하는 과정입니다.
| 명령어 | 설명 | 분석 대상 | 비고 |
|---|---|---|---|
/review | 변경 사항의 품질, 보안성, 컨벤션을 검토합니다. | Diff 기록 | PR 올리기 전 최종 검문소 역할 |
/bug | 발생한 에러를 분석하고 해결 전략을 제안합니다. | Stack Trace | 에러 로그를 복사해서 주면 정확도 상승 |
/compact | 대화 내역을 요약하여 컨텍스트 창을 최적화합니다. | 토큰 사용량 | 대화가 길어질 때 성능 저하 방지 필수 |
/simplify | 코드를 분석하여 더 간결하게 개선할 점을 제안합니다. | 코드 복잡도 | 가독성 향상 및 리팩토링 포인트 발견 |
/security-review | 보안 이슈나 비효율적인 로직을 찾아냅니다. | 보안 취약점 | “이 코드에서 메모리 누수 위험 있어?” |
/release-notes | Claude Code의 버전별 변경 사항을 확인합니다. | 업데이트 로그 | 신기능 도입 및 버그 수정 여부 확인 |
5. 자동화 및 검증 (Automation & Validation)
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 테스트 수행 |
