Claude Code 2.1.329 변경사항: 게이트웨이 max_tokens, /tasks, /code-review 및 버그 수정

2026년 11월 19일 출시된 Claude Code 2.1.329는 게이트웨이 뒤에서의 max_tokens 자동 재시도를 제거하고 /tasks에 예약 작업과 포크를 추가하며, /code-review 기본 동작을 전체 브랜치 비교로 변경합니다. 또한 훅 출처 신뢰 경고 추가, ~/.claude.json 초기화 및 macOS·VS Code·사용 크레딧 버그 수정을 포함합니다. 업그레이드 방법, 게이트웨이 연결 경로 비교, 같은 날 배포된 2.1.328 주요 변경사항도 함께 다룹니다.

목차
Claude Code 2.1.329 변경사항: 게이트웨이 max_tokens, /tasks, /code-review 및 버그 수정

Claude Code 2.1.329가 2026년 11월 19일에 출시되었습니다. 이번 버전은 게이트웨이 환경에서 max_tokens 자동 재시도를 제거하고, /tasks 기능을 확장하며, /code-review와 저장된 예약 작업 동작을 바꾸고, ~/.claude.json 초기화 및 macOS·VS Code 로그아웃 오류를 수정합니다. 터미널, VS Code, Claude Desktop 사용자뿐 아니라 LLM 게이트웨이나 Pro·Max 사용 크레딧을 쓰는 팀 모두 영향을 받습니다. 먼저 claude --version과 claude update를 실행해 업그레이드하고, 사용 중인 게이트웨이의 출력 상한이 낮다면 CLAUDE_CODE_MAX_OUTPUT_TOKENS를 설정합니다.

Claude Code 2.1.329 연결 경로 선택

2.1.329로 업그레이드하면 게이트웨이 출력 토큰 제한, 자체 호스팅 게이트웨이의 allow_cidrs 경고, Pro 및 Max 월간 크레딧 표시 방식이 달라집니다. 로컬이나 팀 설정을 바꾸기 전에 현실적인 연결 경로를 먼저 비교합니다.

연결 경로계정 및 지역 요건과금 단위선택 기준
Claude Pro / Max 구독Anthropic 지원 지역의 유료 claude.ai 계정(Pro, Max, Ultra, Team 또는 Enterprise, 무료 claude.ai 제외)구독 포함 사용량 및 선택적 사용 크레딧Remote Control, 음성 입력 또는 웹과 CLI 통합 사용량이 필요한 경우
Anthropic Console API 직접 연결Anthropic 지원 지역의 Claude Console 계정(platform.claude.com, API 키 또는 Console 로그인)API 토큰당 종량제 과금프록시 없이 Anthropic API에 직접 과금하려는 경우
조직용 또는 자체 호스팅 게이트웨이조직이 관리하는 프록시(예: 사내 IdP 로그인을 지원하는 Claude apps gateway)와 업스트림 API 또는 클라우드 자격 증명업스트림 Anthropic Console, Bedrock, Agent Platform 또는 Foundry 계정에 토큰당 과금팀 차원의 중앙 예산 관리, 모델 접근 제어, 감사 로그, 관리 설정이 필요한 경우
BetterToken 종량제 API 게이트웨이BetterToken 계정 및 콘솔 API 키(API 접속에 claude.ai 계정 불필요)토큰당 종량제 과금(구매한 유료 잔액은 매월 초기화되지 않음)게이트웨이를 직접 구축하지 않고 Anthropic 호환 Claude API 접속이나 다중 모델 선택이 필요한 경우

Claude Code 2.1.329를 BetterToken에 연결하기

BetterToken은 Anthropic 공식 제품이 아닌 독립적인 멀티모델 API 플랫폼입니다. Claude Code용 Anthropic 호환 Base URL은 https://bettertoken.ai입니다. Claude Code가 /v1/messages를 자동으로 붙이므로 ANTHROPIC_BASE_URL에는 /v1을 빼고 입력합니다.

2026-11-20 기준 BetterToken은 Anthropic 호환 엔드포인트에서 claude-sonnet-5-5, claude-opus-5-5, claude-haiku-5-5, claude-fable-5-2(각각 1M 토큰 컨텍스트 창과 최대 128K 출력 지원, Sonnet 5.5·Opus 5.5·Haiku 5.5는 동기 출력) 및 claude-haiku-4-5-20251001(200K 컨텍스트와 최대 64K 동기 출력)을 제공합니다. 대규모 세션을 실행하기 전에 현재 요금 페이지에서 실시간 입력, 출력, 캐시 단가를 확인합니다.

