[Claude Code] 명령어 정리: 터미널에서 AI와 협업하는 법

1. 도입부

개발을 하다 보면 브라우저와 터미널을 오가는 과정에서 흐름이 끊기는 것이 가장 큰 낭비다. Claude Code는 이러한 불편함을 해결하기 위해 터미널 안에서 AI와 직접 대화하며 코드를 수정하고, 테스트를 실행하며, 심지어 GitHub PR까지 관리할 수 있게 설계되었다.

Claude Code의 핵심은 바로 슬래시(/)로 시작하는 명령어들이다. 이 명령어들을 얼마나 숙달하느냐에 따라 AI 에이전트를 단순히 대화 상대로 쓸지, 아니면 강력한 자동화 도구로 쓸지가 결정된다. 오늘은 실무에서 가장 자주 쓰이는 명령어들을 카테고리별로 나누어 정리하고, 효율적인 활용 팁까지 함께 살펴본다.

 

2. 주요 특징 및 핵심 로직

Claude Code의 명령어 시스템은 단순한 텍스트 입력을 넘어 시스템의 상태를 제어하고 외부 도구와 연동하는 역할을 한다. 크게 다음과 같은 4가지 논리적 흐름으로 구분할 수 있다.

1. 세션 및 컨텍스트 관리: 대화의 흐름을 제어하고 토큰을 절약하기 위해 컨텍스트를 압축하거나 되감는 로직.
2. Git 및 PR 워크플로우: 로컬 코드를 넘어 GitHub의 PR 댓글을 반영하거나 CI 실패를 자동 수정하는 협업 도구.
3. 고급 자동화 루틴: 반복적인 체크 작업이나 대규모 변경 사항을 병렬로 처리하는 에이전트 오케스트레이션.
4. 시스템 및 도구 연동: MCP(Model Context Protocol)를 통한 외부 API 연동 및 개인화된 환경 설정.

 

3. 상세 가이드 및 심층 분석

📂 [Essential] 실무 필수 명령어 TOP 10

가장 기본이 되면서도 손에 익어야 하는 핵심 명령어들이다.

명령어목적설명

/clear	세션 초기화	대화 기록을 지우고 깨끗하게 시작한다. (기존 세션은 /resume 가능)
/compact	컨텍스트 압축	대화가 길어질 때 핵심만 요약해 토큰 낭비를 줄인다.
/init	프로젝트 초기화	CLAUDE.md 가이드 파일을 생성해 프로젝트 규칙을 학습시킨다.
/doctor	상태 진단	설치 상태와 설정을 체크하고 발견된 문제를 자동으로 수정한다.
/config	설정 패널	테마, 모델, 에디터 모드(Vim 등)를 조정하는 GUI 탭을 연다.
/resume	세션 재개	이전 작업 세션 목록에서 선택하여 이어서 진행한다.
/context	사용량 시각화	현재 토큰 사용량을 색상 그리드로 보여주며 최적화를 제안한다.
/copy	응답 복사	AI의 응답이나 특정 코드 블록을 클립보드에 즉시 복사한다.
/model	모델 변경	Sonnet, Opus 등 모델을 변경하거나 사고 강도(Effort)를 조절한다.
/exit	종료	세션을 안전하게 종료하고 터미널로 돌아간다.

 

🚀 [Advanced] 생산성을 2배로 높이는 프로급 명령어

단순 코딩 보조를 넘어선 강력한 자동화 기능들이다.

1. Git 및 협업 가속화

• /autofix-pr: 실무에서 가장 유용하다. 현재 브랜치의 PR을 감시하다가 CI가 실패하거나 리뷰어가 댓글을 남기면 즉시 수정 사항을 푸시한다.
• /review: 로컬 환경에서 PR 코드를 검토한다. 더 깊은 분석이 필요하면 클라우드 에이전트를 쓰는 /ultrareview를 활용하자.
• /diff: 단순 git diff보다 강력하다. Claude가 수정한 턴(Turn)별 변경 사항을 인터페이스로 탐색할 수 있다.
• /teleport: 웹 세션(claude.ai)에서 작업하던 내용을 현재 터미널로 그대로 가져온다. 환경 간의 벽을 허무는 기능이다.

2. 자동화 루틴 및 병렬 처리

• /loop [interval] [prompt]: 특정 주기로 명령을 반복한다. 예: /loop 5m 배포가 완료되었는지 확인해줘.
• /schedule: 복잡한 유지보수 루틴을 설정하고 자동화한다. /routines로도 사용 가능하다.
• /batch <instruction>: 코드베이스 전체의 대규모 변경을 조율한다. 작업을 쪼개어 여러 백그라운드 에이전트가 동시에 실행하도록 한다.
• /simplify [focus]: 최근 변경된 코드의 품질을 검토하고 효율성 측면에서 개선 사항을 자동 적용한다.

3. 도구 및 정보 연동

• /mcp: Model Context Protocol 서버를 관리한다. 이를 통해 Claude가 Jira, GitHub API, Google Search 등 외부 도구에 접근하게 된다.
• /btw <question>: 현재 대화의 맥락(Context)을 오염시키지 않고 잠깐 딴길로 새는 질문을 할 때 유용하다.
• /claude-api: 사용 중인 언어(Python, TS 등)에 맞는 SDK 참조 자료를 즉시 로드한다.

 

4. 실무 팁 및 주의사항

1. 색상으로 세션 구분하기: 여러 프로젝트를 동시에 진행한다면 /color 명령어로 프롬프트 바 색상을 바꿔보자. 시각적으로 세션을 혼동하는 일을 막아준다.
2. Vim 모드 활용: 터미널 환경이 익숙한 개발자라면 /config 에 들어가 Editor mode를 Vim으로 바꿔보자. 입력창에서도 강력한 키바인딩을 쓸 수 있다.
3. 보안이 최우선: /permissions 명령어를 통해 Claude가 접근하거나 수정할 수 있는 범위를 엄격히 관리하자. .env 같은 민감 파일은 미리 차단 목록에 넣는 것이 좋다.
4. 토큰 다이어트: /recap은 세션을 떠난 후 나타나는 한 줄 요약 기능이다. 이를 통해 다음에 들어왔을 때 이전 맥락을 빠르게 파악할 수 있어 효율적이다.

 

5. 마무리

Claude Code는 단순한 챗봇이 아니라 터미널 환경을 완벽하게 이해하는 공동 개발자(Co-developer)에 가깝다. 오늘 정리한 명령어들을 하나씩 직접 타이핑해 보며 손에 익힌다면, 코딩과 디버깅, 배포에 이르는 전체 사이클에서 이전과는 비교할 수 없는 속도를 경험하게 될 것이다. 처음에는 /help를 자주 입력하며 익숙해지는 것부터 시작해 보자.