claudekit / updates / claude-code-2-1-280
[ PATCH · ]

Claude Code 2.1.280

Claude Opus 5.5(`claude-opus-5-5`)가 추가돼 기본 Opus 모델이 됐고, Pro와 Team Standard 플랜의 기본 모델도 Sonnet에서 Opus로 바뀌었습니다. 대화상자에서 실수로 누른 `y`, `n`이 확인이나 취소로 처리되지 않고, MCP 도구 설명 길이 제한을 바꾸는 환경 변수가 생겼습니다. 버그 수정에는 심볼릭 링크 경로를 거친 쓰기가 작업 폴더 밖에 쓰이는데도 자동 승인되던 문제, auto mode가 같은 작업을 끝없이 재시도하던 문제, 대화상자에서 Ctrl+C를 두 번 누르면 Claude Code가 종료되던 문제가 포함됩니다.

Claude Code
공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

무엇이 바뀌었나?

Claude Code 2.1.280이 2026년 9월 22일 출시됐습니다. 가장 큰 변화는 Claude Opus 5.5 추가입니다. 기본 Opus 모델이 Opus 5.5로 바뀌었고, Pro와 Team Standard 플랜의 기본 모델도 Opus가 됐습니다. 권한 측면에서는 심볼릭 링크를 거친 쓰기와 auto mode의 재시도 동작이 바로잡혔습니다. 나머지 수정은 대화상자의 키 입력과 마우스 동작, 세션 재개, 백그라운드 서브 에이전트, 플러그인 관리에 넓게 걸쳐 있습니다.

새 기능

  • Claude Opus 5.5 (claude-opus-5-5)

    Opus 5.5가 추가되어 기본 Opus 모델이 됐습니다. 컨텍스트는 100만(1M) 토큰이고, 가격은 백만 토큰당 $4/$20, 캐시 읽기는 백만 토큰당 $0.20입니다.

  • CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH

    MCP 도구 설명과 서버 안내문(server instructions)은 2,048자에서 잘렸고, 이 한도를 바꿀 방법이 없었습니다. 이 환경 변수로 세션의 모든 MCP 서버에 적용되는 한도를 바꿀 수 있습니다.

  • 전체 화면 모드의 마우스 지원 확대

    전체 화면 모드에서 일부 목록은 마우스로 다룰 수 없었습니다. 이제 휠로 /skills 목록을 스크롤하고, /plugin에서 스킬 상태 옵션을 클릭으로 고를 수 있습니다.

  • hook_execution_complete OpenTelemetry 이벤트의 출력 크기 정보

    훅 출력이 얼마나 컸는지 텔레메트리로는 알 수 없었습니다. 이제 이 이벤트에 훅 출력 크기와, 너무 커서 파일로 저장된 출력의 개수가 함께 기록됩니다.

  • [VSCode] 새 대화상자와 명령

    터미널에만 있던 기능이 VS Code 확장에도 생겼습니다. 세션의 버전, 계정, 모델, 서버 정보를 보여 주는 Status 대화상자(/status), 샌드박스 모드와 샌드박스 밖 실행 허용 여부, 제외 명령을 설정하는 Sandbox 대화상자(/sandbox), 확장 상태와 설치, 재연결, 권한 페이지를 모은 Claude in Chrome 대화상자(/chrome)가 추가됐습니다. 대화를 일반 텍스트로 복사하거나 저장하는 Export conversation(/export), plan mode로 전환하거나 계획을 보여 주는 /plan도 생겼습니다. Slash commands 대화상자에는 스킬마다 출처, 예상 토큰 수, 켜짐 여부가 표시되고 클릭으로 켜고 끌 수 있으며, /skills로 열 수 있습니다.

  • [Claude Tag] Slack 스레드의 Working 표시와 Stop 버튼

    채널에서 Claude가 작업 중인지 알기 어렵고 중간에 멈출 방법도 없었습니다. 이제 Claude의 스레드에 Slack 기본 Working 표시, Stop 버튼, 스레드 제목이 붙습니다. 표시는 Claude가 끝날 때까지 유지되고, Stop을 누르면 작업이 중단됩니다. 또한 Restrict 또는 Channel only 게스트 설정에서 게스트가 들어오거나 마지막 게스트가 나가 Claude의 응답 방식이 바뀌면 채널에 짧은 안내가 올라옵니다.

주요 개선

