eyaltoledano/claude-task-master

@eyaltoledano & @RalphEcom 제작

Claude를 사용한 AI 기반 개발을 위한 작업 관리 시스템으로, Cursor AI와 완벽하게 호환됩니다.

문서

📚 전체 문서 보기

빠른 링크

• 빠른 시작 가이드
• 설치
• API 키 및 제공자
• 지원되는 편집기
• MCP 도구 참조
• CLI 명령어 참조
• 작업 구조
• 작업 종속성
• 태그 및 워크스트림
• 연구 명령어
• 루프 명령어
• AI 제공자 개요
• 팀 협업
• 모범 사례
• FAQ
• 변경 로그

Hamster의 다른 제품

• Hamster Studio
• 제품 및 엔지니어링 방법
• 제품 및 엔지니어링 기술
• Hamster 가격

Cursor 1.0+ 빠른 설치 (원클릭)

!Add task-master-ai MCP server to Cursor

참고: 링크를 클릭한 후에도 구성에 API 키를 추가해야 합니다. 링크는 MCP 서버를 설치하지만 키는 플레이스홀더로 설정되므로 실제 API 키로 교체해야 합니다.

Claude Code 빠른 설치

Claude Code 사용자의 경우:

claude mcp add taskmaster-ai -- npx -y task-master-ai

• 프로젝트 루트의.env 파일
• taskmaster-ai의 mcp 구성 "env" 섹션

API 키를 구성에 추가하는 것을 잊지 마세요:

요구 사항

Taskmaster는 여러 명령어에서 AI를 활용하며, 이를 위해 별도의 API 키가 필요합니다. API 키를 추가하면 다양한 AI 제공자의 여러 모델을 사용할 수 있습니다. 예를 들어 Claude 3.7을 사용하려면 Anthropic API 키가 필요합니다.

사용할 모델은 세 가지 유형으로 정의할 수 있습니다: 주 모델, 연구 모델, 폴백 모델(주 모델 또는 연구 모델이 실패할 경우). 사용하는 모델에 관계없이 해당 제공자의 API 키가 mcp.json 또는.env에 있어야 합니다.

다음 중 하나 이상이 필요합니다:

• Anthropic API 키 (Claude API)
• OpenAI API 키
• Google Gemini API 키
• Perplexity API 키 (연구 모델용)
• xAI API 키 (연구 또는 주 모델용)
• OpenRouter API 키 (연구 또는 주 모델용)
• Claude Code (API 키 불필요 - Claude Code CLI 필요)
• Codex CLI (ChatGPT 구독을 통한 OAuth - Codex CLI 필요)

연구 모델 사용은 선택 사항이지만 강력히 권장됩니다. Claude Code 또는 Codex CLI(OAuth 사용)를 사용하지 않는 경우 최소 하나의 API 키가 필요합니다. 모든 API 키를 추가하면 모델 제공자를 자유롭게 전환할 수 있습니다.

빠른 시작

옵션 1: MCP (권장)

MCP(Model Control Protocol)를 사용하면 편집기에서 직접 Task Master를 실행할 수 있습니다.

1. 편집기에 따라 다음 경로에 MCP 구성 추가

수동 구성

Cursor & Windsurf & Q Developer CLI (mcpServers)

{
  "mcpServers": {
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        // "TASK_MASTER_TOOLS": "all", // 옵션: "all", "standard", "core", 또는 쉼표로 구분된 도구 목록
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
        "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE",
        "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE",
        "MISTRAL_API_KEY": "YOUR_MISTRAL_KEY_HERE",
        "GROQ_API_KEY": "YOUR_GROQ_KEY_HERE",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE",
        "XAI_API_KEY": "YOUR_XAI_KEY_HERE",
        "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE",
        "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY_HERE"
      }
    }
  }
}

🔑 YOUR…KEY_HERE를 실제 API 키로 교체하세요. 사용하지 않는 키는 제거할 수 있습니다.

참고: MCP 설정에서 0 tools enabled가 표시되면 편집기를 다시 시작하고 API 키가 올바르게 구성되었는지 확인하세요.

VS Code (servers + type)

{
  "servers": {
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        // "TASK_MASTER_TOOLS": "all", // 옵션: "all", "standard", "core", 또는 쉼표로 구분된 도구 목록
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
        "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE",
        "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE",
        "MISTRAL_API_KEY": "YOUR_MISTRAL_KEY_HERE",
        "GROQ_API_KEY": "YOUR_GROQ_KEY_HERE",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE",
        "XAI_API_KEY": "YOUR_XAI_KEY_HERE",
        "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE",
        "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY_HERE"
      },
      "type": "stdio"
    }
  }
}

🔑 YOUR…KEY_HERE를 실제 API 키로 교체하세요. 사용하지 않는 키는 제거할 수 있습니다.

2. (Cursor 전용) Taskmaster MCP 활성화

Cursor 설정(Ctrl+Shift+J) 열기 ➡ 왼쪽 MCP 탭 클릭 ➡ task-master-ai 토글 활성화

3. (선택 사항) 사용할 모델 구성

편집기의 AI 채팅 창에서 다음을 입력하세요:

Change the main, research and fallback models to <model_name>, <model_name> and <model_name> respectively.

예를 들어, Claude Code(API 키 불필요)를 사용하려면:

Change the main model to claude-code/sonnet

사용 가능한 모델 표 | Claude Code 설정

4. Task Master 초기화

편집기의 AI 채팅 창에서 다음을 입력하세요:

Initialize taskmaster-ai in my project

5. PRD 준비 (권장)

새 프로젝트: .taskmaster/docs/prd.txt에 PRD를 생성하세요. 기존 프로젝트: scripts/prd.txt를 사용하거나 task-master migrate로 마이그레이션할 수 있습니다.

초기화 후 .taskmaster/templates/example_prd.txt에서 예제 PRD 템플릿을 확인할 수 있습니다.

[!NOTE]

복잡한 프로젝트에는 PRD가 권장되지만, 채팅에서 "Can you help me implement [description of what you want to do]?"라고 물어 개별 작업을 항상 생성할 수 있습니다.

항상 상세한 PRD로 시작하세요.

PRD가 상세할수록 생성되는 작업이 더 좋아집니다.

6. 일반 명령어

AI 어시스턴트를 사용하여:

• 요구 사항 파싱: Can you parse my PRD at scripts/prd.txt?
• 다음 단계 계획: What's the next task I should work on?
• 작업 구현: Can you help me implement task 3?
• 여러 작업 보기: Can you show me tasks 1, 3, and 5?
• 작업 확장: Can you help me expand task 4?
• 최신 정보 연구: Research the latest best practices for implementing JWT authentication with Node.js
• 컨텍스트를 포함한 연구: Research React Query v5 migration strategies for our current API implementation in src/api.js

채팅에서 Task Master 사용에 대한 더 많은 예제

옵션 2: 명령줄 사용

설치

# 전역 설치
npm install -g task-master-ai

# 또는 프로젝트 내에 로컬 설치
npm install task-master-ai

새 프로젝트 초기화

# 전역 설치 시
task-master init

# 로컬 설치 시
npx task-master init

# 특정 규칙으로 프로젝트 초기화
task-master init --rules cursor,windsurf,vscode

프로젝트에 대한 입력을 요청합니다.