Claude Code 자주 사용하는 명령어 완벽 가이드

 

Claude Code 자주 사용하는 명령어 완벽 가이드

Claude Code는 터미널에서 직접 작동하는 AI 코딩 도구입니다. 자연어로 코딩 작업을 지시하고, 파일을 편집하며, 테스트를 실행하고, PR까지 생성할 수 있습니다. 이 가이드에서는 실무에서 가장 많이 사용하는 명령어들을 정리했습니다.

📋 목차

  1. 기본 CLI 명령어
  2. 대화형 슬래시 명령어
  3. 모드 및 작업 흐름
  4. 파일 참조 방법
  5. 커스텀 명령어 생성
  6. 설정 및 구성
  7. 유용한 팁과 단축키

1. 기본 CLI 명령어

세션 시작

# 기본 실행
claude

# 특정 모델 지정
claude --model claude-opus-4-20250514

# 권한 확인 건너뛰기 (주의: 위험할 수 있음)
claude --dangerously-skip-permissions

# MCP 디버그 모드
claude --mcp-debug

# 디버그 모드
claude --debug

인증 및 설정

# 브라우저를 통한 인증
claude auth

# API 키로 인증
export ANTHROPIC_API_KEY="your-api-key-here"

# 설정 확인
claude config

# 버전 확인
claude --version

2. 대화형 슬래시 명령어

Claude Code 세션 내에서 /로 시작하는 명령어를 사용할 수 있습니다.

위험을 감수하신다면 이것도 사용 가능 ^^  /auto를 사용하셔도 되요 

claude --dangerously-skip-permissions

핵심 내장 명령어

# 도움말 - 사용 가능한 모든 명령어 확인
/help

# 대화 초기화 (토큰 절약을 위해 자주 사용 권장)
/clear

# 컨텍스트 확인 - 현재 Claude가 가진 정보 확인
/context

# 권한 설정 관리
/permissions

# 이전 메시지로 돌아가기
/back

# 모드 전환
/auto      # 자동 모드
/plan      # 계획 모드
/compact   # 컴팩트 모드

에이전트 관련

# 서브 에이전트 생성 및 관리
/agents

# 특정 에이전트 호출
/agent:code-reviewer    # 코드 리뷰어 에이전트
/agent:test-engineer    # 테스트 엔지니어 에이전트
/agent:documentation    # 문서화 에이전트

GitHub 통합

# GitHub 앱 설치 (PR 자동 리뷰)
/install-github-app

# GitHub 이슈 확인 및 수정
/fix-github-issue <이슈번호>

플러그인 관리

# 플러그인 설치
/plugin install <plugin-name>

# 플러그인 목록 확인
/plugin list

# 플러그인 제거
/plugin remove <plugin-name>

3. 모드 및 작업 흐름

Claude Code는 세 가지 주요 작업 모드를 제공합니다.

Auto 모드 (자동 모드)

설명: Claude가 파일을 자동으로 편집하고 작업을 진행
활성화: /auto 또는 Tab 키
특징: 
- 권한 확인 없이 파일 편집
- 빠른 작업 진행
- Esc로 중단 가능

사용 예시:
"이 기능을 구현해줘" 입력 후 커피 타러 가기

Plan 모드 (계획 모드)

설명: 실행 전 상세한 계획 수립
활성화: /plan 또는 Shift+Tab 두 번
특징:
- Extended Thinking 활용
- 파일 편집 전 계획 승인 필요
- 복잡한 아키텍처 결정에 유용

사용 예시:
"이 리팩토링을 어떻게 진행할지 계획을 세워줘"

Interactive 모드 (대화형 모드)

설명: 기본 모드, 모든 작업에 권한 확인
특징:
- 모든 파일 편집과 명령 실행 전 확인
- 안전하지만 느림
- 학습 단계나 중요한 작업에 적합

4. 파일 참조 방법

기본 참조

# @ 기호로 파일 참조
"@src/components/Header.tsx를 리팩토링해줘"

