172만명의 커뮤니티!! 함께 토론해봐요.
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
안녕하세요. MCP가 토큰 46.9% 절감해주고, 컨텍스트엔지니어링의 핵심 도구로 설명해주셨는데요. 뒷쪽에서는 MCP가 불필요한 토큰을 소비한다고 설명해주시는 부분도 있어서 헷갈립니다. 보충 설명 가능할까요? AI 모델 vs AI 코딩 도구: 무엇이 다를까? [UP_260206]
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
안녕하세요. Cursor에서 왼쪽 사이드바에서 레포지토리 초기화를 하였고, 선생님의 영상에서 처럼 커밋을 하려는데, "스테이징에 변경된 사항"에 무려 1000개가 나옵니다. 그간 연습하면서 했던 모든 것들이 나오나? 싶기도 하고요. (선생님 영상에는 6개) 이렇게 많으니깐 무엇을 커밋해야 되고 무엇을 하면 안되는지 감이 오지 않습니다. 어떤것이 문제로 작용했을까요? 어떻게 해결 하면 좋을까요? 감사합니다!
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
커서 AI 클로드 코드 사용하기 (Windows) 따라가는 중 커서 툴 설치 후에 터미널에서 claude 를 실행하면 제목과 같이 오류가 나는데요. 어떻게 조치해야 할까요?
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
Git 사용자 정보 설정 확인 시, 아래와 같이 global user.email 명령어 실행시에는 이메일이 출력되지 않으며, global user.name 실행시에는 이름이 아닌 이메일이 출력됩니다. 사용하는데 문제 없는 걸까요?
해결됨
나만의 Claude Code 하네스 (SPEC·TDD·CI로 짓는 AI 개발 워크플로우)
수업노트로 요청한 tdd-red 스킬의 초안은 다음과 같습니다. 아래 내용으로 진행하면 import error, 파일 없음 에러도 정상적인 red 로 인식하고 다음 단계로 진행됩니다. --- name: tdd-red description: 승인된 테스트 시나리오를 실패하는 테스트 코드로 작성한다. TDD Red 단계 시작 시 사용한다. argument-hint: <feature> <이슈 번호> allowed-tools: Read Write Bash --- `$ARGUMENTS`에서 feature 이름과 이슈 번호를 파싱해 해당 이슈의 승인된 시나리오를 실패하는 테스트 코드로 작성한다. ## 시작 전 ### 인자 파싱 `$ARGUMENTS`를 공백으로 분리해 첫 번째 토큰을 `{feature}`, 두 번째 토큰을 `{issue}` 로 사용한다. | 입력 예시 | feature | issue | | ------------------ | -------- | ----- | | `/tdd-red tag 2` | `tag` | `2` | | `/tdd-red search 1`| `search` | `1` | 누락된 값이 있으면 실행 전에 사용자에게 질문한다. - `{feature}`가 없으면: "어떤 기능의 이슈인가요? (예: tag, search, ...)" - `{issue}`가 없으면: "이슈 번호를 알려주세요." 두 값이 확정된 뒤 `docs/features/{feature}/issue-{issue}.md` 를 읽어 시그니처와 테스트 시나리오 목록을 파악한다. - 시그니처 섹션: 테스트 대상 파일 경로 및 함수·컴포넌트명 확인 - 테스트 시나리오 섹션: 작성할 시나리오 목록 전체 수집 파일이 없으면 즉시 멈추고 사용자에게 알린다 (`/test-scenarios {feature} {issue}` 를 먼저 실행해야 한다는 안내 포함). --- ## 단계 1: 테스트 파일 준비 시그니처에서 테스트 대상 파일 경로를 추출하고 테스트 파일 경로를 결정한다. ### 파일 위치 규칙 | 구현 파일 | 테스트 파일 | | ---------------------------------- | ---------------------------------------- | | `src/api/tags.ts` | `src/api/tags.test.ts` | | `src/components/TagInput.tsx` | `src/components/TagInput.test.tsx` | | `src/context/NotesContext.tsx` | `src/context/NotesContext.test.tsx` | - 테스트 파일이 이미 존재하면 기존 내용을 읽어 중복 `describe` 블록을 피한다. - 테스트 파일이 없으면 새로 생성한다. ### 파일 헤더 (신규 생성 시) ```ts import { describe, it, expect, vi, beforeEach } from 'vitest'; // 컴포넌트 파일인 경우에만 추가: // import { render, screen } from '@testing-library/react'; // import userEvent from '@testing-library/user-event'; ``` --- ## 단계 2: 시나리오를 테스트 코드로 작성 시나리오를 하나씩 `it()` 블록으로 변환한다. 한 번에 모두 작성하지 않고 **시나리오 하나 작성 → 실행 → 실패 확인 → 다음 시나리오** 순서를 반복한다. ### 테스트 이름 형식 ``` should [기대 동작] when [조건] ``` ### describe 블록 구조 함수·컴포넌트 단위로 묶는다. ```ts describe('함수명 또는 컴포넌트명', () => { it('should [기대 동작] when [조건]', () => { // Red 단계: 구현이 없으므로 실패하는 코드만 작성 }); }); ``` ### Red 테스트 작성 원칙 - 구현이 존재하지 않으므로 import가 실패하거나 호출이 오류를 던져야 한다. - 억지로 통과시키려 하지 않는다. 실패 자체가 목표다. - `expect`는 실제 기대 동작을 명확하게 표현한다. `expect(true).toBe(false)` 같은 더미 assertion은 사용하지 않는다. **API 함수 예시** ```ts import { addTag } from './tags'; describe('addTag', () => { it('should return updated note when valid tag is added', async () => { const result = await addTag('note-1', 'work'); expect(result.tags).toContain('work'); }); it('should throw when tag is empty string', async () => { await expect(addTag('note-1', '')).rejects.toThrow(); }); }); ``` **컴포넌트 예시** ```ts import { render, screen } from '@testing-library/react'; import { TagInput } from './TagInput'; describe('TagInput', () => { it('should render input when component is mounted', () => { render(<TagInput tags={[]} onAdd={vi.fn()} onRemove={vi.fn()} />); expect(screen.getByRole('textbox')).toBeInTheDocument(); }); }); ``` --- ## 단계 3: 시나리오별 실행 루프 각 시나리오를 작성한 직후 아래 명령으로 해당 테스트 파일만 실행한다. ```bash npx vitest run <테스트-파일-경로> --reporter=verbose ``` - **실패 확인**: `FAIL` 또는 import 오류가 나오면 정상. 다음 시나리오로 이동한다. - **통과**: 테스트가 의도치 않게 통과하면 즉시 멈추고 사용자에게 알린다. 구현 파일이 이미 존재하는지 확인한다. --- ## 단계 4: 전체 확인 모든 시나리오 작성이 끝나면 전체 테스트를 실행한다. ```bash npm test ``` - 작성한 테스트 파일의 모든 케이스가 실패하는지 확인한다. - 기존에 통과하던 테스트가 새로 실패하면 즉시 사용자에게 보고한다. --- ## 제약 - 테스트 파일(`*.test.ts`, `*.test.tsx`)만 생성하거나 수정한다. - `src/` 안의 구현 코드(`*.ts`, `*.tsx`, `*.css` 등 테스트 파일 제외)는 절대 수정하지 않는다. - 테스트가 통과하도록 mock이나 stub으로 우회하지 않는다. --- ## 산출물 - 작성된 테스트 파일 목록 및 경로 - 시나리오별 실패 메시지 요약 - `npm test` 결과: 실패한 테스트 수 / 전체 테스트 수 관련해서, import 에러 및 파일 에러는 없어야한다.(stub 이 있어야 함. Collect 는 모두 성공하고 Test 단계에서 실패해야한다.) 는 점을 고려해서 아래와 같이 스킬을 수정했는데, 피드백 부탁드립니다. --- name: tdd-red description: 승인된 테스트 시나리오를 실패하는 테스트 코드로 작성한다. TDD Red 단계 시작 시 사용한다. argument-hint: <feature> <이슈 번호> allowed-tools: Read Write Bash --- `$ARGUMENTS`에서 feature 이름과 이슈 번호를 파싱해 해당 이슈의 승인된 시나리오를 실패하는 테스트 코드로 작성한다. ## 시작 전 ### 인자 파싱 `$ARGUMENTS`를 공백으로 분리해 첫 번째 토큰을 `{feature}`, 두 번째 토큰을 `{issue}` 로 사용한다. | 입력 예시 | feature | issue | | ------------------- | -------- | ----- | | `/tdd-red tag 2` | `tag` | `2` | | `/tdd-red search 1` | `search` | `1` | 누락된 값이 있으면 실행 전에 사용자에게 질문한다. - `{feature}`가 없으면: "어떤 기능의 이슈인가요? (예: tag, search, ...)" - `{issue}`가 없으면: "이슈 번호를 알려주세요." 두 값이 확정된 뒤 `docs/features/{feature}/issue-{issue}.md` 를 읽어 시그니처와 테스트 시나리오 목록을 파악한다. - 시그니처 섹션: 테스트 대상 파일 경로 및 함수·컴포넌트명 확인 - 테스트 시나리오 섹션: 작성할 시나리오 목록 전체 수집 파일이 없으면 즉시 멈추고 사용자에게 알린다 (`/test-scenarios {feature} {issue}` 를 먼저 실행해야 한다는 안내 포함). --- ## 단계 0: 스텁 생성 테스트 파일을 작성하기 전에, 이슈의 시그니처를 읽어 **아직 존재하지 않는 구현 파일**에 대해서만 최소 스텁을 생성한다. ### 목적 Import Error 때문에 테스트가 실행조차 되지 않으면, 테스트가 무엇을 거부하는지 알 수 없다. 스텁은 빌드를 통과시켜 테스트가 **Assertion Failure로 실패**하도록 만드는 것이 전부다. ### 스텁 작성 규칙 - **기존 파일이 있으면 건드리지 않는다.** 신규 파일만 생성한다. - 시그니처의 파라미터·반환 타입을 그대로 선언한다. 구현 로직은 쓰지 않는다. - 반환값은 타입을 만족하는 최솟값으로 고정한다. | 반환 타입 | 스텁 반환값 | | ------------------ | ------------- | | `string[]` | `[]` | | `string` | `''` | | `boolean` | `false` | | `Promise<T>` | `Promise.resolve(/* 최솟값 */)` | | React 컴포넌트 | `return <div />;` | | `void` | _(반환 없음)_ | ### 스텁 예시 **훅 (`src/hooks/useTagInput.ts`)** ```ts import { useState } from 'react'; export function useTagInput(_initialTags: string[]) { const [tags] = useState<string[]>([]); const [inputValue, setInputValue] = useState(''); return { tags, inputValue, setInputValue, addTag: (_value: string) => {}, removeTag: (_tag: string) => {}, handleKeyDown: (_e: React.KeyboardEvent<HTMLInputElement>) => {}, }; } ``` **컴포넌트 (`src/components/TagInput.tsx`)** ```tsx import { TagInputProps } from '../types'; // 필요 시 인라인 정의 export function TagInput(_props: TagInputProps) { return <div />; } ``` **API 함수 (`src/api/tags.ts`)** ```ts import { Note } from '../types/note'; export async function addTag(_noteId: string, _tag: string): Promise<Note> { return Promise.resolve({} as Note); } ``` --- ## 단계 1: 테스트 파일 준비 시그니처에서 테스트 파일 경로를 결정한다. | 구현 파일 | 테스트 파일 | | -------------------------------- | ----------------------------------- | | `src/api/tags.ts` | `src/api/tags.test.ts` | | `src/components/TagInput.tsx` | `src/components/TagInput.test.tsx` | | `src/context/NotesContext.tsx` | `src/context/NotesContext.test.tsx` | - 테스트 파일이 이미 존재하면 기존 내용을 읽어 중복 `describe` 블록을 피한다. - 테스트 파일이 없으면 새로 생성한다. ### 파일 헤더 (신규 생성 시) ```ts import { describe, it, expect, vi, beforeEach } from 'vitest'; // 컴포넌트 파일인 경우에만 추가: // import { render, screen } from '@testing-library/react'; // import userEvent from '@testing-library/user-event'; ``` --- ## 단계 2: 시나리오를 테스트 코드로 작성 이슈의 시나리오 전체를 한 번에 `it()` 블록으로 변환한다. ### 테스트 이름 형식 ``` should [기대 동작] when [조건] ``` ### describe 블록 구조 함수·컴포넌트 단위로 묶는다. ```ts describe('함수명 또는 컴포넌트명', () => { it('should [기대 동작] when [조건]', () => { // 스텁이 있으므로 import는 통과하고, assertion이 실패한다 }); }); ``` ### Red 테스트 작성 원칙 - `expect`는 실제 기대 동작을 명확하게 표현한다. `expect(true).toBe(false)` 같은 더미 assertion은 사용하지 않는다. - 스텁의 반환값(빈 배열, `<div />` 등)을 기준으로 assertion이 자연스럽게 실패하도록 작성한다. - 테스트가 통과하도록 mock이나 stub으로 우회하지 않는다. **API 함수 예시** ```ts import { addTag } from './tags'; describe('addTag', () => { it('should return updated note when valid tag is added', async () => { const result = await addTag('note-1', 'work'); expect(result.tags).toContain('work'); // 스텁은 {} 반환 → tags 없음 → Assertion Failure }); it('should throw when tag is empty string', async () => { await expect(addTag('note-1', '')).rejects.toThrow(); // 스텁은 throw 안 함 → Assertion Failure }); }); ``` **컴포넌트 예시** ```ts import { render, screen } from '@testing-library/react'; import { TagInput } from './TagInput'; describe('TagInput', () => { it('should render input when component is mounted', () => { render(<TagInput tags={[]} onAdd={vi.fn()} onRemove={vi.fn()} />); expect(screen.getByRole('textbox')).toBeInTheDocument(); // 스텁은 <div /> → textbox 없음 → Assertion Failure }); }); ``` --- ## 단계 3: 실행 및 Red 품질 확인 모든 테스트 파일을 작성한 뒤 파일별로 실행한다. ```bash npx vitest run <테스트-파일-경로> --reporter=verbose ``` ### Red 품질 기준 | 실패 유형 | 판정 | 조치 | | ------------------ | ------------- | ---------------------------------------- | | Assertion Failure | ✅ 올바른 Red | 다음으로 진행 | | Runtime Error | ✅ 허용 | 다음으로 진행 | | Import Error | ❌ 스텁 누락 | 단계 0으로 돌아가 해당 파일 스텁 보완 | | Syntax Error | ❌ 테스트 오류 | 테스트 코드 수정 | - **Import Error가 발생하면 올바른 Red로 인정하지 않는다.** 스텁을 보완한 뒤 다시 실행한다. - 테스트가 의도치 않게 통과하면 즉시 멈추고 사용자에게 알린다. --- ## 단계 4: 전체 확인 모든 파일의 Red 품질이 확인된 뒤 전체 테스트를 실행한다. ```bash npm test ``` - 이슈에서 작성한 테스트 파일의 케이스가 모두 Assertion Failure로 실패하는지 확인한다. - 기존에 통과하던 테스트가 새로 실패하면 즉시 사용자에게 보고한다. --- ## 제약 - 테스트 파일(`*.test.ts`, `*.test.tsx`)은 자유롭게 생성·수정한다. - 단계 0의 스텁은 **존재하지 않는 파일**에 한해서만 신규 생성한다. - **기존 구현 파일은 수정하지 않는다.** --- ## 산출물 - 생성된 스텁 파일 목록 및 최솟값 반환 내용 - 작성된 테스트 파일 목록 및 경로 - 파일별 실패 유형 요약 (Assertion Failure / Runtime Error) - `npm test` 결과: 실패한 테스트 수 / 전체 테스트 수
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
안녕하세요, mission 4 과제를 진행중인데 클로드 코드의 프롬프트 수행 속도가 약 7분 이상으로 상당히 느립니다. 원래 속도가 이런 건지, 제 컴퓨터가 느리게 돌아가는 건지 여쭤봅니다..!
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
플랜모드에 대해 업데이트가 있는것 같아요! 강의 화면과 조금 달라요~!
해결됨
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
서브에이전트 강의 듣던중 궁금증이 생겨 문의 드립니다. 병렬처리를 할때 전체 작업에대한 md파일을 하나 만들고 클로드 코드를 n개 켜서 진행 하는거로 알고 있었는데요. 서브에이전트롤 활용하면 (별도의 thread? 같은 개념인가..) 여려개의 클로드 코드를 실행하지 않고 하나의 클로드코드에서 병렬처리를 할수 있을까요? 할수 있다면 어떤게 더 효율적인지 궁금합니다.
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
CLAUDE에서 init 명령어를 통해서 해당 프로젝트에 대한 내용과 구조를 파악해서 claude.md 파일을 만드는 것으로 알고 있는데 PRD 파일을 따로 만들어야하는 이유가 뭔가요? CLAUDE.MD 와 PRD.MD 간의 차이가 뭔지 잘 이해가 안되네요
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
과제를 따라가면서 하다가 user-memory-setup 폴더에 /memory를 입력하면 .claude 폴더도 안만들어지고, CLAUDE.md 파일도 안 만들어집니다. 그래서 클로드를 통해 해당 폴더랑 파일은 만들어서 안에 나의 정보를 작성하고 /memory를 입력했음에도 불구하고 ~/.claude/ CLAUDE.md 0L, 0B 표시만 뜹니다. 폴더도 확인했는데 왜 이렇게 뜰까요?
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
안녕하세요 사내에서 사용하려고 하는데 말씀하신 Shrimp task manager나 그 외 MCP사용할 때 대화내용의 유출이나 보안상 사용해도 괜찮은지 여쭤보고 싶습니다
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
이런 프로젝트할 때는 서브에이전트를 사용해서 PRD만들고 ROADMAP만드는 순서로 진행하면 되는건가요??
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
아래와 같은 메시지가 보이고 cursor command가 실행 안되는 것 같아요. curos를 인식되게 하려면 어떻게 해요? PS E:\Dropbox\claude-code-mastery> cursor . cursor: The term 'cursor' is not recognized as a name of a cmdlet, function, script file, or executable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
안녕하세요. 151강 마지막 부분에서 보면 커스텀 커맨드는 /명령어를 통해 직접 호출해야 하지만 스킬은 자동으로 작동한다고 말씀주셨습니다. 저같은 비전공자들은 어떤 작업을 할때 어떤 스킬을 참고해야 하는지 모를때가 많습니다. 만약, 여러 종류의 스킬을 프로젝트에 저장해 놓고 "@aa 서브에이전트를 활용해서 task를 진행해주세요. skills 디렉토리에 있는 skill 중 진행에 필요한 사항은 참고해서 진행해주세요." 라고 프롬프트를 한다면 해당 서브에이전트가 필요한 skill을 선택해서 사용할 수 있을까요?
해결됨
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
안녕하세요. mcp관련 부분 강의를 듣고 있는데요 직접 호출하는 CDN 방식? 을 사용하는거 말고 로컬에 설치해서 사용하는 방식은 없을까요? 추후 해당 MCP가 더이상 사용하지 않고 폐기 되거나, 버전 업그레이드거 되면서 이슈가 터지는걸 방지하기 위해서 어떻게 해줘야 할지요
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
Claude Code on Windows requires either Git for Windows (for bash) or PowerShell. Install one of: - Git for Windows: https://git-scm.com/downloads/win - PowerShell 7: https://aka.ms/powershell Or set CLAUDE_CODE_GIT_BASH_PATH to your bash.exe location. irm https://claude.ai/install.ps1 | iex : Installation failed (exit code 1) 위치 줄:104 문자:5 + Write-Error "Installation failed (exit code $installExitCode)" + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + CategoryInfo : NotSpecified: (:) [Write-Error], WriteErrorException + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
안녕하세요 강사님! 어느덧 완강을 앞두고 있습니다..!! 먼저 좋은강의 제공해주셔서 감사합니다~~ 먼저 settings.local.json 내에 해당 환경변수를 설정하고나서 "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } 강사님께서 사용하신 자연어( 3명의 팀원을 만들어서 각각 보안, 성능, 스타일 리뷰해줘 ) 를 통해 에이전트 팀을 실행시켰는데요. 아무래도 클로드가 업데이트가 됨에 따라서 강사님께서 찍으신 강의 내용과 UI가 조금 다른거 같아서 질문드립니다!! (사진 1) (사진 2) 사진1과 같이 자연어를 통해 서브에이전트 팀 생성을 요청했는데요. 현재 제가 tmux를 사용하지 않아서, 표시 모드가 In-progress 라서 Shift-down 조작을 진행했습니다! 다만 해당 키로 조작시, 저렇게 Background tasks 라고 UI가 나오는데요! (강사님과 조금 UI 가 다른거 같습니다) + 추가로 강사님의 영상처럼 팀원을 스폰 하겠다 라는 말도 없기도 하고, 저의 프롬프트 요청이 완료 되고 나서, 테스크 현황과 관련된 브리핑이 없기도해서 현재 정상적으로 에이전트 팀이 실행된게 맞는지 궁금합니다!!
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
Agent teams에 대한 강의 잘 들었습니다. 제가 복잡한 프로젝트를 agent team을 만들어 진행을 하는데, pro plan이다보니 계속 사용량 한계에 도달하여 claude가 멈추게 됩니다. 다시 해당 세션을 열어 실행을 할 수는 있지만, team lead 외에 기존에 돌아가던 teammate agent들이 모두 종료되어 있어 다시 띄워야 하고 기존 컨텍스트를 잃어버린다는 문제를 겪고 있습니다. 이런 상황에 어떻게 사용하는 것이 적절한지 여쭙고 싶습니다. 혹은 제가 잘못 이해하고 사용하는 것인지도 궁금합니다.
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
cd workspace 명령 시 알아듣지 못해요
미해결
클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지
기존의 todos가 tasks로 변경되었는데, 기존 영상대로 혹은 제가 더 수정해서 해봤지만, tasks는 플랜이나 utra plan으로 하면서 task가 하나로 남더라고요.. 아마 utra plan생겨서 그런거 같은데, 울트라 플랜이라고 말 안해도 지가 알아서 넘어가더라구요.. 영상 강의처럼 하려면 이제 테스크를 분할해서 해주세요. 이걸 매번 붙여야할까요? 그래야 서브 에이전트로 나눠서 todos처럼 나눠서 하려나요?
