코드깎는노인의 영상 **「클로드코드 50분 마스터 | 바이브코딩 완전 초보자용」**은 Claude Code를 처음 접하는 사람을 위해 설치부터 실제 작업, 되돌리기, Git 버전관리, CLAUDE.md, Context 관리, Skill과 Subagent까지 한 번에 익히는 입문 강의입니다. ## Claude Code는 무엇인가? Claude Code는 웹 채팅창에서 코드를 보여주는 도구가 아니라, **내 컴퓨터의 실제 프로젝트 폴더를 읽고 파일을 만들고 수정하고 명령을 실행하는 AI 코딩 에이전트**입니다. 즉: **말로 요청 → 파일 수정 → 실행 → 확인 → 다시 수정** 까지 이어지는 개발 작업을 AI에게 맡길 수 있습니다. ## 1. 처음에는 작업 폴더부터 정확히 잡는다 Claude Code는 현재 터미널이 들어가 있는 폴더를 작업장으로 사용합니다. 그래서 가장 먼저: 1. 새 프로젝트 폴더 생성 2. 해당 폴더로 이동 3. 그 안에서 Claude Code 실행 순서로 시작하는 것이 중요합니다. 사용자 홈 폴더처럼 범위가 너무 큰 곳에서 바로 실행하면 불필요하게 많은 파일을 읽거나 수정 대상으로 인식할 수 있습니다. ## 2. 부탁할 때는 세 가지를 같이 말한다 영상에서 반복해서 강조하는 요청 방식은: - 무엇을 할지 - 어디까지 할지 - 어떻게 확인할지 입니다. 예: > 할 일 추가와 삭제만 있는 작은 앱을 만들어줘. 로그인이나 통계 기능은 넣지 말고, 브라우저에서 추가와 삭제가 실제로 되는지 확인해줘. 처럼 범위와 검증 기준을 같이 주면 과도한 기능 추가를 줄일 수 있습니다. ## 3. 마음대로 수정하는 것이 불안하면 모드를 바꾼다 Claude Code는 작업 모드에 따라 자동으로 수정하거나 승인 요청을 할 수 있습니다. 영상에서는 Shift+Tab으로 모드를 바꾸고, 중요한 작업에서는 **manual 또는 plan 중심으로 먼저 확인하는 습관**을 권합니다. 권한 창이 나오면 무조건 승인하지 말고: - 내 요청과 관련된 명령인지 - 작업 폴더 밖을 건드리는지 - 삭제·설치·업로드 같은 위험 작업인지 를 확인하는 것이 중요합니다. ## 4. 생각과 다르게 흘러가면 빨리 멈춘다 AI가 잘못된 방향으로 작업 중인데 끝까지 기다릴 필요는 없습니다. 영상에서는 Esc로 작업을 중지하고 바로 원하는 방향을 다시 설명하는 방식을 추천합니다. 핵심은: > **잘못된 작업을 오래 진행시키기보다 초기에 멈추는 것** 입니다. ## 5. 되돌리기와 Git은 다르다 Claude Code에는 대화 기반 되감기 기능이 있지만 모든 변경을 완벽하게 복구할 수 있는 것은 아닙니다. 그래서 중요한 시점마다 Git Commit을 남기는 습관이 필요합니다. 예: **기능 하나 완성 → 확인 → git commit** 을 반복하면 문제가 생겼을 때 안정적인 지점으로 돌아갈 수 있습니다. Git은 내 컴퓨터 안의 버전 기록이고, GitHub는 그 기록을 원격 저장소에 올리는 서비스라는 차이도 설명합니다. ## 6. 큰 기능은 Plan 모드부터 작은 수정은 바로 실행해도 되지만, 큰 기능은 먼저 계획을 받는 것이 좋습니다. 예: - 인증 추가 - DB 구조 변경 - 대규모 리팩터링 - 여러 파일을 건드리는 기능 같은 작업에서는: **계획 작성 → 계획 검토 → 수정 요청 → 승인 → 실행** 순서가 안전합니다. 특히 Claude가 임의로 정한 기본 동작이나 기술 선택이 있는지 계획에서 확인해야 합니다. ## 7. 에러는 요약하지 말고 그대로 준다 에러가 발생했을 때 사용자가 의미를 추측해서 짧게 바꾸기보다 **원문 그대로 붙여 넣는 것이 가장 좋습니다.** 에러 문장을 찾기 어렵다면: - 무엇을 눌렀는지 - 실제로 어떤 일이 일어났는지 - 원래는 어떻게 되어야 하는지 를 설명하면 됩니다. ## 8. Playwright를 연결하면 브라우저 검증까지 자동화 가능 Claude Code는 기본적으로 파일과 터미널 작업에 강하지만, 브라우저에서 실제 버튼을 누르고 확인하려면 별도 도구가 필요합니다. 영상에서는 **Playwright MCP**를 예로 듭니다. 이를 연결하면 Claude가: - 페이지 열기 - 버튼 클릭 - 입력 - 결과 확인 까지 직접 수행할 수 있어 개발 → 테스트 루프를 더 자동화할 수 있습니다. ## 9. 다음 날 이어서 작업하는 방법 Claude Code를 종료했다가 다음 날 다시 열면 새 대화처럼 보일 수 있습니다. 영상에서는: - claude -c - /resume - /rename 을 이용해 이전 대화를 이어가거나 찾는 방법을 설명합니다. ## 10. CLAUDE.md는 프로젝트의 상시 규칙 매번 반복해서 말해야 하는 규칙은 CLAUDE.md에 적어 두는 것이 좋습니다. 예: - 설명은 쉬운 말로 - UI 문구는 존댓말 - 수정 전 변경 계획 먼저 보고 - 작업 후 lint 실행 같은 규칙입니다. Claude Code는 대화가 새로 시작되어도 CLAUDE.md를 다시 읽기 때문에 프로젝트 공통 지침으로 사용할 수 있습니다. /init을 이용하면 프로젝트를 분석해 CLAUDE.md 초안도 만들 수 있습니다. ## 11. 자동 메모와 CLAUDE.md는 다르다 Claude가 대화 중 일부 내용을 자동으로 기억할 수도 있지만, 반드시 지켜야 할 규칙은 자동 메모에만 맡기지 않는 것이 좋습니다. 중요한 규칙은 직접 CLAUDE.md에 명시하는 편이 안전합니다. ## 12. Context가 길어질 때 대화가 길어지면 모델이 기억해야 할 정보가 많아지고, 앞의 지시를 놓칠 가능성도 커집니다. 영상에서는 세 가지 명령을 구분합니다. ### /clear 주제가 완전히 바뀔 때 새 대화처럼 시작 ### /compact 현재 대화를 요약해서 Context를 줄이고 같은 작업을 계속 ### /context 현재 Context 사용량 확인 즉: **주제가 바뀌면 /clear** **같은 일을 계속해야 하면 /compact** 로 이해하면 쉽습니다. ## 13. 잠깐 다른 질문은 /btw 현재 작업 흐름을 흐리지 않고 잠깐 다른 질문만 하고 싶다면 /btw를 사용할 수 있습니다. 이렇게 하면 본 대화 Context에 불필요한 정보가 섞이는 것을 줄일 수 있습니다. ## 14. 같은 문제를 계속 못 풀면 새로 시작 같은 오류를 두세 번 반복해서 해결하지 못하면 실패한 시도가 Context에 계속 누적됩니다. 이때는: 1. 지금까지 알아낸 원인 정리 2. /clear 3. 문제 상황을 처음부터 구체적으로 다시 설명 하는 편이 오히려 빠를 수 있습니다. ## 15. 사용량·모델·생각 깊이 확인 영상에서는: - /usage - /effort - /model 을 통해 사용량과 추론 깊이, 모델 선택을 확인하는 방법도 설명합니다. 초보자라면 기본값을 그대로 쓰고 정말 어려운 작업에서만 Effort를 높이는 것이 좋습니다. ## 16. @로 파일을 정확히 지정 수정해야 할 파일을 알고 있다면: @파일명 형태로 직접 지정할 수 있습니다. 프로젝트가 커질수록 '그 파일 고쳐줘'보다 정확한 파일을 지정하는 것이 훨씬 안전합니다. ## 17. !로 터미널 명령 직접 실행 Claude Code 입력창에서 !를 붙이면 터미널 명령을 바로 실행할 수 있습니다. 예: !git log --oneline 처럼 사용할 수 있습니다. ## 18. 반복 작업은 Skill로 만든다 자주 쓰는 요청은 Skill 형태로 만들어 슬래시 명령처럼 재사용할 수 있습니다. 예: /check 를 실행하면: - 문법 검사 - lint - 테스트 를 자동 수행하도록 만들 수 있습니다. 즉, 반복 프롬프트를 **재사용 가능한 작업 절차**로 바꾸는 개념입니다. ## 19. Subagent로 일을 나눈다 하나의 Claude가 모든 검사를 순서대로 하는 대신 Subagent에게 역할을 나눌 수 있습니다. 예: - 접근성 점검 Agent - 보안 점검 Agent - 코드 리뷰 Agent 를 동시에 실행하고 결과만 메인 대화로 가져올 수 있습니다. 이 방식은 Context 사용량을 줄이고 병렬 작업에도 유리합니다. ## 초보자에게 가장 중요한 습관 영상 전체를 관통하는 핵심은 기능을 많이 외우는 것이 아닙니다. 다음 습관이 더 중요합니다. 1. 작업 범위를 작게 나눈다 2. 무엇을·어디까지·어떻게 확인할지 말한다 3. 위험한 권한은 읽고 승인한다 4. 잘못 가면 빨리 멈춘다 5. 좋은 상태마다 Git Commit을 남긴다 6. 큰 기능은 Plan부터 본다 7. 중요한 규칙은 CLAUDE.md에 적는다 8. 주제가 바뀌면 Context를 정리한다 9. 최종 보고의 '확인하지 못한 것'을 반드시 본다 ## 핵심 정리 Claude Code를 잘 쓰는 핵심은 '프롬프트를 멋지게 쓰는 것'보다 **AI에게 일을 맡기고 검토하는 개발 습관을 만드는 것**입니다. 전체 흐름을 요약하면: **작게 요청 → 계획 확인 → 실행 → 검증 → Commit → Context 정리 → 반복 작업은 Skill/Subagent화** 입니다. 바이브코딩 초보자라면 처음부터 복잡한 앱을 만들기보다 작은 프로젝트에서 이 흐름을 반복해 보는 것이 가장 좋은 출발점입니다.