이 가이드는 Claude Code를 사용한 일반적인 워크플로우에 대한 단계별 튜토리얼을 제공합니다. 각 튜토리얼에는 Claude Code를 최대한 활용하는 데 도움이 되는 명확한 지침, 예제 명령 및 모범 사례가 포함되어 있습니다.

​
목차

​
이전 대화 재개하기

​
작업을 원활하게 계속하기

사용 시기: Claude Code로 작업하던 태스크를 나중 세션에서 이어서 진행해야 할 때. Claude Code는 이전 대화를 재개하기 위한 두 가지 옵션을 제공합니다:
  • --continue를 사용하여 가장 최근 대화를 자동으로 계속하기
  • --resume을 사용하여 대화 선택기 표시하기
1

가장 최근 대화 계속하기

claude --continue
이렇게 하면 프롬프트 없이 즉시 가장 최근 대화를 재개합니다.
2

비대화형 모드에서 계속하기

claude --continue --print "Continue with my task"
비대화형 모드에서 가장 최근 대화를 재개하려면 --print를 --continue와 함께 사용하세요. 스크립트나 자동화에 적합합니다.
3

대화 선택기 표시하기

claude --resume
이렇게 하면 다음 정보를 보여주는 대화형 대화 선택기가 표시됩니다:
  • 대화 시작 시간
  • 초기 프롬프트 또는 대화 요약
  • 메시지 수
화살표 키로 탐색하고 Enter를 눌러 대화를 선택하세요.
작동 방식:
  1. 대화 저장소: 모든 대화는 전체 메시지 기록과 함께 자동으로 로컬에 저장됩니다
  2. 메시지 역직렬화: 재개할 때 전체 메시지 기록이 복원되어 컨텍스트를 유지합니다
  3. 도구 상태: 이전 대화에서의 도구 사용 및 결과가 보존됩니다
  4. 컨텍스트 복원: 대화는 이전 컨텍스트가 모두 유지된 상태로 재개됩니다
팁:
  • 대화 기록은 로컬 머신에 저장됩니다
  • 가장 최근 대화에 빠르게 접근하려면 --continue를 사용하세요
  • 특정 과거 대화를 선택해야 할 때는 --resume을 사용하세요
  • 대화를 재개할 때 계속하기 전에 전체 대화 기록을 볼 수 있습니다
  • 재개된 대화는 원래 대화와 동일한 모델 및 구성으로 시작됩니다
예시: 
# 가장 최근 대화 계속하기
claude --continue

# 특정 프롬프트로 가장 최근 대화 계속하기
claude --continue --print "Show me our progress"

# 대화 선택기 표시하기
claude --resume

# 비대화형 모드에서 가장 최근 대화 계속하기
claude --continue --print "Run the tests again"

​
새로운 코드베이스 이해하기

​
코드베이스 빠른 개요 얻기

사용 시기: 새 프로젝트에 합류했고 그 구조를 빠르게 이해해야 할 때.
1

프로젝트 루트 디렉토리로 이동하기

cd /path/to/project
2

Claude Code 시작하기

claude
3

상위 수준 개요 요청하기

> 이 코드베이스에 대한 개요를 알려주세요
4

특정 컴포넌트에 대해 더 자세히 알아보기

> 여기서 사용된 주요 아키텍처 패턴을 설명해주세요 

> 주요 데이터 모델은 무엇인가요?

> 인증은 어떻게 처리되나요?
팁:
  • 넓은 질문으로 시작한 다음 특정 영역으로 좁혀가세요
  • 프로젝트에서 사용되는 코딩 규칙과 패턴에 대해 물어보세요
  • 프로젝트 특정 용어의 용어집을 요청하세요

​
관련 코드 찾기

사용 시기: 특정 기능이나 기능과 관련된 코드를 찾아야 할 때.
1

Claude에게 관련 파일 찾기 요청하기

> 사용자 인증을 처리하는 파일을 찾아주세요
2

컴포넌트 상호작용 방식에 대한 컨텍스트 얻기

> 이러한 인증 파일들이 어떻게 함께 작동하나요?
3

실행 흐름 이해하기

> 프론트엔드에서 데이터베이스까지 로그인 프로세스를 추적해주세요
팁:
  • 찾고 있는 것에 대해 구체적으로 말하세요
  • 프로젝트의 도메인 언어를 사용하세요

