Claude Code v2.1.92의 5가지 새로운 기능 마스터하기: MCP 결과 지속성, 플러그인 실행 파일 및 대화형 튜토리얼

작성자 주: Claude Code v2.1.92부터 v2.1.90까지 세 가지 버전의 핵심 업데이트를 상세히 설명합니다. MCP 도구 결과 영속화(500K 문자), 플러그인 bin 디렉토리, /powerup 대화형 튜토리얼 등 5가지 주요 기능을 포함합니다.

Claude Code가 최근 세 가지 버전(v2.1.90 ~ v2.1.92)을 통해 연달아 대규모 업데이트를 발표했습니다. 특히 MCP 도구 결과 영속화, 플러그인 실행 파일 디렉토리, /powerup 대화형 튜토리얼 기능이 개발자 커뮤니티에서 큰 주목을 받고 있습니다. 이번 글에서는 이러한 업데이트가 AI 보조 프로그래밍 워크플로우에 미치는 실질적인 영향을 빠르게 정리해 드립니다.

핵심 가치: 3분 만에 Claude Code 최신 3개 버전의 핵심 기능 업그레이드를 파악하고, MCP 영속화 설정 방법과 /powerup 학습 경로를 마스터하세요.

Claude Code v2.1.92 업데이트 요약

Claude Code는 2026년 4월 초, v2.1.90, v2.1.91, v2.1.92 세 가지 버전을 연달아 출시했습니다. 버전별 핵심 업데이트 내용은 다음과 같습니다.

Claude Code v2.1.92 주요 분석

v2.1.92의 핵심 변화는 기업용 보안 관리와 개발 경험 최적화라는 두 가지 방향에 집중되어 있습니다.

forceRemoteSettingsRefresh 정책은 기업 팀을 위한 중요한 업데이트입니다. 이 정책을 활성화하면 CLI가 시작될 때마다 최신 원격 관리 설정을 강제로 가져오며, 가져오기에 실패하면 즉시 종료(fail-closed 보안 모델)됩니다. 이는 기업 IT 팀이 모든 개발자가 항상 회사의 보안 정책을 준수하는 설정을 실행하도록 보장하여, 로컬 캐시로 인한 정책 불일치 문제를 방지할 수 있음을 의미합니다.

Bedrock 대화형 구성 마법사는 AWS 사용자의 초기 설정 경험을 크게 개선했습니다. 로그인 화면에서 '3rd-party platform'을 선택하면, 마법사가 AWS 인증, 리전 설정, 자격 증명 확인 및 모델 바인딩의 전체 과정을 안내하므로 더 이상 설정 파일을 수동으로 편집할 필요가 없습니다.

Claude Code MCP 도구 결과 지속성 상세 분석

MCP 결과 지속성 핵심 메커니즘

v2.1.91에서 도입된 MCP 도구 결과 지속성(Persistence)은 이번 업데이트에서 개발자들에게 가장 큰 영향을 미치는 기능입니다. 이전에는 MCP 도구가 반환하는 대규모 결과(예: 데이터베이스 스키마, 대형 코드베이스 인덱스 등)가 기본 제한을 초과하여 잘리는 바람에 컨텍스트 정보가 유실되는 문제가 있었습니다.

이제 MCP 서버는 _meta["anthropic/maxResultSizeChars"] 필드를 설정하여 기본 결과 크기 제한을 재정의할 수 있으며, 최대 500,000자(약 500K)까지 지원합니다. 이를 통해 다음과 같은 개선이 가능해졌습니다.

• 데이터베이스 스키마 완벽 전달: 대형 프로젝트의 전체 데이터베이스 구조를 한 번에 Claude에게 전달 가능
• 코드베이스 인덱스 잘림 방지: 프로젝트 수준의 파일 인덱스와 의존성 그래프를 온전히 유지
• API 문서 전체 로드: 복잡한 API의 전체 문서를 컨텍스트로 포함 가능

