Claude Code 명령어 궁극의 사전: 파워 유저를 위한 완벽 가이드

@ai_ai_ailover
일본어6일 전 · 2026년 7월 11일
128K
209
18
1
753

TL;DR

Claude Desktop 내 Claude Code 명령어에 대한 포괄적인 매뉴얼로, 세션 관리, 병렬 처리, 자동화된 테스트 및 보안 검토를 다룹니다.

Code 탭 명령어, 공식 스킬, 실무 워크플로우 완벽 해설

이 글에서 다루는 "명령어"의 범위

이 글은 Claude Desktop의 Code 탭 입력 필드에서 실행되는 명령어를 다룹니다. 구체적으로는 입력 필드 시작 부분에 "/"를 입력하거나 입력 필드 옆 "+" 버튼에서 "Slash commands"를 선택하여 호출하는 명령어입니다.

다음 세 가지 유형을 다룹니다:

  • Claude Code 자체에 내장된 명령어
  • Anthropic이 번들로 제공하는 공식 스킬
  • 프로젝트 또는 플러그인에서 추가한 스킬

반대로, 터미널에서 Claude Code를 시작하는 방법, 시작 플래그, 비대화형 실행, 외부 스크립트에서의 조작은 다루지 않습니다.

Claude Desktop에서는 모델, 권한 모드, 플러그인, 커넥터, diff, 작업 등 많은 작업을 GUI로 수행할 수 있습니다. 따라서 터미널 버전에서 사용되는 일부 명령어는 Desktop에 표시되지 않거나 GUI 작업으로 대체됩니다.

현재 환경에서 사용 가능한 명령어를 확인하는 가장 확실한 방법은 Code 탭 입력 필드에 "/"를 입력하는 것입니다. 표시되는 내용은 OS, 구독 플랜, 실행 환경, 설치된 플러그인, 프로젝트 스킬에 따라 다릅니다.

제 1장: Claude Desktop에서 명령어 호출 방법

Claude Desktop의 Code 탭에서는 두 가지 방법으로 명령어를 호출할 수 있습니다.

첫째, 입력 필드 시작 부분에 "/"를 입력하는 방법입니다.

/

후보 목록이 나타나며, 계속 입력하면 범위를 좁힐 수 있습니다.

/ver

그러면 "/verify"와 같이 "ver"이 포함된 후보가 표시됩니다.

둘째, 입력 필드 옆 "+" 버튼에서 "Slash commands"를 선택하는 방법입니다. 목록에는 다음 항목이 함께 표시됩니다:

  • 내장 명령어
  • Anthropic의 공식 번들 스킬
  • 사용자 생성 스킬
  • 프로젝트별 스킬
  • 설치된 플러그인의 스킬

선택하면 명령어 이름이 입력 필드에 강조 표시되어 삽입됩니다. 그런 다음 요청 사항을 작성하여 보내면 됩니다.

명령어는 입력 시작 부분에 배치

명령어로 인식되려면 일반적으로 메시지 시작 부분에 위치해야 합니다.

올바른 예:

/plan 인증 기능을 Session Cookie 방식으로 마이그레이션하는 계획을 세워줘

다음은 일반 자연어로 해석될 수 있습니다:

먼저 /plan을 사용하여 인증 기능을 조사해봐

명령어 이름 뒤에 작성된 텍스트는 해당 명령어의 인수 또는 요청 내용으로 처리됩니다.

여러 스킬을 한 번에 결합

Claude Code v2.1.199 이상에서는 입력 시작 부분에 최대 6개의 스킬을 나열할 수 있습니다.

/security-context /api-rules /test-policy 인증 API 구현해줘

이렇게 하면 지정된 모든 스킬이 로드되고 각 스킬에 요청이 전달됩니다. 하지만 항상 많은 것이 좋은 것은 아닙니다. 유사한 스킬이 중복되면 다음과 같은 문제가 발생할 수 있습니다:

  • 충돌하는 명령어
  • 컨텍스트 소비 증가
  • 모호한 우선순위
  • 불필요한 단계 실행
  • 복잡한 완료 조건

현재 작업과 직접 관련된 스킬만 결합하세요.

제 2장: 세션 및 컨텍스트 구성을 위한 명령어

Claude Desktop에서는 각 세션마다 대화 기록, 프로젝트 폴더, 변경 사항, 컨텍스트가 독립적입니다. 작업이 진행됨에 따라 현재 대화를 계속할지, 요약할지, 아니면 다른 세션으로 분할할지 결정해야 합니다. 이러한 명령어가 도움이 됩니다.

/clear

/clear

현재 대화를 종료하고 빈 컨텍스트로 새 대화를 시작합니다. 이전 대화는 삭제되지 않으며 Desktop 사이드바에 남아 있습니다. 이름을 지정할 수도 있습니다:

/clear auth-investigation

다음과 같은 경우 /clear를 사용하세요:

  • 인증 작업을 마치고 결제 작업으로 넘어갈 때
  • 이전 가설이나 잘못된 결과를 이어가고 싶지 않을 때
  • 새 이슈를 시작할 때
  • 대화가 너무 길어지고 목표가 변경되었을 때

