Claude Code 고급 활용

Claude Code는 터미널 기반 AI 코딩 에이전트입니다. 이 핸드북은 고급 사용자가 멀티세션과 자동화를 통해 생산성을 극대화하는 방법을 다룹니다.

최근 업데이트 하이라이트

• Opus 4.7 + xhigh 추론: /effort, --effort, 모델 피커에서 xhigh를 사용할 수 있고, 인수 없이 /effort를 실행하면 인터랙티브 슬라이더가 열립니다. Max 사용자의 Opus 4.7 세션에서는 Auto 모드 접근 경로도 단순화되었습니다. (v2.1.111)
• 신규 고급 명령: /ultrareview, /fewer-permission-prompts, /focus, /recap, /tui, /team-onboarding이 추가되어 코드 리뷰, 프롬프트 감소, 세션 복귀, 렌더러 전환, 팀 온보딩 문서화가 강화되었습니다. (v2.1.101~v2.1.111, 현재 commands docs 명칭 반영)
• 세션 복귀 UX 강화: compact 또는 resume 뒤에 session recap이 기본 활성화되고, 필요하면 /recap으로 수동 생성할 수 있습니다. (v2.1.108~v2.1.110)
• 설치/업데이트 경로 정리: 공식 설치 문서는 네이티브 인스톨러와 Homebrew/WinGet을 우선 경로로 안내하고, npm 설치는 deprecated로 명시합니다. (v2.1.111)
• 퍼미션 피로 감소: 읽기 전용 glob Bash(ls *.ts)와 cd <project-dir> && ... 패턴이 더 이상 권한 프롬프트를 트리거하지 않고, /fewer-permission-prompts가 공통 allowlist 제안을 생성합니다. cd <current-directory> && git ... 같은 no-op 패턴도 추가로 정리되었습니다. (v2.1.111~v2.1.113)
• 훅/워크트리 운영 보강: PreCompact 훅이 compaction 자체를 block할 수 있고, EnterWorktree 도구에 기존 worktree 경로를 직접 넘길 수 있습니다. (v2.1.105)
• 헤드리스/플러그인 신호 개선: --output-format stream-json의 init 이벤트에 plugin_errors가 포함되고, models가 Skill tool을 통해 내장 슬래시 명령도 호출할 수 있습니다. (v2.1.108~v2.1.111)
• 운영/보안 경계 보강: CLI 실행 경로가 플랫폼별 네이티브 Claude Code binary 중심으로 정리되고, sandbox.network.deniedDomains로 넓은 allowlist 안에서도 민감 도메인을 예외 차단할 수 있게 되었습니다. (v2.1.113)
• 서브에이전트/원격 안정성 보강: 중간에 멈춘 subagent는 10분 후 명시적으로 실패 처리되고, Remote Control 세션의 subagent transcript 스트리밍/아카이브 누락 문제가 보정되었습니다. (v2.1.113)
• Auto 모드: AI 분류기가 도구 호출 위험도를 판단, 안전한 작업 자동 진행 + 위험 작업 차단 (2026-03-24)
• Computer Use: macOS 화면을 보고 마우스/키보드를 제어하는 연구 프리뷰 (2026-03-24)
• Dispatch: iPhone에서 작업 전송 → 데스크탑에서 자동 실행 → 완료 알림 (2026-03-17)
• PowerShell 도구: Windows에서 네이티브 PowerShell 실행 (v2.1.84 프리뷰)
• 훅 확장: PermissionDenied, CwdChanged, FileChanged, TaskCreated 이벤트 + 조건부 if 필드
• 운영 제어 강화: forceRemoteSettingsRefresh fail-closed 정책, Auto 모드 Recent 재시도, Remote Control hostname prefix (v2.1.89-92)
• 에이전트 UX 강화: /agents의 ● N running, Running/Library 탭, Run agent/View running instance (v2.1.97-98)
• --bare 경량 실행: 스크립트용 -p 호출에서 hooks/LSP/플러그인을 건너뛰는 최소 실행 모드 (v2.1.81)
• --channels 연구 프리뷰: MCP 서버가 세션에 메시지를 푸시하고, 폰으로 도구 승인 릴레이 (v2.1.80-81)
• 1M 컨텍스트 기본화: Opus 4.6가 Max/Team/Enterprise에서 1M 컨텍스트 윈도우 기본 적용 (v2.1.75)
• MCP 고도화: elicitation, Channels, CIMD/RFC 9728 OAuth, 서버 중복 제거, maxResultSizeChars, nonblocking 연결
• 모델: Sonnet 4.6 출시(2026-02-17), Opus 4.6 64k 기본 출력, thinking summaries 기본 비활성화
• Worktree 격리: --worktree 플래그, worktree.sparsePaths sparse-checkout, 세션 재개 시 자동 전환
• 추론 제어: /effort (low ○ / medium ◐ / high ●), "ultrathink", 스킬/커맨드 effort frontmatter
• 서브에이전트: initialPrompt 자동 시작, @ 멘션 타입어헤드, named 서브에이전트, background partial-progress 보고, dynamic MCP 상속, isolated worktree 접근 안정화
• 스킬/플러그인: paths: glob 필터, 스킬 listing cap 1,536자와 토큰 수 정렬, disableSkillShellExecution, 플러그인 bin//monitors, /claude-api의 Managed Agents 가이드 확장
• 명령 UX: /powerup, 인터랙티브 /release-notes, /cost 모델별·cache-hit breakdown, /tag//vim 제거
• 성능 개선: --resume 45% 빠르게, 시작 시 ~80MB 메모리 절감, Read 도구 압축 포맷
• VS Code 강화: /remote-control 브릿지, AI 세션 제목, 트랜스크립트 검색, Desktop 앱
• Code Review: 멀티에이전트 PR 리뷰 (연구 프리뷰, Team/Enterprise)
• Remote Control & Dispatch: 모든 플랜에서 로컬 세션을 모바일/브라우저로 접속

핸드북 구조

목차

참고 문서

• Claude Code 개요/설치: https://code.claude.com/docs/ko/setup (한국어)
• 요금제: https://claude.com/ko-kr/pricing (한국어)
• Changelog: https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md (영어)