MCP 결과 지속성 설정 방법

MCP 서버 응답에 _meta 필드를 추가하기만 하면 바로 활성화됩니다.

{
  "content": [
    {
      "type": "text",
      "text": "... 대규모 결과 내용 ..."
    }
  ],
  "_meta": {
    "anthropic/maxResultSizeChars": 500000
  }
}

import { Server } from "@modelcontextprotocol/sdk/server/index.js";

const server = new Server({
  name: "database-schema-server",
  version: "1.0.0"
});

server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "get_database_schema") {
    const schema = await fetchFullDatabaseSchema();

    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(schema, null, 2)
        }
      ],
      _meta: {
        "anthropic/maxResultSizeChars": 500000
      }
    };
  }
});

🎯 개발 팁: MCP 서버를 개발 중이라면 maxResultSizeChars 값을 합리적으로 설정하세요. 항상 최대치인 500K로 설정할 필요는 없으며, 실제 데이터 양에 맞춰 적절한 상한선을 선택하면 됩니다. 다양한 AI 모델을 테스트해야 하는 경우, APIYI(apiyi.com) 플랫폼을 통해 API 키를 통합 관리하면 MCP 서버가 각 모델에서 어떻게 작동하는지 빠르게 검증할 수 있습니다.

Claude Code 플러그인 실행 파일 지원

플러그인 bin/ 디렉토리 메커니즘

v2.1.91에서 추가된 플러그인 bin/ 디렉토리 지원은 Claude Code 플러그인 생태계의 중요한 확장입니다. 이제 플러그인 개발자는 플러그인 패키지에 실행 파일을 포함하고, Bash 도구에서 직접 명령어로 호출할 수 있습니다.

이 기능의 주요 활용 사례는 다음과 같습니다.

• 커스텀 CLI 도구: 플러그인에 포함된 명령줄 도구를 Claude의 Bash 도구에서 바로 실행
• 빌드 스크립트: 프로젝트 전용 빌드, 테스트, 배포 스크립트
• 데이터 처리 도구: 커스텀 데이터 변환 및 포맷팅 도구

플러그인 bin/ 디렉토리 구조

my-claude-plugin/
├── plugin.json
├── src/
│   └── index.ts
└── bin/
    ├── lint-check        # 커스텀 코드 검사 도구
    ├── db-migrate        # 데이터베이스 마이그레이션 스크립트
    └── deploy-preview    # 미리보기 배포 도구

설정을 마치면 Claude Code가 Bash 명령을 실행할 때 이 도구들을 직접 호출할 수 있습니다.

# Claude가 Bash에서 플러그인 실행 파일을 직접 호출
lint-check src/
db-migrate --status
deploy-preview --branch feature/new-api

Claude Code v2.1.91 기타 주요 업데이트

💡 실용 팁: --resume 수정은 광범위한 영향을 미치던 문제를 해결했습니다. 이전에는 --resume으로 세션을 복구할 때 비동기 쓰기가 조용히 실패하면 세션 기록 체인이 끊기는 현상이 있었습니다. 이제 이 문제가 완전히 해결되어 장시간의 개발 세션도 안전하게 중단하고 다시 시작할 수 있습니다.

Claude Code /powerup 인터랙티브 튜토리얼 시스템

/powerup 기능 개요

v2.1.90에서 도입된 /powerup은 Claude Code의 첫 번째 내장형 인터랙티브 튜토리얼 시스템입니다. 터미널 내에서 애니메이션 데모가 포함된 강의를 제공하며, 입문부터 고급까지 총 18개의 핵심 지식을 다룹니다.

/powerup 사용 방법

Claude Code 터미널에서 다음과 같이 입력하세요:

/powerup

시스템이 인터랙티브 메뉴를 표시하며, 원하는 강의 모듈을 선택할 수 있습니다. 각 강의는 다음을 포함합니다:

