스킬이 위험한 명령을 실행 하면 어떻게 될까요? 편리함 뒤에는 항상 보안 위험이 있습니다. 스킬을 안전하게 만들고 운영하는 방법을 알아야 합니다. 이 글에서는 스킬 보안과 효율적인 운영 방법을 알아봅니다. 보안 기본 원칙 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 스킬이 rm -rf 같은 명령을 실행하면 어떻게 돼요? 🎯 딱딱씨 기본적으로 Claude Code는 위험한 명령 전에 확인 을 요청해. 하지만 allowedCommands에 추가하면 확인 없이 실행되니까 조심해야 해! 🤔 왜왜씨 그럼 어떤 명령은 절대 허용하면 안 되겠네요? 🎯 딱딱씨 맞아! 파일 삭제, 권한 변경, 시스템 명령 은 절대 자동 허용하면 안 돼. 복구가 불가능한 경우가 많거든. 보안 3원칙 ① 최소 권한 - 필요한 것만 허용 ② 확인 유지 - 위험 명령은 확인 필수 ③ 비밀 보호 - API 키, 비밀번호 노출 금지 위험 명령 목록 ⚠️ 절대 자동 허용 금지 명령 위험성 영향 ...

CLAUDE.md, 스킬, MCP, Hooks... 이것들을 어떻게 조합 해야 할까요? 개별 기능을 아는 것과 전체를 설계 하는 것은 다릅니다. 이 글에서는 Claude Code의 구성 요소들을 통합하는 아키텍처를 알아봅니다. 구성 요소 정리 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 CLAUDE.md, 스킬, settings.json... 다 비슷해 보이는데 어떤 걸 써야 하는지 헷갈려요. 🎯 딱딱씨 회사로 비유하면 이해하기 쉬워! CLAUDE.md = 회사 규정 (항상 적용) 스킬 = 업무 매뉴얼 (필요할 때 참조) settings.json = 시스템 설정 (백그라운드) MCP = 외부 협력사 연결 구성 요소 역할 적용 시점 CLAUDE.md 기본 지침, 프로젝트 규칙 항상 로드 스킬 (SKILL.md) 특정 작업 수행 가이드 키워드/명령으로 활성화 settings.json 권한, 동작, MCP 설정 백그라운드 ...

Claude Code가 외부 서비스와 대화 할 수 있다면 어떨까요? Slack 메시지 전송, GitHub 이슈 생성, 데이터베이스 조회... 이 모든 것이 MCP(Model Context Protocol) 로 가능합니다. 이 글에서는 MCP의 개념과 설정 방법을 알아봅니다. MCP란? 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 MCP가 뭔가요? 이름만 들으면 무슨 프로토콜 같은데... 🎯 딱딱씨 맞아, 프로토콜이야! 쉽게 말하면 Claude Code가 외부 도구와 소통하는 표준 방식 이지. USB가 다양한 기기를 컴퓨터에 연결하듯, MCP는 다양한 서비스를 Claude에 연결해. 🤔 왜왜씨 그럼 아무 서비스나 연결할 수 있어요? 🎯 딱딱씨 MCP 서버가 있는 서비스만 가능해. GitHub, Slack, 데이터베이스 등 주요 서비스들은 이미 MCP 서버가 있어서 바로 연결할 수 있어! MCP의 핵심 MCP = Model Context Protocol 역할 = Claude와 외부 서비스 연결 구성 = MCP 서버 (제공자) ↔ Claude (소비자) 결과: 외부 도구/데이터를 Clau...

서브에이전트가 서로 협력 할 수 있다면 어떨까요? Agent Teams는 여러 에이전트가 하나의 목표를 위해 함께 작업 하는 실험적 기능입니다. 이 글에서는 Agent Teams의 개념과 활용 가능성을 알아봅니다. Agent Teams란? 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 서브에이전트랑 Agent Teams는 뭐가 달라요? 🎯 딱딱씨 학교 과제로 비유하면, 서브에이전트는 혼자 맡은 파트를 끝내고 제출 하는 거야. Agent Teams는 팀원끼리 대화하면서 함께 완성 하는 거지. 🤔 왜왜씨 팀원끼리 대화요? 🎯 딱딱씨 응! 에이전트 A가 작업 중 막히면 에이전트 B에게 메시지를 보내서 도움을 요청할 수 있어. 이게 핵심 차이야. 서브에이전트 vs Agent Teams 서브에이전트 = 독립 작업 → 결과 반환 Agent Teams = 협업 작업 → 상호 소통 가능 핵심: 에이전트 간 메시지 교환 Teams 핵심 기능 💡 Agent Teams의 특징 공유 Task List - 팀 전체가 같은 할 일 목록 공유 Peer-to-Peer ...

