Claude Code가 느릴 때는 네트워크, 컨텍스트 크기, 모델 선택, 도구 설정 순으로 점검하면 일부 환경에서는 해결됩니다. 재설치 전에 확인할 7가지 체크포인트를 순서대로 정리했습니다.
Claude Code 응답이 느려질 때는 일부 환경에서는 도구 자체보다 주변 환경에서 원인이 나옵니다. 재설치나 초기화로 시간을 낭비하기 전에, 원인을 좁혀 나가는 7단계 점검 순서를 정리했습니다.
같은 프롬프트인데 어제는 5초, 오늘은 40초가 걸린 경험이 있다면 원인은 보통 몇 가지로 좁혀집니다. 네트워크, 부풀어 오른 컨텍스트, 잘못된 모델 선택, 자동 실행되는 도구들입니다.
먼저 알아둘 게 하나 있습니다. Claude Code는 Anthropic이 만든 명령줄 기반 AI 코딩 도구입니다(터미널이라는 검은 화면에서 명령어로 조작하는 프로그램). 웹 채팅과 달리 파일을 읽고 명령을 실행하기 때문에, 느려지는 지점이 챗봇보다 훨씬 다양합니다.
느려짐을 판단하기 전에 확인할 것
체감상 느리다고 느껴지는 순간에도, 실제 원인은 세 가지 층으로 나뉩니다. 네트워크 지연, 모델 응답 시간, 로컬 처리(파일 읽기·명령 실행) 입니다.
세 가지가 섞이면 "그냥 느리다"가 되지만, 나눠 보면 해결법이 완전히 달라집니다.
| 증상 | 의심 층 | 먼저 볼 곳 |
|---|---|---|
| 첫 응답이 나오기까지 오래 걸림 | 네트워크·인증 | 인터넷, VPN, 프록시 |
| 응답이 나오다 중간에 멈춤 | 모델·컨텍스트 | 대화 길이, 모델 선택 |
| 파일 읽거나 명령 실행에서 지체 | 로컬 처리 | 프로젝트 크기, 도구 설정 |
이 표를 옆에 두고, 아래 순서대로 하나씩 점검해 나가면 됩니다.
1. 버전이 최신인지부터 본다
가장 먼저 볼 것은 Claude Code CLI 버전입니다. 오래된 버전은 응답 스트리밍이나 캐싱 처리가 개선되기 전 상태일 수 있습니다.
글 작성 시점 기준 최신 버전은 2.1.220입니다(npm 공식 패키지 페이지 기준). 아래 명령으로 현재 버전을 확인합니다.
claude --version이 명령은 지금 설치된 Claude Code의 버전 번호를 출력합니다. 숫자가 위와 크게 차이 난다면 업데이트를 먼저 해봅니다.
npm update -g @anthropic-ai/claude-code여기서 npm은 Node.js 프로그램을 설치·관리하는 도구고, -g는 컴퓨터 전체에서 쓸 수 있게 전역 설치한다는 뜻입니다.
💡 업데이트만으로 체감 속도가 달라지는 경우가 꽤 있습니다. 다른 설정을 만지기 전에 이걸 먼저 해두면 뒤 단계 진단이 정확해집니다.
2. 네트워크와 인증 경로를 확인한다
Claude Code는 로컬에서 돌지 않습니다. 매 요청마다 Anthropic 서버와 통신하기 때문에, 네트워크가 느리면 환경에 따라 느립니다.
특히 다음 경우 응답이 눈에 띄게 지연됩니다.
- 회사·학교 네트워크에서 프록시(중간 서버)를 강제로 거치는 경우
- VPN을 켜둔 채로 우회 경로를 타는 경우
- Wi-Fi 신호가 약해 재전송이 반복되는 경우
- DNS 응답이 느린 공용 네트워크
간단한 확인법은 웹 브라우저에서 claude.ai에 접속해 페이지 로딩 속도를 보는 것입니다. 브라우저도 느리다면 원인은 Claude Code가 아니라 네트워크 쪽입니다.
카페에서 작업하는 프리랜서라면, VPN을 잠깐 꺼보고 다시 시도해보는 것만으로 응답 속도가 정상으로 돌아오는 경우가 많습니다.
3. 컨텍스트가 부풀어 있진 않은지 본다
같은 세션에서 대화를 오래 이어가면 컨텍스트(대화 기록 전체) 가 계속 커집니다. 컨텍스트가 커질수록 매 요청마다 처리해야 할 정보량이 늘고, 응답 시작까지 걸리는 시간도 길어집니다.
비유하자면, 매 질문마다 지금까지의 대화록 전체를 다시 훑어보고 답하는 것과 비슷합니다. 대화가 100줄일 때와 5,000줄일 때가 같을 수 없죠.
세션이 오래됐다 싶으면 다음을 시도해봅니다.
- ☐현재 작업과 상관없는 이전 대화는
/clear명령으로 컨텍스트 초기화 - ☐큰 파일을 통째로 붙여넣는 대신, 필요한 함수·구간만 추려서 전달
- ☐새 작업을 시작할 때는 새 세션을 열기
[긴 세션] 질문1 → 답변1 질문2 → 답변2 (앞 내용 다 참조) 질문3 → 답변3 (앞 내용 다 참조) ↓ 컨텍스트 계속 누적 [분리한 세션] 새 세션 → 필요한 것만 ↓ 가볍고 빠름
블로그 글을 여러 편 정리하는 작업자라면, 글 하나가 끝날 때마다 세션을 새로 여는 습관만으로도 체감 속도가 다릅니다.
4. 모델 선택이 상황에 맞는지 본다
Claude Code에서는 상황별로 다른 모델을 고를 수 있습니다. 무거운 모델일수록 추론 품질은 좋지만 응답 시작까지 시간이 더 걸립니다.
- 간단한 파일 수정, 이름 바꾸기, 주석 정리 → 가벼운 모델로 충분
- 아키텍처 설계 리뷰, 복잡한 리팩터링 → 큰 모델이 값어치를 함
문제는 모든 작업에 무거운 모델을 쓰고 있을 때입니다. "왜 이렇게 느리지?"의 답이 여기서 나오는 경우가 있습니다.
Claude Code 세션 안에서 /model 명령으로 현재 모델과 선택 가능한 목록을 확인할 수 있습니다. 사용 가능한 모델 이름과 정확한 요금·성능 차이는 Anthropic 공식 문서에서 확인하세요 — 라인업이 자주 갱신되기 때문에 이 글에 숫자로 박아두는 건 오히려 부정확할 수 있습니다.
5. 자동 실행되는 도구·MCP 서버를 점검한다
Claude Code는 파일 읽기, 명령 실행, 웹 검색 같은 도구(tool) 를 자동으로 호출할 수 있습니다. 여기에 MCP(Model Context Protocol, 외부 도구를 붙이는 확장 규격) 서버를 추가로 연결해두면 응답 전에 여러 단계를 거치게 됩니다.
느려질 때 흔한 원인은 이렇습니다.
| 원인 | 증상 |
|---|---|
| MCP 서버 하나가 응답 안 함 | 전체 응답이 그 서버 타임아웃까지 대기 |
| 매 요청마다 대용량 파일 자동 로드 | 첫 응답 시작이 계속 지연 |
| 웹 검색 도구가 반복 호출 | 답변 하나에 수십 초 |
/mcp 명령으로 현재 연결된 MCP 서버 목록과 상태를 볼 수 있습니다. 당장 안 쓰는 서버는 잠깐 비활성화한 뒤 속도가 달라지는지 비교해봅니다.
6. 프로젝트 폴더 크기와 무시 파일을 정리한다
Claude Code가 현재 폴더를 인식할 때, 파일 개수가 많으면 그만큼 초기 인식이 무거워집니다. node_modules, dist, .venv, 빌드 산출물, 대용량 로그 파일 같은 것들이 프로젝트 안에 그대로 있으면 매번 불필요한 스캔이 일어납니다.
.gitignore 파일(git에서 무시할 파일 목록을 적어두는 파일)을 잘 관리하는 것만으로도 도움이 됩니다. Claude Code는 이 목록을 참고해 스캔에서 제외하는 방식으로 동작합니다.
- ☐
node_modules/가 무시 목록에 있는지 확인 - ☐로그 파일(
*.log)이 프로젝트 루트에 쌓여있진 않은지 확인 - ☐이미지·영상 같은 큰 바이너리 파일은 별도 폴더로 분리
취미로 웹사이트를 만드는 분이 프로젝트 폴더 안에 스크린샷 수백 장을 그대로 두고 있다면, 이걸 별도 폴더로 옮기는 것만으로 초기 반응이 훨씬 빨라집니다.
7. Anthropic 서비스 상태를 확인한다
여기까지 다 해봤는데도 느리다면, 마지막으로 서비스 자체 상태를 봅니다. 특정 시간대에 전 세계적으로 요청이 몰리면 Anthropic 쪽 응답 시간이 늘어날 수 있습니다.
Anthropic은 공식 상태 페이지(status.anthropic.com)에서 API·Claude Code 상태를 공개합니다. 여기에 지연이나 장애가 표시돼 있다면 내 설정 문제가 아니라 서비스 측 이슈입니다.
이 경우 할 수 있는 건 대기하거나, 급하면 가벼운 모델로 잠시 우회하는 정도입니다. 재설치나 설정 변경은 오히려 나중에 상황을 헷갈리게 만들 수 있으니 참아둡니다.
점검 순서를 다시 한 번
느릴 때 만질 것이 많아 보이지만, 순서는 단순합니다.
버전 확인 ↓ 네트워크 확인 ↓ 컨텍스트 정리 ↓ 모델·도구 점검 ↓ 프로젝트 정리 ↓ 서비스 상태 확인
이 순서대로 하나씩 배제해 나가면, 일부 환경에서는의 "느림"은 재설치 없이 원인이 잡힙니다.
다음에 응답이 답답하게 느껴질 때, 곧바로 캐시를 지우거나 재설치를 시도하기보다 위 목록을 위에서부터 훑어보세요. 일부 환경에서는 범인은 오래된 세션과 무거워진 프로젝트 폴더입니다. 이 두 개만 정리해도 체감 속도가 눈에 띄게 달라지는 경우가 많습니다.
함께 보면 좋은 글
'AI & LLM > Claude & Anthropic' 카테고리의 다른 글
| Claude Artifacts 저장 안됨: 로딩·공유 오류 점검 순서 (0) | 2026.08.05 |
|---|---|
| Claude 5 프롬프트, 이전 세대와 달라진 점 정리 (0) | 2026.08.04 |
| Claude API 비용 절감, 배치·캐싱·모델 선택으로 접근하는 법 (0) | 2026.07.29 |
| Claude Artifacts 무료·Pro·Team 요금제별 차이 정리 (0) | 2026.07.20 |
| Claude Code 대안 5가지 비교: Cursor, Aider, Cline, Copilot 정리 (1) | 2026.07.18 |