Bash에서 API 키가 화면에 출력되지 않도록 읽은 뒤 테스트 세션용 환경 변수를 내보냅니다. 아래 명령은 Base URL, 인증 토큰, 기본 모델 및 Sonnet·Haiku·Opus 별칭 모델을 함께 지정합니다.

read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY

export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export ANTHROPIC_AUTH_TOKEN="$BETTERTOKEN_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"

단발 프롬프트를 보내 연결 상태를 확인합니다.

claude -p "Reply with only: OK"

401 오류나 연결·모델 오류 없이 OK만 반환되면 인증이 정상적으로 완료된 것입니다. 이어서 claude를 실행하고 /status를 입력합니다. Anthropic base URL 항목이 https://bettertoken.ai로 표시되고, 인증 줄이 claude.ai 로그인이 아닌 ANTHROPIC_AUTH_TOKEN으로 표시되는지 확인합니다. 시작 시 자격 증명 출처 충돌 경고가 나타나면 /logout을 실행해 저장된 claude.ai 세션을 지우고, 셸에 ANTHROPIC_API_KEY가 설정되어 있다면 함께 해제합니다.

이 값을 세션 간에 유지하려면 ~/.claude/settings.json(Windows에서는 %USERPROFILE%\.claude\settings.json)의 "env" 블록에 추가한 뒤 Claude Code를 완전히 재시작합니다. 전체 설정 예시는 BetterToken Claude Code 설정 가이드 또는 Claude Code API 설정 페이지에서 확인할 수 있습니다. CLAUDE_CODE_MAX_OUTPUT_TOKENS는 선택한 모델의 출력 상한이 Claude Code의 요청 크기보다 낮을 때만 추가합니다. 선택 항목인 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1을 설정하면 자동 업데이트가 꺼지므로, 업데이트할 때 claude update를 수동으로 실행합니다. Remote Control과 음성 입력은 claude.ai 로그인이 필요하므로 API 키와 사용자 지정 Base URL 구성에서는 사용할 수 없습니다.

BetterToken 계정 만들기

조직에서 이미 자체 프록시나 Claude apps gateway를 운영하고 있다면 기존 관리 설정을 유지하거나, Anthropic 공식 Claude Code를 LLM 게이트웨이에 연결하기 문서를 참고해 ANTHROPIC_BASE_URL과 함께 ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY 또는 apiKeyHelper를 구성합니다.

게이트웨이 max_tokens 오류와 allow_cidrs 시작 경고

Claude Code 2.1.329는 2.1.326에서 도입된 자동 재시도 동작을 제거합니다. 2.1.326에서는 요청의 max_tokens가 모델 한도를 초과할 때 Claude Code가 API 오류 메시지에 보고된 최댓값으로 자동 재시도했습니다. 공식 Claude Code 변경 로그에 따르면 2.1.329부터 이 재시도가 더 이상 동작하지 않습니다.

이 변경은 Claude Code가 요청하는 양보다 적은 출력 토큰만 허용하는 모델을 게이트웨이 뒤에서 사용하는 팀에 영향을 줍니다. Claude Code 환경 변수 참조 문서에 따르면, Claude Code가 인식하지 못하는 사용자 지정 모델 ID는 기본 출력 토큰이 32000이고 상한은 128000입니다. 게이트웨이가 해당 ID를 출력 한도가 더 낮은 모델로 연결하면, 이제 요청이 조용히 재시도되지 않고 max_tokens 오류로 실패합니다.

셸 또는 ~/.claude/settings.json에서 CLAUDE_CODE_MAX_OUTPUT_TOKENS를 모델의 확인된 출력 상한 값으로 지정합니다. 아래는 Bash에서 설정하는 예시입니다.

export CLAUDE_CODE_MAX_OUTPUT_TOKENS="16384"

16384를 실제 모델의 출력 한도로 바꾼 뒤 Claude Code를 재시작하고, 짧은 프롬프트를 보내 max_tokens 오류가 사라졌는지 확인합니다. 게이트웨이가 출력 길이가 아니라 입력 길이 때문에 요청을 거부한다면 Claude Code 1M 컨텍스트 창 게이트웨이 오류 해결 가이드를 참고합니다.

