클로드 코드 LLM 게이트웨이에서 MCP 도구 검색 켜고 끄는 환경변수 설정법

클로드 코드(Claude Code)는 MCP 도구 정의를 처음부터 다 싣지 않고, 도구 검색(tool search)으로 필요할 때 찾아 불러온다. 지금까지는 ANTHROPIC_BASE_URL을 앤트로픽이 아닌 주소(LLM 게이트웨이·프록시)로 바꾸면 도구 검색이 저절로 꺼졌고, MCP 도구가 처음부터 컨텍스트에 다 실렸다. 10월 19일 나온 2.1.304부터는 이런 주소에서도 기본으로 켜진다. 게이트웨이가 400이나 422로 거절하면 도구 검색을 빼고 다시 보낸다. 설명 문서의 환경변수 표는 아직 예전 동작 그대로다.

재시도를 거치지 않고 처음부터 끄려면 ENABLE_TOOL_SEARCH를 false로 둔다.

ENABLE_TOOL_SEARCH=false claude

도구 정의가 작을 때만 처음부터 싣고 싶으면 문턱 모드를 쓴다. auto는 도구 정의가 컨텍스트 창의 10%보다 작으면 처음부터 싣고, auto:N은 그 기준을 N%로 바꾼다.

ENABLE_TOOL_SEARCH=auto:5 claude

매번 앞에 붙이기 번거로우면 settings.json의 env에 넣는다.

{
  "env": {
    "ENABLE_TOOL_SEARCH": "auto:5"
  }
}

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS를 켜 두면 ENABLE_TOOL_SEARCH를 무엇으로 넣든 도구 검색은 꺼진 채다.