목록과 대화상자

  • /permissions 탐색

    규칙을 보거나 추가, 삭제하고 나면 포커스가 규칙 목록에서 벗어났고, 규칙 삭제와 디렉터리 제거 확인은 기본 선택이 “예”였습니다. 이제 포커스가 규칙 목록으로 돌아오고, 두 확인 창의 기본 선택은 No입니다. 규칙 목록에서 ←/→나 Tab을 누르면 포커스를 옮기지 않고 탭만 바뀝니다.

  • 긴 목록의 스크롤바

    /artifacts와 /workflows 목록이 길면 얼마나 가려져 있는지 알 수 없었습니다. 이제 오른쪽 끝의 스크롤바로 숨은 분량과 현재 위치를 보여 줍니다.

  • 화면 표시 정리

    워크플로 진행 트리에서 실행 중인 에이전트와 단계는 ⟳ 대신 흐린 점으로 표시됩니다. 전체 화면에서 /plugin의 Add Marketplace 양식과 /workflows 상세 화면에 겹쳐 그려지던 상자와 가로줄이 없어졌습니다. /autocompact의 하단 안내는 값을 조정하는 ←/→ 키를, /fast의 하단 안내는 켜고 끄는 Space 키를 알려 줍니다.

  • 언어를 지정하지 않은 코드 블록

    언어를 적지 않은 코드 블록은 주변 문장과 구분이 잘 되지 않았습니다. 이제 인라인 코드처럼 색이 입혀져 명령이 눈에 띕니다.

  • @ 파일 추천 순서

    폴더 이름에만 검색어가 걸친 파일이 파일 이름에 검색어가 든 파일보다 위에 올 수 있었습니다. 이제 파일 이름이 일치하는 쪽이 먼저 표시됩니다.

진단과 안내

  • /cost의 캐시 미스 원인

    thinking 모드와 thinking 표시 방식을 바꾼 것도 캐시 미스 원인으로 이름을 밝힙니다.

  • UserPromptSubmit 훅 시간 초과 안내

    어떤 훅 명령이 시간을 초과했는지 알 수 없었습니다. 이제 안내 메시지와 디버그 로그에 해당 훅 명령이 표시됩니다.

  • /btw와 실행 중인 도구

    도구가 아직 실행 중일 때 /btw로 곁가지 질문을 하면, 그 호출을 실패한 것으로 읽었습니다. 이제 진행 중인 호출로 인식합니다.

  • 기타 안내

    /install-github-app의 GitHub CLI 확인 단계와 저장소 선택 단계에 “Esc to cancel”이 표시됩니다. 세션 간 메시지 기능의 시작 경고는 --debug-file이 사용자가 지정한 경로에 디버그 로그를 쓴다는 점을 설명합니다.

아티팩트와 /ultrareview

  • 읽지 못한 아티팩트 링크 알림

    Claude가 받은 아티팩트 링크를 읽지 못해도 그대로 작업을 이어 갔습니다. 이제 계속하기 전에 사용자에게 먼저 알립니다.

  • 아티팩트 페이지

    열람 화면에서 막히는 Print 버튼, 확인 대화상자, 기기 기능이 빠졌고, 이메일과 전화번호는 텍스트로 표시됩니다. 다크 모드가 입력 양식과 스크롤바에도 적용됩니다.

  • /ultrareview 업로드에서 제외되는 파일 확대

    id_rsa copy나 kubeconfig (1).yaml처럼 이름을 바꾼 주요 파일 사본은 업로드 제외 대상에서 빠질 수 있었습니다. 이제 이런 사본도 로컬에만 남습니다.

