오늘도 공부

원문 출처: TheDecipherist - Claude Code Mastery이 가이드는 원문을 기반으로 한국어 사용자를 위해 재구성하고, 실전 예제를 추가했습니다.1. 왜 Claude Code 설정이 중요한가?핵심 인사이트: CLAUDE.md는 제안, Hooks는 강제많은 개발자들이 CLAUDE.md에 ".env 파일 수정 금지"라고 적어놓고 안심합니다. 하지만 이것은 **제안(suggestion)**일 뿐입니다:CLAUDE.md에 "don't edit .env" 작성 ↓LLM이 파싱 ↓다른 컨텍스트와 함께 고려 ↓"아마도" 따를 것... 하지만 보장 없음반면 PreToolUse Hook으로 .env 접근을 차단하면:.env 파일 접근 시도 ↓Hook 실행 (항상) ↓Exit..

Pencil 앱의 아키텍처를 분석하고, 동일한 방식으로 Claude Code와 실시간 통신하는 웹 애플리케이션을 구현하는 방법을 알아봅니다.다운로드 Pencil – Design on canvas. Land in code.Pencil fundamentally increases your engineering speed by bringing designing directly into your preferred IDE.www.pencil.dev 배경: Pencil 앱이란?Pencil은 macOS용 디자인 도구로, 로컬에 설치된 Claude Code와 실시간으로 통신하여 AI 기반 디자인 작업을 수행합니다. 사용자가 채팅으로 요청하면 Claude가 디자인 파일을 직접 수정하고, 그 과정이 UI에 실시간으로 표시됩..

메인 에이전트가 **지휘자(Conductor)**가 되어 기획, 디자인, 프론트엔드, 백엔드, 테스트, 리뷰 전문 에이전트들을 조율하는 실습입니다. 실제 개발팀처럼 역할을 분담하여 프로젝트를 완성합니다.🎼 오케스트라 패턴이란? ┌─────────────────────────────────┐ │ 🎭 Conductor (지휘자) │ │ 메인 에이전트 │ │ - 작업 분배 및 조율 │ │ - 진행 상황 관리 │ ..

이 튜토리얼에서는 실제로 Claude Code에서 서브 에이전트를 만들고 테스트해봅니다. 단계별로 따라하면서 서브 에이전트의 강력함을 직접 체험해보세요.📋 사전 준비Claude Code가 설치되어 있어야 합니다터미널에서 claude 명령어로 실행 가능해야 합니다🧪 실습 1: 기본 제공 에이전트 확인하기Step 1: Claude Code 실행cd ~/my-project # 아무 프로젝트 폴더로 이동claudeStep 2: 사용 가능한 에이전트 목록 확인/agents다음과 같은 내장 에이전트들이 보입니다:Explore: 코드베이스 탐색 전용 (Haiku 모델, 읽기 전용)Plan: 계획 모드에서 리서치용general-purpose: 복잡한 다단계 작업용Step 3: 내장 에이전트 직접 호출해보기@Exp..

Claude Code를 단일 에이전트로만 사용하고 계신가요? 서브 에이전트와 백그라운드 에이전트를 제대로 활용하면 컨텍스트 윈도우를 절약하면서 더 높은 품질의 결과물을 얻을 수 있습니다. 이 글에서는 서브 에이전트의 개념부터 실전 워크플로우까지 자세히 알아보겠습니다.🤔 서브 에이전트란?서브 에이전트는 메인 에이전트가 특정 작업을 위임할 수 있는 전문화된 보조 에이전트입니다. 마치 팀장이 팀원들에게 업무를 분배하듯이, 메인 에이전트가 서브 에이전트들에게 작업을 할당하고 결과를 수집합니다.서브 에이전트 사용의 장점컨텍스트 윈도우 절약: 서브 에이전트의 작업 내용이 메인 대화에 누적되지 않음병렬 처리: 여러 작업을 동시에 수행 가능전문화된 결과: 각 에이전트가 특정 영역에 집중하여 더 나은 품질 제공대규모 ..

