문제 해결 글 목록
AI 코딩 CLI를 설치하거나 쓰다가 막혔을 때 오류 문구와 증상으로 원인을 가르는 순서를 다룹니다. 오류마다 증상·원인·해결을 나눠 정리합니다.
-
AI 코딩 CLI 오류 해결 길잡이: 설치·로그인·한도·MCP 증상별 순서
Claude Code·Codex CLI·Gemini CLI가 막혔을 때 --version과 첫 대화 두 가지로 설치·로그인·한도·MCP·설정 중 어디가 문제인지 가르고, 증상별로 볼 글을 정리했습니다.
-
Could not locate the Claude CLI on PATH 오류 해결 (VS Code)
VS Code 확장이 Could not locate the Claude CLI on PATH로 멈출 때 where.exe로 원인을 가르고, PATH를 PowerShell 프로필 대신 사용자 환경 변수에 넣은 뒤 VS Code를 다시 시작하는 순서입니다.
-
Claude API thinking 400 오류: disabled·between_tools·effort 해결
Claude API가 thinking 설정 때문에 400을 돌려줄 때 오류 문구로 원인을 가릅니다. Sonnet 5.5의 disabled 거절과 between_tools, effort xhigh·max 충돌, 끌 수 없는 모델에서 고칠 값을 정리했습니다.
-
Claude Code exit code 137: 실행 중 SIGKILL 원인과 해결
Claude Code process exited with code 137은 SIGKILL로 끝났다는 뜻입니다. 커널 로그에 Killed process가 있으면 메모리 부족, 없으면 띄운 앱이나 스크립트를 봅니다. Linux에서 직접 재현한 결과와 가르는 순서를 정리했습니다.
-
Codex CLI 오류 해결: 400·401·codex_apps 등 7가지
Codex CLI 오류는 메시지 첫머리로 원인이 갈립니다. 400 모델 미지원, 401 Missing bearer, codex_apps 시작 실패, unexpected argument, read-only sandbox, stdin 대기 등 7가지의 원문과 해결 명령을 정리했습니다.
-
Claude Code·Codex 한글 깨짐: Windows에서 원인과 해결
Windows PowerShell 5.1에서 Claude Code·Codex CLI·Antigravity CLI의 한글이 깨지는 세 경우(출력 받기, 파이프 입력, 에이전트가 만든 .ps1)를 직접 재현하고 프로필 네 줄과 BOM 저장으로 고친 결과입니다.
-
Claude Code 훅이 작동 안 할 때: /hooks부터 4단계 점검
Claude Code 훅이 작동하지 않으면 /hooks 등록, 매처, 스크립트 실행, JSON 해석 순으로 끊긴 곳을 찾습니다. Failed with non-blocking status code, 종료 코드 126·127, Windows의 Bash 매처·jq·역슬래시 문제까지 다룹니다.
-
Claude Code 설치·로그인 오류 해결: command not found 등
Claude Code 설치가 멈춘 단계를 먼저 가르고 command not found: claude, exit code 137, claude.exe 호환 오류, OAuth error: Invalid code, API Error: 403 등 문구별 원인과 해결을 정리했습니다.
-
Claude Code 설정이 적용되지 않을 때: /status·claude doctor로 확인하는 순서
훅·권한·CLAUDE.md를 고쳤는데 그대로일 때 /context·/status로 읽혔는지, claude doctor로 거부됐는지, 위 단계가 덮었는지, --safe-mode로 비교하는 네 단계 확인 순서를 정리했습니다.
-
Gemini CLI 인증 오류: GOOGLE_CLOUD_PROJECT·종료 코드 41
Gemini CLI 로그인이 This account requires setting the GOOGLE_CLOUD_PROJECT 오류나 종료 코드 41·55·1로 멈출 때 고치는 순서입니다. 변수를 넣어야 하는 계정과 지워야 하는 계정, 0.60.0에서 직접 본 오류 출력을 실었습니다.
-
Claude Code MCP 서버 연결 실패: ENOENT 등 오류 4가지 해결
클로드 코드(Claude Code) MCP 서버가 안 붙을 때 claude mcp list 상태 줄 끝의 ENOENT, CONNECTION_CLOSED, HTTP 405, Missing environment variables 문구별로 볼 곳과 고치는 법을 정리했습니다.
-
Claude Code 529 Overloaded·사용량 제한 오류: 메시지별 해결
Claude Code의 529 Overloaded, not your usage limit, Request rejected (429), hit your session limit, spend limit 메시지별로 무엇이 막혔는지와 기다릴지·모델을 바꿀지·설정을 볼지를 정리했습니다.
-
Claude Code Windows 경로 문제: 공백·한글·CRLF가 깨뜨리는 곳
Windows에서 Claude Code가 경로 때문에 조용히 어긋나는 곳을 정리했습니다. settings.json은 역슬래시 두 번, 권한 규칙은 //c/, 훅은 구분자 정규화. Git Bash 경로, 한글 폴더 충돌, CRLF 스크립트까지 직접 확인했습니다.