# 여러 파일 참조
"@src/App.tsx와 @src/utils/api.ts를 분석해줘"

# 디렉토리 전체 참조
"@src/components/ 디렉토리의 모든 컴포넌트를 검토해줘"

드래그 앤 드롭

일반 드래그: 새 탭으로 파일 열기
Shift + 드래그: Claude에게 파일 참조하기

이미지 참조

Ctrl + V: 클립보드의 이미지 붙여넣기
(주의: Cmd + V는 작동하지 않음)

5. 커스텀 명령어 생성

프로젝트별 명령어

프로젝트 루트에 .claude/commands/ 디렉토리 생성

예시: 코드 리뷰 명령어

# .claude/commands/review.md
---
description: 포괄적인 코드 리뷰 수행
---

최근 변경사항에 대해 포괄적인 코드 리뷰를 수행하세요:

1. TypeScript 및 React 컨벤션 준수 확인
2. 적절한 에러 핸들링 및 로딩 상태 검증
3. 접근성 표준 충족 확인
4. 새 기능에 대한 테스트 커버리지 검토
5. 보안 취약점 검사
6. 성능 영향 검증
7. 문서화 업데이트 확인

코드 품질 체크리스트를 사용하고, 발견한 새로운 패턴을 CLAUDE.md에 업데이트하세요.

사용: /review

예시: 이슈 자동 수정 명령어

# .claude/commands/fix-issue.md
---
description: GitHub 이슈 분석 및 수정
---

GitHub 이슈를 분석하고 수정하세요: $ARGUMENTS

다음 단계를 따르세요:
1. `gh issue view`로 이슈 세부사항 확인
2. 이슈에 설명된 문제 이해
3. 관련 파일 검색
4. 문제 수정을 위한 변경사항 구현
5. 수정 검증을 위한 테스트 작성 및 실행
6. 린팅 및 타입 체킹 통과 확인
7. 설명적인 커밋 메시지 작성
8. PR 푸시 및 생성

모든 GitHub 관련 작업에는 GitHub CLI(`gh`)를 사용하세요.

사용: /fix-issue 1234

개인용 전역 명령어

홈 디렉토리에 ~/.claude/commands/ 생성

예시: 보안 검토 명령어

# ~/.claude/commands/security-review.md
---
description: 코드의 보안 취약점 검토
---

이 코드에서 보안 취약점을 검토하세요:

- SQL 인젝션 가능성
- XSS 취약점
- 인증/인가 이슈
- 민감한 데이터 노출
- 안전하지 않은 의존성

사용: /security-review

6. 설정 및 구성

CLAUDE.md 파일

프로젝트 컨텍스트와 지침을 제공하는 핵심 파일

# .claude/CLAUDE.md

# 프로젝트 컨텍스트

## 코딩 표준
- 모든 새 코드는 TypeScript 사용
- 기존 ESLint 설정 준수
- Jest를 사용한 모든 새 함수 테스트
- React에서 Hooks를 사용한 함수형 컴포넌트 사용

## 아키텍처
- Frontend: Next.js with TypeScript
- Backend: Node.js with Express
- Database: PostgreSQL with Prisma
- State: Zustand for client state

## 파일 구조
- 컴포넌트: `src/components/`
- 유틸리티: `src/utils/`
- 테스트: 소스 파일과 함께 `.test.ts` 확장자

## 주요 명령어
- 빌드: `npm run build`
- 테스트: `npm test`
- 린트: `npm run lint`
- 개발 서버: `npm run dev`

settings.json 구성

// .claude/settings.json
{
  "model": "claude-sonnet-4-20250514",
  "maxTokens": 4096,
  "permissions": {
    "allowedTools": [
      "Read",
      "Write",
      "Bash(git *)",
      "Bash(npm *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Write(./production.config.*)"
    ]
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write(*.py)",
        "hooks": [
          {
            "type": "command",
            "command": "python -m black $file"
          }
        ]
      },
      {
        "matcher": "Write(*.ts)",
        "hooks": [
          {
            "type": "command",
            "command": "npm run lint:fix $file"
          }
        ]
      }
    ]
  }
}