🤖 Ralph for Claude Code: AI가 알아서 개발해주는 자율 개발 루프 도구"개발 지시만 내려놓으면, AI가 완성할 때까지 알아서 개발한다"프로젝트 요구사항만 정의해두면 Claude Code가 자동으로 코드를 작성하고, 테스트하고, 완성될 때까지 반복 실행하는 도구가 있다javaexpert.tistory.com 들어가며최근 AI 코딩 커뮤니티에서 화제가 된 Ralph Wiggum Loop(이하 Ralph)는 Claude Code를 무한 루프로 실행하여 자율적으로 소프트웨어를 개발하는 기법입니다. 이 글에서는 Ralph의 창시자가 직접 설명한 핵심 원리와 실전 적용법을 정리합니다.핵심 개념: "배열을 결정론적으로 조작하라"Ralph의 본질은 단순합니다:컨텍스트 윈도우 = 배열(Array)L..

"개발 지시만 내려놓으면, AI가 완성할 때까지 알아서 개발한다"프로젝트 요구사항만 정의해두면 Claude Code가 자동으로 코드를 작성하고, 테스트하고, 완성될 때까지 반복 실행하는 도구가 있다면 어떨까요? Ralph가 바로 그런 도구입니다.📌 Ralph란?Ralph는 Geoffrey Huntley의 기법에서 영감을 받아 만들어진 자율형 AI 개발 루프 시스템입니다. 심슨 가족의 캐릭터 Ralph Wiggum에서 이름을 따왔어요.핵심 아이디어┌─────────────────────────────────────────────────────────┐│ Ralph 동작 원리 │├─────────────────────────────..

앤스로픽(Anthropic)의 내부 기밀인 시스템 프롬프트(System Prompt)가 깃허브를 통해 유출되었습니다. 단순한 지침이 아닙니다. 무려 2만 4천 토큰 분량의 방대한 '사고 매뉴얼'입니다.이번 유출로 Claude의 3가지 핵심 뼈대가 드러났습니다.1️⃣ 행동 가이드라인 (Behavior Guidelines): 모델이 어떻게 반응해야 하는지 2️⃣ 도구 사용 프로토콜 (Tool Protocols): 외부 툴을 어떻게 다루는지 3️⃣ 인용 규칙 (Citation Rules): 정보를 어떻게 출처와 함께 제공하는지이걸 보면 확실해집니다. 우리가 쓰는 AI는 마법이 아닙니다. 치밀하게 설계된 '규칙'과 '정책'의 산물입니다.1. 검색 결과 기반 답변일 때 인용 규칙 ()웹 검색, Drive 검색, ..

Claude Code 에이전트에게 전달할 지침# 지침 파일 분리 및 온디맨드 참조 설정## 목표CLAUDE.md에 모든 지침을 넣지 않고, 필요할 때만 관련 지침 파일을 참조하도록 구성## 디렉토리 구조project/ ├── CLAUDE.md # 메인 지침 (핵심만) └── .claude/ └── instructions/ ├── flutter-style.md # Flutter 코딩 스타일 ├── api-patterns.md # API 패턴 가이드 ├── state-mgmt.md # 상태관리 지침 └── testing-guide.md # 테스트 작성 가이드## CLAUDE.md 작성 방식메인 CLAUDE.md에는 기본 규칙만 두고, 상세 지침은 @파일경로로 참조 안내:```markdown# 프로젝트 지침#..

들어가며: Claude Code는 개발자만을 위한 도구가 아니다대부분의 사람들은 Claude Code가 앱을 빠르게 만들고 싶은 엔지니어를 위한 도구라고 생각합니다. 저도 그랬습니다. 이미 Cursor로 코딩 프로젝트를 잘 처리하고 있었고, Claude 웹/데스크톱으로 브레인스토밍, 리서치, 글쓰기를 충분히 해결하고 있었으니까요.그래서 Claude Code가 출시되었을 때 솔직한 반응은 이랬습니다: "이미 잘 돌아가는 시스템을 왜 복잡하게 만들어?"터미널은 위협적으로 보였고, 모든 데모는 코딩에 관한 것이었지 글쓰기가 아니었습니다. 그래서 몇 달간 무시했죠.완전히 틀린 판단이었습니다.두 달 전 Claude Code를 써보고 깨달았습니다: Claude Code는 제가 써본 최고의 글쓰기 및 리서치 어시스턴..