동작이 바뀐 항목

  • Pro, Team Standard 플랜의 기본 모델 (변경)

    기본 모델이 Sonnet에서 Opus로 바뀌어 Max, Team Premium, Enterprise와 같아졌습니다.

  • 새 모델의 effort 수준 (변경)

    /effort가 모델별로 저장되기 전에 저장한 effort 수준은 Opus 5.5 같은 새 모델에 적용되지 않습니다. 새 모델은 수준을 직접 고를 때까지 기본값으로 시작합니다.

  • Opus 4.7, Opus 4.8, Fable 5의 출시 기본 effort (변경)

    이 모델들은 -p나 Agent SDK의 /effort, 프로젝트, 관리형, --settings의 effortLevel, 모델별 수준을 무시하고 출시 당시 기본 effort를 유지했습니다. 이제 지정한 값을 따릅니다.

  • 대화상자의 y, n 키 (변경)

    실수로 누른 n이 대화상자를 닫고 y가 확인해 버렸습니다. 이제 Enter와 Esc로 확인과 취소를 합니다. 이전처럼 쓰려면 keybindings.json에서 y, n을 confirm:yes, confirm:no에 연결합니다.

  • 전체 화면 모드의 ctrl+l, cmd+k 되돌림 (변경)

    2.1.260에서 이 키가 대화 기록 화면을 지우도록 바뀌었으나, 다시 화면을 새로 그리는 동작으로 돌아갔습니다.

  • 예약된 이름을 흉내 낸 플러그인 마켓플레이스 거부 (변경)

    예약된 마켓플레이스 이름을 흉내 낸 마켓플레이스는 추가할 수 없고, 이미 추가돼 있으면 더 이상 불러오지 않습니다.

  • PermissionRequest 훅의 agent 유형 (변경)

    agent 유형 훅은 이 위치에서 요청을 허용하거나 거부할 수 없는데도 실행됐습니다. 이제 실행되지 않고, command 또는 http 훅을 쓰라는 오류가 표시됩니다.

  • 셀프 호스팅 러너의 라이프사이클 훅 git (변경)

    라이프사이클 훅 안의 git은 러너 공유 git 파일에 지정된 훅 폴더와 프로그램을 무시합니다. 그 파일에 적힌 로컬 경로와 git:// 원격 저장소는 이제 GIT_ALLOW_PROTOCOL이 필요합니다.

  • [VSCode] 붙여 넣은 텍스트와 프롬프트 처리 (변경)

    800자 또는 줄바꿈 2개를 넘는 붙여 넣기는 표시가 붙어 Claude가 직접 입력한 내용과 구분할 수 있습니다. 붙여 넣은 텍스트의 보이지 않는 유니코드 서식 문자와 태그 문자는 안내와 함께 제거되고, 그 밖의 입력에서도 보내기 전에 제거됩니다. “Open in New Tab”은 마지막 편집기 그룹 뒤가 아니라 현재 작업 중인 편집기 그룹 옆에 Claude를 엽니다.

  • [Claude Code on the web] 관리자 설정과 클라우드 세션 (변경)

    Routines 켜기, 끄기 설정이 Admin settings → Capabilities → Remote sessions로 옮겨졌고, Claude Code 관리 페이지에서 링크로 연결됩니다. Claude 앱에서 보는 클라우드 세션은 사용자에게 줄 파일을 앱이 열 수 있는 위치에 저장합니다. 관리자가 GitHub를 끈 조직에서 셀프 호스팅 환경으로 세션을 시작할 때 나오던 빈 저장소 선택기는 제거됐습니다.

  • [Claude Tag] GitHub 연결 안내 (변경)

    관리 설정의 GitHub 배너가 연결되지 않은 이유(로그인 안 함, 앱 미연결 또는 미설치, 로그인 만료, SSO 미승인)를 알려 줍니다.

  • [Code Review] REVIEW.md 크기 제한 안내 (변경)

    REVIEW.md 지침이 크기 제한을 넘어 잘리거나 빠지면, Code Review 체크 결과에 해당 파일과 한도가 표시됩니다.

주요 버그 수정

권한과 auto mode

  • 심볼릭 링크 경로를 거친 쓰기가 작업 폴더 안의 경로 표기로 판단되던 문제 수정. 이제 권한 확인에 실제로 쓰이는 위치가 표시되고, acceptEdits, 허용 규칙, auto mode가 작업 폴더 밖에 쓰이는 쓰기를 승인하지 않습니다.
  • 안전 검사가 검토를 거절한 작업을 auto mode가 계속 재시도하던 문제 수정. 이제 한 번 거부하고 재시도해도 소용없다고 알립니다.
  • 안전 검사가 응답하지 않을 때 auto mode가 쉬지 않고 계속 거부하던 문제 수정. 재시도 간격이 점점 늘어나고, 연속 10번 실패하면 메시지와 함께 턴을 멈춥니다.
  • 모델이 file_path, content 대신 path, file_text, file_content나 불필요한 description을 보내면 Write 호출이 검증에 실패하던 문제 수정.