설정 파일 계층 구조:

  1. ~/.claude/settings.json - 전역 설정
  2. .claude/settings.json - 프로젝트 설정 (Git에 체크인)
  3. .claude/settings.local.json - 로컬 개인 설정 (Git 무시)

MCP 서버 설정

// .mcp.json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

7. 유용한 팁과 단축키

단축키

Tab              - Auto 모드 활성화
Shift + Tab (2번) - Plan 모드 활성화
Esc              - Claude 작업 중단
Esc (2번)        - 이전 메시지 목록 표시
Ctrl + C         - Claude Code 종료
Ctrl + V         - 이미지 붙여넣기
↑ (위 화살표)    - 이전 대화 세션 탐색

워크플로우 베스트 프랙티스

1. 복잡한 작업의 4단계 워크플로우

# 1단계: 문제 설명
"기능 X를 구현해야 해. 요구사항은..."

# 2단계: 연구 및 계획 (Plan 모드 사용)
/plan
"이 문제를 해결하기 위한 상세한 계획을 세워줘"

# 3단계: 구현
/auto
"계획대로 구현해줘"

# 4단계: 커밋 및 PR
"변경사항을 커밋하고 PR을 생성해줘. README도 업데이트해줘"

2. 디버깅 루프

# 테스트 실행 및 실패 확인
"npm test를 실행하고 실패한 테스트를 수정해줘"

# 자동 수정 반복
/auto
"모든 테스트가 통과할 때까지 반복해줘"

3. 코드베이스 학습

# 새 프로젝트 온보딩
"이 프로젝트의 전체 아키텍처를 설명해줘"
"인증 시스템이 어떻게 작동하는지 설명해줘"
"가장 중요한 파일들을 찾아서 요약해줘"

4. 린트 자동 수정

claude --dangerously-skip-permissions
"모든 린트 에러를 수정해줘"

토큰 최적화 팁

# 자주 /clear 사용
# 새 작업 시작할 때마다 대화 기록 초기화
/clear

# 필요한 파일만 참조
# 전체 디렉토리 대신 특정 파일만 @멘션

# CLAUDE.md에 반복적인 지침 저장
# 매번 설명하지 말고 문서화

보안 팁

# 민감한 파일 접근 차단
# .claude/settings.json에서:
{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Write(./production.config.*)"
    ]
  }
}

# 컨테이너에서 --dangerously-skip-permissions 사용
# Docker Dev Container로 격리된 환경 구성

8. 실전 예시

예시 1: 새 API 엔드포인트 추가

# Plan 모드로 시작
/plan
"사용자 프로필 업데이트를 위한 새 REST API 엔드포인트를 추가해줘.
- PUT /api/users/:id
- 인증 필요
- 유효성 검사 포함
- 단위 테스트 작성"

# 계획 검토 후 구현
/auto
"계획대로 구현해줘"

# 테스트 및 검증
"테스트를 실행하고 모든 것이 통과하는지 확인해줘"

# 커밋
"변경사항을 커밋하고 'feat: add user profile update endpoint'라는 메시지로 PR을 생성해줘"

예시 2: 버그 수정

# 버그 설명
"로그인 후 리다이렉트가 작동하지 않아. @src/components/Login.tsx를 확인해줘"

# Claude의 분석 후
"제안한 수정사항을 적용해줘"

# 테스트
"수동으로 테스트할 수 있도록 개발 서버를 시작해줘"

# 
run, test, fix 
install, run, test, fix

예시 3: 리팩토링
/plan
"@src/utils/ 디렉토리의 모든 유틸리티 함수를 리팩토링해줘.
- TypeScript 엄격 모드 적용
- 더 나은 에러 처리
- JSDoc 주석 추가
- 단위 테스트 추가"

# 계획 승인 후
/auto
"단계별로 진행하고, 각 파일을 수정한 후 테스트를 실행해줘"

9. 추가 리소스

공식 문서