/compact

/compact

동일한 대화를 유지하지만 과거 대화 내용과 도구 결과를 요약하여 컨텍스트를 확보합니다. 유지할 내용을 지정할 수 있습니다:

/compact 인증 방식 결정, 변경된 파일, 실패하는 테스트, 보류 중인 작업 유지

다음과 같은 경우 /compact를 사용하세요:

  • 동일한 기능을 오랫동안 작업할 때
  • 컨텍스트 사용량이 많을 때
  • 오래된 검색 결과나 긴 로그가 많을 때
  • 중요한 설계 결정을 유지하고 싶을 때

/context

/context

현재 컨텍스트를 소비하는 항목(기록, CLAUDE.md, 규칙, 스킬, MCP 정의, 파일 등)을 확인합니다. 자세한 내용은:

/context all

Claude가 과거 요청과 현재 요청을 혼동하기 시작하거나, 너무 많은 스킬이 로드되었거나, 중요한 지침을 잊기 시작할 때 실행하세요.

/branch

/branch alternative-auth

해당 시점의 현재 대화를 복제하여 복제본으로 이동합니다. 원본은 그대로 유지되므로 현재 계획을 잃지 않고 대안을 시도할 수 있습니다. 이는 Git 브랜치가 아닌 대화를 브랜칭합니다.

/fork

/fork 현재 계획과 별도로 JWT 방식의 안전성과 비용을 조사해줘

현재 대화 전체를 상속하는 Background Subagent를 시작합니다. /branch와 달리 현재 대화에 머무르면서 에이전트가 사이드 작업을 처리합니다. 결과는 완료되면 메인 대화로 반환됩니다.

/btw

/btw 이 인증 프로세스에서 사용된 쿠키 이름이 뭐였지?

현재 컨텍스트를 사용하여 "사이드 질문"을 하고, 내용을 메인 대화 기록에 저장하지 않습니다. 메인 작업을 방해하지 않고 빠르게 확인해야 할 때 유용합니다.

/recap

/recap

현재 세션을 간략하게 요약합니다. 긴 프로세스 후나 여러 세션을 동시에 처리할 때 상황을 파악하는 데 유용합니다.

/rename

/rename auth-cookie-migration

현재 세션의 이름을 변경합니다. 사이드바를 정리하는 데 유용합니다.

제 3장: 계획 및 목표 제어를 위한 명령어

/plan

/plan 인증을 JWT에서 Session Cookie로 마이그레이션하는 계획을 세워줘

Claude를 Plan 모드로 전환하여 코드 편집 전에 조사하고 계획을 수립합니다. 구현 세부 사항, 테스트 구성, 실행 전 위험을 식별하는 데 도움이 됩니다.

/goal

/goal 모든 테스트 통과, 타입 오류 0, 변경된 등록 화면 수동 확인 완료까지 계속

명확한 완료 조건을 설정합니다. 평가자가 목표가 충족되었는지 확인할 때까지 Claude는 여러 차례에 걸쳐 계속 작업합니다. 목표는 객관적이고 관찰 가능해야 합니다.

/loop

/loop 5m CI 상태 확인하고 실패하면 조사

현재 세션 내에서 설정된 간격으로 요청을 반복합니다. CI, 배포 대기, 로그 모니터링에 유용합니다.

제 4장: 병렬 처리 및 대규모 작업을 위한 명령어

/batch

/batch src/ 디렉토리를 기존 Logging API에서 새 API로 마이그레이션

큰 변경 사항을 독립적인 단위로 나누고 Background Subagent와 Git Worktree를 사용하여 병렬로 구현하는 공식 스킬입니다. 여러 파일이나 패키지에 걸친 반복적인 변경 작업에 가장 적합합니다.

/deep-research

/deep-research 2026년 기준 WebAssembly Component Model 구현 현황 조사

많은 하위 에이전트에 연구를 분산시키고 결과를 통합하는 동적 워크플로우입니다. 일반 웹 검색보다 훨씬 강력합니다.

제 5장: 구현된 애플리케이션 실행을 위한 명령어

Claude Desktop은 Browser Pane을 사용하여 애플리케이션을 실제로 확인할 수 있습니다. 핵심 명령어는 /run, /verify, /run-skill-generator입니다.

/run

/run

프로젝트 애플리케이션을 시작하고 변경된 부분을 작동시킵니다. 앱이 시작되는지, 버튼이 작동하는지, 콘솔 오류가 있는지 확인합니다.

/verify

/verify

실행 결과를 통해 변경 사항이 요구 사항을 충족함을 증명합니다. /run이 작동에 초점을 맞추는 반면, /verify는 "완료 조건"이 충족되었는지(예: 실제로 로그인할 수 있는지?)에 초점을 맞춥니다.

/run-skill-generator

/run-skill-generator

프로젝트별 시작 및 확인 방법을 학습하여 /run/verify용 맞춤 스킬을 생성합니다. 향후 세션에서 토큰과 시간을 절약할 수 있습니다.

