운영 노하우
Claude Code에 세션당 웹검색 200회, 서브에이전트 200개라는 기본 상한이 생겼습니다. 2026년 7월 24일 v2.1.219부터입니다. 같은 업데이트에서 서브에이전트가 백그라운드 기본 실행으로 바뀌고 중첩 깊이가 1단계에서 3단계로 늘어난 것을 함께 보면, 이 상한이 왜 지금 들어왔는지가 분명해집니다. 1인으로 자동화를 돌리는 입장에서는 제한이 아니라 예산으로 다뤄야 할 값 네 개입니다.
AI가 부하 AI를 만드는 층이 세 겹으로 늘었습니다
v2.1.219에서 두 가지가 동시에 바뀌었습니다. 첫째, 서브에이전트가 기본적으로 백그라운드에서 실행됩니다. 둘째, 서브에이전트가 다시 서브에이전트를 부르는 중첩 깊이가 기존 1단계에서 3단계로 확대됐습니다. 이 둘을 겹쳐 보면 그림이 명확해집니다. 일을 하나 맡겼는데 그 일을 받은 AI가 부하를 여럿 만들고, 그 부하들이 각자 또 부하를 만듭니다. 대화창에는 아무것도 보이지 않는 상태로 말입니다.
Anthropic, "Claude Code changelog" v2.1.215 · v2.1.218 · v2.1.219 (2026-07-19 ~ 2026-07-25)
원문 보기 →
잡아야 할 상한값 네 개
공식 문서에 명시된 환경변수는 다음 네 가지입니다. 환경변수란 프로그램이 실행될 때 참고하는 설정값을 말합니다. 괄호 안이 기본값입니다.
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION (200) — 한 세션에서 웹검색을 몇 번까지 허용할지
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION (200) — 한 세션에서 서브에이전트를 몇 개까지 만들지
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS (20) — 동시에 몇 개까지 돌릴지
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH (3) — 부하가 부하를 부르는 단계를 몇 층까지 허용할지
서브에이전트 예산은 대화를 초기화하는 /clear를 실행하면 다시 채워집니다. 영구 한도가 아니라 "이번 대화에서 쓸 수 있는 총량"으로 이해하시면 정확합니다. 값을 바꾸는 방법은 간단합니다. 맥과 리눅스에서는 터미널에 export 변수명=숫자를 입력한 뒤 Claude Code를 실행하고, 윈도우에서는 set 변수명=숫자를 씁니다. 매번 입력하기 번거로우면 프로젝트 폴더의 설정 파일에 적어두면 됩니다.
자동으로 돌던 검수가 수동으로 바뀌었습니다
같은 시기에 검수 동작도 정리됐습니다. v2.1.215(7월 19일)부터 Claude가 /verify와 /code-review를 스스로 실행하지 않습니다. 필요할 때 직접 호출해야 합니다. 이어서 v2.1.218(7월 22일)부터 /code-review는 백그라운드 서브에이전트로 동작해, 검수 로그가 대화창을 채우지 않습니다. 실무에서 갈리는 지점이 여기입니다. "알아서 검수해 주겠지" 하고 두면 이제 검수 자체가 돌지 않습니다. 코드를 만지는 작업이라면 마무리 단계에서 검수 명령을 직접 실행하는 절차를 새로 넣으셔야 합니다.
1인 운영자의 세팅 기준 — 세션 성격에 따라 다르게
저는 아임웹·식스샵·카페24 제작을 1인으로 돌리면서 서브에이전트를 30명 가까이 구성해 두고 씁니다. 그 경험으로 보면 모든 세션에 같은 값을 쓰는 것은 비효율적입니다. 클라이언트 실작업 세션은 중첩 깊이를 1로 낮춰 결과를 예측 가능하게 만드는 편이 낫습니다. 작업 구조가 이미 정해져 있어 깊은 위임이 필요 없고, 오히려 어디서 무엇이 바뀌었는지 추적이 어려워지기 때문입니다. 반대로 자료조사·리서치 세션은 넓게 훑어야 하므로 기본값을 그대로 두는 편이 낫습니다. 다만 매일 자동으로 도는 스케줄 작업에는 웹검색 상한을 기본값보다 낮게 잡으시길 권합니다. 사람이 지켜보지 않는 시간대에 도는 작업일수록 울타리가 좁아야 안전합니다.
제한이 아니라 법인카드 한도로 보십시오
이 값들을 "AI를 못 쓰게 막는 장치"로 읽으면 방향이 어긋납니다. 직원에게 법인카드를 주면서 한도를 걸어두는 것에 가깝습니다. 한도가 정해져 있어야 마음 놓고 맡길 수 있습니다. AI에게 일을 맡기는 방식이 한 단계 넘어가는 중입니다. 예전에는 "얼마나 잘 시키느냐"가 관건이었다면, 백그라운드 실행과 중첩 위임이 기본이 된 지금은 "얼마나 잘 가둬두느냐"가 함께 필요합니다.
먼저 claude --version으로 v2.1.219 이상인지 확인하십시오. 그다음 실작업 세션은 중첩 깊이를 1로, 무인 스케줄 작업은 웹검색 상한을 기본값보다 낮게 잡으시면 됩니다. 마지막으로 코드 작업 체크리스트에 검수 명령 수동 실행을 한 줄 추가하십시오. 이 세 가지만 해두면 백그라운드에서 무슨 일이 벌어지는지 몰라 불안해할 일이 확실히 줄어듭니다.
누끼토끼는 1인 운영 기준으로 Claude Code와 노코드 빌더를 엮는 실무 강의와 칼럼을 운영하고 있습니다. 에이전트 구성과 안전장치 설정을 처음부터 함께 잡아보실 수 있습니다.