무엇이 바뀌었나?
Claude Code 2.1.316이 2026년 10월 31일 출시됐습니다. ultrathink와 서브에이전트 effort를 다루는 환경 변수, Claude apps gateway의 공유 예산과 정책 병합 방식이 새로 들어왔고, Opus 4.8의 fast mode 지원 중단이 공지됐습니다. 수정은 Bash 도구의 셸, Vertex AI와 Amazon Bedrock의 모델 별칭, gateway 모델 제한, auto mode, VS Code 확장, 클라우드 세션, Claude Tag에 걸쳐 50건이 넘습니다.
새 기능
-
CLAUDE_CODE_DISABLE_ULTRATHINK프롬프트에
ultrathink라는 단어가 들어가면 그 턴이 높은 effort로 실행되는데, 이 키워드를 끌 방법이 없었습니다. 이 환경 변수를 설정하면ultrathink키워드가 동작하지 않습니다. -
CLAUDE_CODE_SUBAGENT_EFFORT서브에이전트는 따로 지정하지 않으면 세션의 effort를 그대로 물려받았습니다. 이제 이 환경 변수로, 다른 설정이 effort를 정하지 않을 때 서브에이전트가 쓸 effort 수준을 따로 정할 수 있습니다.
-
CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROPClaude Code는 서로를 순환해 인증하는 시스템 교차 인증서(cross-certificate)를 빼고 사용합니다. 사설 CA(사내 인증 기관)가 이런 인증서를 필요로 하는 서버에 연결해야 한다면, 이 환경 변수로 해당 인증서를 유지할 수 있습니다.
-
Claude apps gateway의 그룹 공유 예산(pooled group budget)
지금까지는 구성원마다 개별 사용 한도만 둘 수 있었습니다. 이제 지출 한도 관리 API(spend limits admin API)의
pooled_budget으로, 그룹 구성원이 함께 쓰는 월 예산 하나를 각자의 한도 위에 추가로 둘 수 있습니다. -
Claude apps gateway의
managed.policy_mode: layered개발자에게 맞는 정책이 여러 개여도 첫 번째 정책만 적용됐습니다.
layered로 설정하면 맞는 정책이 모두 적용되고, 각 정책은 목록에서 아래에 있는 정책 위에 병합됩니다. -
Bedrock 업스트림의
guardrail.input_taggingAmazon Bedrock guardrail의 프롬프트 공격(prompt attacks) 필터는 검사할 입력이 지정된 태그로 감싸져 있어야 동작합니다. Claude apps gateway의 Bedrock 업스트림에서 이 설정을 켜면 프롬프트를 그 입력 태그로 감싸 보냅니다.
all_messages_and_system을 고르면 시스템 프롬프트까지 태그로 감쌉니다. -
[VS Code] 채팅 패널에서 Claude apps gateway 로그인
gateway에 로그인하려면 터미널을 열어야 했습니다. 이제 채팅 패널에서 바로 로그인할 수 있습니다.
-
[Cloud sessions] MCP 서버 입력 양식 카드
클라우드 세션에서 MCP 서버가 양식 입력을 요청하면, 사용자가 보지도 못한 채 요청이 취소됐습니다. 이제 양식 카드가 나타나 내용을 채우거나 거절할 수 있습니다.
-
[Cloud sessions] “Catching up…” 표시
클라우드 세션이나 Remote Control 세션으로 돌아왔을 때 메시지가 아직 최신 상태로 맞춰지는 중인지 알 수 없었습니다. 이제 맞춰지는 동안 “Catching up…” 줄이 표시됩니다.
-
[Code Review] 심각도별 조사 결과 카드
Code Review 분석(analytics) 페이지에 기간 내 전체 조사 결과 수, 심각도별로 쌓은 일별 차트, 심각도별 건수를 보여 주는 카드가 추가됐습니다.
주요 개선
-
Claude Desktop Code 탭과 웹에서 시작한
/code-review의 결과 카드Claude Desktop의 Code 탭이나 웹에서
/code-review를 시작하면, 클라우드 세션과claude remote-control세션에서는 결과가 일반 텍스트 목록으로만 나왔습니다. 이제 결과 카드(findings card)로 표시됩니다. -
큰 저장소에서
/diff속도큰 저장소에서는
/diff를 갱신할 때마다 저장소 전체를 훑는 git 명령이 여러 번 실행됐습니다. 이제 보통 한 번 덜 실행되고, git이 느릴 때는 갱신 간격을 넓힙니다. -
GitHub 원격 저장소가 없을 때의 안내
/ultrareview, 클라우드 세션, 클라우드 에이전트가 GitHub 원격 저장소를 찾지 못하면 무엇을 해야 하는지 분명하지 않았고,/ultrareview는gh가 거부하는gh명령을 제안했습니다. 이제 github.com/new에서 저장소를 만들라고 안내하고, 잘못된gh명령은 제안하지 않습니다. -
SSL 인증서 오류 메시지
SSL 인증서 오류가 나도 원인을 짐작하기 어려웠습니다. 이제 서버가 중간 인증서(intermediate certificate)를 빠뜨린 경우 등 가능성 높은 원인과 각각의 해결 방법을 알려 줍니다.
-
Team, Enterprise의 서버 관리 설정 적용 방식
Anthropic API에서 받아 온 서버 관리 설정(server-managed settings)은 승인 확인을 거쳐야 적용됐습니다. 이제 확인 없이 바로 적용되고, 검증되지 않는 저장된 사본은 거부합니다.
-
auto mode의 예약 작업 프롬프트 규칙 유지
"$defaults"가 없는autoMode.allow목록을 쓰면 예약 작업 프롬프트에 대한 기본 제공 규칙까지 사라졌습니다. 이제 이 규칙은 유지됩니다. -
[VS Code]
ultrathink를 터미널과 같게VS Code에서도
ultrathink가 들어간 턴은xhigheffort로 실행되고, 채팅 입력창에 무지개색으로 표시됩니다. 터미널과 같은 동작입니다. -
[Cloud sessions] Enterprise 구성원의 네트워크 비밀 값 관리
Enterprise 구성원은 자기 클라우드 환경의 네트워크 비밀 값(network secrets)을 보기만 할 수 있었습니다. 이제 직접 추가하고 삭제할 수 있습니다.
-
[Cloud sessions] Changes 창의 안내 위치
Changes 창에서 목록이 무엇을 생략했는지 알려 주는 안내가 diff 위에 한 줄을 차지했습니다. 이제 브랜치 이름 옆 배지로 표시됩니다.
-
[Claude Tag] 채널 참여 방식 선택
Slack 채널의 Respond automatically 스위치가 채널 Configure 페이지와 Claude Tag 관리자 설정의 “How Claude participates” 선택 항목으로 바뀌었습니다.
주요 버그 수정
셸과 Bash 도구
- 인증 정보가 거부되거나 클라우드 세션이 보관 처리되는 등 Claude Code가 스스로 종료될 때 macOS와 Linux에서 셸 명령이 계속 실행되던 문제 수정.
- 값에 줄바꿈이 있는 bash 별칭(alias)과 이름이 대시(-)로 시작하는 함수가 Bash 도구의 셸에서 깨지거나 사라지던 문제 수정. Git Bash는 예외입니다.
SHELLOPTS를 내보낸(export) 상태에서 Bash 도구로 시작한 bash 스크립트가 첫 명령만 실행하고 멈추던 문제 수정.- 명령이 타입 캐스트,
param,using, 특성(attribute)으로 시작하면 PowerShell 훅이 종료 코드 2를 받아도 차단하지 않던 문제 수정. - [Windows] rc 파일이 errexit, pipefail을 설정하고 winpty 별칭만 정의하거나 아무 별칭도 정의하지 않으면, Git Bash에서 Bash 도구가 사용자 별칭과 함수를 잃던 문제 수정.
- 검색 프로세스가 시간 초과로 종료 신호를 받고도 끝나지 않으면 Grep과 Glob이 결과를 돌려주지 않던 문제 수정. Windows에서 보고됐습니다.
모델과 네트워크
- Vertex AI와 Amazon Bedrock에서 최신 모델을 계정이나 리전에서 아직 쓸 수 없을 때,
sonnet,opus,haiku별칭이 이전 모델로 전환하지 않고 세션 중간에 오류를 내던 문제 수정. - 부모 서브에이전트의 모델을 물려받은 서브에이전트가 백그라운드 작업이나 메시지로 다시 깨어나면 메인 모델로 바뀌던 문제 수정.
- 이 버전이 인식하지 못하는 모델을
/model <id>로 지정해도 경고가 없던 문제 수정. 이런 모델은 자동 압축(auto-compact)이 20만 토큰 컨텍스트 창을 가정한다는 점을 이제 알려 줍니다. - 압축된 응답이 중간에 끊기거나 손상되면 일부 네트워크 요청이 멈추던 문제 수정.
Claude apps gateway와 보안
- Claude apps gateway가 요청에 들어 있는 모든 모델을
availableModels,deniedModels,models와 대조하지 않던 문제 수정. 이제 차단된 모델이 들어 있는 요청은 해당 필드 이름이 적힌 400 오류를 받습니다. - 관리 설정이 Claude apps gateway를 요구하는 환경에서
claude auth login이 실행을 거부하던 문제 수정. 이제 터미널에서는 gateway 로그인 화면을 보여 줍니다. --restricted세션에서 Read 허용 규칙이 적용되는 작업 디렉터리 밖 파일이 업로드되던 문제 수정.- plugin MCP의
headersHelper스크립트가, 자격 증명처럼 보이는 이름의 환경 변수가1같은 스위치 값으로 설정돼 있으면 손상된CLAUDE_PLUGIN_ROOT와 서버 URL을 받던 문제 수정.
auto mode와 헤드리스 실행
"$defaults"가 없는 관리autoMode.allow목록에, 호스트 앱의--settings,/permissions에서 처음 추가한 규칙,/auto-mode-setup때문에 기본 제공 예외가 다시 들어가던 문제 수정.- 서버가 안전 판정을 돌려주지 않아 auto mode가 턴을 멈췄는데도 클라우드 세션과 클라우드 예약 작업이 실패로 표시되지 않던 문제 수정.
- 백그라운드 에이전트가 아직 실행 중일 때
claude -p의 텍스트 출력이 auto mode가 턴을 멈춘 이유를 알려 주지 않던 문제 수정. - 실험적 beta를 끈 프록시나 LLM gateway 뒤에서 호스트 애플리케이션(Claude Desktop 등)이 시작한 세션에서
CLAUDE_CODE_AUTO_MODE_SERVER=1이 무시되던 문제 수정.
SDK와 도구
- SDK의
register_repo_root제어 요청이CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1상태에서 작업 디렉터리 밖 디렉터리의 CLAUDE.md를 불러오지 않던 문제 수정. - Artifact 도구가
self수준의 아티팩트 데이터베이스 접근 규칙을?로 표시하던 문제 수정. 이 규칙을 없애는 재게시를 거부할 때 해당 규칙을 다시 보여 주지 않던 문제도 수정됐습니다.
화면과 입력
- 보이지 않는 문자가 들어간 프롬프트를 보내려면 Enter를 두 번 눌러야 하던 문제 수정. 이제 일반 프롬프트는 문자를 정리해 첫 Enter에 보내고, 명령은 지금처럼 검토를 기다립니다.
/clear나/resume을 실행할 때 대화 일부가 아직 저장 중이었다면, 그 대화를 다시 열어도 계획(plan)이 복원되지 않던 드문 문제 수정.- “hold space to speak” 안내가 한 세션 안에서 세 번의 표시 횟수를 모두 써 버리고, 푸시 투 토크(push-to-talk) 키가 지정되지 않았을 때 빈 키를 보여 주던 문제 수정.
- 좁은 터미널에서 첫 실행 설정이 보안 안내와 터미널 설정 설명의 단어를 빠뜨리던 문제 수정.
- Enterprise 설문 카드가 입력한 1이나 0을 잠시 뒤 자동으로 답으로 받던 문제 수정. 이제 입력한 답은 Enter를 눌러야 제출됩니다.
셀프 호스팅 러너
- 세션 프로세스가 교체된 뒤에는, Claude가 작업하는 동안 보낸 메시지가 Stop을 누른 뒤에도 답변되던 문제 수정.
- 세션이 새 컴퓨터로 옮겨 갈 때 MCP 서버의 켜기/끄기 설정이 가끔 사라지던 문제 수정.
VS Code 확장
- 모델 설정에
opus[1m]처럼[1m]태그가 붙어 있으면 Effort 슬라이더, Ultracode 스위치, 모델 이름이 보이지 않던 문제 수정. - 설정 파일에 오류가 있을 때 저장된
/btw곁가지 질문 기록이 너무 일찍 삭제되던 문제 수정. - 계획을 “Yes, and manually approve edits”로 승인한 대화가 다시 불러오거나 재시작한 뒤 Auto 모드로 돌아오던 문제 수정.
Cloud sessions
- Claude가 디렉터리를 옮긴 뒤 클라우드 세션 Files 창의 파일 검색이 폴더를
../..경로로 보여 주던 문제 수정. 이제 프로젝트 루트 기준 경로로 표시합니다.
Claude Tag
- Slack 채널에서 Claude가 만든 캔버스가 다른 채널이나 DM에도 공유되면, 원래 채널에서 그 캔버스를 고치거나 내용을 덧붙이지 못하던 문제 수정.
- 양쪽 조직 모두 Claude를 설치한 Slack Connect 스레드에서, Slack이 답글을 상대 조직의 앱으로 전달하면 태그 없는 답글에 응답하지 않던 문제 수정.
- 클라우드 예약 작업의 Slack 실시간 상태 체크리스트가 반쯤 완료된 상태로 남던 문제 수정. 이제 실행 중에 올린 최상위 메시지를 그 실행이 수정할 수 있습니다.
알아두면 좋은 점
- Opus 4.8에서 fast mode를 쓰고 있다면 2026년 11월 30일 전에 Opus 5.5로 옮기세요. Opus 4.8의 fast mode는 2026년 10월 30일부로 지원 중단됐고, 11월 30일에 제거되면 Opus 4.8의 fast mode 요청은 일반 Opus 4.8로 대체되지 않고 오류를 돌려줍니다. 속도 향상을 계속 쓰려면 Opus 5.5로 전환해야 합니다.
- 서브에이전트를 세션보다 낮은(또는 높은) effort로 돌리고 싶다면
CLAUDE_CODE_SUBAGENT_EFFORT를 설정하세요. 다른 설정이 effort를 정하지 않은 서브에이전트에만 적용됩니다. - Team, Enterprise 로그인에서는 Anthropic API에서 받아 온 서버 관리 설정이 이제 승인 확인 없이 바로 적용됩니다.
"$defaults"없이autoMode.allow목록을 관리하고 있다면 예약 작업 프롬프트에 대한 기본 제공 규칙은 이제 목록과 관계없이 유지됩니다.- 이 글은 주요 항목만 정리했습니다. 전체 변경 목록은 GitHub 릴리스 노트에서 볼 수 있습니다.