원문: Writing a good CLAUDE.md by Kyle Mistele (HumanLayer)Claude Code를 사용하면서 "왜 Claude가 내 지시를 무시하지?"라고 생각해 본 적 있으신가요? CLAUDE.md 파일을 제대로 작성하면 이 문제를 해결할 수 있습니다. 이 글에서는 Claude Code의 성능을 극대화하는 CLAUDE.md 작성법을 실전 예제와 함께 상세히 알아봅니다.핵심 원칙: LLM은 (거의) 상태가 없다LLM은 상태 비저장(stateless) 함수입니다. 추론(inference) 시점에 모델의 가중치는 이미 고정되어 있으므로, 시간이 지나도 학습하지 않습니다. 모델이 여러분의 코드베이스에 대해 아는 것은 오직 컨텍스트 윈도우에 입력된 토큰뿐입니다.Claude Code 같..

클로드 코드 훅에 대한 기본 설명은 아래 링크에서 꼭 확인하고 오세요. Claude Code 훅(Hook) 완벽 가이드: 개발 워크플로우를 자동화하는 11가지 방법Claude Code는 AI 기반 코딩 어시스턴트로, 다양한 훅(Hook) 이벤트를 통해 개발 프로세스를 세밀하게 제어할 수 있습니다. 이 글에서는 각 훅의 용도와 실제 활용 예제를 상세히 살펴보겠습니다.훅(Hojavaexpert.tistory.com AI 코딩 어시스턴트의 모든 동작을 제어하고, 팀 표준을 강제하며, 보안을 자동화하는 방법 들어가며Claude Code를 사용하면서 이런 고민을 해본 적 있으신가요?"매번 프로젝트 컨텍스트를 설명하기 귀찮다""실수로 프로덕션 환경에 영향을 줄까봐 불안하다""코드 스타일이 일관되지 않아서 리뷰할 때..

Claude Code는 AI 기반 코딩 어시스턴트로, 다양한 훅(Hook) 이벤트를 통해 개발 프로세스를 세밀하게 제어할 수 있습니다. 이 글에서는 각 훅의 용도와 실제 활용 예제를 상세히 살펴보겠습니다.훅(Hook)이란?훅은 Claude Code의 실행 흐름에서 특정 시점에 발생하는 이벤트입니다. 각 훅에서 커스텀 로직을 실행하여 프롬프트 강화, 권한 관리, 보안 정책 적용 등을 자동화할 수 있습니다.1. SessionStart - 세션 초기화핵심 질문: 초기 컨텍스트나 환경 설정이 필요한가?용도:프로젝트 컨텍스트 로드환경 변수 설정시작 스크립트 실행실제 예제:# .claude/hooks/session_start.pydef on_session_start(): """세션 시작 시 프로젝트 환경 설정..

GitHub - Njengah/claude-code-cheat-sheet: Ultimate collection of Claude Code tips, tricks, hacks, and workflows that you can useUltimate collection of Claude Code tips, tricks, hacks, and workflows that you can use to master Claude Code in minutes - Njengah/claude-code-cheat-sheetgithub.com Claude Code는 터미널에서 직접 AI 코딩 어시스턴트를 활용할 수 있는 강력한 도구입니다. 이 가이드는 초보자부터 전문가까지, 단계별로 Claude Code를 마스터할 수 있도록 구성..

AI 코딩 도구를 제대로 활용하고 싶다면? 이 가이드 하나면 충분합니다.🎯 이 가이드를 읽어야 하는 이유Claude Code를 사용하다가 이런 경험 있으신가요?"처음엔 잘 되다가 갑자기 이상한 코드를 만들어요""내가 원하는 게 아닌데 계속 엉뚱한 걸 만들어요""코드가 너무 복잡해서 뭐가 뭔지 모르겠어요"이런 문제들은 대부분 사용법의 문제입니다. Claude Code를 제대로 활용하는 방법을 알면 이런 문제를 90% 이상 해결할 수 있습니다.1. 가장 중요한 3가지 원칙원칙 1: 컨텍스트 관리가 전부다컨텍스트란 Claude가 기억하고 있는 대화 내용을 말합니다. 컨텍스트가 너무 많아지면 Claude의 성능이 급격히 떨어집니다.🔴 나쁜 예:계속 대화를 이어가면서 코드를 수정하고, 또 수정하고...→ 결국..

단순한 프롬프트에서 벗어나 체계적인 컨텍스트 관리로 AI 코딩의 레벨을 한 단계 올려보세요.들어가며많은 개발자들이 Claude Code를 사용할 때 이렇게 시작합니다:"채팅봇 만들어줘"하지만 이것은 제로 컨텍스트 접근 방식입니다. 기본적인 결과만 얻을 수 있죠.컨텍스트 인식(Context-Aware) 방식은 완전히 다릅니다:❌ "집을 지어줘"✅ "3층짜리, 침실 6개, 욕실 2개, 개인 안전실 1개가 있는 집을 지어줘. 평면도와 청사진을 작성하고, 완공 시 건축업자를 위한 파티도 계획해줘"이 차이가 바로 오늘 다룰 핵심입니다.Context-Aware란 무엇인가?컨텍스트 인식 개발은 단순히 파일을 구조화하는 것을 넘어, AI가 항상 올바른 신호를 받을 수 있도록 프로젝트를 설계하는 것입니다.여기에는 다음이..

들어가며AI의 발전으로 코딩의 패러다임이 완전히 바뀌고 있습니다. 이제는 복잡한 문법을 외우지 않아도, 자신이 원하는 것을 명확하게 설명만 할 수 있다면 AI가 코드를 작성해줍니다. 이것이 바로 '바이브 코딩(Vibe Coding)'입니다. 마치 주니어 개발자에게 명확한 지시를 내리듯이, AI에게 원하는 것을 설명하면 빠르게 작동하는 코드를 얻을 수 있습니다.바이브 코딩이란 무엇인가?바이브 코딩은 AI를 활용하여 아이디어를 설명하는 것만으로 코드를 작성하는 방식입니다. 복잡한 문법을 암기할 필요 없이, "파란색 배경의 웹페이지를 만들어줘"라고 AI에게 말하면 코드가 생성됩니다.전통적인 코딩 vs 바이브 코딩전통적인 방식: 안녕하세요바이브 코딩 방식:AI에게: "파란색 배경에 '안녕하세요'라는 제목이..

들어가며: AI 코딩 에이전트 논쟁현재 개발자 커뮤니티에서는 AI 코딩 에이전트의 실효성에 대한 논쟁이 뜨겁습니다. 한쪽에서는 "AI 코딩은 형편없다"고 주장하고, 다른 한쪽에서는 "당신이 제대로 사용하지 못하는 것일 뿐"이라고 반박합니다.양쪽 입장 모두 일리가 있지만, 개발자들이 가장 자주 범하는 실수는 **컨텍스트 윈도우(Context Window)**에 대한 이해 부족입니다. 컨텍스트 윈도우는 현재 AI 코딩 에이전트가 직면한 가장 큰 제약사항이지만, 대부분의 개발자들은 이것이 무엇인지, 어떻게 성능에 영향을 미치는지 제대로 모르고 있습니다.이 글에서는 AI 코딩 에이전트 사용자가 반드시 알아야 할 컨텍스트 윈도우의 모든 것을 상세히 다루겠습니다.컨텍스트 윈도우란 무엇인가?기본 개념컨텍스트 윈도우는..

CodeDeck - 개발자를 위한 코드 학습 카드 뉴스프로그래밍 언어와 프레임워크를 카드 뉴스 형태로 쉽게 배우는 개발자 학습 플랫폼www.codedeck.kr AI 기반 코딩 도구들이 우후죽순 쏟아지고 있는 요즘, Claude Code는 단순히 코드를 생성하는 것을 넘어서 실제 프로덕션 환경에서 활용 가능한 강력한 기능들을 제공합니다. 이 글에서는 Claude Code의 핵심 기능들을 실전 관점에서 깊이 있게 다루어 보겠습니다.CLAUDE.md: 에이전트의 헌법프로젝트에서 가장 중요한 파일은 바로 루트 디렉토리의 CLAUDE.md입니다. 이 파일은 Claude Code가 여러분의 코드베이스를 이해하는 핵심 문서입니다.효과적인 CLAUDE.md 작성 원칙1. 가드레일부터 시작하기처음부터 완벽한 매뉴얼을 ..

CodeDeck - 개발자를 위한 코드 학습 카드 뉴스프로그래밍 언어와 프레임워크를 카드 뉴스 형태로 쉽게 배우는 개발자 학습 플랫폼www.codedeck.kr Claude Code의 잘 알려지지 않은 hooks 기능을 활용하여 각 턴이 끝날 때마다 자동으로 품질 검사를 실행하고 귀중한 시간을 절약하는 방법을 알아봅니다.핵심 요약Stop hook을 사용하여 각 턴 종료 시점에 결정론적이고 자동화된 품질 검사를 실행합니다가벼운 PostToolUse hook과 after-write.sh를 조합하여 편집 후 즉각적인 포맷팅이나 빠른 검증을 수행합니다.claude/settings.json에서 after-write.sh를 PostToolUse에, 강력한 end-of-turn-check.sh를 Stop에 연결하여 ..

"뼈대를 먼저 만들고, 그 다음에 살을 붙여라" — Flow Framework GitHub - khgs2411/flow: Iterative development framework combining Domain-Driven Design with Agile philosophyIterative development framework combining Domain-Driven Design with Agile philosophy - khgs2411/flowgithub.com 들어가며AI 코딩 도구를 사용하다 보면 이런 경험 없으신가요?프롬프트를 던지고 기다렸는데, 결과가 엉뚱한 방향으로...어제 ChatGPT와 나눴던 대화 내용을 오늘 다시 설명해야 하는 상황AI가 만든 코드가 마음에 안 들어서 결국 전체를 다..

GitHub - GWUDCAP/cc-sessions: an opinionated approach to productive development with Claude Codean opinionated approach to productive development with Claude Code - GWUDCAP/cc-sessionsgithub.com 당신이 여기 오게 된 이유이런 경험 있으신가요?💭 LLM 프로그래밍 가능성에 설레어 Cursor/Cline/Claude Code를 설치했다😬 처음엔 신기하고 좋았다. 컨텍스트 매니저 안 짜도 되니까!🤮 근데 Claude가 이상한 짓을 하기 시작했다Claude에게 한 함수에만 에러 핸들링 추가하라고 했더니:파일의 모든 함수에 에러 핸들링을 추가함에러 타입도 ..

Claude Agent Skills: A First Principles Deep DiveTechnical deep dive into Claude Agent Skills' prompt-based meta-tool architecture. Learn how context injection design, two-message patterns, LLM-based routin...leehanchung.github.io원문을 정리한 내용입니다. Claude의 Agent Skills 시스템은 프롬프트 기반 메타-툴 아키텍처를 통해 LLM의 능력을 확장하는 정교한 시스템입니다. 기존의 함수 호출이나 코드 실행과 달리, Skills는 프롬프트 확장과 컨텍스트 수정을 통해 작동합니다.이 글에서는 Claude의 Agent ..

Understanding Claude Code Components: A Practical GuideUsing only slash commands? You're automating 20% of what Claude Code handles. Most engineers can't explain when to use Agents vs Tools vs Skills. This practical guide helps eliminate the confusion.www.devashish.me위 내용을 한국어로 정리했습니다. 들어가며대부분의 개발자는 Claude Code를 단순한 채팅 인터페이스처럼 사용합니다. 질문하고, 답변 받고, 코드를 복사-붙여넣기 하죠. 하지만 이는 Claude Code가 제공하는 자동화 기능의 ..

고급 튜토리얼: PDF 양식 자동화 스킬 만들기목표이 튜토리얼에서는 실행 가능한 Python 스크립트와 검증 로직을 포함한 고급 스킬을 만들어봅니다.난이도⭐⭐⭐ 고급 - 실행 가능한 스크립트, 계획-검증-실행 패턴, 시각적 분석소요 시간약 60-90분단계 1: 문제 정의하기시나리오여러분은 매주 수백 개의 PDF 양식을 처리해야 합니다. 현재 프로세스:PDF 양식 열기스프레드시트에서 데이터 찾기수동으로 필드 채우기저장 및 다음 양식으로이 과정에서 발생하는 문제:😓 반복적이고 시간 소모적🐛 오타나 잘못된 필드 입력 오류🔍 어떤 필드를 채웠는지 추적 어려움📊 일괄 처리 불가능해결 방법Claude가 다음을 수행하도록 스킬을 만듭니다:PDF 양식 분석 (어떤 필드가 있는지)스프레드시트 데이터 매칭변경 계획..

중급 튜토리얼: API 문서화 스킬 만들기목표이 튜토리얼에서는 점진적 공개(Progressive Disclosure) 패턴을 사용하여 여러 파일로 구성된 스킬을 만들어봅니다.난이도⭐⭐ 중급 - 여러 파일 구조, 조건부 참조, 도메인별 구성소요 시간약 30-40분단계 1: 문제 정의하기시나리오여러분은 REST API 문서를 작성하는 일을 자주 합니다. API는 여러 도메인(사용자, 결제, 상품)으로 나뉘어 있고, 각 도메인마다 다른 스키마와 엔드포인트가 있습니다.현재 문제점:모든 API 정보를 하나의 파일에 넣으면 너무 길어짐 (1000+ 줄)Claude가 필요없는 도메인 정보까지 읽어서 토큰 낭비새로운 도메인을 추가하기 어려움해결 방법점진적 공개 패턴을 사용하여 Claude가 필요한 정보만 읽도록 구조화..

초급 튜토리얼: 간단한 블로그 글 작성 스킬 만들기목표이 튜토리얼에서는 블로그 글을 일관된 형식으로 작성하도록 돕는 간단한 스킬을 만들어봅니다.난이도⭐ 초급 - 코드 없음, 순수 마크다운 지침만 사용소요 시간약 15-20분단계 1: 문제 정의하기시나리오여러분은 기술 블로그를 운영하고 있습니다. 매번 블로그 글을 쓸 때마다 다음과 같은 지침을 Claude에게 반복해서 말하고 있습니다:"독자를 '여러분'이라고 칭해줘""각 섹션은 명확한 소제목으로 시작해줘""코드 예시는 항상 설명을 먼저 하고 그 다음에 보여줘""마지막에 핵심 요약을 3개 bullet point로 정리해줘"이런 지침을 스킬로 만들면 매번 반복하지 않아도 됩니다!단계 2: 스킬 디렉토리 생성하기먼저 스킬을 저장할 폴더를 만듭니다:blog-wri..

목차핵심 원칙스킬 구조효과적인 작성 패턴콘텐츠 가이드라인평가와 반복 개선실행 가능한 코드가 포함된 스킬체크리스트핵심 원칙1. 간결함이 핵심컨텍스트 윈도우는 공공재입니다. 스킬은 다음 요소들과 함께 컨텍스트를 공유합니다:시스템 프롬프트대화 기록다른 스킬의 메타데이터실제 요청 내용작성 시 항상 자문하세요:"Claude가 정말 이 설명을 필요로 할까?""Claude가 이미 알고 있다고 가정할 수 있을까?""이 단락이 토큰 비용을 정당화할까?"2. 적절한 자유도 설정작업의 취약성과 가변성에 맞춰 구체성 수준을 조정하세요.높은 자유도 (텍스트 기반 지침) - 다음 경우에 사용:여러 접근 방식이 유효한 경우결정이 맥락에 따라 달라지는 경우휴리스틱이 접근 방식을 안내하는 경우중간 자유도 (구조화된 가이드라인) - 다..

Advanced Claude Code Hooks: Controlling Sub-Agent Behavior | LTSCommerce - Bespoke PHP DevelopmentAdvanced Claude Code Hooks: Controlling Sub-Agent Behavior 24 October 2025 • 8 min read • AI Claude Code hooks are powerful automation tools that execute at specific points during AI coding sessions. While basic hooks can validate prompts or add contexltscommerce.dev원문을 번역한 내용입니다.개요Claude Code의 훅(ho..

TaskMaster CLI: 효율적인 프로젝트 작업 관리를 위한 필수 명령어 가이드TaskMaster는 AI 기반의 강력한 작업 관리 CLI 도구입니다. PRD(Product Requirements Document)에서 자동으로 작업을 생성하고, 복잡한 작업을 세분화하며, 의존성을 관리할 수 있습니다. 이 글에서는 TaskMaster의 핵심 명령어들과 실제 사용 예제를 소개합니다.🚀 프로젝트 초기 설정1. 프로젝트 초기화새로운 프로젝트를 시작할 때 가장 먼저 해야 할 일은 TaskMaster 구조를 초기화하는 것입니다.# 대화형 모드로 프로젝트 초기화task-master init# 옵션을 직접 지정하여 초기화task-master init --name="My Awesome Project" --descri..