Claude Code 사용 팁 34가지

# Claude Code는 모든 표준 CLI 작업을 수행할 수 있습니다
claude --help
claude --version
claude --list-sessions

# 프롬프트를 직접 전달하여 작업 실행
claude -P "package.json을 분석하고 모든 종속성을 나열하세요"

# 비대화형 모드, 결과 직접 출력
claude -P "React 컴포넌트 생성" --no-interactive

# 다른 도구와 결합하여 사용
git diff | claude -P "이러한 코드 변경 사항을 설명하세요"
npm test 2>&1 | claude -P "테스트 실패 원인을 분석하세요"

# 파이프라인을 통한 데이터 전달
cat error.log | claude -P "오류 로그를 분석하고 해결책을 제공하세요"
curl https://api.example.com | claude -P "이 API 응답을 분석하세요"

# 터미널 1
claude --session frontend-work

# 터미널 2
claude --session backend-api

# 터미널 3
claude --session testing

새로운 Claude 인스턴스에서 테스트를 실행하고 결과를 보고해 주세요.

[디자인 이미지 붙여넣기]
이 디자인 목업을 기반으로 다음을 포함하는 해당 React 컴포넌트를 생성하세요:
- 반응형 레이아웃
- 모바일 적응
- Tailwind CSS 사용

// 자동화된 스크린샷 스크립트 예제
const puppeteer = require('puppeteer')

async function captureScreenshots() {
  const browser = await puppeteer.launch()
  const page = await browser.newPage()

  // 다양한 상태의 스크린샷 캡처
  await page.goto('https://localhost:3000')
  await page.screenshot({ path: 'homepage.png' })

  await page.click('.login-button')
  await page.screenshot({ path: 'login-page.png' })

  await browser.close()
}

screenshots/ 디렉토리의 모든 스크린샷을 분석하고 UI 불일치를 식별하세요.

// MCP 구성 예제
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-postgres"]
    }
  }
}

데이터베이스 연결 후 다음을 수행하세요:
1. 기존 테이블 구조 분석
2. TypeScript 타입 정의 생성
3. CRUD API 인터페이스 생성

Cloudflare MCP에서 최신 Workers API 문서를 가져와 예제 프로젝트를 만드세요.

https://docs.example.com/api/v2

위 문서를 기반으로 해당 TypeScript SDK를 만드세요.

https://en.wikipedia.org/wiki/Chess_rules

위 규칙을 기반으로 체스 게임의 핵심 로직을 구현하세요.

# CLAUDE.md 예제 구조

## 프로젝트 개요

프로젝트 목적 및 기술 스택에 대한 간략한 설명

## 개발 표준

- 코드 스타일 가이드라인
- 명명 규칙
- 파일 구성 구조

## 자주 사용하는 명령

프로젝트의 자주 사용하는 명령 나열

## 참고 사항

프로젝트별 참고 사항 및 제한 사항

# 프로젝트 루트 디렉토리에서 실행
> /init

# Claude Code가 프로젝트를 분석하고 구성 파일을 생성합니다

## 프로젝트 규칙

- 모든 API 응답에는 status 및 data 필드가 포함되어야 합니다
- 변수에는 camelCase, 컴포넌트에는 PascalCase 사용
- any 타입 사용 금지, 명확한 TypeScript 타입 정의 필수

## 코드 템플릿

### React 컴포넌트 템플릿

\```tsx
import React from 'react';

interface Props {
// props 정의
}

export const ComponentName: React.FC<Props> = ({ }) => {
return <div></div>;
};
\```

## 아키텍처 결정 기록

### ADR-001: Redux Toolkit 사용

- **날짜**: 2024-01-15
- **결정**: Redux Toolkit을 상태 관리 솔루션으로 채택
- **이유**: Redux 사용 단순화, 보일러플레이트 코드 감소

## 주요 종속성

| 패키지 | 버전     | 목적             | 참고 사항                  |
| ------ | -------- | ---------------- | -------------------------- |
| react  | ^18.0.0  | UI 프레임워크    | 동시성 기능 사용           |
| next   | ^14.0.0  | 풀스택 프레임워크 | App Router                |

## 테스트 전략

- 단위 테스트 커버리지 > 80%
- 모든 API 엔드포인트에는 통합 테스트가 있어야 합니다
- Jest + React Testing Library 사용
- E2E 테스트는 Playwright 사용

// .claude/commands/test-all.js
module.exports = {
  name: 'test-all',
  description: '모든 테스트 실행 및 커버리지 보고서 생성',
  execute: async () => {
    await runCommand('npm test -- --coverage')
    await runCommand('npm run e2e')
  }
}

// .claude/commands/aliases.js
module.exports = {
  c: 'commit',
  p: 'push',
  ta: 'test-all',
  dev: 'npm run dev'
}

// .claude/commands/deploy.js
module.exports = {
  name: 'deploy',
  description: '완전한 배포 프로세스',
  execute: async () => {
    await runCommand('npm test')
    await runCommand('npm run build')
    await runCommand('npm run deploy:prod')
  }
}

// .claude/commands/create-component.js
module.exports = {
  name: 'create-component',
  description: '새 컴포넌트 생성',
  parameters: ['name', 'type'],
  execute: async (name, type = 'functional') => {
    // 매개변수를 기반으로 컴포넌트 생성
  }
}

// .claude/commands/smart-test.js
module.exports = {
  name: 'smart-test',
  execute: async () => {
    const files = await getChangedFiles()
    if (files.some((f) => f.endsWith('.tsx'))) {
      await runCommand('npm run test:components')
    }
    if (files.some((f) => f.includes('api/'))) {
      await runCommand('npm run test:api')
    }
  }
}

// .claude/commands/scaffold.js
module.exports = {
  name: 'scaffold',
  interactive: true,
  execute: async () => {
    const type = await prompt('타입 선택: component/page/api')
    const name = await prompt('이름 입력:')
    // 입력을 기반으로 코드 생성
  }
}

# 프론트엔드 개발 작업 공간 생성
claude --workspace frontend --dir ./src/components

# 백엔드 개발 작업 공간 생성
claude --workspace backend --dir ./src/api

# 테스트 작업 공간 생성
claude --workspace testing --dir ./tests

# 세션 기록 보기
claude --history

# 특정 세션 복원
claude --resume <session-id>

# 세션 기록 내보내기
claude --export-session > session-backup.json