Claude Code 2.1.330: Enterprise 게이트웨이 로그인, /loop 최대 30일, max_tokens 재시도 복구

Claude Code 2.1.330은 Enterprise Admin Console 조직 로그인을 통한 조직 클라우드 프로바이더 및 게이트웨이 적용 기능을 추가하고, 세션이 유지되는 동안 /loop 및 정기 작업의 최대 기간을 7일에서 30일로 늘리며, 게이트웨이 뒤에서의 max_tokens 자동 재시도를 복구합니다. 활성 엔드포인트 검증, BetterToken 및 Anthropic 공식 경로 연결, easel 차트 제어, 서드파티 루머와의 차이를 확인할 수 있습니다.

목차
Claude Code 2.1.330: Enterprise 게이트웨이 로그인, /loop 최대 30일, max_tokens 재시도 복구

Claude Code 2.1.330 버전이 2026년 11월 20일에 배포되면서 기업용 게이트웨이 연결, 장기 실행 /loop 스케줄, 그리고 max_tokens 자동 재시도 동작이 변경되었습니다. 이번 업데이트는 Enterprise Admin Console 로그인을 도입하는 팀, 사용자 지정 ANTHROPIC_BASE_URL 게이트웨이로 Claude Code 트래픽을 라우팅하는 개발자, 그리고 여러 날에 걸쳐 정기 작업을 실행하는 모든 사용자에게 직접적인 영향을 줍니다. claude update 명령으로 업데이트한 뒤 claude --version으로 2.1.330 버전을 확인하고, 새 작업을 시작하기 전에 claude를 실행하여 /status에서 현재 활성화된 엔드포인트와 인증 정보 출처를 점검하십시오.

Claude Code 2.1.330 연결 경로 선택하기

인증 정보가 서로 충돌하지 않도록 로컬 설정 파일을 수정하기 전에 하나의 연결 경로만 선택하십시오. 구독 플랜과 API 종량제 과금 구조의 전반적인 비교는 Claude Code 구독과 API 과금 비교 가이드에서 확인할 수 있습니다.