대화상자와 키 입력

  • /model, /effort, /config, /permissions, /plugin 등 대부분의 대화상자에서 Ctrl+C나 Ctrl+D를 두 번 누르면 대화상자가 닫히는 대신 Claude Code가 종료되던 문제 수정.
  • 터미널 창을 앞으로 가져오기 위해 한 클릭이 포인터 아래 항목(검색 선택기, 탭 표시줄, 에이전트와 워크플로 행, 슬래시 명령 링크, 추천 드롭다운)까지 실행하던 문제 수정.
  • 대화상자의 텍스트 입력란에서 입력한 글자, 숫자, Space가 같은 키의 단축키로 처리돼 사라지던 문제 수정.
  • Home, End가 /config 설정 목록과 /model, /memory, 권한 확인 같은 선택 목록에서 동작하지 않던 문제, /skills 메뉴에서 PgUp/PgDn이 처음이나 끝에서 멈추지 않고 반대쪽으로 넘어가던 문제, /config 목록에서 Tab이 선택한 설정 값을 조용히 바꾸던 문제 수정.
  • 전체 화면 모드에서 숨은 옵션이 있는 선택 목록(/model, /permissions 등)이 마우스 휠로 스크롤되지 않던 문제 수정.
  • 음성 받아쓰기가 Ctrl+C로 멈추지 않고(프롬프트는 지워지지만 마이크는 계속 녹음), 변환 처리 중 Esc로 취소되지 않으며, 변환 결과 화면과 vim NORMAL 모드에서 Space를 누르고 있으면 받아쓰기가 시작되던 문제 수정.
  • Ctrl+S로 보관한 ! 셸 모드 프롬프트가 복원 시 일반 프롬프트로 돌아오고, 보관 직후 /가 파일 경로를 나열하던 문제 수정.
  • 백그라운드 서브 에이전트가 실행 중일 때 종료하려면 Ctrl+C를 서너 번 눌러야 하던 문제 수정. 이제 두 번이면 종료됩니다.

보이지 않는 문자 제거

  • Windows 터미널에서 Enter를 눌러 보이지 않는 문자가 제거된 뒤 프롬프트 줄이 뒤섞인 채로 남던 문제 수정. 이제 화면을 다시 그려 실제로 보낼 텍스트를 그대로 확인할 수 있습니다.
  • 보이지 않는 문자 정리가 페르시아어, 아랍어에서 라틴 문자 단어나 숫자에 접미사를 붙일 때 쓰는 ZWNJ(폭 없는 비결합자, 예: “PDF”의 복수형)까지 제거하던 문제 수정.

세션과 API 오류

  • “role ‘system’ must precede an ‘assistant’ message” API 오류로 매 턴 대화가 실패하던 문제 수정.
  • advisor를 켠 대화가 이를 지원하지 않는 프록시나 게이트웨이 뒤에서 API Error 400 “Input tag ‘advisor_20260301‘“로 매 턴 실패하던 문제 수정. 이제 advisor 없이 요청을 다시 보냅니다.
  • 저장된 기록에 불러오지 못한 MCP 도구에 대한 형식이 잘못된 알림이 있으면 매 턴과 /compact가 실패하던 문제, 형식이 잘못된 시스템 메시지나 파일 목록이 빠진 메모리 저장 알림이 있으면 세션 재개 시 충돌하던 문제 수정.
  • 오래 실행한 전체 화면 세션이 “Claude Code exited after an unrecoverable interface error”로 종료되던 원인 중 하나 수정. 손상된 캐시 메시지 목록을 다시 만듭니다.
  • 설정 파일이나 편집 후 다시 읽는 파일이 읽는 도중 네임드 파이프로 바뀌면 Claude Code가 멈추던 문제 수정.
  • settings.json으로 옮겨진 환경설정이 ~/.claude.json에 null이나 "false" 같은 값으로 남아 있으면 /config가 충돌하고 일부 켜기, 끄기 설정을 잘못 읽던 문제 수정.
  • Claude가 작업 중일 때 호스트 앱(Claude Desktop, VS Code, SDK)에서 모델을 바꾸면 다음 프롬프트에서 프롬프트 캐시가 적중하지 않던 문제 수정.
  • IDE에서 선택한 영역이, 보낸 프롬프트가 입력창으로 돌아올 때(Esc로 편집, 되감기, 시작 훅 실행 중 Esc) 사라지던 문제 수정.