​
효율적으로 버그 수정하기

​
오류 메시지 진단하기

사용 시기: 오류 메시지가 발생했고 그 원인을 찾아 수정해야 할 때.
1

Claude와 오류 공유하기

> npm test를 실행할 때 오류가 발생합니다
2

수정 권장사항 요청하기

> user.ts의 @ts-ignore를 수정하는 몇 가지 방법을 제안해주세요
3

수정 적용하기

> 제안하신 null 체크를 추가하도록 user.ts를 업데이트해주세요
팁:
  • Claude에게 오류를 재현하는 명령어와 스택 트레이스를 알려주세요
  • 오류를 재현하는 단계를 언급하세요
  • 오류가 간헐적인지 일관적인지 Claude에게 알려주세요

​
코드 리팩토링하기

​
레거시 코드 현대화하기

사용 시기: 오래된 코드를 현대적인 패턴과 관행을 사용하도록 업데이트해야 할 때.
1

리팩토링할 레거시 코드 식별하기

> 코드베이스에서 더 이상 사용되지 않는 API 사용을 찾아주세요
2

리팩토링 권장사항 얻기

> utils.js를 현대적인 JavaScript 기능을 사용하도록 리팩토링하는 방법을 제안해주세요
3

안전하게 변경사항 적용하기

> 동일한 동작을 유지하면서 ES2024 기능을 사용하도록 utils.js를 리팩토링해주세요
4

리팩토링 확인하기

> 리팩토링된 코드에 대한 테스트를 실행해주세요
팁:
  • Claude에게 현대적인 접근 방식의 이점을 설명해달라고 요청하세요
  • 필요할 때 변경사항이 이전 버전과의 호환성을 유지하도록 요청하세요
  • 리팩토링을 작고 테스트 가능한 단위로 수행하세요

​
테스트 작업하기

​
테스트 커버리지 추가하기

사용 시기: 테스트되지 않은 코드에 테스트를 추가해야 할 때.
1

테스트되지 않은 코드 식별하기

> NotificationsService.swift에서 테스트로 커버되지 않은 함수를 찾아주세요
2

테스트 스캐폴딩 생성하기

> 알림 서비스에 대한 테스트를 추가해주세요
3

의미 있는 테스트 케이스 추가하기

> 알림 서비스의 엣지 조건에 대한 테스트 케이스를 추가해주세요
4

테스트 실행 및 확인하기

> 새 테스트를 실행하고 실패한 부분을 수정해주세요
팁:
  • 엣지 케이스와 오류 조건을 다루는 테스트를 요청하세요
  • 적절한 경우 단위 테스트와 통합 테스트를 모두 요청하세요
  • Claude에게 테스트 전략을 설명해달라고 요청하세요

​
풀 리퀘스트 생성하기

​
포괄적인 PR 생성하기

사용 시기: 변경사항에 대한 잘 문서화된 풀 리퀘스트를 생성해야 할 때.
1

변경사항 요약하기

> 인증 모듈에 대해 내가 변경한 사항을 요약해주세요
2

Claude로 PR 생성하기

> pr 생성해주세요
3

검토 및 개선하기

> 보안 개선 사항에 대한 더 많은 컨텍스트로 PR 설명을 향상시켜주세요
4

테스트 세부 정보 추가하기

> 이러한 변경 사항이 어떻게 테스트되었는지에 대한 정보를 추가해주세요
팁:
  • Claude에게 직접 PR을 만들어달라고 요청하세요
  • 제출하기 전에 Claude가 생성한 PR을 검토하세요
  • Claude에게 잠재적 위험이나 고려사항을 강조해달라고 요청하세요

​
문서 처리하기

​
코드 문서 생성하기

사용 시기: 코드에 대한 문서를 추가하거나 업데이트해야 할 때.
1

문서화되지 않은 코드 식별하기

> auth 모듈에서 적절한 JSDoc 주석이 없는 함수를 찾아주세요
2

문서 생성하기

> auth.js의 문서화되지 않은 함수에 JSDoc 주석을 추가해주세요
3

검토 및 개선하기

> 더 많은 컨텍스트와 예제로 생성된 문서를 개선해주세요
4

문서 확인하기

