AI 툴 문제 해결41 CLAUDE.md 작성법: AI가 프로젝트 규칙을 무시할 때 Claude Code 입문 Claude Code에 같은 프로젝트를 열고 매번 같은 지시를 반복하고 있다면, CLAUDE.md 파일 하나로 해결할 수 있습니다. 규칙 파일을 만들어두면 AI가 매 세션마다 자동으로 읽어서 일관된 결과물을 만들어냅니다. 📌 3줄 요약 • 대화창에 입력한 규칙은 대화가 길어지면 컨텍스트에서 밀려나 유실됩니다. • CLAUDE.md 파일에 규칙을 적어두면 매 세션마다 자동 로드되어 일관성이 유지됩니다. • 규칙은 20개 이내로 짧고 명확하게, 목록 형태로 작성하는 것이 핵심입니다. 📑 목차 1. CLAUDE.md 없이 작업하면 반복되는 문제 2. CLAUDE.md의 역할과 동작 원리 3. CLAUDE.md .. 2026. 8. 6. Claude Code MCP 서버 연결 오류 해결법 트러블슈팅 MCP 서버를 처음 연결하다 보면 설정 파일 오타, 경로 오류, 실행 환경 불일치 같은 문제로 막히기 쉬워요.이 글에서는 대표적인 연결 실패 원인과 에러별 대응법, 그리고 연결 성공 후 확인해야 할 사항까지 한번에 정리합니다. 📌 3줄 요약 MCP 서버 연결 실패의 대부분은 설정 파일 경로 오류와 실행 환경 불일치가 원인이에요. 설정 파일 점검 체크리스트 4단계와 에러 메시지별 대응법을 알면 빠르게 해결할 수 있어요. 연결 성공 후에는 /tools로 도구 목록을 확인하고, 프로젝트별로 서버를 분리 관리하는 것이 핵심이에요. 🗂️ 목차 MCP 서버 연결이 안 되는 대표 원인 설정 파일 점검 체크리스트 서버 실행 오류별 대응.. 2026. 8. 4. 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 위험 명령어 PreToolUse 훅으로 차단하기 Claude Code 활용법Claude Code가 도구를 실행하기 직전, 위험한 명령을 자동으로 걸러주는 PreToolUse 훅의 동작 원리부터 설정 방법, 실전 활용 팁까지 단계별로 정리합니다.📌 3줄 요약PreToolUse 훅은 Claude Code가 도구를 실행하기 직전에 사용자 스크립트를 먼저 실행하여 위험한 명령을 자동 차단하는 기능이다.settings.json에 matcher와 command를 등록하면 특정 도구에만 훅을 적용할 수 있다.차단 스크립트를 작성하면 rm -rf / 같은 위험 명령과 저장소 밖 파일 쓰기를 자동으로 막을 수 있다.🗂 목차PreToolUse 훅이 필요한 상황과 동작 원리settings.json에 PreToolUse 훅 등록하는 법위험 명령과 저장소 밖 쓰기를 차단.. 2026. 7. 25. Claude Code 메모리 기능으로 프로젝트 맥락 기억시키는 법 Claude Code 입문Claude Code를 쓸 때마다 같은 맥락을 반복 설명하고 계신가요?메모리 기능을 한번만 설정해두면, 매 세션마다 프로젝트 배경을 자동으로 불러올 수 있습니다.📌 3줄 요약LLM은 세션이 끝나면 대화 내용을 잊어버리므로, 매번 맥락을 반복 설명해야 하는 문제가 있습니다.CLAUDE.md 파일로 프로젝트 단위 맥락을, 자동 메모리로 개인 취향을 각각 저장할 수 있습니다.메모리가 작동하지 않을 때는 파일 위치·분량·충돌 여부를 순서대로 점검하면 대부분 해결됩니다.🗂️ 목차1. 대화가 끝나면 다 잊어버리는 문제2. CLAUDE.md 파일로 프로젝트 맥락 저장하기3. 자동 메모리로 개인 취향 기억시키기4. 메모리가 제대로 작동하지 않을 때 점검법대화가 끝나면 다 잊어버리는 문제Cl.. 2026. 7. 23. 이전 1 2 3 4 5 6 7 다음
