Claude Code 웹 검색이 200번에서 멈추지 않는다, 한 시간에 100번씩 다시 찬다

대화형 세션의 WebSearch는 200번을 쓰면 더 돌지 않았다. 서브에이전트로 조사를 나눠 돌리면 금방 닿는 숫자다. v2.1.290(10월 5일)부터는 터미널 세션의 한도가 한 시간에 100번 정도씩 다시 찬다.

충전 속도는 환경변수로 바꾼다.

# 한 시간에 50번만 채운다
export CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR=50

값은 숫자만 쓴다. 다른 꼴로 쓰면 설정이 없는 것으로 읽힌다. 0을 넣으면 충전이 꺼지고, claude -p 같은 비대화형 실행은 기본값이 0이라 처음부터 충전되지 않는다.

한도 자체를 올리려면 CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION을 쓴다. 올릴 수는 있어도 끌 수는 없다.

export CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION=500

급할 땐 /clear로 새 대화를 시작해도 횟수가 0으로 돌아간다. 돌고 있는 워크플로처럼 서브에이전트를 띄울 수 있는 작업이 남아 있으면 횟수가 그대로 이어진다.