Claude Code 세션 4번, tool call 0번 — API 키 하나가 막은 하루

2026-03-22, Claude Code 세션을 4번 열었고 총 tool call 수는 0이다.

TL;DR — Invalid API key 오류가 모든 세션을 막았다. 외부 API 키 하나가 잘못되면 Claude Code는 첫 발도 못 뗀다.

세션 4번, 아무것도 못 한 날

세션 1과 3은 동일한 프롬프트였다. build-logs/에 한국어/영어 빌드 로그를 생성하고 STATUS.md를 갱신하는 작업. 세션 2와 4도 같은 목적이었다 — 블로그 초안을 blog-drafts/2026-03-22-draft-ko.md로 저장하는 것.

4번 모두 같은 결과로 끝났다. Invalid API key · Fix external API key.

Claude Code가 외부 API를 호출하려는 순간 인증 오류가 터졌고, 이후 작업은 진행되지 않았다. Edit 0번, Read 0번, Bash 0번. 수정된 파일 없음, 생성된 파일 없음.

무엇이 막았나

saju_global 프로젝트는 외부 API와 연동되어 있다. 정확히 어떤 서비스의 키인지는 세션 기록만으로 특정할 수 없지만, Claude Code가 첫 번째 도구 호출 전에 키를 검증하는 단계에서 실패한 것으로 보인다.

흔히 이런 상황이 발생하는 경우는 세 가지다. 키가 만료됐거나, 환경변수에 잘못 세팅됐거나, 프로젝트를 다른 환경으로 옮기면서 .env가 빠졌거나. 어느 쪽이든 해결 방법은 같다 — 키를 새로 발급하거나 환경변수를 재확인하는 것.

자동화 파이프라인의 가장 흔한 장애 지점

Claude Code로 반복 작업을 자동화하면 빌드 로그 생성, 블로그 초안 작성, STATUS.md 갱신 같은 작업을 프롬프트 하나로 처리할 수 있다. 하지만 외부 의존성이 하나라도 깨지면 전체 파이프라인이 멈춘다.

이번 케이스가 그 전형이다. 프롬프트는 완벽하게 작성됐고, Claude Code도 정상 동작했고, 의도한 작업도 명확했다. 그런데 API 키 하나 때문에 4개 세션이 모두 빈 손으로 끝났다.

자동화에 투자할수록 이런 외부 의존성 관리가 더 중요해진다. 키 만료 알림을 설정해두거나, 세션 시작 전 환경변수 체크를 스크립트로 넣는 것이 현실적인 예방책이다.

기록의 이유

tool call 0번짜리 세션은 빌드 로그에 쓸 내용이 없어 보인다. 그런데 이게 오히려 더 정직한 기록이다.

Claude Code를 쓰다 보면 “오늘은 아무것도 못 했다”는 날이 생긴다. 그 이유가 코드 문제가 아니라 API 키 같은 인프라 문제일 때가 많다. 그 패턴을 기록해두면 다음에 같은 상황이 생겼을 때 원인을 빠르게 찾을 수 있다.

오늘 saju_global는 멈췄다. 키를 고치면 다시 돌아간다.