Anthropic의 자체 호스팅 Claude apps gateway를 운영하는 담당자도 매번 반복되는 시작 경고를 받게 됩니다. access_control.allow_cidrs가 비어 있으면 2.1.329는 시작할 때마다 텍스트 로그에 테두리가 쳐진 안내 문구인 never expose the gateway to the public internet을 기록합니다(단, trusted_proxies와 public_url을 모두 설정하지 않고 루프백 주소에 바인딩한 경우에는 이 시작 경고가 표시되지 않습니다). Claude apps gateway 구성 가이드에 명시된 것처럼 access_control의 두 목록(allow_cidrs와 deny_cidrs)을 모두 비워 두면 게이트웨이가 모든 클라이언트 주소의 요청을 수락하므로, 네트워크 경계에만 접근 통제를 의존하게 됩니다. 게이트웨이는 개발자 장비에서 명령을 실행하는 관리 설정을 배포할 수 있기 때문에 이 설정이 중요합니다. access_control.allow_cidrs에 사설 대역을 채우고, 게이트웨이와 그 앞단의 모든 구성 요소가 공용 인터넷에서 접근할 수 없도록 유지합니다. 로드 밸런서, 포트 포워딩 또는 터널이 트래픽을 중계할 때는, 해당 프론트엔드가 들어오는 각 연결의 주소를 덧붙여 개발자가 마지막 X-Forwarded-For 항목을 작성할 수 없는 경우에만 listen.trusted_proxies에 등록합니다. 개발자가 접속하는 주소나 대역은 절대 등록하지 않습니다. 반대로 요건을 충족하는 중계 장비를 누락하면 게이트웨이가 클라이언트 주소 대신 중계 장비의 주소만 보게 됩니다. 게이트웨이를 재시작해 경고가 사라졌는지 확인합니다.

/tasks, 저장된 예약 작업 및 /code-review 동작 변경

2.1.329 버전은 활성 세션 작업이 /tasks에 표시되는 방식과 /code-review가 diff를 계산하는 방식을 바꿉니다. 반복 작업을 재개하거나 브랜치 리뷰를 시작하기 전에 두 변경사항을 확인합니다.

/tasks에서 예약 작업, /loop 깨우기 및 포크 관리

이제 /tasks 화면에 현재 세션의 예약 작업, /loop 깨우기, 목표(goal), 그리고 현재 대화의 포크가 함께 표시됩니다. 항목을 선택한 뒤 x를 눌러 확인하면 해당 작업을 중지할 수 있습니다. /tasks 헤더와 하단 푸터의 백그라운드 카운터도 셸, 모니터, MCP 호출, 에이전트, 워크플로, 예약 작업을 합친 단일 숫자로 통합되었습니다.

업그레이드 이후에는 이전 버전에서 저장한 예약 작업을 수동으로 점검해야 합니다. 새로 로그인한 세션에서는 이전 버전으로 저장한 예약 작업 대부분을 다시 등록해야 합니다. 다만 원래 세션을 claude --resume으로 재개하면 기존 예약 작업이 그대로 실행됩니다. 또한 Exit and stop tasks를 선택하면 현재 세션의 예약 작업이 중지되어 세션을 재개해도 다시 시작되지 않습니다(Claude가 응답하는 도중에 종료한 경우는 예외입니다). Cloud, Desktop, /loop 예약 방식의 차이는 Claude Code 작업 예약 가이드에서 확인할 수 있습니다.

/code-review 기본 브랜치 diff 및 풀 리퀘스트 검사

대상 없이 /code-review를 실행하면 대부분의 모델에서 기본 브랜치를 기준으로 현재 브랜치 전체를 검토하도록 변경되었습니다. 여러 커밋이 쌓인 브랜치에서 /code-review가 diff를 잃어버리던 버그도 함께 수정되었습니다.

풀 리퀘스트 리뷰 기준도 엄격해졌습니다. 기존에는 /code-review <pr number>를 실행했을 때 풀 리퀘스트 대신 로컬에 체크아웃된 브랜치를 별도 안내 없이 검토하는 경우가 있었습니다. 2.1.329에서는 gh pr diff로 풀 리퀘스트를 읽거나, 읽을 수 없을 때 그 사실을 명확히 알립니다. gh pr diff가 실패하거나 거부되면 /code-review <pr number> --fix와 풀 리퀘스트 URL을 전달한 /code-review는 리뷰를 진행하지 않고 즉시 중단됩니다.