서브 에이전트와 백그라운드 작업

  • 끝나지 않은 백그라운드 에이전트, 셸, 워크플로가 있는 세션을 재개하면 사용자가 입력하기도 전에 모델 턴이 시작되던 문제 수정.
  • 헤드리스와 SDK 세션에서 턴을 마무리하는 중인 백그라운드 서브 에이전트에 보낸 메시지가 조용히 사라지던 문제 수정.
  • 서브 에이전트의 보고서를 읽기 전에 대화가 압축(compact)되면 보고서가 사라지던 문제 수정.
  • 재개한 포크 서브 에이전트가 처음 쓰던 도구 목록을 다시 보내지 않고 새로 만들어 프롬프트 캐시가 깨지던 문제, 서브 에이전트 결과를 verbose 모드 밖에서 펼치면 내부 출처 머리말이 보이던 문제 수정.
  • LSP 플러그인이 켜져 있어도 백그라운드 서브 에이전트가 LSP 도구를 쓰지 못하던 문제 수정.
  • 백그라운드 셸 작업이 결과 없는 grep처럼 문제없는 0 아닌 종료 코드를 실패로 보고하던 문제 수정.
  • 세션에 넘긴 환경 변수에 NUL 문자가 있으면 백그라운드 세션(claude --bg)이 git, 훅, 플러그인 등 보조 프로그램을 실행하지 못하던 문제 수정.
  • 임시 디렉터리가 가득 찼거나 쓸 수 없거나 다른 사용자 소유일 때 claude agents가 오류 대신 빈 화면에서 멈추던 문제 수정.

플러그인, 스킬, MCP

  • manifest.json에 이름이 적힌 스킬이 ~/.claude/skills/에서 ~/.claude/skills/.trash/로 옮겨지던 문제 수정.
  • 브랜치나 태그를 추적하는 GitHub 저장소 또는 git URL의 플러그인을 업데이트해도 installed_plugins.json에 설치 당시 커밋이 남던 문제, 공식 마켓플레이스 스냅숏 파일이 링크이거나 너무 크면 claude plugin update가 기록된 커밋을 지우고 버전을 “unknown”으로 바꾸던 문제 수정.
  • 백그라운드 마켓플레이스 자동 업데이트가 git credential helper를 무시해 비공개 저장소 마켓플레이스를 매번 다시 복제하거나 업데이트하지 못하던 문제 수정.
  • claude mcp remove 뒤 같은 이름으로 다시 추가한 MCP 서버가 재연결되지 않고 인증 필요로 표시되던 문제 수정.
  • /plugin과 /skills에서 직접 끈 스킬이 불러오기에 실패한 플러그인과 같은 빨간 ✘로 표시되던 문제 수정. 꺼진 스킬은 흐린 ◯로 표시됩니다.
  • /mcp에서 같은 서버가 목록에는 △, 상세 화면에는 ⚠로 표시되던 문제 수정. 목록, 상세 화면, /plugin 모두 ⚠로 통일됩니다.
  • 전체 화면 모드에서 /plugin, /skills, /mcp 검색창의 오른쪽 테두리가 사라지던 문제, 다중 선택 옵션 설명이 라벨이 아니라 번호 아래로 들여쓰기되던 문제 수정.

아티팩트와 /ultrareview

  • 조직 정책을 불러오지 못하면(웹 프록시 뒤 등) Artifact 도구가 아무 설명 없이 사라지던 문제 수정. 이제 무엇이 막고 있는지 알려 줍니다.
  • 아티팩트를 다시 게시할 때 해당 기능을 설정 없이 다시 보내면 저장된 데이터베이스 접근 규칙이 초기화되거나 열람자 프로필 범위가 빠지던 문제 수정. 이제 이런 재게시는 거부됩니다.
  • /ultrareview가 중지된 클라우드 리뷰를 완료나 재시도할 오류로 보고하고, 세션이 삭제되거나 로그인 계정이 바뀌어도 시간 제한까지 기다리던 문제 수정.

Remote Control, 클라우드, 셀프 호스팅 러너

  • Claude 앱에서 Remote Control과 클라우드 세션의 컨텍스트 사용량이 /compact나 /clear 직후 빠지거나 이전 값으로 보이던 문제, 커밋하지 않은 변경이 있으면 diff 화면에서 브랜치에 커밋된 파일이 빠지던 문제 수정.
  • 긴 과부하 대기 중 세션 액세스 토큰이 교체되면 클라우드와 셀프 호스팅 러너 세션이 “Authentication failed”로 실패하던 문제 수정.
  • Cowork 세션에서 약 10,800자를 넘는 메모리 파일에 쓰기 충돌이 나면 Claude에 파일의 처음과 끝만 보여 줘, 다시 쓸 때 중간 내용이 사라지던 문제 수정.
  • 셀프 호스팅 러너에서 --configure-git을 쓰면 라이프사이클 훅 커밋에 서명하지 못하던 문제, 정확히 --retire-at 시점에 끝난 턴의 완료 신호가 사라지던 문제 수정.
  • Windows에서 백그라운드 정리 작업이 ~/.claude/session-env, image-cache 등을 다른 위치로 옮기기 위해 만든 디렉터리 심볼릭 링크나 정션(junction)을 지우던 문제 수정.