> 문서가 프로젝트 표준을 따르는지 확인해주세요
팁:
  • 원하는 문서 스타일을 지정하세요(JSDoc, docstrings 등)
  • 문서에 예제를 요청하세요
  • 공개 API, 인터페이스 및 복잡한 로직에 대한 문서를 요청하세요

​
이미지 작업하기

​
이미지 및 스크린샷 분석하기

사용 시기: 코드베이스에서 이미지로 작업하거나 이미지 콘텐츠 분석에 Claude의 도움이 필요할 때.
1

대화에 이미지 추가하기

다음 방법 중 하나를 사용할 수 있습니다:
  1. Claude Code 창에 이미지를 끌어다 놓기
  2. 이미지를 복사하여 cmd+v(Mac에서)로 CLI에 붙여넣기
  3. 이미지 경로 제공하기 claude “이 이미지를 분석해주세요: /path/to/your/image.png”
2

Claude에게 이미지 분석 요청하기

> 이 이미지는 무엇을 보여주나요? 
> 이 스크린샷의 UI 요소를 설명해주세요 
> 이 다이어그램에 문제가 있는 요소가 있나요?
3

컨텍스트를 위해 이미지 사용하기

> 여기 오류 스크린샷이 있습니다. 무엇이 원인인가요? 
> 이것은 현재 데이터베이스 스키마입니다. 새 기능을 위해 어떻게 수정해야 할까요?
4

시각적 콘텐츠에서 코드 제안 얻기

> 이 디자인 목업과 일치하는 CSS를 생성해주세요 
> 이 컴포넌트를 재현하려면 어떤 HTML 구조가 필요할까요?
팁:
  • 텍스트 설명이 불분명하거나 번거로울 때 이미지를 사용하세요
  • 더 나은 컨텍스트를 위해 오류, UI 디자인 또는 다이어그램의 스크린샷을 포함하세요
  • 대화에서 여러 이미지로 작업할 수 있습니다
  • 이미지 분석은 다이어그램, 스크린샷, 목업 등에서 작동합니다

​
확장 사고 사용하기

​
복잡한 작업을 위해 Claude의 확장 사고 활용하기

사용 시기: 깊은 추론이 필요한 복잡한 아키텍처 결정, 까다로운 버그 또는 다단계 구현 계획에 작업할 때.
1

컨텍스트를 제공하고 Claude에게 생각해달라고 요청하기

> API에 OAuth2를 사용하는 새로운 인증 시스템을 구현해야 합니다. 코드베이스에서 이를 구현하는 가장 좋은 접근 방식에 대해 깊이 생각해주세요.
Claude는 코드베이스에서 관련 정보를 수집하고 인터페이스에 표시될 확장 사고를 사용할 것입니다.
2

후속 프롬프트로 사고 개선하기

> 이 접근 방식의 잠재적 보안 취약점에 대해 생각해주세요 
> 처리해야 할 엣지 케이스에 대해 더 깊이 생각해주세요
확장 사고에서 최대한의 가치를 얻기 위한 팁: 확장 사고는 다음과 같은 복잡한 작업에 가장 가치가 있습니다:
  • 복잡한 아키텍처 변경 계획하기
  • 복잡한 문제 디버깅하기
  • 새로운 기능에 대한 구현 계획 만들기
  • 복잡한 코드베이스 이해하기
  • 다양한 접근 방식 간의 트레이드오프 평가하기
사고를 프롬프트하는 방식에 따라 다양한 수준의 사고 깊이가 발생합니다:
  • “think”는 기본 확장 사고를 트리거합니다
  • “think more”, “think a lot”, “think harder”, “think longer”와 같은 강화 구문은 더 깊은 사고를 트리거합니다
더 많은 확장 사고 프롬프팅 팁은 확장 사고 팁을 참조하세요.
Claude는 응답 위에 이탤릭체 회색 텍스트로 사고 과정을 표시합니다.

​
프로젝트 메모리 설정하기

​
효과적인 CLAUDE.md 파일 만들기

사용 시기: 중요한 프로젝트 정보, 규칙 및 자주 사용하는 명령어를 저장하기 위해 CLAUDE.md 파일을 설정하고 싶을 때.
1

코드베이스에 대한 CLAUDE.md 부트스트랩하기