커뮤니티 리소스

플러그인 마켓플레이스

10. 자주 묻는 질문 (FAQ)

Q: Claude Code가 계속 권한을 묻는데, 어떻게 해결하나요? A: claude --dangerously-skip-permissions로 시작하거나, .claude/settings.json에서 특정 도구들을 allowedTools에 추가하세요.

Q: 토큰 사용량이 너무 빠르게 증가해요. A: /clear를 자주 사용하고, 필요한 파일만 참조하며, CLAUDE.md에 반복적인 컨텍스트를 저장하세요.

Q: Claude가 너무 많은 변경을 한 번에 하려고 해요. A: Plan 모드(/plan)를 사용하여 먼저 계획을 세우고 단계별로 승인하세요.

Q: 팀과 설정을 공유하려면 어떻게 하나요? A: .claude/ 디렉토리와 .mcp.json을 Git에 커밋하세요. .claude/settings.local.json만 .gitignore에 추가하세요.

Q: 대용량 파일을 다룰 때 Claude가 실패해요. A: Claude Code는 18,000줄 파일도 처리할 수 있습니다. 파일을 여러 번 나눠서 작업하거나, 특정 섹션만 참조하세요.

마치며

Claude Code는 강력한 도구이지만, 효과적으로 사용하려면 워크플로우를 이해하고 적절한 명령어를 사용하는 것이 중요합니다. 이 가이드의 명령어들을 실무에 적용하면서 자신만의 워크플로우를 개발해보세요.

핵심 포인트:

  • 새 작업마다 /clear 사용
  • 복잡한 작업은 /plan으로 시작
  • CLAUDE.md와 커스텀 명령어로 반복 작업 자동화
  • 팀과 설정을 공유하여 일관성 유지

Happy coding! 🚀

댓글

댓글 쓰기

이 블로그의 인기 게시물

Claude AI의 생명과학 적용: 최신 자료 종합 리뷰

Claude AI의 생명과학 적용: 최신 자료 종합 리뷰 📌 개요 Anthropic은 2025년 10월 20일 "Claude for Life Sciences"를 공식 출시하며 생명과학 분야에 본격 진출했습니다. 이는 생명과학 연구 전 과정을 지원하는 특화된 AI 플랫폼으로, 약물 발견부터 규제 제출까지 과학적 발견 프로세스 전체를 가속화하는 것을 목표로 합니다. 1️⃣ Claude AI의 생명과학 적용 방법 1.1 기술적 성능 향상 Claude Sonnet 4.5는 Protocol QA 벤치마크에서 0.83점을 기록해 인간 기준선 0.79를 초과했으며, 이는 실험실 프로토콜 이해 능력이 인간 수준을 넘어섰음을 의미합니다. BixBench 평가에서도 생물정보학 작업에서 이전 모델 대비 상당한 개선을 보였습니다. 1.2 과학 도구 통합 (MCP Connectors) Claude for Life Sciences의 핵심은 Model Context Protocol (MCP) 기반 커넥터를 통한 실험실 도구와의 직접 통합입니다: 통합된 플랫폼: Benchling : 실험 노트북, 실험 기록에 대한 소스 링크 제공 PubMed : 수백만 개의 생물의학 연구 논문 접근 10x Genomics : 자연어로 단일 세포 및 공간 분석 수행 Scholar Gateway (Wiley) : 권위 있는 동료 검토 과학 콘텐츠 접근 Synapse.org : 공개/비공개 프로젝트에서 데이터 공유 및 분석 BioRender : 검증된 과학 그림, 아이콘, 템플릿 라이브러리 또한 Databricks와 Snowflake와도 연동되어 대규모 생물정보학 연구 분석과 자연어 쿼리를 통한 대용량 데이터셋 검색이 가능합니다. 1.3 Agent Skills 기능 Skills는 Claude가 특정 프로토콜과 절차를 일관되고 예측 가능하게 따를 수 있도록 하는 지침, 스크립트, 리소스를 포함한 폴더입니다. 첫 번째 공식 Skill: single-ce...
자세한 내용 보기