복잡한 작업을 혼자 다 처리 하려면 버거울 때가 있습니다. 이럴 때 서브에이전트 를 활용하면 작업을 분산하고 병렬로 처리할 수 있습니다. 이 글에서는 커스텀 서브에이전트를 만들고 활용하는 방법을 알아봅니다. 서브에이전트란? 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 서브에이전트가 뭔가요? 🎯 딱딱씨 팀 프로젝트를 생각해봐. 팀장이 모든 일을 직접 하면 힘들잖아? 그래서 팀원에게 업무를 분담 하지. 서브에이전트가 바로 그 팀원이야. 🤔 왜왜씨 그럼 메인 에이전트가 팀장이고, 서브에이전트가 팀원인 거네요? 🎯 딱딱씨 정확해! 메인 에이전트가 전체를 조율하고, 서브에이전트들이 각자 맡은 작업을 처리해서 결과를 돌려주는 거야. 서브에이전트 개념 메인 에이전트 = 전체 작업 조율 (팀장) 서브에이전트 = 특정 작업 전담 (팀원) 결과: 복잡한 작업 분산 + 병렬 처리 가능 언제 서브에이전트를 쓸까? 💡 서브에이전트가 유용한 경우 여러 파일 분석 - 각 파일을 서브에이전트가 병렬 분석 다양한 관점 필요 - 각 관점별 서브에이전트 배치 ...

스킬을 만들었는데 제대로 동작하는지 어떻게 확인 하나요? 스킬도 코드처럼 테스트와 디버깅 이 필요합니다. 문제가 생겼을 때 원인을 찾고 해결하는 방법을 알아야 합니다. 이 글에서는 스킬을 검증하고 문제를 해결하는 방법을 알아봅니다. 스킬 테스트 기본 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 스킬 테스트는 어떻게 해요? 유닛 테스트 같은 게 있나요? 🎯 딱딱씨 스킬은 코드가 아니라 프롬프트 라서 전통적인 테스트와 달라. 대신 시나리오 기반 테스트 를 해. 🤔 왜왜씨 시나리오 기반이요? 🎯 딱딱씨 "이렇게 요청하면 이렇게 응답해야 한다"를 정해두고, 실제로 그렇게 되는지 확인하는 거야. 스킬 테스트 3단계 ① 활성화 테스트 - 스킬이 제대로 인식되는가? ② 동작 테스트 - 의도한 대로 동작하는가? ③ 엣지 케이스 - 예외 상황에서도 괜찮은가? 활성화 테스트 먼저 스킬이 제대로 인식되는지 확인합니다. 테스트 방법 💡 활성화 테스트 체크리스트 /help 입력 → 스킬 목록에 보이는가? /스킬명 입력 → 스킬...

특정 이벤트가 발생할 때 자동으로 무언가 실행 되면 좋겠다고 생각한 적 있으신가요? "파일 저장할 때마다 린트 실행", "세션 시작할 때 환경 체크" 같은 자동화를 Hooks 로 구현할 수 있습니다. 이 글에서는 Hooks의 동작 원리와 설정 방법을 알아봅니다. Hooks란? 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 Hooks가 뭔가요? Git hooks랑 같은 건가요? 🎯 딱딱씨 비슷한 개념이야! Git hooks가 "커밋 전에 실행"처럼 동작하듯, Claude Code Hooks는 "이 이벤트 때 실행" 을 설정하는 거야. 🤔 왜왜씨 어떤 이벤트에 설정할 수 있어요? 🎯 딱딱씨 세션 시작, 프롬프트 전송, 도구 실행 전/후, 알림 등 20가지 이상 의 이벤트가 있어! Hooks의 핵심 이벤트 = 언제 실행할지 (트리거) 명령 = 무엇을 실행할지 (액션) 이벤트 발생 → 명령 자동 실행 주요 Hook 이벤트 이벤트 발생 시점 ...

스킬이 특정 명령어를 실행 해야 한다면 어떻게 해야 할까요? 기본적으로 Claude Code는 안전을 위해 많은 동작에 사용자 확인 을 요청합니다. 하지만 자주 쓰는 명령이라면 매번 확인하기 번거롭죠. 이 글에서는 settings.json 으로 스킬의 권한과 동작을 설정하는 방법을 알아봅니다. settings.json이란? 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 스킬에서 npm install을 실행하려는데 매번 허용하냐고 물어봐요. 🎯 딱딱씨 보안을 위해 그래. 하지만 settings.json 에 "이 명령은 항상 허용"이라고 설정하면 안 물어봐. 🤔 왜왜씨 settings.json은 어디에 있어요? 🎯 딱딱씨 두 곳에 있을 수 있어. 전역 : ~/.claude/settings.json 프로젝트 : .claude/settings.json settings.json 역할 ① 명령어 허용 목록 - 확인 없이 실행할 명령 ② MCP 서버 설정 - 외부 도구 연결 설정 ③ 기타 동작 설정 - Claude Code 동작 ...

