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

목차

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

코드베이스 빠른 개요 얻기

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

1

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

$ cd /path/to/project
2

Claude Code 시작

$ claude
3

상위 수준 개요 요청

> give me an overview of this codebase
4

특정 컴포넌트 자세히 살펴보기

> explain the main architecture patterns used here
> what are the key data models?
> how is authentication handled?

팁:

  • 광범위한 질문으로 시작한 다음 특정 영역으로 좁혀가기
  • 프로젝트에서 사용된 코딩 규칙과 패턴에 대해 문의하기
  • 프로젝트 특정 용어 용어집 요청하기

관련 코드 찾기

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

1

Claude에게 관련 파일 찾기 요청

> find the files that handle user authentication
2

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

> how do these authentication files work together?
3

실행 흐름 이해하기

> trace the login process from front-end to database

팁:

  • 찾고자 하는 것에 대해 구체적으로 명시하기
  • 프로젝트의 도메인 언어 사용하기

효율적으로 버그 수정하기

오류 메시지 진단

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

1

Claude와 오류 공유

> I'm seeing an error when I run npm test
2

수정 권장사항 요청

> suggest a few ways to fix the @ts-ignore in user.ts
3

수정사항 적용

> update user.ts to add the null check you suggested

팁:

  • Claude에게 문제를 재현하고 스택 트레이스를 얻는 명령어 알려주기
  • 오류를 재현하는 단계 언급하기
  • 오류가 간헐적인지 일관적인지 Claude에게 알려주기

코드 리팩토링

레거시 코드 현대화

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

1

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

> find deprecated API usage in our codebase
2

리팩토링 권장사항 얻기

> suggest how to refactor utils.js to use modern JavaScript features
3

안전하게 변경사항 적용

> refactor utils.js to use ES2024 features while maintaining the same behavior
4

리팩토링 검증

> run tests for the refactored code

팁:

  • Claude에게 현대적 접근 방식의 이점 설명 요청
  • 필요한 경우 하위 호환성 유지 요청
  • 작고 테스트 가능한 단위로 리팩토링 수행

테스트 작업하기

테스트 커버리지 추가

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

1

테스트되지 않은 코드 식별

> find functions in NotificationsService.swift that are not covered by tests
2

테스트 스캐폴딩 생성

> add tests for the notification service
3

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

> add test cases for edge conditions in the notification service
4

테스트 실행 및 검증

> run the new tests and fix any failures

팁:

  • 엣지 케이스와 오류 조건을 다루는 테스트 요청
  • 적절한 경우 단위 테스트와 통합 테스트 모두 요청
  • Claude에게 테스트 전략 설명 요청

풀 리퀘스트 생성하기

포괄적인 PR 생성

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

1

변경사항 요약

> summarize the changes I've made to the authentication module
2

Claude로 PR 생성

> create a pr
3

검토 및 개선

> enhance the PR description with more context about the security improvements
4

테스트 세부정보 추가

> add information about how these changes were tested

팁:

  • Claude에게 직접 PR 생성 요청
  • 제출하기 전에 Claude가 생성한 PR 검토
  • Claude에게 잠재적 위험이나 고려사항 강조 요청

문서 처리하기

코드 문서 생성

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

1

문서화되지 않은 코드 식별

> find functions without proper JSDoc comments in the auth module
2

문서 생성

> add JSDoc comments to the undocumented functions in auth.js
3

검토 및 개선

> improve the generated documentation with more context and examples
4

문서 검증

> check if the documentation follows our project standards

팁:

  • 원하는 문서 스타일 지정 (JSDoc, docstrings 등)
  • 문서에 예제 요청
  • 공개 API, 인터페이스 및 복잡한 로직에 대한 문서화 요청

이미지 작업하기

이미지와 스크린샷 분석

사용 시기: 코드베이스에서 이미지 작업을 하거나 Claude의 도움을 받아 이미지 내용을 분석해야 할 때.

1

대화에 이미지 추가

다음 방법 중 하나를 사용할 수 있습니다:

# 1. Claude Code 창에 이미지를 드래그 앤 드롭

# 2. 이미지를 복사하여 ctrl+v로 CLI에 붙여넣기

# 3. 이미지 경로 제공
$ claude
> Analyze this image: /path/to/your/image.png
2

Claude에게 이미지 분석 요청

> What does this image show?
> Describe the UI elements in this screenshot
> Are there any problematic elements in this diagram?
3

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

> Here's a screenshot of the error. What's causing it?
> This is our current database schema. How should we modify it for the new feature?
4

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

> Generate CSS to match this design mockup
> What HTML structure would recreate this component?

팁:

  • 텍스트 설명이 불명확하거나 번거로울 때 이미지 사용
  • 더 나은 컨텍스트를 위해 오류, UI 디자인 또는 다이어그램의 스크린샷 포함
  • 대화에서 여러 이미지로 작업 가능
  • 이미지 분석은 다이어그램, 스크린샷, 목업 등에서 작동

프로젝트 메모리 설정하기

효과적인 CLAUDE.md 파일 생성

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

1

코드베이스용 CLAUDE.md 부트스트랩

> /init

팁:

  • 반복적인 검색을 피하기 위해 자주 사용하는 명령어(빌드, 테스트, 린트) 포함
  • 코드 스타일 선호도와 명명 규칙 문서화
  • 프로젝트에 특화된 중요한 아키텍처 패턴 추가
  • Claude를 실행하는 폴더, 상위 디렉토리(Claude가 자동으로 읽음) 또는 하위 디렉토리(Claude가 필요에 따라 가져옴)에 CLAUDE.md 파일을 추가할 수 있음

유닉스 스타일 유틸리티로 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

Model Context Protocol (MCP) 설정하기

Model Context Protocol (MCP)은 LLM이 외부 도구와 데이터 소스에 접근할 수 있게 해주는 오픈 프로토콜입니다. 자세한 내용은 MCP 문서를 참조하세요.

제3자 MCP 서버는 자신의 책임 하에 사용하세요. MCP 서버를 신뢰할 수 있는지 확인하고, 특히 인터넷과 통신하는 MCP 서버를 사용할 때는 프롬프트 인젝션 위험에 노출될 수 있으므로 각별히 주의하세요.

MCP 서버 구성

사용 시기: Model Context Protocol을 사용하여 특수 도구와 외부 서버에 연결함으로써 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 서버 관리

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

# 특정 서버의 세부정보 가져오기
$ claude mcp get my-server

# 서버 제거
$ claude mcp remove my-server

팁:

  • -s 또는 --scope 플래그를 project(기본값) 또는 global과 함께 사용하여 구성이 저장되는 위치 지정
  • -e 또는 --env 플래그로 환경 변수 설정 (예: -e KEY=value)
  • MCP는 Claude Code(클라이언트)가 여러 특수 서버에 연결할 수 있는 클라이언트-서버 아키텍처를 따름

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 세션에서 데이터베이스에 대해 질문할 수 있습니다
$ claude
> describe the schema of our users table
> what are the most recent orders in the system?
> show me the relationship between customers and invoices

팁:

  • Postgres MCP 서버는 안전을 위해 읽기 전용 액세스를 제공
  • Claude는 데이터베이스 구조를 탐색하고 분석 쿼리를 실행하는 데 도움을 줄 수 있음
  • 이를 사용하여 익숙하지 않은 프로젝트의 데이터베이스 스키마를 빠르게 이해할 수 있음
  • 연결 문자열이 최소한의 필요한 권한을 가진 적절한 자격 증명을 사용하는지 확인

다음 단계

Claude Code 참조 구현

개발 컨테이너 참조 구현을 클론하세요.

Was this page helpful?