claude 실행했는데 Unable to connect to API (ETIMEDOUT)이나 fetch failed만 뜨고 아무것도 안 되는 상황, 회사 네트워크에서 특히 자주 겪습니다. 근데 이 에러 하나에 원인이 최소 서너 가지 섞여 있어서, 검색해서 나오는 해결법을 그대로 따라 해도 안 먹히는 경우가 많아요. 이 글은 Claude Code 공식 에러 레퍼런스와 네트워크 설정 문서를 기준으로, 실제로 자주 나오는 원인부터 순서대로 짚어봅니다. 마지막에는 드물지만 실제 보고된 QUIC 차단 케이스도 다룹니다. Claude Code API 연결 안 될 때, 뭐부터 봐야 할까공식 문서(code.claude.com/docs/en/errors)는 이 계열 에러의 원인을 "보통 로컬 네트워크, 프록시, 방화벽,..

Claude Code에서 sandbox.enabled: true만 켜두면 자격증명이 자동으로 보호될 거라고 생각하기 쉬운데, 사실 그렇지 않습니다. 샌드박스의 기본 읽기 정책은 "일부 디렉터리만 빼고 컴퓨터 전체를 읽을 수 있게 허용"하는 쪽으로 설계돼 있어서, ~/.aws/credentials나 ~/.ssh 같은 자격증명 파일은 손대지 않으면 그대로 노출됩니다. 이 글에서는 왜 이런 구조인지, 실제로 어떤 위험으로 이어질 수 있는지, 그리고 sandbox.credentials로 정확히 어떻게 막는지 정리했습니다. 샌드박스를 켜도 자격증명이 뚫려 있는 이유Claude Code의 Bash 샌드박스는 매번 승인을 묻지 않고도 명령을 실행할 수 있게 해주는 격리 환경입니다. macOS는 Seatbelt, Li..

Claude Code로 작업하다가 갑자기 "Autocompact is thrashing"이라는 경고가 뜨면서 대화가 멈춘 적 있으신가요? 몇 턴 지나면 또 뜨고, /clear를 눌러도 다시 뜨고 — 작업 흐름이 뚝뚝 끊기니 답답할 수밖에 없습니다. 이 오류는 정확히 어떤 상황에서 발생하고, 왜 반복되는지, GitHub 이슈와 공식 문서를 근거로 정리했습니다.Claude Code 터미널에 "Autocompact is thrashing" 경고 배너가 뜬 화면 "Autocompact is thrashing" 에러 메시지, 정확히 뭐라고 뜨나에러 메시지 원문은 이래요."Autocompact is thrashing: the context refilled to the limit within 3 turns of th..

결론부터 말씀드리면, 2026년 7월 9일 현재 Claude의 피크 시간 사용량 제한은 적용되지 않습니다. "요즘 왜 이렇게 한도가 빨리 닳지" 싶어서 검색하셨다면, 그 문제의 원인이었던 정책은 이미 5월 초에 폐지됐어요. 다만 이 정책이 왜 생겼고 왜 없어졌는지, 그리고 폐지 발표문에 "다시는 안 한다"는 확언은 없다는 점까지 알아두면 앞으로 비슷한 이슈가 또 생겼을 때 헷갈리지 않습니다. 오늘은 이 짧고 굵었던 정책의 타임라인과, 한국 시간으로는 정확히 몇 시였는지를 정리해봤습니다.Claude 피크 시간 사용량 제한 도입부터 폐지까지 타임라인 인포그래픽 피크 시간 사용량 제한이란 무엇이었나Anthropic 엔지니어 Thariq Shihipar가 2026년 3월 26일 X(트위터)에서 직접 밝힌 내용이..

Claude Code를 업데이트했더니 갑자기 명령 하나하나마다 승인을 물어보고, 설정 어딘가에 "Manual"이라는 낯선 모드 이름이 떠 있다면 — 지금 검색해서 들어오신 이유가 바로 그거일 겁니다. 2026년 7월 3일 릴리스된 v2.1.200 이후 커뮤니티에서 가장 많이 나오는 질문이에요. 근데 검색해 보면 "기본값이 Auto에서 Manual로 바뀌었다"는 글과 "아무것도 안 바뀌었다"는 글이 섞여 있어서 더 헷갈립니다.이 글에서 그 사실 관계를 공식 릴리스 노트 기준으로 정확히 가르고, Auto 모드로 되돌리는 설정까지 순서대로 정리합니다.Claude Code 터미널에서 권한 승인 프롬프트가 반복해서 뜨는 화면 스크린샷 v2.1.200에서 실제로 바뀐 것은 딱 두 가지GitHub 릴리스 노트 원문 ..

