AI 코딩 도구

Claude Code 4월 2026 업데이트 완전 정리 — /powerup, MCP 500K, 세션 성능 개선

Claude Code v2.1.90~v2.1.101 4월 업데이트 실무 분석. /powerup 18레슨 인터랙티브 코스, MCP 툴 결과 500K 허용, SSE 스트리밍 선형 성능 개선, 헤드리스 defer 권한, 서브에이전트 버그 수정까지 워크플로우 영향을 정리한다.

2026-04-14

Claude Code v2.1.90~v2.1.101이 2026년 4월 첫 두 주 동안 연속 출시됐다. 핵심 변경사항은 세 가지다: 터미널 내 인터랙티브 학습 시스템 /powerup, MCP 툴 결과 최대 500K 문자 허용, SSE 스트리밍 선형 복잡도 개선. 이 글은 각 변경사항이 실제 워크플로우에 어떤 영향을 주는지 정리한다.

이 글이 필요한 사람: Claude Code를 매일 사용하는 개발자, MCP 서버를 직접 구축하는 엔지니어, 팀에 Claude Code를 처음 도입하려는 리드 개발자.

※ 공식 Changelog: claude.ai/code/docs/changelog

4월 업데이트 한눈에 보기 — v2.1.89~v2.1.101

2026년 4월 첫 주에만 Claude Code는 v2.1.89부터 v2.1.92까지 4개 버전을 연속 출시했다. 이후 4월 중순까지 v2.1.101에 도달하며 총 10회 이상 버전이 갱신됐다. 단순 버그픽스가 아니라 각 버전마다 사용성과 성능에 직접 영향을 주는 변경이 포함됐다.

/powerup — 터미널 내 인터랙티브 학습 시스템

v2.1.90에서 추가된 /powerup은 Claude Code를 처음 쓰는 사람이 터미널을 벗어나지 않고 18개 레슨을 통해 핵심 기능을 배울 수 있는 학습 시스템이다. 별도 문서를 찾거나 튜토리얼 사이트를 방문할 필요 없이 Claude Code 안에서 바로 실습한다.

레슨은 선형으로 구성되어 있지 않다. 관심 있는 주제를 골라서 시작할 수 있고, 각 레슨은 실제 태스크를 수행하며 배우는 방식이다. "파일을 읽어라"가 아니라 "이 버그를 고쳐라" 형식으로 진행된다.

/powerup 실행
# Claude Code 터미널에서 실행
/powerup

# 레슨 목록이 나타나면 번호를 선택
# 예시 레슨:
# 1. 기본 파일 탐색과 코드 수정
# 2. 테스트 작성과 실행
# 3. 서브에이전트 활용
# 4. MCP 서버 연결
# 5. CLAUDE.md로 프로젝트 컨텍스트 설정
# ...

팀 전체가 Claude Code를 도입할 때 온보딩 문서 대신 /powerup을 쓰는 것이 효율적이다. 실습 기반이기 때문에 문서를 읽는 것보다 빠르게 개념이 잡힌다.

Claude Code /powerup — 터미널 내 인터랙티브 학습 시스템 18레슨 — /powerup을 실행하면 터미널에서 18개 레슨을 순서에 상관없이 선택해 실습할 수 있다.

MCP 툴 결과 500K — 대용량 응답 처리

v2.1.91 이전에는 MCP 툴 결과의 최대 크기가 제한되어 있었다. 대용량 파일을 읽거나 DB 쿼리 결과가 크면 결과가 잘려서 Claude Code가 불완전한 정보로 작업해야 했다. v2.1.91에서 이 한도가 500K 문자(약 500KB)로 확장됐다.

실무에서 이 변경이 영향을 주는 상황:

대용량 로그 파일 분석 MCP 서버
수백 개 행의 DB 쿼리 결과를 반환하는 MCP 서버
전체 코드베이스를 인덱싱해 검색하는 MCP 서버
긴 API 응답을 그대로 전달하는 MCP 서버

MCP 서버에서 500K 결과 반환 예시
# 이전: 결과가 잘려 에러 발생
# 이후: 최대 500K 문자까지 정상 처리

# MCP 서버 구현 예시 (TypeScript)
import { Server } from "@modelcontextprotocol/sdk/server/index.js";

const server = new Server({ name: "log-analyzer", version: "1.0.0" }, {
  capabilities: { tools: {} }
});

