본문 바로가기

전체 글86

CLAUDE.md로 프로젝트 규칙을 AI에게 가르치는 법 Claude Code 입문Claude Code에 우리 프로젝트 규칙을 알려주는 가장 쉬운 방법, CLAUDE.md 파일 하나면 충분해요.📌 3줄 요약CLAUDE.md는 프로젝트 규칙을 Claude Code에 자동으로 전달하는 설정 파일이에요.코딩 스타일·금지 사항·폴더 구조·커밋 규칙·명령어, 이 5가지만 넣어도 작업 품질이 확 달라져요.프로젝트 루트에 두면 전체 적용, 하위 폴더에 두면 영역별 적용이 가능해요.📑 목차1. CLAUDE.md가 필요한 이유2. CLAUDE.md 파일 만들기와 기본 구조3. CLAUDE.md에 담으면 좋은 규칙 5가지4. CLAUDE.md 적용 확인과 관리 요령CLAUDE.md가 필요한 이유Claude Code는 똑똑하지만, 우리 프로젝트만의 규칙까지 알지는 못해요. 변.. 2026. 8. 2.
Claude Code 스킬이란? 반복 작업을 묶는 개념 정리 Claude Code 입문Claude Code의 스킬(Skill)은 반복 작업을 하나의 명령으로 묶어 재사용할 수 있게 해주는 핵심 기능이에요. 스킬의 개념부터 폴더 구성, 다른 자동화 방식과의 차이까지 한 번에 정리해 드릴게요.📌 3줄 요약스킬은 반복 작업을 슬래시 명령 하나로 실행할 수 있게 패키징한 것프롬프트 파일(지시서) + 참조 파일(규칙)로 구성되어 유지보수가 쉬움훅·에이전트와 달리 사용자가 직접 호출하는 방식이라 입문자에게 가장 적합📑 목차스킬(Skill)의 정의와 필요한 이유스킬이 반복 작업을 처리하는 원리간단한 스킬 폴더 구성 예시스킬과 다른 자동화 방식의 차이점스킬(Skill)의 정의와 필요한 이유Claude Code에서 스킬(Skill)이란, 자주 반복하는 작업 절차를 하나의 명령.. 2026. 8. 2.
CLAUDE.md 프로젝트 규칙 설정으로 AI 헛발질 줄이는 법 Claude Code 입문Claude Code가 엉뚱한 파일을 수정하고, 안 쓰는 라이브러리를 설치하고, 관련 없는 코드를 리팩토링하는 문제를 겪고 계신가요?CLAUDE.md 파일 하나면 이런 "AI 헛발질"을 대폭 줄일 수 있습니다.📌 3줄 요약CLAUDE.md는 AI에게 프로젝트 맥락을 알려주는 온보딩 문서 역할을 한다기술 스택, 금지 사항, 디렉토리 구조를 적으면 AI의 엉뚱한 행동이 크게 줄어든다처음부터 완벽하게 쓰지 말고, AI가 실수할 때마다 규칙을 하나씩 추가하는 방식이 가장 효과적이다🗂️ 목차CLAUDE.md 없이 작업하면 생기는 문제들CLAUDE.md 핵심 규칙 작성법실전 CLAUDE.md 템플릿 적용하기CLAUDE.md 적용 후 달라지는 점CLAUDE.md 없이 작업하면 생기는 문제.. 2026. 8. 2.
Claude Code에서 Opus 모델로 장시간 에이전트 작업이 끊길 때 해결법 트러블슈팅Claude Code에서 Opus 모델로 장시간 에이전트 작업을 돌리다가 갑자기 끊긴 적 있으신가요? 컨텍스트 초과, 타임아웃, 토큰 폭증까지 — 원인별 해결법과 실패 시 복구 방법을 정리했습니다.📌 3줄 요약장시간 작업 실패의 3대 원인은 컨텍스트 윈도우 초과, 네트워크 타임아웃, 토큰 사용량 폭증입니다.작업을 3~5단계로 분할하고, 중간중간 /compact 명령으로 컨텍스트를 압축하면 성공률이 크게 올라갑니다.실패 시 claude --resume으로 세션을 이어가고, git stash로 중간 결과를 보존할 수 있습니다.📑 목차1. Opus 모델로 장시간 작업이 실패하는 이유2. 타임아웃 설정과 모델 선택 확인하기3. 작업을 쪼개서 안정적으로 실행하는 방법4. 장시간 작업 실패 시 복구하는.. 2026. 8. 2.
Claude Code 모델 선택 가이드: Opus vs Sonnet vs Haiku 비교 Claude Code 입문 Claude Code를 처음 설치하면 기본 모델이 자동으로 설정됩니다. 그래서 많은 분이 모델을 바꿀 수 있다는 사실 자체를 모르고 지나칩니다. Opus, Sonnet, Haiku — 세 모델의 차이와 전환 방법을 정리했습니다. 📌 3줄 요약 Claude Code에서 Opus 4.6, Sonnet 4.6, Haiku 4.5 세 모델을 자유롭게 전환할 수 있다. Sonnet을 기본으로 쓰고, 어려운 작업에만 Opus를 꺼내는 전략이 비용 대비 만족도가 가장 높다. 대화 중 /model 명령어 한 줄이면 즉시 전환되고, 대화 맥락도 그대로 유지된다. 🗂️ 목차 1. Claude Code에서 모델을 고를 수 있다는 사실 .. 2026. 7. 29.
Claude Code 플러그인으로 팀에 스킬 한 번에 배포하는 법 팀 협업 & 자동화 Claude Code 스킬을 혼자만 쓰기엔 아깝습니다. 플러그인으로 묶어서 팀 전체에 한 줄 명령으로 배포하는 방법을 처음부터 끝까지 정리했습니다. 📌 3줄 요약 스킬·서브에이전트를 plugin.json으로 패키징하면 팀원이 한 줄로 설치할 수 있다 Git 저장소에 포함하면 git pull 한 번으로 최신 플러그인이 자동 배포된다 시맨틱 버저닝과 CHANGELOG로 버전을 관리하면 팀 전체 AI 작업 품질이 일정해진다 📑 목차 1. 스킬을 팀에 공유해야 하는 이유 2. 플러그인 디렉토리 구조 만들기 3. Git 저장소로 팀에 플러그인 배포하기 4. 플러그인 업데이트와 버전 관리 전략 스킬을 팀에 .. 2026. 7. 29.
Claude Code로 블로그 자동 발행 파이프라인 만드는 법 에이전트 실전 자동화블로그 글감 찾기부터 초안 작성, 발행까지 반복되는 작업을 Claude Code 파이프라인으로 자동화하는 방법을 단계별로 알려드릴게요. 비개발자도 폴더 하나, 파일 하나로 시작할 수 있어요.📌 3줄 요약블로그 반복 작업(글감·초안·검토·저장)을 파이프라인으로 연결하면 글 1편당 소요 시간이 1시간 → 10분으로 줄어요.CLAUDE.md 파일에 워크플로우를 적어두면, Claude Code가 알아서 순서대로 처리해요.세션 요약 파일로 중복 주제를 방지하고, 작업 스케줄러로 매일 자동 실행까지 가능해요.📑 목차1. 블로그 자동화 파이프라인이 필요한 이유2. 파이프라인 폴더 구조와 CLAUDE.md 설정3. 단계별 자동화 명령 실행 흐름4. 반복 실행과 세션 요약으로 파이프라인 완성하기블.. 2026. 7. 27.
Claude Code Fast 모드로 응답 속도 2배 높이는 법 Claude Code 입문Claude Code를 쓸 때 응답 대기 시간이 아깝다고 느낀 적 있으신가요? Fast 모드 하나면 동일한 Opus 모델을 유지하면서 응답 속도를 2배 이상 끌어올릴 수 있습니다. 켜는 법부터 실전 활용 전략까지, 직접 써보고 정리했습니다.📌 3줄 요약Fast 모드는 같은 Opus 모델을 그대로 쓰면서 출력 속도만 높여주는 기능입니다.대화창에 /fast만 입력하면 즉시 전환되고, 다시 입력하면 일반 모드로 돌아옵니다.정형화된 작업은 Fast 모드, 깊은 사고가 필요한 작업은 일반 모드로 구분하면 시간 대비 효율이 크게 올라갑니다.📑 목차Fast 모드가 필요한 순간Fast 모드 켜는 방법과 설정Fast 모드 응답 속도 실제 비교Fast 모드를 활용한 실전 비용 절약 전략Fast.. 2026. 7. 25.
Claude Code 위험 명령어 PreToolUse 훅으로 차단하기 Claude Code 활용법Claude Code가 도구를 실행하기 직전, 위험한 명령을 자동으로 걸러주는 PreToolUse 훅의 동작 원리부터 설정 방법, 실전 활용 팁까지 단계별로 정리합니다.📌 3줄 요약PreToolUse 훅은 Claude Code가 도구를 실행하기 직전에 사용자 스크립트를 먼저 실행하여 위험한 명령을 자동 차단하는 기능이다.settings.json에 matcher와 command를 등록하면 특정 도구에만 훅을 적용할 수 있다.차단 스크립트를 작성하면 rm -rf / 같은 위험 명령과 저장소 밖 파일 쓰기를 자동으로 막을 수 있다.🗂 목차PreToolUse 훅이 필요한 상황과 동작 원리settings.json에 PreToolUse 훅 등록하는 법위험 명령과 저장소 밖 쓰기를 차단.. 2026. 7. 25.

티스토리툴바