• 개념 설명: 기능의 핵심 원리와 설계 의도
• 애니메이션 데모: 터미널 내 실시간 작업 시연
• 실습 연습: 자신의 프로젝트에서 직접 시도해보도록 가이드

/powerup 추천 학습 경로

개발자의 숙련도에 따라 다음과 같은 학습 경로를 추천합니다:

초보자 시작하기 — 3가지 기초부터 마스터하세요:

1. CLAUDE.md 프로젝트 설정 파일 작성법
2. /compact 명령어로 컨텍스트 윈도우 관리하기
3. 계획 모드(Plan Mode)로 복잡한 작업을 단계별로 해결하기

중급으로 도약 — 자동화 능력에 집중하세요:

1. Hooks로 자동화 워크플로우 설정하기
2. 하위 에이전트(Sub-agents)로 작업 병렬 처리하기
3. MCP 서버로 Claude의 도구 능력 확장하기

고급 기술 — 잠재력 극대화하기:

1. Worktrees로 격리된 환경에서 병렬 개발하기
2. /schedule로 원격 에이전트 예약 실행하기
3. SDK 헤드리스 모드를 CI/CD 파이프라인에 통합하기

🚀 빠른 시작: MCP 서버 개발 중 다양한 대규모 언어 모델을 호출하여 테스트해야 한다면, APIYI(apiyi.com)의 통합 인터페이스를 추천합니다. 하나의 API 키로 Claude, GPT, Gemini 등 주요 모델을 모두 이용할 수 있습니다.

Claude Code v2.1.92 성능 최적화 요약

Write 도구 성능 향상

v2.1.92에서는 Write 도구의 diff 계산을 최적화하여, 탭(Tab) 문자, & 기호, $ 달러 기호가 포함된 대용량 파일 처리 시 성능이 약 60% 향상되었습니다. 대규모 설정 파일, Shell 스크립트, 템플릿 파일을 자주 다루는 개발자들에게 큰 도움이 될 것입니다.

v2.1.90 성능 최적화

v2.1.90 버전에는 여러 가지 저수준 성능 최적화가 포함되었습니다:

v2.1.92 기타 개선 사항

• /cost 명령어 강화: 구독 사용자는 모델별 및 캐시 적중률별 상세 비용 내역을 확인할 수 있습니다.
• /release-notes 업그레이드: 이제 인터랙티브 버전 선택기가 제공되어 원하는 버전의 업데이트 기록을 쉽게 확인할 수 있습니다.
• 원격 제어 세션 명명: 기본적으로 호스트 이름 접두사(예: myhost-graceful-unicorn)를 사용하며, --remote-control-session-name-prefix를 통해 사용자 정의가 가능합니다.
• 캐시 만료 알림: Pro 사용자는 프롬프트 캐시 만료 시 푸터(footer) 알림을 통해 대략적인 미캐시 토큰 수를 확인할 수 있습니다.

💰 비용 관리 팁: Claude Code의 /cost 명령어는 이제 모델별 상세 비용 분석을 제공합니다. 여러 대규모 언어 모델을 개발에 동시에 활용한다면, APIYI(apiyi.com) 플랫폼의 청구 기능을 통해 각 모델의 사용량과 비용을 통합 관리하여 효율적인 비용 통제가 가능합니다.

Claude Code v2.1.92 버그 수정 내역

최근 세 가지 버전에서 사용자 경험에 영향을 주던 여러 문제를 해결했습니다.

v2.1.92 수정 사항

• 하위 에이전트 tmux 세션 생성 실패 문제 수정
• 공백 문자만 포함된 thinking 블록으로 인해 발생하는 API 400 오류 수정
• 자동 주행 모드에서 의도치 않은 키 입력으로 설문조사가 제출되는 문제 수정
• 전체 화면 스크롤 재생 시 메시지가 중복 표시되는 현상 수정
• 플러그인 MCP 서버가 'connecting' 상태에서 멈추는 문제 수정
• /tag 및 /vim 명령어 제거
• Linux 샌드박스에서 Unix Socket 차단 복구