연결 경로필수 요건과금 단위문서화된 클라이언트 및 기능 범위선택 기준
종량제 API 게이트웨이(BetterToken)BetterToken 계정 및 API 키(claude.ai 계정 제출이나 공유 불필요)각 모델의 현재 과금 단위에 따른 종량제 결제(구매한 유료 잔액은 매월 초기화되지 않음)Anthropic Messages(https://bettertoken.ai)를 통해 Claude Code CLI(~/.claude/settings.json) 및 VS Code 확장 프로그램(claudeCode.environmentVariables) 지원. Remote Control, 음성 입력, easel은 사용할 수 없음자체 게이트웨이를 운영하거나 Enterprise 플랜에 가입하지 않고 Claude 및 다른 모델을 종량제로 사용하려는 경우
Enterprise Admin Console 로그인Enterprise 조직 소속, Owner의 스위치 활성화, claude 2.1.330+(함께 사용 시 업데이트된 VS Code 확장 프로그램 포함), 조직의 클라우드 또는 게이트웨이 접근 권한프로바이더별 상이(조직의 클라우드 프로바이더 또는 게이트웨이 계정으로 청구됨)터미널과 VS Code에서 조직의 Desktop 3P 설정과 Connection 프로바이더 적용. Remote Control, 클라우드 세션, 음성 모드, claude.ai 커넥터는 사용할 수 없음조직이 이미 Enterprise Admin Console에서 Claude Desktop 연결을 관리 중이며 managed-settings.json 배포를 중단하려는 경우
자체 호스팅 LLM 게이트웨이 또는 클라우드 프로바이더직접 운영하는 프록시 또는 AWS, Google Cloud, Azure 계정과 게이트웨이/클라우드 인증 정보프로바이더별 상이(클라우드 프로바이더 또는 업스트림 게이트웨이 과금 기준 따름)ANTHROPIC_BASE_URL 또는 프로바이더 환경 변수(CLAUDE_CODE_USE_BEDROCK=1, CLAUDE_CODE_USE_VERTEX=1)로 Claude Code 연결. 기능 범위는 게이트웨이나 프로바이더에 따라 다름규정 준수를 위해 내부 트래픽 로깅, 맞춤형 지출 한도 또는 클라우드 청구가 필요한 경우
claude.ai 직접 구독 또는 Claude Consoleclaude.ai Pro, Max, Ultra, Team, Enterprise 계정 또는 초대를 받은 Claude Console 계정구독 요금제 또는 Claude Console 과금구독 플랜에서는 easel(WSL 외부의 macOS 및 Linux), Remote Control, 음성 입력 같은 claude.ai 계정 전용 기능 지원별도의 사용자 지정 게이트웨이 계층 없이 Anthropic 호스팅 기능을 그대로 사용하려는 경우

BetterToken을 통해 Claude Code 2.1.330 연결하기

BetterToken은 Claude Code용 Anthropic 호환 Messages 엔드포인트(https://bettertoken.ai)를 제공하며, 2026-11-21 기준으로 Claude 모델(claude-sonnet-5-5, claude-opus-5-5, claude-haiku-5-5, claude-fable-5-2)을 제공하고 있습니다. 실시간 단가와 캐시 규칙은 최신 요금 페이지에서 확인하십시오. API 접근은 claude.ai 구독과 별도이므로 Remote Control, 음성 입력, easel 기능은 제공되지 않습니다.

먼저 BetterToken 워크스페이스에서 API 키를 발급하십시오. 테스트 과정에서 Claude Code가 기존 로그인 정보를 물려받지 않도록 경쟁하는 인증 정보를 먼저 정리해야 합니다. 이전에 claude.ai에 로그인했다면 Claude Code 내부에서 /logout을 실행한 뒤, Bash에서 ANTHROPIC_API_KEY를 해제하고 비밀 키가 화면에 출력되지 않도록 대화형 세션을 시작하십시오.

unset ANTHROPIC_API_KEY
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"
claude

ANTHROPIC_BASE_URL 끝에는 /v1을 붙이지 마십시오. Claude Code가 /v1/messages 경로를 자동으로 추가합니다. 열린 세션 안에서 /status를 실행해 두 줄을 확인합니다. Anthropic base URL 항목에는 https://bettertoken.ai가 표시되어야 하며, 인증 항목에는 claude.ai 계정 로그인 대신 ANTHROPIC_AUTH_TOKEN이 표시되어야 합니다. 시작 시 두 개의 인증 정보 출처가 감지되었다는 경고가 나타나면 /logout을 실행하여 BetterToken API 키만 남기십시오. 대화형 세션을 종료한 뒤 같은 셸에서 claude -p "Reply with only: OK" 명령을 실행합니다. 401 오류, 연결 오류, 모델 오류 없이 단순한 OK 응답이 돌아오면 검증된 연결에서 요청이 정상 처리된다는 뜻입니다.

이 구성을 영구 적용하려면 BetterToken Claude Code 설정 가이드를 따르거나 Claude Code API 설정 개요를 참고하십시오. macOS 또는 Linux에서는 자동 설정 스크립트(curl -fsSL "https://www.bettertoken.ai/install-claudecode-provider.sh" | bash)를 실행할 수 있습니다. 이 스크립트는 Node.js가 필요하며, 인수로 전달하지 않은 경우 API 키 입력을 요청합니다. 실행 후에는 ~/.claude/settings.json 파일(Windows에서는 PowerShell 스크립트가 문서화되어 있으며 경로는 %USERPROFILE%\.claude\settings.json입니다)을 확인하고 Claude Code를 완전히 재시작하십시오. CLI를 수동으로 구성하려면 해당 파일에 env 객체를 추가하고 "ANTHROPIC_BASE_URL": "https://bettertoken.ai", 발급받은 API 키를 넣은 "ANTHROPIC_AUTH_TOKEN", "API_TIMEOUT_MS": "3000000", 최신 요금 페이지에서 복사한 검증된 모델 ID(예: claude-sonnet-5-5)를 넣은 "ANTHROPIC_MODEL", 그리고 세 가지 역할별 별칭(ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL)을 설정합니다. 설정 가이드에 따라 세 별칭 모두에 동일한 모델 ID를 지정하거나 역할마다 서로 다른 검증된 모델 ID(예: claude-haiku-5-5, claude-sonnet-5-5, claude-opus-5-5)를 지정할 수 있습니다. 선택 항목인 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"을 추가하면 자동 업데이트, 오류 보고, 일부 가용성 점검 및 계정 기능이 비활성화되지만 인증 자체에는 필수 항목이 아닙니다. VS Code 확장 프로그램에서는 VS Code의 settings.json 파일에 claudeCode.environmentVariables를 추가하고 위와 동일한 변수 이름과 값을 {"name": "...", "value": "..."} 형식의 객체 배열로 입력한 뒤(전체 JSON 예시는 위에 연결된 설정 가이드에서 확인할 수 있습니다), Claude Code를 재시작하고 /status를 다시 확인하십시오.

BetterToken 계정 만들기

Anthropic 공식 경로를 선호하는 경우 조직 로그인은 Enterprise Admin Console에서 터미널용 Claude Code 관리하기 문서를 따르고, claude.ai 구독이나 Claude Console 로그인 또는 클라우드 프로바이더 연동은 Claude Code 인증 가이드를 참고하십시오.

Enterprise Admin Console 로그인과 게이트웨이 우선순위 검증하기

2.1.330 버전부터 개발자는 claude auth login 명령으로 Anthropic Enterprise Admin Console에서 관리하는 조직에 로그인할 수 있습니다. 로그인이 유지되는 동안(약 한 달) Claude Code는 조직 콘솔의 설정을 적용하고, Organization settings > Desktop 3P 아래 Connection 페이지에 저장된 클라우드 프로바이더 또는 게이트웨이로 모델 요청을 보냅니다.

사전에 Owner 또는 Primary Owner 권한을 가진 관리자가 Organization settings > Desktop 3P의 Connection 페이지를 저장하고, 기본값이 꺼짐 상태인 Allow sign-in from Claude Code in terminals and IDEs 스위치를 켜야 합니다. 조직 전체에 적용하려면 Organization settings > Products > Claude Code에서 활성화하고, 상위 조직이 있는 환경에서 파일럿 그룹에만 적용하려면 Organization settings > People > Permission policies로 이동해 해당 그룹 정책의 Claude Code 섹션에서 스위치를 켭니다. 어느 위치에서 변경하든 스위치를 켠 뒤 반드시 Save changes를 클릭해야 합니다. 이후 claude CLI를 2.1.330 이상으로 업데이트하고, VS Code 확장 프로그램도 함께 사용 중이라면 확장 프로그램도 함께 업데이트하십시오. 조직 로그인은 요청을 어느 엔드포인트로 보낼지만 Claude Code에 알려줄 뿐 업스트림 인증까지 대신 처리하지 않습니다. 따라서 AWS, Google Cloud, Azure를 사용한다면 개발자 각자가 클라우드 인증 정보를 보유해야 하며, 자체 로그인 절차가 있는 게이트웨이라면 Claude Code 안에서 /login을 한 번 더 실행해야 합니다(완료하기 전까지 Claude Code는 모든 프롬프트를 거부하고 필요한 조치를 안내합니다).

로컬 머신에서 우선 적용되는 설정 확인하기

Claude Code는 다음 세 단계의 엄격한 우선순위(낮은 순위에서 높은 순위 순)로 설정을 결정합니다.

  1. 개발자 개인의 설정 파일.
  2. claude auth login 이후 내려받는 Enterprise Admin Console 설정.
  3. 컴퓨터에 설치된 로컬 Claude Code 관리 설정(managed-settings.json, macOS MDM 프로필 또는 Windows 레지스트리 정책. Claude Desktop 구성 프로필과 HKCU 레지스트리 정책은 여기에 포함되지 않습니다).

컴퓨터에 로컬 Claude Code 관리 설정이 단 하나라도 남아 있으면 해당 머신은 콘솔 설정을 완전히 무시하고 The organization's settings won't apply on this computer, because the computer's own managed settings take priority.라는 메시지를 출력합니다.

관리자는 문서화된 두 가지 선택지 중 하나를 고를 수 있습니다.

  • 로컬 관리 설정 제거하기: 콘솔에서 지원하는 규칙을 콘솔로 옮긴 뒤 Claude Code용 managed-settings.json, 드롭인 파일, MDM 프로필 또는 레지스트리 정책을 삭제합니다. 이때 Claude Desktop 구성 프로필은 그대로 두십시오.
  • 콘솔 설정과 로컬 관리 설정 병행하기: 콘솔에서 지정할 수 없는 설정이 꼭 필요한 경우에만 로컬 관리 설정을 유지하고, 조직 ID를 forceLoginOrgUUID 항목으로 추가합니다. 이렇게 하면 머신이 콘솔 설정도 함께 따르면서 다른 조직 로그인을 차단합니다. 로그인된 상태에서는 콘솔 연결 설정이 로컬 연결 설정을 대체하고 양쪽 제한이 합산되며 일부 로컬 관리 설정은 더 이상 적용되지 않습니다. 다만 forceLoginOrgUUID가 설정된 컴퓨터에서는 ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN 또는 apiKeyHelper를 사용하는 세션 시작이 거부되므로, BetterToken 같은 별도 게이트웨이 키도 함께 써야 하는 머신에는 forceLoginOrgUUID를 넣지 마십시오.

콘솔 설정만으로는 개발자의 로그인을 강제할 수 없습니다. 콘솔에서 로그인을 허용한 뒤 CLI 전용 머신에서 조직 로그인을 필수로 만들려면 로컬 관리 설정에 세 가지 키를 추가해야 합니다. 먼저 머신이 콘솔을 따르고 타 조직을 거부하도록 지정하는 forceLoginOrgUUID(단독으로는 로그인을 강제하지 않음), 조직에 로그인한 경우에만 클라우드나 게이트웨이 세션을 허용하는 "enforceAnthropicSignIn": true(true는 따옴표 없이 입력해야 함), 그리고 enforceAnthropicSignIn을 무시하는 구버전을 차단하는 "requiredMinimumVersion": "2.1.330"입니다. 그러나 동일한 프로바이더에서 Claude Desktop도 함께 실행하는 컴퓨터에는 enforceAnthropicSignIn이나 requiredMinimumVersion을 절대 설정하지 마십시오. enforceAnthropicSignIn은 로그인된 상태에서도 Claude Desktop 세션(Code, Cowork, Chat 및 예약 작업)을 중단시키며, requiredMinimumVersion은 Claude Desktop에 번들된 Claude Code 사본이 최소 버전보다 낮을 때마다 모든 Claude Desktop 세션 시작을 차단합니다.

활성 프로바이더 검증 및 단축 링크 오류 해결하기

claude auth login을 실행하고 브라우저에서 조직을 선택한 뒤 다음 두 단계로 설정을 검증하십시오.

  1. 터미널에 Signed in to the organization이 출력되는지 확인합니다. 대신 Login successful.이 표시되었다면 다른 계정을 선택한 것이므로 claude auth login을 다시 실행해야 합니다.
  2. 열려 있는 Claude Code 세션을 모두 닫고 claude를 실행한 뒤 /status를 입력합니다.
    • Setting sources 항목에 Enterprise managed settings (remote)가 포함되어야 합니다.
    • 클라우드 프로바이더를 쓰는 경우 API provider에 해당 프로바이더 이름과 함께 끝에 (chosen by your organization)이 표시됩니다.
    • 게이트웨이를 쓰는 경우 Anthropic base URL에 게이트웨이 주소가 표시되고, 연결이 isn't used 상태라고 알리는 줄이 없어야 합니다.
    • Managed settings (remote) 줄은 Claude Code가 전달할 내용이 있을 때만 나타나며, 문제의 원인과 콘솔 JSON 중 무시된 설정 이름을 알려줍니다.

또한 2.1.330 버전은 /login, claude auth login, claude setup-token에서 출력하는 claude.ai 로그인 URL을 단축했습니다. 단축 URL에서 오류가 발생하거나 스크립트가 URL에서 값을 파싱해야 하는 경우 셸 또는 사용자 설정에 CLAUDE_CODE_FULL_SIGN_IN_LINK=1을 지정하십시오(2.1.330 이상 필요). 엔드포인트를 전환한 뒤 게이트웨이에서 HTTP 403이나 TLS 오류로 트래픽이 차단된다면 Claude Code 403 및 TLS 오류 진단 가이드를 참고하십시오.

/loop 및 최대 30일 정기 작업 변경 사항

2.1.330에서는 세션이 계속 실행되는 동안 정기 예약 작업과 /loop 작업의 최대 실행 기간이 기존 7일에서 최대 30일로 늘어났으며, 이제 Claude Code가 작업 종료 시점도 함께 안내합니다. 단, 두 가지 엄격한 조건이 적용됩니다.

  • 세션이 계속 실행 중이어야 합니다: 예약 작업 레퍼런스에 따르면 /loop와 CronCreate 작업은 세션 범위에 묶여 있으며 Claude Code가 실행 중이고 유휴 상태일 때만 동작합니다. Claude가 긴 요청을 처리하느라 예정 시각을 지나친 경우, 누락된 주기를 모두 몰아서 실행하지 않고 유휴 상태가 되었을 때 한 번만 실행합니다. 일반 터미널을 닫으면 작업이 더 이상 실행되지 않습니다. 터미널을 닫은 뒤에도 /loop 작업을 계속 유지하려면 먼저 /background(또는 /bg)로 세션을 백그라운드로 옮기십시오. 대기 중인 예약 작업이나 /loop 웨이크업이 활성화된 동안에는 Claude Code의 슈퍼바이저 서비스가 터미널 없이도 백그라운드 세션을 유지합니다. 나중에 claude --resume 또는 claude --continue로 재개하면 만료되지 않은 CronCreate 작업은 복원되지만 자체 주기 방식의 /loop는 복원되지 않습니다.
  • 2.1.330 이전에 생성한 작업은 여전히 7일 만에 종료됩니다: Claude Code를 업그레이드해도 기존에 등록된 스케줄의 기간은 자동으로 연장되지 않습니다.

업그레이드 이후 기존 정기 작업을 30일 제한으로 전환하려면 다음 순서를 따르십시오.

  1. 자연어(예: what scheduled tasks do I have?) 또는 CronList로 작업 목록을 조회해 각 작업의 8자리 ID, 스케줄, 다음 실행 시각, 프롬프트를 확인합니다.
  2. 2.1.330 이전에 만든 작업은 자연어(예: cancel the deploy check job)로 취소하거나 해당 ID를 CronDelete에 전달해 삭제합니다.
  3. /loop 또는 자연어 프롬프트로 스케줄을 다시 만들고 2.1.330이 표시하는 새 종료 시각을 확인합니다.

이와 관련된 두 가지 수정 사항도 2.1.330에 포함되었습니다. 첫째, 조직 이름이 없는 건너뛴 예약 작업 안내 메시지가 이제 --resume 옵션으로 Claude Code를 시작하도록 안내합니다. 실행 중인 세션 안에서 /resume을 실행해도 해당 작업이 동작하지 않기 때문입니다. 둘째, VS Code에서 분기(fork)한 대화가 원본 대화의 /loop 스케줄을 중복 실행하던 문제가 해결되었습니다.

복구된 max_tokens 자동 재시도와 게이트웨이 동작

2.1.329 버전에서 LLM 게이트웨이 뒤에 연결했을 때 max_tokens 오류가 발생했다면 2.1.330으로 업그레이드해 클라이언트 측 자동 복구 기능을 되살릴 수 있습니다. Claude Code 공식 체인지로그에는 연속된 세 버전의 변경 이력이 기록되어 있습니다.

  • 2.1.326: max_tokens 값이 모델 상한을 초과했을 때 Anthropic API가 반환한 최댓값으로 자동 재시도하는 기능을 추가했습니다.
  • 2.1.329: 해당 자동 재시도를 제거하고, 출력 토큰 상한이 더 낮은 모델을 게이트웨이 뒤에서 사용하는 경우 CLAUDE_CODE_MAX_OUTPUT_TOKENS를 수동 설정하도록 안내했습니다(자세한 내용은 Claude Code 2.1.329 게이트웨이 체인지로그를 참고하십시오).
  • 2.1.330: 2.1.329의 제거 조치를 되돌리고, max_tokens가 모델 또는 게이트웨이 제한을 초과할 때의 자동 재시도를 복구했습니다.

이 변화는 사용자 지정 모델 별칭이나 출력 한도가 낮은 모델에 가장 직접적인 영향을 미칩니다. Claude Code 환경 변수 레퍼런스에 따르면 인식되지 않는 모델 ID는 기본 출력 토큰 32000, 상한 128000으로 설정됩니다. 게이트웨이 호환성 가이드에서는 대부분의 재시도 로직이 업스트림 오류 문구를 기준으로 동작하므로 게이트웨이가 업스트림 오류 응답 본문을 수정하지 말고 그대로 전달해야 한다고 명시합니다. 게이트웨이가 HTTP 상태 코드를 유지하더라도 업스트림 오류를 자체 래퍼(엔벨로프)로 감싸면 자동 복구 경로가 깨집니다.

일반 응답이 정상적으로 돌아왔다는 사실만으로는 첫 요청이 이미 게이트웨이 한도 안에 들었을 수도 있으므로 자동 재시도가 작동했다고 단정할 수 없습니다. Claude Code가 보고된 max_tokens 한도로 재시도했는지 확인하려면 요청 필드가 기록되는 게이트웨이 로그를 점검하십시오. 상한을 초과한 첫 요청이 max_tokens 오류를 반환하고, 그 직후 오류에 담긴 더 낮은 max_tokens 값으로 재시도 요청이 이어지는지 확인하면 됩니다. BetterToken 워크스페이스 대시보드에서 공식적으로 제공하는 필드는 잔액, 요청 시각, 모델, 상태, 입력/출력/캐시 토큰 사용량, 요금입니다. 실패 항목 바로 뒤에 성공 항목이 이어진다면 단서가 될 수 있으나 두 요청이 같은 턴에서 발생했는지나 재시도된 max_tokens 값까지는 증명하지 못하므로, 정확한 검증은 요청 필드가 노출되는 게이트웨이 로그에 의존해야 합니다. 2.1.330에서도 게이트웨이가 계속 max_tokens 오류를 반환한다면 대체 수단으로 CLAUDE_CODE_MAX_OUTPUT_TOKENS에 활성 모델과 게이트웨이 경로가 허용하는 출력 토큰 상한을 설정하십시오(두 상한을 모두 아는 경우 더 낮은 값을 사용합니다). 이 상한을 지정한 뒤 응답이 성공하는 것은 제한된 요청이 통과한다는 뜻이지 자동 재시도가 발동했다는 증거는 아닙니다. 게이트웨이 뒤에서 컨텍스트 윈도우 가정까지 충돌한다면 인식되지 않는 게이트웨이 모델 제한 해결 가이드를 함께 확인하십시오.

게이트웨이 구성과 관련된 세 가지 추가 변경 사항도 2.1.330에 반영되었습니다.

  • 게이트웨이 환경의 WebFetch /effort 수정: 게이트웨이가 소형 고속 모델을 거부할 때 WebFetch 페이지 요약이 /effort 수준을 무시하던 문제를 수정했습니다.
  • 인식되지 않는 sonnet/haiku ID용 짧은 시스템 프롬프트: "sonnet"이나 "haiku"가 포함된 미인식 모델 이름도 다른 미인식 이름처럼 짧은 시스템 프롬프트를 사용합니다. 모든 모델에 전체 프롬프트를 적용하려면 CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0을 설정하십시오.
  • Claude apps 게이트웨이 토큰 절감: Claude apps 게이트웨이에 로그인한 터미널 세션에서 서브에이전트 진행 요약이 전체 대화가 아닌 짧은 메모를 바탕으로 작성되도록 바뀌어 토큰 사용량이 크게 줄었습니다.

easel 차트 제어 및 기업 MCP 경고 해제하기

2.1.330에는 내장 모드인 easel(/plugin에서는 cc-plugin-easel)이 추가되었습니다. 이 기능은 Claude에 차트 그리기 도구를 제공하고, Prometheus 범위 쿼리 결과처럼 지원되는 시계열 형식의 MCP 결과 아래에 자동으로 차트를 그려줍니다. Claude Code 체인지로그와 모드 개요 문서에 명시된 easel 요구 사항은 다음과 같습니다.

  • 로그인 조건: claude.ai 구독(Pro, Max 및 제공 대상 Team, Enterprise). API 키 세션이나 서드파티 게이트웨이 세션에서는 로드되지 않습니다.
  • 플랫폼: WSL 외부의 macOS 또는 Linux.

easel은 두 단계로 제어할 수 있습니다.

  • 자동 차트만 끄기: /config를 실행하고 Auto charts를 끕니다. 이 상태에서도 사용자가 요청하면 Claude가 차트를 그릴 수 있습니다.
  • 모드 전체 비활성화하기: /plugin을 열고 Installed 탭의 Built-in 아래에서 cc-plugin-easel을 비활성화합니다. 사용자 설치 모드를 중지하는 설정 및 플래그(disableAllHooks, --bare, --safe-mode)는 내장 모드를 멈추지 못합니다.

조직에서 allowedMcpServers 또는 deniedMcpServers로 MCP 접근을 필터링하며(MCP 서버 접근 제어 문서 참고) 내장 차트 도구를 제외한 환경이라면, 2.1.330에서 시작할 때마다 뜨던 번거로운 경고가 사라집니다. 이제 매 시작 시 MCP server blocked by enterprise policy: easel 경고가 출력되지 않으며, 내장 차트 도구는 기업 정책에 따라 계속 차단된 상태로 유지됩니다.

「confirm-before-risky-actions」 루머와 실제 2.1.330 변경 사항

2026년 11월 20일 X의 @ClaudeCodeLog 같은 서드파티 릴리스 요약 계정은 새로운 “confirm-before-risky-actions policy”를 2.1.330의 핵심 기능으로 소개했습니다. 같은 날 @alexmichael은 해당 정책이 이미 2.1.321에서 도입된 항목이라고 지적했습니다.

공식 2.1.330 체인지로그(CHANGELOG.md 및 code.claude.com/docs/en/changelog)에는 confirm-before-risky-actions 항목이 없습니다. 2.1.330에 실제로 포함된 승인 관련 변경은 범위가 더 좁습니다. 루트, 홈, 최상위 폴더 또는 작업 폴더를 대상으로 하는 더 많은 rm 명령이 실행 전 승인을 요구하게 되었고, 응답할 사람이 없는 환경에서는 Claude Code가 해당 명령을 거부합니다.

함께 확인할 기타 2.1.330 안정성 수정 사항

2.1.330에는 일상적인 개발 흐름을 막던 여러 안정성 수정 사항도 포함되었습니다.

  • 세션 멈춤 현상 해결: 매우 긴 대화를 압축한 직후 몇 분 동안 멈추던 문제, 일부 페이지에서 WebFetch가 멈추거나 빈 결과를 반환하던 문제, 그리고 Linux 및 WSL에서 2분 이상 절전 모드에 들어간 뒤 첫 프롬프트에서 3분간 대기하던 문제를 수정했습니다.
  • 병렬 세션 및 설정 보호: 여러 Claude Code 프로세스가 동시에 저장할 때 사용자 설정이 유실되던 문제를 고쳤고, ExitWorktree 및 워크트리 종료 대화 상자가 다른 실행 중 세션에서 사용 중인 워크트리를 삭제하지 못하도록 막았습니다. 또한 API가 거부하는 입력 스키마를 가진 MCP 도구가 많을 때 "JSON schema is invalid" 오류로 턴이 실패하고 세션 파일이 수 메가바이트씩 커지던 문제도 수정되었습니다.
  • 검색, 리뷰, 러너 개선: /config 검색에서 입력한 문자로 시작하는 대부분의 설정 이름이 먼저 표시되도록 개선되었으며(effort로 Model, dark나 light로 Theme 검색 가능), /ultrareview는 셸이 다른 저장소로 이동한 경우 실행을 멈추고 두 폴더 이름을 모두 표시합니다. 또한 Team 및 Enterprise 플랜에서 월간 지출 한도 잔액이 일반 리뷰 비용보다 적을 때 남은 한도를 안내하며, 자체 호스팅 러너에는 --start-dir 및 SELF_HOSTED_RUNNER_START_DIR가 추가되었습니다.
  • VS Code 확장 프로그램: /fork, /workflows, claudeCode.escapeStopsClaude가 추가되었고, 코드 블록을 복사할 때 끝에 줄바꿈이 붙어 붙여넣기와 동시에 명령이 실행되던 버그가 수정되었습니다.

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

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

무료로 시작하기