스킬에 정보를 많이 넣으면 좋을까요? 반드시 그렇지는 않습니다. 너무 많은 정보는 토큰을 낭비 하고, AI의 집중력을 떨어뜨립니다. 이 글에서는 필요한 정보만 필요한 시점에 제공하는 프로그레시브 디스클로저 기법을 알아봅니다. 프로그레시브 디스클로저란? 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 프로그레시브 디스클로저가 뭔가요? 이름이 어려워요. 🎯 딱딱씨 회사 교육 자료를 생각해봐. 신입 교육에서 모든 내용을 한꺼번에 주면 머리가 터지잖아? 🤔 왜왜씨 맞아요, 필요할 때 하나씩 주는 게 낫죠. 🎯 딱딱씨 그게 바로 프로그레시브 디스클로저야! 기본 정보 만 먼저 주고, 상세 정보는 필요할 때 불러오는 거지. 프로그레시브 디스클로저의 핵심 SKILL.md = 핵심 정보만 (요약) knowledge/ = 상세 정보 저장 (필요시 로드) 결과: 토큰 절약 + 집중력 향상 knowledge 폴더 활용 상세 정보는 knowledge 폴더 에 분리합니다. 스킬 구조: skills/my-skill/SKILL.md - 핵심만 skills/my-skill/knowled...

스킬이 복잡해지면 순서가 중요 해집니다. "먼저 이걸 하고, 그다음 저걸 하고, 마지막에 이걸 해줘" - 이런 작업을 체계적으로 설계하는 것이 워크플로우 패턴 입니다. 이 글에서는 스킬에서 자주 사용하는 워크플로우 패턴들을 알아봅니다. 워크플로우란? 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 워크플로우가 뭔가요? 🎯 딱딱씨 조립설명서 같은 거야. "1단계: A를 끼우고, 2단계: B를 연결하고..." 이런 식으로 작업 순서 를 정해놓는 거지. 🤔 왜왜씨 그냥 "이거 해줘"라고 하면 알아서 안 하나요? 🎯 딱딱씨 간단한 건 괜찮아. 하지만 복잡한 작업은 순서를 명확히 해야 빠짐없이, 일관되게 처리돼. 안 그러면 어떤 때는 A부터, 어떤 때는 C부터 시작해. 워크플로우 패턴의 필요성 ① 일관성 - 매번 같은 순서로 작업 수행 ② 완결성 - 필요한 단계를 빠뜨리지 않음 ③ 품질 - 각 단계에서 검증 가능 패턴 1: 순차 실행 가장 기본적인 패턴입니다. 단계를 순서대로 실행합니다. Step 1 → Step 2 → S...

스킬을 만들었는데, 더 빠르고 정확하게 호출하고 싶지 않으신가요? 슬래시 명령 은 스킬을 단축키처럼 사용하는 방법입니다. 이 글에서는 슬래시 명령의 구조와 인자(Arguments) 전달법 을 마스터합니다. 슬래시 명령이란? 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 슬래시 명령이 뭔가요? 그냥 스킬 이름 부르는 거랑 다른가요? 🎯 딱딱씨 핸드폰 단축 다이얼 같은 거야. "김철수한테 전화해"라고 말하는 대신 1번만 누르면 바로 연결되잖아? 슬래시 명령도 그래. 🤔 왜왜씨 그럼 키워드 매칭보다 뭐가 좋은 거예요? 🎯 딱딱씨 100% 확실 하게 원하는 스킬이 실행돼. 키워드 매칭은 가끔 다른 스킬이 실행될 수 있는데, 슬래시 명령은 그런 일이 없어. 슬래시 명령의 장점 ① 정확성 - 원하는 스킬이 100% 실행 ② 속도 - 짧은 명령으로 빠른 호출 ③ 인자 전달 - 명령과 함께 데이터 전달 가능 기본 사용법 슬래시 명령 형식: /스킬명 [인자] 💡 사용 예시 /daily-briefing - 인자 없이 실행 ...

이론은 충분합니다. 이제 직접 만들어볼 차례입니다. 이 글에서는 간단하지만 실용적인 스킬을 처음부터 끝까지 함께 만들어봅니다. 완성하면 매일 아침 "오늘 뭐하지?" 를 Claude에게 물어볼 수 있게 됩니다. 만들 스킬 소개 실습 스킬: daily-briefing 기능 : 오늘 날짜, 요일, 주요 일정을 브리핑 트리거 : "오늘 브리핑", "데일리 브리핑" 요청 시 출력 : 깔끔하게 정리된 오늘의 정보 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 왜 이 스킬을 첫 번째로 만드는 거예요? 🎯 딱딱씨 세 가지 이유야. 간단 하고, 매일 쓸 수 있고 , 결과를 바로 확인 할 수 있거든. 첫 스킬로 딱이지! Step 1: 폴더 생성 먼저 스킬을 저장할 폴더를 만듭니다. 터미널에서 실행: mkdir -p ~/.claude/skills/daily-briefing 🎯 딱딱씨의 팁 폴더명은 스킬의 name 과 동일하게 맞추는 것이 관리하기 좋습니다! Step 2: SKILL.md 작성 핵심 파일인 SKILL.md를 작성합니다. --- name: daily-briefing description: 오늘의 날짜, 요일, 주요 정보를 브리핑. "오늘 브리핑", "데일리 브리핑", "오늘 뭐야" 요청 시 활성화 keyword...