본문 바로가기

분류 전체보기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.

티스토리툴바