> /init
팁:
  • 자주 사용하는 명령어(빌드, 테스트, 린트)를 포함하여 반복적인 검색을 피하세요
  • 코드 스타일 선호도 및 명명 규칙을 문서화하세요
  • 프로젝트에 특화된 중요한 아키텍처 패턴을 추가하세요
  • CLAUDE.md 메모리는 팀과 공유하는 지침과 개인 선호도 모두에 사용할 수 있습니다. 자세한 내용은 Claude의 메모리 관리를 참조하세요.

​
모델 컨텍스트 프로토콜(MCP) 설정하기

모델 컨텍스트 프로토콜(MCP)은 LLM이 외부 도구 및 데이터 소스에 접근할 수 있게 해주는 오픈 프로토콜입니다. 자세한 내용은 MCP 문서를 참조하세요.
제3자 MCP 서버는 자신의 책임하에 사용하세요. MCP 서버를 신뢰하는지 확인하고, 특히 인터넷과 통신하는 MCP 서버를 사용할 때는 프롬프트 인젝션 위험에 노출될 수 있으므로 특별히 주의하세요.

​
MCP 서버 구성하기

사용 시기: 모델 컨텍스트 프로토콜을 사용하여 Claude의 기능을 전문화된 도구 및 외부 서버에 연결하여 향상시키고 싶을 때.
1

MCP Stdio 서버 추가하기

# 기본 구문
claude mcp add <name> <command> [args...]

# 예시: 로컬 서버 추가하기
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2
2

MCP SSE 서버 추가하기

# 기본 구문
claude mcp add --transport sse <name> <url>

# 예시: SSE 서버 추가하기
claude mcp add --transport sse sse-server https://example.com/sse-endpoint
3

MCP 서버 관리하기

# 구성된 모든 서버 나열하기
claude mcp list

# 특정 서버에 대한 세부 정보 가져오기
claude mcp get my-server

# 서버 제거하기
claude mcp remove my-server
팁:
  • -s 또는 --scope 플래그를 사용하여 구성이 저장되는 위치를 지정하세요:
    • local (기본값): 현재 프로젝트에서 당신에게만 사용 가능 (이전 버전에서는 project라고 불렸습니다)
    • project: .mcp.json 파일을 통해 프로젝트의 모든 사람과 공유
    • user: 모든 프로젝트에서 당신에게 사용 가능 (이전 버전에서는 global이라고 불렸습니다)
  • -e 또는 --env 플래그로 환경 변수 설정 (예: -e KEY=value)
  • MCP_TIMEOUT 환경 변수를 사용하여 MCP 서버 시작 타임아웃 구성 (예: MCP_TIMEOUT=10000 claude는 10초 타임아웃 설정)
  • Claude Code 내에서 /mcp 명령을 사용하여 언제든지 MCP 서버 상태 확인
  • MCP는 클라이언트-서버 아키텍처를 따르며, Claude Code(클라이언트)는 여러 전문화된 서버에 연결할 수 있습니다

​
MCP 서버 스코프 이해하기

사용 시기: 다양한 MCP 스코프가 어떻게 작동하는지 이해하고 팀과 서버를 공유하고 싶을 때.
1

로컬 스코프 MCP 서버

기본 스코프(local)는 MCP 서버 구성을 프로젝트별 사용자 설정에 저장합니다. 이러한 서버는 현재 프로젝트에서 작업하는 동안 당신에게만 사용 가능합니다.
# 로컬 스코프 서버 추가하기 (기본값)
claude mcp add my-private-server /path/to/server

# 명시적으로 로컬 스코프 지정하기
claude mcp add my-private-server -s local /path/to/server
2

프로젝트 스코프 MCP 서버 (.mcp.json)

프로젝트 스코프 서버는 프로젝트 루트의 .mcp.json 파일에 저장됩니다. 이 파일은 팀과 서버를 공유하기 위해 버전 관리에 체크인해야 합니다.
# 프로젝트 스코프 서버 추가하기
claude mcp add shared-server -s project /path/to/server
이렇게 하면 다음 구조의 .mcp.json 파일이 생성되거나 업데이트됩니다:
{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}
3

사용자 스코프 MCP 서버