"어제까지 잘 쓰던 코파일럿인데 오늘 갑자기 채팅이 막혔다" — 요즘 GitHub 커뮤니티에 이런 글이 부쩍 늘었어요. 2026년 6월 1일부로 GitHub Copilot이 정액제에서 사용량 기반 AI Credits 과금으로 바뀌면서 생긴 일입니다. 근데 문제는 크레딧이 예상보다 훨씬 빨리 사라진다는 거예요. 대체 왜 이렇게 빨리 줄어드는 걸까요? 크레딧이 바닥났을 때 뭘 할 수 있는지까지 실전 대처법으로 정리해봤습니다.GitHub Copilot AI Credits 요금 폭탄을 상징하는 대표 이미지 AI Credits 과금, 대체 뭐가 바뀐 건가핵심만 말하면 이렇습니다. 예전엔 한 달에 프리미엄 요청 몇 번, 이런 식으로 횟수를 세는 구조였는데, 이제는 실제로 사용한 토큰량만큼 크레딧을 깎아요. 1 AI..

npm install -g @anthropic-ai/claude-code를 돌렸는데 EACCES: permission denied, mkdir '/usr/local/lib/node_modules/@anthropic-ai' 같은 에러 로그만 뜨고 멈춘 적 있으신가요? 이거, 검색해보면 십중팔구 "sudo 붙여서 설치하세요"라는 답이 먼저 나오는데 그게 진짜 근본 해결책은 아닙니다. npm이 root 소유 디렉터리에 파일을 쓰려다 막히는 게 원인이라서, sudo는 증상만 잠깐 가리는 처방이거든요. EACCES가 왜 나는지, OS별로 왜 다르게 대응해야 하는지, 그리고 Anthropic이 공식적으로 권장하는 우회 방법은 뭔지 아래서 하나씩 확인해보세요.터미널에 표시된 npm EACCES permission d..

"클로드도 이제 종량제로 바뀐다더라", "쓴 만큼 낸다는데 비용 폭탄 아니냐" — 요즘 이런 얘기 한 번쯤 들어보셨을 겁니다. 근데 이 뉴스, 절반만 맞고 절반은 좀 다르게 알려져 있어요. 종량제로 바뀐 건 맞는데, 그 대상이 여러분이 매달 $20 내는 Claude Pro가 아닐 수도 있거든요. 이 글에서는 실제로 뭐가 바뀌었고 누가 영향을 받는지, 그리고 개인·소규모 개발자가 진짜 신경 써야 할 부분이 뭔지 정리해봤습니다.Claude 요금제 구조 - Enterprise 종량제 vs Pro/Max 정액제 비교 다이어그램 "무제한 AI 시대 끝났다"는 종량제 전환 뉴스, 정확히 뭐가 바뀐 걸까2026년 4월 중순 보도된 내용을 보면, Anthropic이 요금 체계를 바꾼 건 사실입니다. 다만 대상이 명확해..

"HWP-MCP 깔았는데 왜 한글 프로그램이 없다고 에러가 나지?" 혹은 반대로 "한글 프로그램도 없는데 이게 왜 돼?" — HWP-MCP를 검색해서 들어온 분이라면 둘 중 하나의 궁금증을 안고 왔을 겁니다. 결론부터 말하면 둘 다 맞는 말입니다. HWP-MCP라는 이름을 쓰는 프로젝트가 GitHub에 여러 개 있고, 그중 어떤 걸 설치했느냐에 따라 답이 정반대로 갈리거든요. 이 글에서는 어떤 프로젝트가 있는지, 내 상황(한컴오피스 있음/없음, OS)에 맞는 선택지가 뭔지 정리해봤습니다.Claude Desktop 설정 화면에 HWP-MCP 서버가 등록된 모습 HWP-MCP, 사실 하나가 아니다저도 처음엔 "HWP-MCP"를 검색하면 나오는 첫 번째 저장소만 보고 "아, 이거구나" 했는데, 알고 보니 Gi..

Claude Code로 코드를 고치다가 갑자기 파일이 엉뚱하게 바뀐 경험, 한 번쯤 있으실 거예요. 저도 처음엔 그냥 프롬프트만 잘 쓰면 되는 줄 알았는데, 여러 파일에 걸친 작업을 시킬 때마다 결과물이 매번 달라지는 걸 보고 나서야 Plan Mode를 진지하게 들여다봤습니다. Claude Code Plan Mode는 Claude가 파일을 고치기 전에 먼저 계획만 세우게 만드는 권한 모드인데, 언제 켜고 언제 꺼야 하는지 감이 안 잡히면 오히려 작업 속도만 늦출 수 있어요. 이 글에서는 진입 방법부터 승인 흐름, 실전 판단 기준, 그리고 실제 써보면서 걸리는 버그까지 정리했습니다.Claude Code 터미널에서 Shift+Tab으로 Plan Mode 전환 화면 Claude Code Plan Mode란 무..