제 6장: 코드 품질 개선을 위한 명령어

/simplify

/simplify

변경된 코드를 검토하여 단순화 및 재사용 가능성을 확인합니다. 불필요한 복잡성을 줄이고 기존 헬퍼를 재사용하는 데 중점을 둡니다.

/code-review

/code-review high --fix

변경 사항을 버그 및 품질 개선 측면에서 검토합니다. 깊이(low, high, xhigh, ultra)를 지정할 수 있으며, 수정 사항을 적용하거나 GitHub에 댓글을 게시하도록 할 수도 있습니다.

/security-review

/security-review

변경 사항을 보안 관점(Injection, XSS, CSRF 등)에서 특별히 분석합니다. 인증 또는 결제 관련 변경에 필수적입니다.

/review

/review 123

GitHub Pull Request의 빠른 단일 패스 검토입니다. 신속한 첫 번째 확인에 좋습니다.

제 7장: 프로젝트 초기화 및 전문 작업

/init

/init

프로젝트를 조사하고 프로젝트 개요, 기술 스택, 코딩 패턴이 포함된 초기 CLAUDE.md 파일을 생성합니다.

/claude-api

/claude-api migrate

Anthropic API, SDK 및 도구 사용에 대한 공식 참조를 로드합니다. Anthropic의 서비스와 상호 작용하는 코드를 작성할 때 사용하세요.

/dataviz

/dataviz 월간 매출과 이탈을 비교하는 대시보드 디자인

차트 유형, 접근성, 정보 우선순위에 중점을 두고 효과적인 데이터 시각화를 설계하기 위한 공식 스킬입니다.

제 8장: Claude Code 자체 진단을 위한 명령어

/doctor

/doctor

Claude Code 설치, 설정 및 컨텍스트 구성을 진단합니다. 성능 문제나 컨텍스트 비대화에 대한 해결책을 제시하고 적용합니다.

/debug

/debug MCP Server 연결이 매번 끊김

Claude Code 자체의 런타임 문제(MCP 연결, 훅, 권한)를 진단합니다. 애플리케이션 코드가 아닙니다.

/fewer-permission-prompts

/fewer-permission-prompts

과거 세션을 분석하여 자주 승인하는 안전한 읽기 전용 작업에 대한 권한 규칙을 생성하여 마찰을 줄입니다.

제 9장: 설정 직접 변경을 위한 명령어

Desktop에서는 GUI가 선호되지만 키-값 쌍과 함께 /config를 사용할 수 있습니다:

/config theme=dark

참고: 인수 없이 /config(대화형 패널)는 Desktop Code 탭에서 작동하지 않습니다.

제 10장: 사용자 지정 스킬 및 플러그인 스킬

프로젝트별 스킬(저장소를 통해 공유), 사용자 스킬(개인 환경 설정), 플러그인 스킬도 "/" 메뉴에 나타납니다. 스킬은 호출될 때만 로드되므로 모든 것을 CLAUDE.md에 넣는 것보다 컨텍스트 효율성이 더 높습니다.

제 11장: 명령어 대신 GUI를 사용해야 할 경우

Claude Desktop에서는 다음 작업에 GUI를 사용하세요:

  • 모델/Effort 선택
  • 권한 모드
  • 플러그인/커넥터 관리
  • Diff 및 작업 모니터링
  • 세션 전환

제 12장: 실용적인 명령어 워크플로우

새 기능 안전하게 구현하기

  1. /plan (설계)
  2. 구현
  3. /simplify (정리)
  4. /code-review high (버그 확인)
  5. /security-review (보안 확인)
  6. /verify (실행 증명)

복잡한 버그 수정하기

  1. /goal (조건 설정)
  2. /fork (가설 조사)
  3. /code-review high
  4. /verify

요약: 명령어는 제어를 위한 인터페이스입니다

Claude Desktop의 명령어는 단순한 터미널 대안이 아닙니다. 언제 계획을 세우고, 언제 병렬화하며, 무엇을 완료 증거로 삼을지 Claude에게 지시하는 인터페이스입니다. 이를 마스터하여 Claude Desktop을 진정한 개발 환경으로 전환하세요.

원클릭 저장

YouMind로 바이럴 글을 AI 심층 읽기

소스를 저장하고, 핵심 질문을 던지고, 주장을 요약해 바이럴 글을 다시 활용할 수 있는 노트로 바꾸세요. 하나의 AI 워크스페이스에서 모두 할 수 있습니다.

YouMind 둘러보기
크리에이터를 위해

당신의 Markdown을 깔끔한 𝕏 글로

직접 쓴 장문을 올릴 때 이미지, 표, 코드 블록을 𝕏에 맞게 정리하는 일은 번거롭습니다. YouMind는 전체 Markdown 초안을 깔끔하고 바로 게시할 수 있는 𝕏 글로 바꿔 줍니다.

Markdown → 𝕏 사용해 보기

분석할 패턴 더 보기

최근 바이럴 아티클

더 많은 바이럴 아티클 보기