사용자 스코프 서버는 머신의 모든 프로젝트에서 당신에게 사용 가능하며, 당신에게만 비공개입니다.
# 사용자 서버 추가하기
claude mcp add my-user-server -s user /path/to/server
팁:
  • 동일한 이름의 로컬 스코프 서버는 프로젝트 스코프 및 사용자 스코프 서버보다 우선합니다
  • 동일한 이름의 프로젝트 스코프 서버(.mcp.json에 있는)는 사용자 스코프 서버보다 우선합니다
  • Claude Code는 보안을 위해 .mcp.json의 프로젝트 스코프 서버를 사용하기 전에 승인을 요청합니다
  • .mcp.json 파일은 팀과 MCP 서버를 공유하기 위해 버전 관리에 체크인하도록 되어 있습니다
  • 프로젝트 스코프 서버를 사용하면 팀의 모든 사람이 동일한 MCP 도구에 쉽게 접근할 수 있습니다
  • 활성화 또는 비활성화된 프로젝트 스코프 서버에 대한 선택을 재설정해야 하는 경우 claude mcp reset-project-choices 명령을 사용하세요

​
Postgres MCP 서버에 연결하기

사용 시기: Claude에게 쿼리 및 스키마 검사를 위한 PostgreSQL 데이터베이스에 대한 읽기 전용 접근 권한을 부여하고 싶을 때.
1

Postgres MCP 서버 추가하기

claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"
2

Claude로 데이터베이스 쿼리하기

# Claude 세션에서 데이터베이스에 대해 질문할 수 있습니다

> 사용자 테이블의 스키마를 설명해주세요
> 시스템에서 가장 최근 주문은 무엇인가요?
> 고객과 인보이스 간의 관계를 보여주세요
팁:
  • Postgres MCP 서버는 안전을 위해 읽기 전용 접근을 제공합니다
  • Claude는 데이터베이스 구조를 탐색하고 분석 쿼리를 실행하는 데 도움을 줄 수 있습니다
  • 이를 사용하여 익숙하지 않은 프로젝트의 데이터베이스 스키마를 빠르게 이해할 수 있습니다
  • 연결 문자열이 최소한의 필요한 권한을 가진 적절한 자격 증명을 사용하는지 확인하세요

​
JSON 구성에서 MCP 서버 추가하기

사용 시기: Claude Code에 추가하려는 단일 MCP 서버에 대한 JSON 구성이 있을 때.
1

JSON에서 MCP 서버 추가하기

# 기본 구문
claude mcp add-json <name> '<json>'

# 예시: JSON 구성으로 stdio 서버 추가하기
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'
2

서버가 추가되었는지 확인하기

claude mcp get weather-api
팁:
  • JSON이 쉘에서 적절하게 이스케이프되었는지 확인하세요
  • JSON은 MCP 서버 구성 스키마를 준수해야 합니다
  • 프로젝트별 구성 대신 사용자 구성에 서버를 추가하려면 -s user를 사용할 수 있습니다

​
Claude Desktop에서 MCP 서버 가져오기

사용 시기: Claude Desktop에서 이미 MCP 서버를 구성했고 수동으로 재구성하지 않고 Claude Code에서 동일한 서버를 사용하고 싶을 때.
1

Claude Desktop에서 서버 가져오기

# 기본 구문 
claude mcp add-from-claude-desktop
2

가져올 서버 선택하기

명령을 실행한 후, 가져오려는 서버를 선택할 수 있는 대화형 대화 상자가 표시됩니다.
3

서버가 가져와졌는지 확인하기

claude mcp list
팁:
  • 이 기능은 macOS 및 Windows Subsystem for Linux(WSL)에서만 작동합니다
  • 해당 플랫폼의 표준 위치에서 Claude Desktop 구성 파일을 읽습니다
  • 사용자 구성에 서버를 추가하려면 -s user 플래그를 사용하세요
  • 가져온 서버는 Claude Desktop에서와 동일한 이름을 갖습니다
  • 동일한 이름의 서버가 이미 존재하는 경우, 숫자 접미사가 붙습니다(예: server_1)

​
Claude Code를 MCP 서버로 사용하기

사용 시기: Claude Code 자체를 다른 애플리케이션이 연결할 수 있는 MCP 서버로 사용하여 Claude의 도구와 기능을 제공하고 싶을 때.
1

Claude를 MCP 서버로 시작하기

# 기본 구문
claude mcp serve
2

