Claude Code와 함께하는 워크플로 자동화

Claude 스크립트 디렉토리

사용자 지정 스크립트와 구성을 저장하기 위해 프로젝트 루트에 .claude 디렉토리를 만드세요:

Claude Code는 사용자 지정 자동화를 위해 이 디렉토리를 자동으로 감지하고 사용합니다.

기본 워크플로 구성

.claude 디렉토리에 config.json 파일을 만드세요:

{
  "projectName": "MyAwesomeProject",
  "description": "A React application for financial management",
  "workflows": {
    "component": {
      "templatePath": "./templates/component.tsx",
      "outputPath": "src/components/{name}/{name}.tsx"
    },
    "test": {
      "templatePath": "./templates/test.tsx",
      "outputPath": "src/components/{name}/__tests__/{name}.test.tsx"
    }
  }
}

이 구성은 컴포넌트 및 테스트 생성을 위한 템플릿 기반 워크플로를 정의합니다.

스크립트 구조

.claude/scripts 디렉토리에 JavaScript 파일을 만드세요:

// .claude/scripts/create-feature.js

module.exports = async (claude, args) => {
  const { featureName } = args;

  // Create feature directory
  await claude.exec(`mkdir -p src/features/${featureName}`);

  // Create component files
  await claude.generateFile(
    `src/features/${featureName}/${featureName}Page.tsx`,
    `Create a React component for the ${featureName} feature page`
  );

  // Create service files
  await claude.generateFile(
    `src/features/${featureName}/${featureName}Service.ts`,
    `Create a service for the ${featureName} feature that handles data fetching and processing`
  );

  // Update route configuration
  await claude.modifyFile(
    'src/routes.tsx',
    `Add a route for the ${featureName} feature page`
  );

  return `${featureName} feature created successfully!`;
};

사용자 지정 스크립트 실행

claude run 명령을 사용하여 사용자 지정 스크립트를 실행하세요:

이렇게 하면 제공된 인수로 스크립트가 실행되어 사용자 프로필 기능에 필요한 모든 파일이 생성됩니다.

템플릿 만들기

.claude/templates 디렉토리에 템플릿 파일을 만드세요:

// .claude/templates/component.tsx

import React from 'react';

interface {{name}}Props {
  // Add props here
}

export const {{name}} = ({ ...props }: {{name}}Props) => {
  return (
    <div className="{{kebabCase name}}-component">
      {/* Component content */}
    </div>
  );
};

export default {{name}};

템플릿은 생성 중에 대체되는 $name과 같은 변수와 함께 handlebars 스타일 구문을 사용합니다.

템플릿 사용하기

claude generate 명령을 사용하여 템플릿에서 파일을 생성하세요:

이렇게 하면 템플릿을 기반으로 src/components/UserProfile/UserProfile.tsx에 새 컴포넌트가 생성됩니다.

CI/CD 통합

Claude Code 자동화를 CI/CD 파이프라인에 통합하세요:

# .github/workflows/claude-checks.yml

name: Claude Code Checks

on:
  pull_request:
    branches: [ main ]

jobs:
  code-quality:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Install Claude CLI
        run: npm install -g @anthropic/claude-cli
      - name: Run Claude Code Review
        run: claude run code-review --reporter=github

이벤트 기반 자동화

프로젝트 이벤트를 기반으로 트리거되는 자동화를 설정하세요:

// .claude/config.json

{
  // ... other config
  "events": {
    "onComponentCreate": "generate-tests",
    "onModelChange": "update-migrations",
    "onApiChange": "update-documentation"
  }
}

이 구성은 특정 이벤트가 발생할 때 특정 스크립트를 자동으로 실행하도록 Claude Code에 지시합니다.