server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "read_large_log") {
    const logContent = await fs.readFile("/var/log/app.log", "utf-8");
    // 500K 이하라면 이제 전체 반환 가능
    return {
      content: [{ type: "text", text: logContent }]
    };
  }
});

/team-onboarding — 팀 설정 자동화

v2.1.91에 함께 추가된 /team-onboarding은 팀 전체가 Claude Code를 동일한 설정으로 사용하도록 표준화하는 커맨드다. 실행하면 현재 프로젝트의 CLAUDE.md 구조, MCP 서버 설정, 권한 설정을 기반으로 팀원용 온보딩 문서를 자동 생성한다.

/team-onboarding 실행
# 프로젝트 루트에서 실행
/team-onboarding

# 생성되는 파일:
# ONBOARDING.md — 프로젝트별 Claude Code 사용 가이드
# .claude/team-settings.json — 팀 공유 설정
#
# 포함 내용:
# - 프로젝트에서 허용/금지된 Claude Code 액션
# - MCP 서버 연결 방법
# - 자주 쓰는 커맨드 목록
# - CLAUDE.md 구조 설명

헤드리스 권한 defer — CI 환경 자동화

v2.1.92의 헤드리스 권한 defer는 CI/CD 파이프라인에서 Claude Code를 사용할 때 중요한 변경이다. 기존에는 Claude Code가 헤드리스(non-interactive) 모드에서 특정 작업을 수행할 때 권한을 즉시 거부했다. 이제는 defer 모드로 "인간 리뷰 후 진행"을 명시적으로 설정할 수 있다.

GitHub Actions에서 Claude Code를 써서 PR 자동 리뷰나 코드 수정을 하는 팀에게 특히 유용하다. 민감한 파일 수정 작업에서 인간이 최종 승인할 때까지 실행을 보류할 수 있다.

GitHub Actions에서 헤드리스 defer 설정
# .github/workflows/claude-review.yml
- name: Claude Code Review
  run: |
    claude --headless \
      --permission-mode defer \
      --defer-on: "write,execute" \
      "이 PR의 보안 취약점을 분석해줘"
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

SSE 스트리밍 성능 개선 — quadratic → linear

v2.1.95+에서 수정된 SSE 스트리밍 성능 문제는 장문 세션에서 발생하던 대표적인 버그였다. 대화 길이가 늘어날수록 각 토큰 처리 시간이 O(n²)으로 증가해서, 500턴 이상 대화에서 응답이 눈에 띄게 느려지는 현상이 있었다.

수정 후 O(n) 선형 복잡도로 바뀌면서 장문 컨텍스트 세션에서도 속도가 일정하게 유지된다. 코드베이스 전체를 맥락으로 가지고 길게 대화하는 워크플로우에서 체감 차이가 크다.

Claude Code SSE 스트리밍 성능 개선 — quadratic에서 linear로 — v2.1.95 이전에는 대화 길이가 늘수록 응답 속도가 이차함수적으로 느려졌다. 수정 후 선형 유지.

워크트리 파일 접근 버그 수정

Git worktree를 여러 개 운영하는 팀에서 Claude Code가 현재 워크트리가 아닌 다른 워크트리의 파일을 잘못 읽거나 수정하는 버그가 v2.1.96에서 수정됐다. 여러 기능 브랜치를 동시에 작업하는 환경에서 중요한 수정이다.

워크트리 기반 워크플로우를 쓰고 있다면 v2.1.96 이상으로 업데이트를 권장한다.

Claude Code 업데이트
# npm으로 설치한 경우
npm update -g @anthropic-ai/claude-code

# 버전 확인
claude --version

# 현재 최신 버전 확인
npm show @anthropic-ai/claude-code version

Claude Code 4월 업데이트 — /powerup, MCP 500K, SSE 성능 개선 — 4월 업데이트의 세 축: /powerup으로 온보딩, MCP 500K로 대용량 처리, SSE 선형화로 장문 세션 안정화.

업데이트 적용 순서 권장: v2.1.96 이상을 설치하면 이번 달 모든 수정사항이 적용된다. 워크트리 버그·SSE 성능·MCP 500K가 모두 포함된다. Claude Code를 자동 업데이트로 설정했다면 이미 최신 버전이 적용되어 있다.

Claude Code업데이트/powerupMCP서브에이전트헤드리스SSEClaude Code 2.1AnthropicAI 코딩 도구