다른 애플리케이션에서 연결하기

Claude Desktop과 같은 모든 MCP 클라이언트에서 Claude Code MCP 서버에 연결할 수 있습니다. Claude Desktop을 사용하는 경우, 다음 구성을 사용하여 Claude Code MCP 서버를 추가할 수 있습니다:
{
  "command": "claude",
  "args": ["mcp", "serve"],
  "env": {}
}
팁:
  • 서버는 View, Edit, LS 등과 같은 Claude의 도구에 대한 접근을 제공합니다
  • Claude Desktop에서 Claude에게 디렉토리의 파일을 읽거나 편집하는 등의 작업을 요청해보세요
  • 이 MCP 서버는 단순히 Claude Code의 도구를 MCP 클라이언트에 노출시키는 것이므로, 개별 도구 호출에 대한 사용자 확인을 구현하는 것은 클라이언트의 책임입니다

​
유닉스 스타일 유틸리티로 Claude 사용하기

​
검증 프로세스에 Claude 추가하기

사용 시기: Claude Code를 린터 또는 코드 리뷰어로 사용하고 싶을 때. 단계:
1

빌드 스크립트에 Claude 추가하기

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
    }
}

​
파이프 인, 파이프 아웃

사용 시기: Claude에 데이터를 파이프하고 구조화된 형식으로 데이터를 다시 받고 싶을 때.
1

Claude를 통해 데이터 파이프하기

cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

​
출력 형식 제어하기

사용 시기: 특히 Claude Code를 스크립트나 다른 도구에 통합할 때 특정 형식으로 Claude의 출력이 필요할 때.
1

텍스트 형식 사용하기 (기본값)

cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt
이는 Claude의 일반 텍스트 응답만 출력합니다(기본 동작).
2

JSON 형식 사용하기

cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json
이는 비용 및 기간을 포함한 메타데이터가 있는 메시지의 JSON 배열을 출력합니다.
3

스트리밍 JSON 형식 사용하기

cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json
이는 Claude가 요청을 처리할 때 실시간으로 일련의 JSON 객체를 출력합니다. 각 메시지는 유효한 JSON 객체이지만, 전체 출력은 연결된 경우 유효한 JSON이 아닙니다.
팁:
  • Claude의 응답만 필요한 간단한 통합에는 --output-format text를 사용하세요
  • 전체 대화 로그가 필요할 때는 --output-format json을 사용하세요
  • 각 대화 차례의 실시간 출력을 위해 --output-format stream-json을 사용하세요

​
커스텀 슬래시 명령어 만들기

Claude Code는 특정 프롬프트나 작업을 빠르게 실행하기 위해 만들 수 있는 커스텀 슬래시 명령어를 지원합니다.

​
프로젝트별 명령어 만들기

사용 시기: 모든 팀원이 사용할 수 있는 프로젝트용 재사용 가능한 슬래시 명령어를 만들고 싶을 때.
1

프로젝트에 명령어 디렉토리 만들기

mkdir -p .claude/commands
2

각 명령어에 대한 마크다운 파일 만들기

echo "Analyze the performance of this code and suggest three specific optimizations:" > .claude/commands/optimize.md
3

Claude Code에서 커스텀 명령어 사용하기

claude > /project:optimize
팁:
  • 명령어 이름은 파일 이름에서 파생됩니다(예: optimize.md는 /project:optimize가 됨)
  • 하위 디렉토리에 명령어를 구성할 수 있습니다(예: .claude/commands/frontend/component.md는 /project:frontend:component가 됨)
  • 프로젝트 명령어는 저장소를 복제한 모든 사람이 사용할 수 있습니다
  • 마크다운 파일 내용은 명령어가 호출될 때 Claude에게 보내지는 프롬프트가 됩니다

​
$ARGUMENTS로 명령어 인수 추가하기

사용 시기: 사용자로부터 추가 입력을 받을 수 있는 유연한 슬래시 명령어를 만들고 싶을 때.
1

$ARGUMENTS 자리 표시자가 있는 명령어 파일 만들기

echo "Find and fix issue #$ARGUMENTS. Follow these steps: 1.
Understand the issue described in the ticket 2. Locate the relevant code in
our codebase 3. Implement a solution that addresses the root cause 4. Add
appropriate tests 5. Prepare a concise PR description" >
.claude/commands/fix-issue.md
2