대부분의 모델에서 나타나던 두 가지 리뷰 오류도 해결되었습니다. 존재하지 않는 ~/.claude/CLAUDE.md를 찾으려다 권한 프롬프트에서 멈추던 문제가 사라졌으며, medium 수준으로 실행한 리뷰의 결과 카드에 high가 표시되던 오류도 수정되었습니다.

훅 신뢰 경고, MCP 진단 및 /status 개선

Claude Code 2.1.329는 폴더 훅, 원격 HTTP MCP 서버, 관리형 마켓플레이스, Code Mode 전반의 진단 정보를 보강했습니다.

  • 폴더 및 관리 훅: 신뢰 확인 대화상자에 해당 폴더의 훅이 어디에 선언되어 있는지 표시됩니다. Claude Desktop 및 기타 비대화형 호스트에서는 관리 설정의 훅을 불러오지 못할 때 대화창 안에 경고가 나타납니다. VS Code에서 신뢰 프롬프트를 거부하면 메시지 입력창 위에 Review trust가 포함된 줄이 추가되어, 창을 새로 고치지 않고도 신뢰 프롬프트를 다시 열 수 있습니다. 예상치 못한 프로젝트 훅이나 원격 MCP 서버를 점검하려면 Claude Code 훅 및 MCP 연결 감사 가이드를 참고합니다.
  • 원격 HTTP MCP 진단: /mcp의 서버 상세 페이지에 Server message 행이 추가되어 원격 HTTP MCP 서버가 연결을 거부할 때 반환한 JSON-RPC 오류 메시지를 바로 보여줍니다. 또한 2.1.329는 구버전 프로토콜에 머물러 있던 대부분의 HTTP MCP 서버를 자동으로 재연결해 백그라운드 MCP 작업이 멈추는 현상을 줄입니다. 서비스의 클라이언트 등록이 폐기되었을 때(HTTP 410 Gone) claude mcp login과 /mcp가 해당 서비스가 Claude Code 로그인을 허용하지 않는다고 잘못 안내하던 오류를 고쳤으며, 인증을 삭제한 뒤 진행 중이던 토큰 갱신이 서버에 다시 로그인해 버리는 문제도 막아 줍니다.
  • 마켓플레이스 자동 업데이트 상태: /status에 Marketplace auto-update 행이 추가되어 자동 업데이트를 받지 못하는 관리형 마켓플레이스와 그 사유를 표시합니다.
  • Code Mode 텔레메트리 및 훅: OpenTelemetry 이벤트와 메트릭이 켜진 상태에서도 Code Mode를 활성화할 수 있습니다. 코드가 호출하는 각 도구는 이벤트를 전송하지만, 트레이싱이 켜져 있으면 Code Mode는 계속 비활성 상태로 유지됩니다. 또한 텔레메트리, 비필수 트래픽 또는 기능 플래그가 꺼져 있을 때도 Code Mode가 시작되도록 바뀌었으며, 관리자는 관리 설정을 통해 이를 계속 꺼 둘 수 있습니다. 실패한 PreToolUse 훅은 명령, HTTP 또는 MCP 도구 훅에 "onFailure": "block"을 지정하지 않는 한 Code Mode 스크립트의 도구 호출을 차단하지 않습니다. Code Mode는 이제 256 MiB를 초과하는 줄 범위 읽기를 거부하고, 무한 루프가 메모리를 가득 채우기 전에 실행을 중단합니다.

~/.claude.json 초기화, 로그아웃 및 사용 크레딧 버그 수정

2.1.329 변경 로그에 나열된 91건의 버그 수정 가운데, 잦은 세션 중단을 일으키던 네 가지 안정성 문제가 해결되었습니다.

첫째, 네트워크 지연이나 파일 잠금으로 인해 저장 도중 ~/.claude.json을 읽지 못해 내용이 비워지면서 기본값으로 초기화되던 오류가 수정되었습니다. 업그레이드하면 앞으로의 저장 작업은 보호되지만, 이전 빌드에서 이미 파일이 초기화된 경우에는 설정을 복원하거나 다시 적용해야 합니다.