v2.1.91 수정 사항

• --resume 사용 시 비동기 쓰기 실패로 세션 기록이 유실되는 문제 수정
• iTerm2, kitty, WezTerm, Ghostty 터미널에서 cmd+delete 단축키가 작동하지 않던 문제 수정
• 컨테이너 재시작 후 계획 모드 상태가 유실되는 문제 수정

v2.1.90 수정 사항

• --resume 사용 시 전체 프롬프트 캐시(prompt-cache) 적중 실패 문제 수정 (v2.1.69부터 발생)
• 무한 속도 제한(rate limit) 대화 상자 루프 문제 수정
• 자동 모드에서 사용자의 명시적 경계(예: "don't push")를 무시하는 문제 수정
• format-on-save 훅 활성화 시 Edit/Write 도구에서 "File content has changed" 오류가 발생하는 문제 수정

자주 묻는 질문 (FAQ)

npm install -g @anthropic-ai/claude-code@latest

요약

Claude Code v2.1.90 ~ v2.1.92 세 가지 버전의 핵심 업데이트 요약입니다:

1. MCP 결과 지속성(Persistence): 최대 500K 문자의 도구 결과를 지원하여 대규모 스키마 및 인덱스가 잘리는 문제를 해결했습니다.
2. 플러그인 bin/ 디렉토리: 플러그인에 실행 파일을 포함할 수 있게 되어 Claude Code의 도구 체인 기능이 확장되었습니다.
3. /powerup 대화형 튜토리얼: 3단계 난이도로 구성된 18개의 강의를 통해 모든 수준의 사용자가 Claude Code를 체계적으로 학습할 수 있습니다.
4. 기업용 보안 강화: forceRemoteSettingsRefresh 정책을 통해 설정 일관성을 보장합니다.
5. 성능 전면 최적화: Write 도구 속도가 60% 향상되었으며, SSE 전송 방식이 O(n²)에서 O(n)으로 최적화되었습니다.

이번 업데이트는 Claude Code가 단순한 AI 프로그래밍 어시스턴트에서 완전한 개발 플랫폼으로 진화하고 있음을 보여줍니다. MCP 생태계의 지속적인 강화와 플러그인 시스템의 완성도는 개발자가 자신만의 워크플로우를 구축하는 데 더 큰 유연성을 제공합니다.

APIYI(apiyi.com)를 통해 Claude 및 기타 주요 대규모 언어 모델의 API를 빠르게 경험해 보세요. 플랫폼에서 제공하는 무료 크레딧과 통합 API 인터페이스를 활용하면 모델 성능을 빠르게 검증하고 비교할 수 있습니다.

📚 참고 자료

1. Claude Code 공식 업데이트 로그: 전체 버전 기록

   • 링크: code.claude.com/docs/en/changelog
   • 설명: 최신 버전 업데이트 세부 정보를 확인할 수 있는 공식 소스

2. Claude Code GitHub 저장소: 오픈 소스 코드 및 이슈 트래킹

   • 링크: github.com/anthropics/claude-code
   • 설명: 소스 코드 확인, 버그 리포트 및 기능 제안

3. MCP 프로토콜 사양: Model Context Protocol 공식 문서

   • 링크: modelcontextprotocol.io
   • 설명: MCP 서버 개발 및 도구 결과 형식에 대한 권위 있는 참고 자료

4. Claude Code 플러그인 개발 가이드: 플러그인 개발 입문 문서

   • 링크: code.claude.com/docs/en/plugins
   • 설명: 플러그인 구조, bin 디렉토리 설정 및 배포 프로세스 안내

작성자: APIYI 기술팀
기술 교류: 댓글로 Claude Code 사용 경험을 공유해 주세요. 더 많은 AI 개발 자료는 APIYI 문서 센터(docs.apiyi.com)에서 확인하실 수 있습니다.