이슈 번호로 명령어 사용하기

 
claude > /project:fix-issue 123
이렇게 하면 프롬프트에서 $ARGUMENTS가 “123”으로 대체됩니다.
팁:
  • $ARGUMENTS 자리 표시자는 명령어 다음에 오는 모든 텍스트로 대체됩니다
  • 명령어 템플릿의 어디에나 $ARGUMENTS를 배치할 수 있습니다
  • 다른 유용한 응용: 특정 함수에 대한 테스트 케이스 생성, 컴포넌트에 대한 문서 작성, 특정 파일의 코드 검토 또는 지정된 언어로 콘텐츠 번역

​
개인 슬래시 명령어 만들기

사용 시기: 모든 프로젝트에서 작동하는 개인 슬래시 명령어를 만들고 싶을 때.
1

홈 폴더에 명령어 디렉토리 만들기

mkdir -p ~/.claude/commands
2

각 명령어에 대한 마크다운 파일 만들기

echo "Review this code for security vulnerabilities, focusing on:" >
~/.claude/commands/security-review.md
3

개인 커스텀 명령어 사용하기

claude > /user:security-review
팁:
  • 개인 명령어는 /project: 대신 /user:로 접두사가 붙습니다
  • 개인 명령어는 당신에게만 사용 가능하며 팀과 공유되지 않습니다
  • 개인 명령어는 모든 프로젝트에서 작동합니다
  • 다양한 코드베이스에서 일관된 워크플로우를 위해 이를 사용할 수 있습니다

​
Git 워크트리로 병렬 Claude Code 세션 실행하기

​
격리된 코딩 환경을 위한 워크트리 사용하기

사용 시기: Claude Code 인스턴스 간에 완전한 코드 격리로 여러 작업을 동시에 수행해야 할 때.
1

Git 워크트리 이해하기

Git 워크트리를 사용하면 동일한 저장소에서 여러 브랜치를 별도의 디렉토리로 체크아웃할 수 있습니다. 각 워크트리는 격리된 파일이 있는 자체 작업 디렉토리를 가지면서 동일한 Git 기록을 공유합니다. 공식 Git 워크트리 문서에서 자세히 알아보세요.
2

새 워크트리 만들기

# 새 브랜치로 새 워크트리 만들기 
git worktree add ../project-feature-a -b feature-a

# 또는 기존 브랜치로 워크트리 만들기
git worktree add ../project-bugfix bugfix-123
이렇게 하면 저장소의 별도 작업 사본이 있는 새 디렉토리가 생성됩니다.
3

각 워크트리에서 Claude Code 실행하기

# 워크트리로 이동하기 
cd ../project-feature-a

# 이 격리된 환경에서 Claude Code 실행하기
claude
4

다른 터미널에서:
cd ../project-bugfix
claude
5

워크트리 관리하기

# 모든 워크트리 나열하기
git worktree list

# 완료 후 워크트리 제거하기
git worktree remove ../project-feature-a
팁:
  • 각 워크트리는 자체 독립적인 파일 상태를 가지므로 병렬 Claude Code 세션에 완벽합니다
  • 한 워크트리에서 변경한 내용은 다른 워크트리에 영향을 미치지 않으므로 Claude 인스턴스가 서로 간섭하는 것을 방지합니다
  • 모든 워크트리는 동일한 Git 기록 및 원격 연결을 공유합니다
  • 장기 실행 작업의 경우, 한 워크트리에서 Claude가 작업하는 동안 다른 워크트리에서 개발을 계속할 수 있습니다
  • 각 워크트리가 어떤 작업을 위한 것인지 쉽게 식별할 수 있도록 설명적인 디렉토리 이름을 사용하세요
  • 프로젝트 설정에 따라 각 새 워크트리에서 개발 환경을 초기화하는 것을 잊지 마세요. 스택에 따라 다음이 포함될 수 있습니다:
    • JavaScript 프로젝트: 의존성 설치 실행(npm install, yarn)
    • Python 프로젝트: 가상 환경 설정 또는 패키지 관리자로 설치
    • 기타 언어: 프로젝트의 표준 설정 프로세스 따르기

​
다음 단계

Claude Code 참조 구현

개발 컨테이너 참조 구현을 복제하세요.