Source: https://aiprimetech.io/ko/blog/claude-code-features-october-2026/

2026년 4월 · 8분 · 뉴스 

# Claude Code 기능 총정리: TypeScript 모드, 초안 복구 및 플러그인 훅 (2026월) 

 A  작성자 [AI Prime Tech](https://aiprimetech.io/ko/)  · AI 활용    

최신 Claude Code 기능 에는 TypeScript 모드, 실수로 지운 프롬프트 복구, 에이전트 작업을 위한 새로운 플러그인 훅이 포함됩니다. 이번 4년 10월 2026일 정리에서는 2.1.287부터 2.1.289까지의 릴리스를 다루고, 개발자가 사용할 수 있는 명령과 구성 변경 사항을 설명하며, 모드를 도입하기 전에 확인할 만한 권한 및 호환성 세부 사항을 짚어 봅니다. 

## Claude Code 기능 한눈에 보기 

10월의 첫 세 릴리스는 주요 확장 기능과 일상적인 개발 작업을 위한 작은 개선 사항을 함께 제공합니다. Claude Code 2.1.287에서는 모드가 도입되었고, 2.1.288에서는 초안 복구와 검토 제어 기능이 추가되었으며, 2.1.289에서는 플러그인 훅 지원이 확대되고 모드 로딩 및 권한 문제가 해결되었습니다. 

아래 표에서 개선하려는 워크플로에 따라 어디부터 살펴볼지 확인할 수 있습니다. 

  | 릴리스  | 날짜  | 주요 추가 기능 및 수정 사항  | 중점적으로 살펴볼 영역    

  | 2.1.287  | 10월 1일  | TypeScript 모드, “알아두세요”, 세션 이름 필터링, MCP URL 프롬프트  | 플러그인 사용자 지정 및 MCP 호환성  

  | 2.1.288  | 10월 2일  | 지운 프롬프트 복구, 검토 결과 수 제한, 모드 텍스트 선택, 세션 단축키  | 프롬프트 편집, 코드 검토, 세션 탐색  

  | 2.1.289  | 10월 3일  | 팀원 생성 훅, 일관된 에이전트 ID, 에이전트 상태, 모드 및 권한 수정  | 에이전트를 인식하는 플러그인 및 관리 대상 컴퓨터의 권한    

이 릴리스들은 동일한 워크플로의 서로 다른 부분을 개선합니다. 모드는 플러그인이 Claude Code의 동작을 변경할 수 있게 하고, 초안 복구는 프롬프트 편집 중 실수를 더 쉽게 되돌릴 수 있게 합니다. 이후의 훅 및 권한 수정은 이러한 확장 기능이 에이전트, 도구, 조직에서 관리하는 설정과 상호작용할 때 중요합니다. 

## TypeScript 모드로 플러그인 동작 확장 

[Claude Code 2.1.287](https://github.com/anthropics/claude-code/releases/tag/v2.1.287) 에서는 Claude Mods가 도입되었으며, 릴리스 노트는 이를 “플러그인이 이제 더 깊은 수준의 동작을 수정할 수 있습니다”라고 설명합니다. 모드는 플러그인 안에 패키징된 작은 TypeScript 함수이며, CLI와 데스크톱 앱 모두에서 작동합니다. 

이 [10월 1일 모드 발표](https://claude.com/resources/articles/claude-code-mods) 에서는 프롬프트 재작성, UI 추가, 내장 기능 대체, 도구 호출 차단·재작성·재시도 등 여러 기능을 설명합니다. 이러한 범위 덕분에 모드는 작업 중 Claude Code의 동작 방식을 변경해야 할 때 유용합니다. 

훅에 익숙한 개발자에게 유용한 구분 기준은 모드에 대해 명시적으로 문서화된 범위입니다. 모드는 프롬프트, UI, 내장 동작, 도구 호출을 변경할 수 있습니다. 다음 자료는 [Claude Code 훅 가이드](/ko/claude-code/hooks/) 프로젝트에 적합한 확장 방식을 평가할 때 참고 기준을 제공합니다. 

### 모드 생성 및 테스트 

이 [버전이 명시된 2.1.287 모드 README](https://raw.githubusercontent.com/anthropics/claude-code/v2.1.287/mods/README.md) 에서는 내보내는 register(on, options) 함수와 다음 형태의 핸들러를 문서화합니다: ($, e, next). 플러그인 구조에는 다음이 포함됩니다: .claude-plugin/plugin.json, hooks/hooks.json, 그리고 다음 경로 아래의 TypeScript 파일: hooks/. 

문서에 나와 있는 개발 명령은 다음과 같습니다: 

```
/plugin-types
claude --plugin-dir mods/diff
claude plugin test mods/diff

```

/plugin-types 은 선언을 작성합니다. 나머지 두 명령은 예제 플러그인 디렉터리로 Claude Code를 실행하고 해당 플러그인을 테스트하기 위한 스냅샷의 예제입니다. 

스냅샷에서는 API가 릴리스 사이에 예고 없이 변경될 수 있다고도 경고합니다. 특히 모드 API에 의존하는 플러그인을 업그레이드할 때는 버전이 명시된 문서를 구현 참고 자료의 일부로 활용하세요. 

### 접근 권한, 신뢰, 내장 모드 

모드는 Claude Code의 머신 접근 권한으로 실행되며 샌드박스에서 실행되지 않습니다. Anthropic의 발표에서는 신뢰할 수 있는 출처에서만 모드를 설치할 것을 권고합니다. 모드를 활성화하기 전에 소스 코드와 출처를 검토하세요. 특히 도구 호출을 재작성하거나 재시도할 수 있는 모드라면 더욱 주의해야 합니다. 

릴리스 2.1.287에는 다음 기능도 추가되었습니다. “알아두세요,” 사용자나 Claude가 놓칠 수 있는 사항을 보조 에이전트가 짚어 주는 내장 모드입니다. 활성화 명령은 다음과 같습니다. 

```
/plugin enable cc-plugin-you-should-know@builtin

```

사용 가능 조건은 텔레메트리가 활성화된 자사 세션으로 명시되어 있습니다. 이 조건은 중요합니다. 발표에서는 모든 세션 구성에서 사용할 수 있다고 명시하지 않았습니다. 

## 초안 복구 및 코드 리뷰 제어 

[Claude Code 2.1.288](https://github.com/anthropics/claude-code/releases/tag/v2.1.288) 대화형 작업에 유용한 두 가지 제어 기능을 추가합니다. Ctrl+C로 지운 프롬프트를 복구하고, 보고할 코드 리뷰 지적 사항의 개수를 선택할 수 있습니다. 

### Ctrl+C로 지운 프롬프트 복원 

Ctrl+C로 프롬프트를 지웠다면 다음 키를 누르세요. 프롬프트가 비어 있는 상태에서 위쪽 화살표 그러면 초안이 복원됩니다. 붙여넣은 텍스트와 이미지도 복구됩니다. 

이 릴리스는 지워진 프롬프트에 대한 구체적인 복구 동작을 설명합니다. 일반적인 초안 보관 기능이나 세션이 종료되는 모든 방식에 대한 복구 동작을 명시하지는 않습니다. 기억할 순서는 간단합니다. Ctrl+C로 프롬프트를 지운 다음, 빈 프롬프트에서 위쪽 화살표를 누르면 복원됩니다. 

이는 프롬프트에 직접 입력한 지침 외의 내용이 포함되어 있을 때 특히 유용합니다. 붙여넣은 자료와 이미지도 복구 대상에 명시적으로 포함되므로, 이 기능은 지워진 초안의 내용까지 복구합니다. 

### 리뷰 지적 사항 개수 설정 

새로운 /code-review --max-findings <n>|all 옵션은 리뷰에서 보고하는 지적 사항의 개수를 제어합니다. 개수를 지정하거나, 모든 지적 사항을 요청하거나, 기본값으로 복원할 수 있습니다. 

```
/code-review --max-findings 5
/code-review --max-findings all
/code-review --max-findings default

```

이 설정은 다음 명령으로 초기화할 때까지 유지됩니다. default. 여러 리뷰를 진행할 때도 계속 유지되는 기본 설정으로 생각하세요. 

릴리스에서는 기본 개수를 명시하지 않았으므로, 인용할 수 있는 검증된 기본 개수는 없습니다. 보고 한도를 확실히 정하고 싶다면 개수를 명시적으로 설정하세요. 내장 동작으로 돌아가려면 초기화 명령을 사용하세요. [CLI 참조](/ko/claude-code/cli/) 는 더 폭넓은 명령줄 워크플로에 유용한 참고 자료입니다. 

## 플러그인 훅의 에이전트 추적 개선 

[Claude Code 2.1.289](https://github.com/anthropics/claude-code/releases/tag/v2.1.289) 팀원 생성 및 에이전트 상태에 관한 플러그인 훅 정보를 추가합니다. 관련 변경 사항은 다음과 같습니다. agent.spawn 팀원용 기능, 플러그인 훅 이벤트 전반에서 사용하는 단일 에이전트 ID, 그리고 다음 항목의 유휴 또는 대기 상태 $.agent.list(). 

플러그인 작성자에게 이러한 추가 기능은 에이전트 활동에 관한 더 많은 정보를 제공합니다. 일관된 ID는 이벤트에 공통 에이전트 식별자를 부여하고, 유휴 및 대기 상태는 다음 항목이 반환하는 목록에 세부 정보를 추가합니다. $.agent.list(). 이 요약에는 완전한 구현 예제가 없으므로, 이러한 추가 기능은 바로 사용할 수 있는 오케스트레이션 절차가 아니라 API 기능으로 보아야 합니다. 

### 모드 로딩 및 UI 수정 

같은 릴리스에서는 업그레이드 후 첫 세션에서 설치된 모드가 로드되지 않는 문제를 수정합니다. 또한 오래된 로컬 마켓플레이스 플러그인 사본과 여러 모드 UI 오류를 해결합니다. 

이러한 수정 사항은 Claude Code를 업데이트한 뒤 확장 기능을 검증할 때 중요합니다. 점검에 업그레이드 후 첫 세션을 포함하고, 설치된 플러그인이 예상한 로컬 마켓플레이스 버전을 반영하는지 확인하세요. 

버전 2.1.288에는 이미 다음 기능이 추가되었습니다. $.ui.selection(). 이 기능은 마지막 전체 화면 텍스트 선택 영역을 반환하며, 선택 영역이 단일 대화 기록 행 안에 있으면 해당 행 자체도 반환합니다. 이를 통해 모드 작성자는 관련 행을 받을 수 있는 조건이 문서화된 선택 영역 정보를 얻을 수 있습니다. 

### 관리 대상 머신의 권한 처리 

버전 2.1.289은 사용자가 설치한 모드와 관련된 권한 동작도 수정합니다. 조직에서 관리하는 머신에서는 복합 셸 명령의 중첩된 부분에 적용된 거부 및 확인 요청 규칙이 모드의 승인에 의해 무시되지 않고 유지됩니다. 

그 밖의 수정 사항은 다음과 관련됩니다. Read IDE 심볼릭 링크를 통한 거부 규칙과 샌드박스 자동 허용이 적용된 상태에서의 Bash 거부 또는 확인 요청 규칙입니다. 이러한 변경 사항은 새로운 모드 기능과 함께 살펴볼 필요가 있습니다. 확장 기능의 동작과 권한 적용 모두 업그레이드를 평가하는 요소이기 때문입니다. 

## 세션 탐색, MCP 및 게이트웨이 호환성 

Claude Code의 여러 소규모 새 기능은 탐색 및 통합 작업에 영향을 줍니다. 

2.1.287에서는 에이전트 보기에 다음 기능이 추가되었습니다. n:<text> 세션 이름과 작업을 일치시키는 필터입니다. 이어서 버전 2.1.288에는 다음 기능이 추가되었습니다. Ctrl+F 를 사용한 세션 이름 검색과 Alt+↑/↓ 를 사용한 에이전트 보기의 그룹 간 이동입니다. 이러한 단축키와 이름 변경 단축키는 다음 항목에서 다시 지정할 수 있습니다. keybindings.json. 

복원된 세션의 경우, 2.1.288에는 다음과 관련된 여러 --resume 수정 사항이 포함되어 복원된 컨텍스트, 최종 응답 및 이전 사고 과정을 보존합니다. 이는 재개된 작업의 안정성을 높이는 변경 사항이며, Ctrl+C로 지운 프롬프트를 복구하는 기능과는 별개입니다. 

### MCP URL 프롬프트 

버전 2.1.287은 다음 프로토콜을 사용하는 MCP 서버에 URL 프롬프트를 추가했습니다. 2025-11-25. 서버 연결이 끊기는 경우, 릴리스에서는 다음 항목을 "bareElicitationCapability": true 호환성 설정으로 제시합니다. 

이 설정은 해당 릴리스의 MCP 변경 사항과 관련된 문제 해결 정보입니다. 모든 경우에 필요한 구성 요건으로 여기기보다는 문제가 발생한 서버의 상황에 맞춰 확인하세요. [MCP 가이드](/ko/claude-code/mcp/) 는 관련 통합 워크플로를 시작하는 데 도움이 됩니다. 

### 구조화된 출력 

버전 2.1.288에는 다음 항목이 도입되었습니다. CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS. 이는 구조화된 출력을 거부하는 게이트웨이 등의 환경에서 구조화된 출력을 비활성화합니다. 

이 요약은 환경 변수의 용도를 설명하지만, 구체적인 설정값이나 셸 명령은 제공하지 않습니다. 환경에서 구조화된 출력 거부 문제가 발생한다면 이 구성 옵션을 살펴보세요. 릴리스에서는 모든 게이트웨이에 이 옵션이 필요하다고 명시하지 않았습니다. 

## 확인해야 할 사용량 한도 

이번 시월 기능 변경 사항과 함께 구월에 조정된 구독 사용량 한도도 살펴볼 필요가 있습니다. 구월 14부터 주간 한도는 영구적으로 프로모션 이전 수준보다 25% 높게 Pro, Max, Team 및 좌석 기반 Enterprise에 적용되고 있습니다. 

앞서 한시적으로 적용된 50% 인상 은 오월 13부터 구월 13, 2026까지 진행되었으며, 태평양 시간 오후 11:59시에 종료되었습니다. Free 및 사용량 기반 Enterprise 좌석은 해당 프로모션에서 제외되었습니다. 

현재 이용 한도를 확인할 때 이 두 비율을 구분하세요. 영구 인상과 종료된 프로모션에는 서로 다른 수치가 적용됩니다. 시월 릴리스에서는 프로모션 수준으로의 복귀를 명시하지 않았습니다. 

다음을 사용하세요: /usage 를 사용해 한도를 확인하세요. 관련 구독 제약에 대한 자세한 내용은 다음 자료를 참조하세요. [Claude Code 요청 한도 가이드](/ko/claude-code/rate-limits/). 

## 핵심 요점  
- Claude Code 2.1.287은 TypeScript 모드를 도입했습니다. 이 모드는 플러그인에 포함되어 제공되며, CLI와 데스크톱 앱에서 프롬프트, UI, 내장 기능 및 도구 호출을 수정할 수 있습니다. 
- 모드는 샌드박스에서 실행되지 않습니다. Claude Code의 머신 접근 권한으로 실행되며, 발표에서는 신뢰할 수 있는 출처에서만 설치할 것을 권고합니다. 
- 버전 2.1.288은 지워진 초안을 복원합니다. Ctrl+C로 프롬프트를 지운 뒤 빈 프롬프트에서 위쪽 화살표를 누르면 붙여넣은 텍스트와 이미지를 포함해 복구할 수 있습니다. 
- 리뷰 지적 사항은 설정할 수 있으며 설정이 유지됩니다. 다음을 사용하세요: /code-review --max-findings 5, all, 또는 default; 기본 개수는 명시되어 있지 않습니다. 
- 버전 2.1.289은 에이전트 관련 플러그인 훅을 확장하고 모드 로딩, UI 및 권한 처리를 수정합니다. 다음 항목을 사용하세요. /usage 이러한 기능 변경 사항과 별개로 현재 한도를 확인할 수 있습니다.  

## 자주 묻는 질문 

### Claude Code 모드란 무엇인가요? 

Claude Code 모드는 플러그인에 패키징된 작은 TypeScript 함수로, 프롬프트를 재작성하고, UI를 추가하고, 내장 기능을 대체하고, 도구 호출을 차단하거나 재작성하거나 재시도할 수 있습니다. CLI와 데스크톱 앱에서 작동하며, Claude Code의 머신 접근 권한으로 실행되고 샌드박스에서 실행되지 않습니다. 

### TypeScript 모드는 어떻게 만들고 테스트하나요? 

2.1.287 스냅샷 문서에는 내보낸 register(on, options) 함수, 다음 형태의 핸들러 ($, e, next), 그리고 다음 항목을 포함하는 플러그인이 설명되어 있습니다. .claude-plugin/plugin.json, hooks/hooks.json, 그리고 다음 경로 아래의 TypeScript hooks/. 다음을 사용하세요: /plugin-types 를 사용해 선언을 작성하세요. 문서에 제시된 예제 명령은 다음과 같습니다. claude --plugin-dir mods/diff 및 claude plugin test mods/diff. 

### Ctrl+C로 실수로 지운 프롬프트를 어떻게 복구하나요? 

Claude Code 2.1.288에서는 Ctrl+C로 프롬프트를 지운 뒤 빈 프롬프트에서 위쪽 화살표를 누르세요. 붙여넣은 텍스트와 이미지를 포함해 지워진 초안이 복원됩니다. 

### 코드 리뷰 지적 사항 한도를 어떻게 변경하거나 초기화하나요? 

다음을 사용하세요: /code-review --max-findings 5 를 사용해 개수 한도를 설정하거나 /code-review --max-findings all 를 사용해 모든 지적 사항을 요청하세요. 선택한 설정은 다음 명령을 실행할 때까지 유지됩니다. /code-review --max-findings default. 릴리스에서는 기본 개수를 명시하지 않았습니다. 

[Claude](/ko/blog/tag/claude/)[코딩](/ko/blog/tag/coding/)[도구](/ko/blog/tag/tools/) 

A

[AI Prime Tech](https://aiprimetech.io/ko/)

이 블로그는 AI Prime Tech가 발행합니다. 기사는 AI의 도움을 받아 초안을 작성합니다. 모델 ID, 가격, 한도 등 버전별 세부 정보는 활용하기 전에 공식 문서와 대조해 확인하세요. 

 더 저렴하게 Claude API 이용하기 

API 키 하나로 Claude Opus 5.5, Sonnet 5, Haiku 4.5, Fable 5.1 및 GPT-6개 모델을 이용하세요. 구독 없이 사용한 만큼만 결제합니다. [API 키 받기 →](/register)  

AI Prime Tech는 독립적인 타사 API 게이트웨이입니다. Claude™ 및 Anthropic®는 Anthropic, PBC의 상표입니다. 제휴 또는 보증 관계를 의미하지 않습니다.