claudecode45 Claude Code /doctor로 설정 문제 한 번에 진단하기 Claude Code 입문Claude Code를 설치했는데 뭔가 안 돼요. 에러 메시지를 검색해봐도 답이 안 나와요. 이럴 때 /doctor 명령어 하나면 30초 안에 원인을 찾을 수 있어요.📌 3줄 요약/doctor는 Claude Code 환경 전체(Node.js·API 키·네트워크)를 자동으로 진단해주는 내장 명령어예요.초록색 ✓ / 빨간색 ✗ 표시로 문제 항목을 직관적으로 파악하고, 해결 방향까지 안내받을 수 있어요./doctor로 해결이 안 되면 캐시 초기화 → 재설치 → GitHub Issues 순서로 대응하면 돼요.🗂️ 목차1. /doctor 명령어가 하는 일2. /doctor 실행 방법과 출력 결과 읽기3. 자주 나오는 진단 항목별 해결법4. /doctor로 해결되지 않을 때 다음 단계/.. 2026. 8. 10. WSL에서 Claude Code 실행 안 될 때 해결법 트러블슈팅 WSL에서 Claude Code 설치가 안 된다면, Node.js 버전·npm 권한·네트워크·WSL 설정 네 가지를 순서대로 점검해보세요. 대부분 10분 안에 해결됩니다. 📌 3줄 요약 WSL에서 Claude Code 설치 실패는 Node.js 미설치/구버전, npm 권한, 네트워크 차단, WSL 설정 네 가지 원인이 대부분입니다. nvm으로 Node.js 18 이상을 설치하고, npm 글로벌 경로를 사용자 디렉토리로 변경하면 권한 문제까지 한 번에 해결됩니다. WSL 2 + 리눅스 홈 디렉토리 조합이 가장 안정적인 실행 환경입니다. 📑 목차 1. WSL 환경에서 Claude Code가 안 되는 이유 2. Node.js 버전과.. 2026. 8. 10. Claude Code 서브에이전트 역할 충돌 문제 해결법 Claude Code 활용법 Claude Code에서 서브에이전트를 여러 개 운영할 때 가장 먼저 부딪히는 문제, 역할 충돌.프롬프트 분리부터 데이터 전달 설계까지, 에이전트 팀을 안정적으로 굴리는 실전 해결법을 정리했습니다. 📌 3줄 요약 서브에이전트 역할 충돌은 프롬프트에 역할 경계를 명시하지 않아서 발생한다. 에이전트별 프롬프트를 별도 파일로 분리하고, 중간 산출물의 파일 경로와 JSON 스키마를 사전 고정하면 대부분 해결된다. 모든 서브에이전트 호출은 반드시 오케스트레이터를 거치는 순차 구조가 가장 안정적이다. 📑 목차 1. 서브에이전트 역할이 겹치는 원인 파악하기 2. 에이전트별 프롬프트 분리로 충돌 방지하기 3. 서브에이.. 2026. 8. 10. Claude Code 스킬 작성부터 재사용까지 문제 해결법 Claude Code 실전 트러블슈팅 Claude Code에서 만든 스킬이 호출해도 반응이 없다면, 기능이 아니라 파일 구조 문제일 확률이 높습니다. 디렉토리 배치, 프롬프트 작성법, 재사용 설정, 디버깅 팁까지 스킬 관련 문제를 한 번에 정리합니다. 📌 3줄 요약 스킬은 .claude/skills/스킬이름/skill.md 경로를 정확히 지켜야 인식됩니다. 프롬프트가 길면 뒷부분 규칙이 무시되므로 핵심 5~7개 이내로 유지하고, 나머지는 references/로 분리하세요. 여러 프로젝트에서 재사용하려면 절대 경로를 제거하고, 글로벌 스킬과 프로젝트 스킬의 이름 충돌을 점검하세요. 📑 목차 1. 스킬 파일 구조를 잘못 만들면 인식되지 않습니다.. 2026. 8. 9. Claude Code 블로그 자동화 파이프라인 오류 해결법 트러블슈팅 Claude Code로 블로그 글을 자동 생성하는 파이프라인을 구축하면서 실제로 부딪힌 오류들과 해결법을 단계별로 정리했습니다. 데이터 전달 구조부터 이미지 경로, 인코딩, 디버깅 전략까지 실전 경험을 담았습니다. 📌 3줄 요약 파이프라인 단계 간 JSON 키 불일치와 경로 오류가 가장 흔한 구조 문제이며, 입출력 스키마 문서화와 pathlib 사용으로 예방할 수 있습니다. 서브에이전트 호출 시 타임아웃 설정과 text=True 옵션 누락이 실패의 80% 이상을 차지합니다. 중간 산출물 파일 저장, 로그 기록, 글 단위 예외 처리로 파이프라인 전체 안정성을 확보할 수 있습니다. 📑 목차 파이프라인 설계 단계에서 먼저 부딪히는 구조 .. 2026. 8. 6. 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. 이전 1 2 3 4 5 ··· 8 다음
