트러블슈팅5 Claude Code가 수정된 파일을 못 읽을 때 해결법 트러블슈팅 Claude Code에서 파일을 분명히 수정했는데, 수정 전 내용을 기준으로 답변하는 경험을 한 적 있나요? 이 글에서는 이 현상이 발생하는 원인과 확실한 해결법 3가지를 알려드립니다. 📌 3줄 요약 Claude Code는 파일을 매번 자동으로 다시 읽지 않아서, 외부 수정 시 옛날 내용을 참조할 수 있다 "파일 다시 읽어줘" 요청 또는 /clear 명령으로 최신 상태를 반영할 수 있다 Claude Code 안에서 직접 수정하면 이 문제가 아예 발생하지 않는다 📑 목차 1. 파일을 고쳤는데 옛날 내용을 참조하는 이유 2. Read 도구로 파일을 다시 읽게 만드는 방법 3. 컨텍스트 초기화로 최신 상태 반.. 2026. 8. 12. 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. Claude Code 블로그 자동화 파이프라인 오류 해결법 트러블슈팅 Claude Code로 블로그 글을 자동 생성하는 파이프라인을 구축하면서 실제로 부딪힌 오류들과 해결법을 단계별로 정리했습니다. 데이터 전달 구조부터 이미지 경로, 인코딩, 디버깅 전략까지 실전 경험을 담았습니다. 📌 3줄 요약 파이프라인 단계 간 JSON 키 불일치와 경로 오류가 가장 흔한 구조 문제이며, 입출력 스키마 문서화와 pathlib 사용으로 예방할 수 있습니다. 서브에이전트 호출 시 타임아웃 설정과 text=True 옵션 누락이 실패의 80% 이상을 차지합니다. 중간 산출물 파일 저장, 로그 기록, 글 단위 예외 처리로 파이프라인 전체 안정성을 확보할 수 있습니다. 📑 목차 파이프라인 설계 단계에서 먼저 부딪히는 구조 .. 2026. 8. 6. Claude Code MCP 서버 연결 오류 해결법 트러블슈팅 MCP 서버를 처음 연결하다 보면 설정 파일 오타, 경로 오류, 실행 환경 불일치 같은 문제로 막히기 쉬워요.이 글에서는 대표적인 연결 실패 원인과 에러별 대응법, 그리고 연결 성공 후 확인해야 할 사항까지 한번에 정리합니다. 📌 3줄 요약 MCP 서버 연결 실패의 대부분은 설정 파일 경로 오류와 실행 환경 불일치가 원인이에요. 설정 파일 점검 체크리스트 4단계와 에러 메시지별 대응법을 알면 빠르게 해결할 수 있어요. 연결 성공 후에는 /tools로 도구 목록을 확인하고, 프로젝트별로 서버를 분리 관리하는 것이 핵심이에요. 🗂️ 목차 MCP 서버 연결이 안 되는 대표 원인 설정 파일 점검 체크리스트 서버 실행 오류별 대응.. 2026. 8. 4. Claude Code에서 Opus 모델로 장시간 에이전트 작업이 끊길 때 해결법 트러블슈팅Claude Code에서 Opus 모델로 장시간 에이전트 작업을 돌리다가 갑자기 끊긴 적 있으신가요? 컨텍스트 초과, 타임아웃, 토큰 폭증까지 — 원인별 해결법과 실패 시 복구 방법을 정리했습니다.📌 3줄 요약장시간 작업 실패의 3대 원인은 컨텍스트 윈도우 초과, 네트워크 타임아웃, 토큰 사용량 폭증입니다.작업을 3~5단계로 분할하고, 중간중간 /compact 명령으로 컨텍스트를 압축하면 성공률이 크게 올라갑니다.실패 시 claude --resume으로 세션을 이어가고, git stash로 중간 결과를 보존할 수 있습니다.📑 목차1. Opus 모델로 장시간 작업이 실패하는 이유2. 타임아웃 설정과 모델 선택 확인하기3. 작업을 쪼개서 안정적으로 실행하는 방법4. 장시간 작업 실패 시 복구하는.. 2026. 8. 2. 이전 1 다음