클로드 코드 빠른 시작

클로드 코드 빠른 시작 https://docs.anthropic.com/ko/docs/claude-code/quickstart 시작하기 전에 다음 사항을 확인하세요: 터미널 또는 명령 프롬프트가 열려 있음 (리눅스, 윈도우즈, 맥 모두 동일) 작업할 코드 프로젝트가 있음 Claude pro 또는 max 이상 계정 가입 Claude.ai  (권장) 또는  Anthropic Console  계정 1단계: Claude Code 설치 NPM 설치 Node.js 18 이상이 설치되어 있다면 : 없으면 링크로 가서 다운로드하고 설치 할 것 npm install -g @anthropic-ai/claude-code 네이티브 설치 (중요) 현재 베타 버전인 새로운 네이티브 설치가 가능함.  윈도우즈 power shell이나 command 창에서 실행 할 수 있음.  WSL에서 실행하는 것을 윈도우즈로 변환할 수 있음(경로 및 사용 프로그램 재설정 필요)  macOS, Linux, WSL: curl - fsSL https : / / claude . ai / install . sh | bash Windows PowerShell: irm https://claude . ai/install . ps1 | iex Windows CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd 2단계: 계정에 로그인 Claude Code를 사용하려면 계정이 필요합니다.  claude  명령으로 대화형 세션을 시작할 때 로그인해야 합니다: claude # 처음 사용할 때 로그인하라는 메시지가 표시됩니다 / login # 프롬프트에 따라 계정으로 로그인하세요 다음 두 가지 계정 유형 중 하나로 로그인할 수 있습니다: Claude.ai  (구독 플랜 - 권장, pro나 max ...
자세한 내용 보기

Claude Code를 사용할 때 유용한 명령어와 팁

C laude Code를 사용할 때 가장   유용한 명령어와 팁 은 다음과 같습니다.[1][2][3][5] 필수 명령어 모음 /init : 프로젝트 설정 초기화, CLAUDE.md 파일 자동 생성.[5] /clear : 대화 내역 초기화, 성능 최적화와 컨텍스트 정리에 효과적.[3][1] /model : AI 모델 변경, Sonnet ↔ Opus 전환 지원.[2][5] /permissions : 파일/폴더 수정 권한 및 허가 자동화.[5] /claude-md : 프로젝트 메모리 파일 생성 및 컨텍스트 공유.[5] /status : 현재 상태(버전, 모델, 계정 등) 확인.[5] /cost : 토큰 사용량 확인, 비용 관리에 유용.[5] claude --continue 또는 claude -c : 이전 세션에서 중단한 작업을 재개.[7][3] claude --help 또는 /help : 사용 중인 환경의 명령어 및 키 바인딩 정보 확인.[10] /exit 또는 Ctrl + C 두번 : 세션 종료.[2][7] 작업 및 컨텍스트 관리 팁 @파일명 : 프롬프트에서 @ 뒤에 파일명을 입력하면 해당 파일을 참조 가능.[1][2] #태그: 작업 내역을 기록할 때 # 사용.[1] 클립보드 이미지 삽입 : Ctrl + V (스크린샷 등 이미지도 첨부 가능).[2][1] 줄바꿈 : Ctrl + J (또는 /terminal-setup으로 불편함 해결).[2] Shift + Tab : 작업 모드 변경(일반/자동수락/계획).[7][2] Esc 키 : 작업 중단 또는 이전 세션 내용 보기.[7][2] 위 화살표 : 이전 대화 내용 탐색.[1][2] 고급 사용 팁 대화 시작 전에는  항상 /clear  명령어 사용해서 불필요한 컨텍스트 제거.[3][1] 맥락이 충분한 자연어 요청 으로 더 똑똑한 답변 유도 (예: “로그인 기능 구현”이 아닌 “JWT 기반 로그인 API를 Express + MongoDB로 구현해줘”).[5] IDE(터미널, VSCode 등)에서 플...
자세한 내용 보기