본문 바로가기

전체 글86

Claude Code Hooks란? 파일 저장 시 자동 실행 원리 Claude Code 입문Claude Code Hooks는 "이런 일이 생기면 → 이 명령을 실행해"라는 규칙을 미리 정해두는 자동화 장치입니다. 이 글에서는 Hooks의 개념부터 설정 파일 구조, 파일 저장 시 자동 포맷이 동작하는 원리, 그리고 처음 설정할 때 알아둘 실전 팁까지 순서대로 정리합니다.📌 3줄 요약Hook은 특정 이벤트가 발생하면 자동으로 명령을 실행하는 장치이며, Claude Code에서도 같은 원리로 동작한다.settings.json에 이벤트와 명령어를 등록해두면, 파일 저장 직후 포맷터·테스트가 자동 실행된다.훅 명령이 실패하면 Claude Code가 피드백으로 받아 자동 수정을 시도하는 것이 일반 에디터와의 핵심 차이다.📑 목차Hooks가 뭔지 한마디로 이해하기Hooks 설정.. 2026. 7. 23.
Claude Code 슬래시 커맨드 만들기 — 자주 쓰는 프롬프트 저장법 Claude Code 입문Claude Code를 쓰다 보면 같은 프롬프트를 반복 입력하게 돼요. 슬래시 커맨드를 사용하면 자주 쓰는 프롬프트를 저장하고 단축키처럼 꺼내 쓸 수 있어요. 등록 방법부터 실전 예시, 관리 팁까지 한 번에 정리했어요.📌 3줄 요약반복되는 긴 프롬프트를 .claude/commands/ 폴더에 마크다운 파일로 저장하면 슬래시 커맨드가 자동 생성돼요.$ARGUMENTS 변수를 활용하면 하나의 커맨드로 다양한 파일·상황에 대응할 수 있어요.팀 프로젝트에서는 커맨드 폴더를 Git에 포함시켜 작업 방식을 통일할 수 있어요.📑 목차1. 같은 프롬프트를 반복 입력하는 문제2. 커스텀 슬래시 커맨드 등록 방법3. 실전에서 유용한 슬래시 커맨드 예시4. 슬래시 커맨드 관리와 주의할 점같은 프.. 2026. 7. 22.
서브에이전트 병렬 실행으로 조사 시간 절반 줄이기 Claude Code 활용법Claude Code의 서브에이전트를 병렬로 실행하면 조사 시간을 절반 이하로 줄일 수 있어요. 독립적인 작업 여러 개를 동시에 돌리는 방법과 실전 시나리오, 주의사항까지 정리했어요.📌 3줄 요약서브에이전트 병렬 실행은 독립적인 작업 여러 개를 동시에 처리해 대기 시간을 획기적으로 줄이는 방식이에요.하나의 메시지에 여러 Agent 호출을 넣으면 Claude Code가 자동으로 병렬 처리하며, 프롬프트에 "병렬"을 명시하는 것이 핵심이에요.작업 간 독립성 확인, 자기완결적 프롬프트, 읽기 전용 작업 위주 활용이 성공의 열쇠예요.🗂 목차1. 서브에이전트 병렬 실행이란 무엇인가2. Agent 도구로 병렬 서브에이전트 호출하는 방법3. 병렬 실행이 효과적인 실전 시나리오 3가지4... 2026. 7. 22.
SKILL.md 작성법 — Claude Code를 나만의 전문가로 만드는 방법 Claude Code 입문Claude Code를 쓰다 보면 매번 같은 지시를 반복하는 순간이 옵니다. "마크다운으로 정리해줘", "테스트 코드도 함께 작성해줘" 같은 요청을 매번 타이핑하는 건 비효율적이에요. 이 문제를 해결하는 기능이 바로 스킬(Skill)입니다. 한 번 만들어두면 슬래시 명령어 한 줄로 언제든 전문가 수준의 결과물을 뽑아낼 수 있어요.📌 3줄 요약스킬은 .claude/skills/ 폴더에 SKILL.md를 만들어 Claude Code에 전문 능력을 추가하는 기능이다.실행 조건·단계·references 폴더를 구성하면, 슬래시 명령어 하나로 일관된 결과물을 만들 수 있다..claude/ 폴더를 Git에 커밋하면 팀 전체가 동일한 기준으로 작업할 수 있다.📑 목차1. Skill이란 —.. 2026. 7. 22.
Claude Sonnet 5 달라진 점과 상위 모델 선택 기준 Claude Sonnet 5 업데이트, 무엇이 달라졌는지 확인하기2026년 7월, Anthropic이 Claude Sonnet 5를 출시했습니다. Claude Code를 쓰다 보면 어느 날 갑자기 응답 스타일이 달라졌다고 느끼는 경우가 있는데, 대부분 이런 모델 업데이트가 원인입니다.내가 지금 어떤 모델을 쓰고 있는지 모르면, 문제가 생겨도 원인을 좁히기 어렵습니다. 실제로 커뮤니티에서도 "어제까지 잘 되던 프롬프트가 갑자기 이상해졌다"는 질문이 모델 업데이트 시기마다 반복해서 올라오네요.이런 혼란을 줄이려면 업데이트 소식이 들릴 때마다 내 환경을 한 번씩 점검하는 습관이 필요합니다.가장 먼저 할 일은 현재 모델 확인입니다. Claude Code 실행 후 /model 명령어를 입력하면 현재 세션에서 사용.. 2026. 7. 21.
Claude Code MCP로 노션·구글 시트 연결하는 가장 쉬운 방법 MCP 서버 연결 전에 준비할 두 가지Claude Code는 기본적으로 내 컴퓨터 안의 파일만 다룰 수 있습니다. 노션이나 구글 시트 같은 외부 서비스와 대화하려면 MCP 서버(Model Context Protocol server)라는 연결 통로가 필요합니다.쉽게 말해 Claude Code와 외부 서비스 사이의 통역사라고 생각하면 됩니다. MCP는 Anthropic이 공개한 표준 규약이라서, 한 번 개념을 익혀 두면 노션이든 슬랙이든 깃허브든 같은 방식으로 연결할 수 있습니다.즉 오늘 배우는 내용은 두 서비스에만 쓰이는 것이 아니라 앞으로 만날 모든 외부 연결의 기본기가 됩니다.준비물은 딱 두 가지입니다. 첫째는 Node.js입니다.대부분의 MCP 서버가 npx 명령어로 실행되기 때문입니다. 터미널에 n.. 2026. 7. 21.
Claude Code 플랜 모드 사용법, 코드 수정 전 계획서 받는 법 Claude Code 입문Claude Code를 쓰다 보면 당황스러운 순간이 있습니다. 간단히 질문만 했는데, AI가 갑자기 파일을 수정해버리는 경우입니다. 이럴 때 필요한 것이 바로 코드를 고치기 전에 계획서부터 받아보는 플랜 모드(Plan Mode)입니다. 오늘은 플랜 모드가 왜 필요한지, 어떻게 켜고 활용하는지 차근차근 정리해봅니다.📌 3줄 요약1. 플랜 모드를 켜면 Claude Code는 코드를 한 줄도 수정하지 않고, 먼저 계획서부터 작성해서 보여줍니다.2. 입력창에서 Shift+Tab 두 번이면 켜지고, 계획서는 승인 전까지 몇 번이든 수정 요청할 수 있습니다.3. 되돌리기 어려운 작업일수록 플랜 모드, 오타 수정 같은 간단한 작업은 일반 모드로 골라 쓰는 것이 핵심입니다.🗂 목차1. 플랜.. 2026. 7. 21.
Claude Sonnet 5 달라진 점과 상위 모델 선택 기준 Claude Sonnet 5 업데이트, 무엇이 달라졌는지 확인하기2026년 7월, Anthropic이 Claude Sonnet 5를 출시했습니다. Claude Code를 쓰다 보면 어느 날 갑자기 응답 스타일이 달라졌다고 느끼는 경우가 있는데, 대부분 이런 모델 업데이트가 원인입니다. 내가 지금 어떤 모델을 쓰고 있는지 모르면, 문제가 생겨도 원인을 좁히기 어렵습니다. 실제로 커뮤니티에서도 "어제까지 잘 되던 프롬프트가 갑자기 이상해졌다"는 질문이 모델 업데이트 시기마다 반복해서 올라오네요. 이런 혼란을 줄이려면 업데이트 소식이 들릴 때마다 내 환경을 한 번씩 점검하는 습관이 필요합니다.가장 먼저 할 일은 현재 모델 확인입니다. Claude Code 실행 후 /model 명령어를 입력하면 현재 세션에서 .. 2026. 7. 21.
Claude Code 메모리 기능, AI가 내 프로젝트를 기억하게 만드는 법 Claude Code 입문어제 분명히 설명했던 내용을 오늘 새 대화에서는 전혀 기억하지 못하는 Claude Code, 답답하셨죠? 이번 글에서는 AI가 내 프로젝트를 계속 기억하게 만드는 메모리 기능을 처음부터 끝까지 정리합니다. CLAUDE.md 파일 만들기부터 # 단축키, 메모리 관리 요령까지 순서대로 따라가 보겠습니다.📌 3줄 요약1. AI는 대화가 끝나면 모든 내용을 잊어버리므로, CLAUDE.md 파일에 규칙을 적어두면 새 대화마다 자동으로 읽고 시작합니다.2. 대화 중 문장 맨 앞에 # 기호만 붙이면 그 자리에서 바로 메모리에 저장할 수 있습니다.3. /memory 명령어로 주기적으로 확인하고 낡은 정보를 지워야 메모리가 제 역할을 합니다.목차1. Claude Code 메모리 기능이 필요한 .. 2026. 7. 21.

티스토리툴바