둘째, macOS와 VS Code의 반복 로그아웃 문제가 해결되었습니다. macOS에서는 로그인 갱신 시 Claude Code-write-check 항목으로 Keychain 쓰기 가능 여부를 검사합니다. Claude Code가 Keychain을 읽을 수는 있지만 저장할 수 없을 때, 만료 시점에 사유를 알리며 해당 세션만 종료하고 다른 세션은 로그인 상태를 유지합니다. VS Code에서는 토큰 갱신이 10~30초 지연되더라도 모든 창과 터미널에서 한꺼번에 로그아웃되지 않습니다. X의 초기 커뮤니티 요약인 @alexmichael의 게시물(2026-11-19 22:17 UTC)에서도 이 로그아웃 수정과 ~/.claude.json 수정을 /tasks, /code-review와 함께 주요 변경점으로 짚었으며, 공식 변경 로그와 내용이 일치합니다.

셋째, Pro 및 Max 사용 크레딧 확인이 더 안정적으로 동작합니다. /usage-credits는 브라우저를 연 뒤 Pro 및 Max 사용자에게 다시 로그인하라고 요구하지 않습니다. 브라우저가 열리지 않아 작업이 크레딧 대기로 일시 중지되었을 때 링크가 8초 만에 사라지던 문제도 수정되었습니다. 아울러 크레딧이 소진되었거나 월간 한도에 도달했을 때 /usage가 사용 크레딧이 꺼져 있다고 표시하던 버그가 고쳐졌고, 해당 한도로 인해 크레딧 기반 모델이 차단될 때 /model이 Pro 및 Max 사용자에게 이를 알립니다. 구독 한도로 진행 중인 작업이 멈췄다면 Claude Code 사용량 한도 복구 워크플로를 따라 Git 체크포인트를 저장한 뒤 연결 경로를 전환합니다.

넷째, 두 가지 에디터 버그가 수정되었습니다. IDE에서 diff를 수락할 때 파일 끝 줄바꿈이 사라지거나 VS Code에서 바이트 순서 표시(BOM)가 누락되는 문제가 해결되었습니다. 또한 /terminal-setup이 블록 주석 주변의 VS Code 설정이나 키 바인딩 파일을 손상시키던 오류와, keybindings.json에 닫히지 않은 문자열이 있을 때 Shift+Enter 바인딩을 잃고도 성공으로 보고하던 오류도 수정되었습니다.

11월 19일 함께 배포된 Claude Code 2.1.328 주요 변경사항

Anthropic은 2026년 11월 19일 01:14:04Z에 v2.1.328을 먼저 배포했고, 약 21시간 뒤인 22:14:41Z에 v2.1.329를 공개했습니다. 2.1.327에서 2.1.329로 바로 업그레이드하는 팀에는 아래 2.1.328 변경사항도 함께 적용됩니다.

  • 게이트웨이 타임아웃과 베타 헤더: 이제 CLAUDE_STREAM_IDLE_TIMEOUT_MS가 게이트웨이, 사용자 지정 Base URL, 클라우드 제공업체에서 5분 연결 제한을 정상적으로 연장합니다. 베타 헤더를 거부하는 게이트웨이 뒤나 Bedrock, Agent Platform, Foundry, Claude apps gateway에서 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS를 설정했을 때 Claude Desktop 외부의 자동 모드가 매 턴 실패하던 오류가 수정되었습니다. 입력 스키마가 anyOf, oneOf, allOf로 시작하는 MCP 도구가 서드파티 제공업체나 텔레메트리·기능 플래그 비활성 상태에서 사라지던 문제도 해결되었습니다.
  • 핵심에 집중한 /code-review 보고서: 대부분의 모델에서 /code-review는 버그와 CLAUDE.md 위반 사항만 보고합니다. 코드 재사용이나 정리 제안은 /simplify를 실행해 확인합니다. 또한 대부분의 모델에서 각 지적 사항에 Important, Pre-existing, Nit 표시를 달고, 각 요약 끝에 수정 제안을 덧붙이며, 문제가 없을 때는 "Code review found no issues."를 출력합니다.
  • 예약 작업 보호와 MCP 훅: 서드파티 제공업체 환경이나 텔레메트리·기능 플래그가 꺼진 상태에서 예약 작업 파일을 읽지 못할 때 새 예약 작업을 저장해도 기존 프로젝트 작업이 지워지지 않습니다. 추가로 mcp_tool 훅도 명령 훅 및 HTTP 훅과 마찬가지로 "onFailure": "block"을 지원합니다.

LLM 워크플로를 최적화할 준비가 되셨나요?

하나의 API로 모델을 연결하고 키와 AI 비용을 관리하세요.

무료로 시작하기