기타 화면

  • 라이트, ANSI 테마에서 세션 피드백 설문에 마우스를 올려도 강조 표시가 없던 문제, /workflows가 실행이 하나뿐일 때 한 줄짜리 목록을 잠깐 보여 준 뒤 여는 문제 수정.

[VSCode]

  • effort 칩이 세션이 실제로 쓰는 수준 대신 예전에 저장된 수준을 표시하던 문제 수정.
  • Python 확장이 활성화 중 멈추면 Claude Code가 시작되지 않던 문제 수정. 이제 60초 뒤 Python 환경 없이 시작합니다.
  • 계획 승인 카드에 auto mode 선택지가 없던 문제 수정. auto mode를 쓸 수 있으면 터미널처럼 첫 선택지가 “Yes, and use auto mode”입니다.
  • 키보드로 세션을 보관하거나 보관 해제한 뒤 세션 목록에서 화살표 키 이동이 멈추던 문제, 세션을 다시 열면 내 메시지에 붙여 넣기 표시 줄이 보이던 문제 수정.

[Claude Code on the web]

  • GitHub Enterprise Server 저장소의 클라우드 세션에서 약 8시간 뒤 gh와 GitHub API 호출이 실패하던 문제 수정. 토큰이 자동으로 갱신됩니다.
  • 예약 실행 직전에 수정한 루틴이 기존 세션을 재개할 때 이전 프롬프트와 이름으로 실행되던 문제 수정.
  • 작업 디렉터리 밖을 가리키는 파일 링크가 끝내 불러오지 못하는 파일 카드를 열던 문제 수정. 이제 링크가 비활성화되고 이유를 표시합니다.
  • 응답 없이 만료되거나 새 메시지로 대체된 승인 요청이 거부로 기록돼 auto mode가 도구 호출 재시도를 거부하던 문제 수정.

[Claude Tag]

  • Enterprise Grid에 합류하기 전에 Claude에 연결한 Slack 워크스페이스에서 예약 루틴이 조용히 실행되지 않던 문제 수정.
  • 파일 검사 서비스가 잠깐 중단됐을 때 Claude가 Slack 파일을 다시 올려 달라고 요청하던 문제 수정. 이제 검사를 재시도하고, 검사기가 중단된 사실을 전달받습니다.
  • Claude의 Slack 답변에서 +, -, *로 시작하는 글머리 항목이 빈 항목과 엉뚱한 하위 항목으로 표시되던 문제 수정.
  • 클라우드 환경 설정 스크립트가 실패했을 때 Slack 알림이 일반적인 “mention me to retry”로만 나오던 문제 수정. 이제 설정 스크립트를 지목하고 먼저 고치라고 안내합니다.

알아두면 좋은 점

  • Opus 5.5가 기본 Opus 모델입니다 — Pro와 Team Standard 플랜도 기본 모델이 Sonnet에서 Opus로 바뀌었습니다. 가격은 백만 토큰당 $4/$20, 캐시 읽기는 $0.20입니다.
  • effort 수준을 다시 확인하세요 — 모델별 저장 방식 이전에 저장한 effort 수준은 Opus 5.5에 적용되지 않으므로, 원하는 수준이 있으면 /effort로 다시 고릅니다. 반대로 Opus 4.7, Opus 4.8, Fable 5는 이제 effortLevel 등 지정한 값을 따릅니다.
  • 대화상자에서 y, n으로 확인, 취소하던 습관은 바꿔야 합니다 — Enter와 Esc를 쓰거나, keybindings.json에서 y, n을 confirm:yes, confirm:no에 연결해 되돌립니다.
  • PermissionRequest에 agent 유형 훅을 두었다면 교체가 필요합니다 — 이제 실행되지 않으므로 command 또는 http 훅으로 바꿉니다.
  • MCP 도구 설명이 잘린다면 — CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH로 기본 2,048자 한도를 바꿀 수 있습니다. 세션의 모든 MCP 서버에 적용됩니다.
  • 셀프 호스팅 러너 사용자 — 러너 공유 git 파일에 로컬 경로나 git:// 원격 저장소가 있으면 GIT_ALLOW_PROTOCOL 설정이 필요합니다.