명령별 변경 기록 | Claude Code 명령어 마스터

Claude Code: 명령별 이전 버전 근거와 동작 변경 기록에서 현재 사용법으로 이동할 수 있는 이력입니다.

핵심 요약

이 페이지는 이전 검증 당시의 기록입니다. 지원 상태와 현재 사용법은 개별 명령 페이지와 전체 목록을 기준으로 확인하세요. 과거의 “최소 지원 버전” 기록은 도입 버전을 새로 보증하지 않습니다.

/add-dir

현재 사용법

이전 버전 근거 기록

공식 명령어 문서에 별도의 최소 버전이 명시되어 있지 않습니다. (Working directories 기능 일부로 제공)

/agents

현재 사용법

이전 변경 메모

v2.1.143: background session의 worktree isolation을 끄는 worktree.bgIsolation: "none" 설정이 추가되었습니다.
v2.1.139: Agent View가 research preview로 추가되었습니다. claude agents로 모든 session의 working/needs input/completed 상태를 관리합니다.

/autofix-pr

현재 사용법

이전 버전 근거 기록

공식 Commands 문서의 명령어 표에는 버전 컬럼이 없으며, 도입 버전이 별도로 명시되어 있지 않습니다. 다만 기능 자체가 Claude Code on the web에 의존하므로, 해당 기능을 사용할 수 있는 플랜·환경이 사실상의 전제 조건입니다.
Claude Code on the web은 Pro·Max·Team 사용자, 그리고 premium seat 또는 Chat + Claude Code seat을 가진 Enterprise 사용자를 대상으로 한 research preview 단계입니다.

/background

현재 사용법

이전 버전 근거 기록

Agent View(background agent)는 research preview이며 Claude Code v2.1.139 이상이 필요합니다. (claude --version으로 확인)
worktree.bgIsolation 설정은 v2.1.143 이상에서 동작합니다.
v2.1.144부터 background 세션은 /resume 세션 선택기에 bg 표시와 함께 나타납니다.
v2.1.251부터 background session 관리용 attach, logs, stop, respawn, rm이 top-level CLI subcommand로 제공됩니다.

/batch

현재 사용법

이전 버전 근거 기록

공식 명령어 문서(/commands)에는 별도 최소 버전이 명시되어 있지 않습니다.
bundled skill 및 백그라운드 서브에이전트, 워크트리 기능을 모두 활용하는 명령이므로, 이 기능들이 모두 제공되는 최신 버전의 Claude Code에서 사용하는 것을 권장합니다.

/claude-api

현재 사용법

이전 버전 근거 기록

공식 명령 레퍼런스(commands)에는 /claude-api의 최소 버전이 별도로 명시되어 있지 않습니다.
아래 "최근 변경"의 버전 정보는 Changelog/릴리스 노트 기준의 역사적 맥락입니다.

최근 변경

v2.1.91: /claude-api skill 가이드가 agent design patterns까지 확장되어, 도구 표면(tool surface), 컨텍스트 관리, 캐싱 전략 판단을 함께 다룹니다.
v2.1.97~v2.1.98: /claude-api skill이 Managed Agents alongside Claude API 기준으로 갱신되어, 단순 SDK 호출 예제뿐 아니라 에이전트 기반 서비스 설계의 출발점으로 쓸 수 있습니다.
v2.1.236+: 현재 Commands reference가 명시한 /claude-api upgrade 최소 버전입니다.
v2.1.247: /claude-api cost-optimize와 Admin API 전반의 안내가 추가됐습니다.
v2.1.259: /claude-api build-eval·hillclimb 추가.

이전 변경 메모

v2.1.247: /claude-api cost-optimize와 Admin API 전반의 안내가 추가됐습니다.
v2.1.259: /claude-api build-eval·hillclimb 추가.

/code-review

현재 사용법

이전 버전 근거 기록

v2.1.147 이전: 이 명령은 /simplify라는 이름이었고 기본적으로 수정을 적용
v2.1.151+: 로컬 /code-review가 correctness bug와 reuse/simplification/efficiency 정리를 함께 리포트
v2.1.154+: /simplify가 cleanup-only 리뷰로 분리되어 /code-review와 역할 구분 확정
v2.1.215+: Claude의 자동 호출 제거, 사용자 수동 호출 전용
v2.1.218: 백그라운드 서브에이전트 실행 도입; v2.1.274부터 모델별 inline 경로 적용

(공식 문서의 min-version 주석을 기준으로 한 값입니다.)

/color

현재 사용법

이전 버전 근거 기록

공식 Commands 문서는 /color에 대한 별도 도입 버전을 명시하지 않습니다. 다만 Changelog 기준으로 다음 동작 변화가 확인됩니다.

v2.1.70: /color reset 동작 수정
v2.1.118: Remote Control 연결 시 session accent color가 claude.ai/code에도 동기화
v2.1.128: 인자 없는 /color가 random session color를 선택

/compact

현재 사용법

이전 버전 근거 기록

초기 내장(legacy) 명령. 별도 alias 없음 (/clear와 달리 /reset·/new 같은 별칭이 없습니다).
v2.1.69: 이미지 보존 개선(summarizer 요청에 이미지를 유지해 prompt cache 재사용 효율 향상), compaction 후 resume 시 preamble recap 생략, VS Code에서 접을 수 있는 "Compacted chat" 카드 표시
v2.1.72: --continue가 compact 후 가장 최근 지점에서 재개되지 않던 문제 수정

이전 변경 메모

v2.1.72: --continue가 compact 후 가장 최근 지점에서 재개되지 않던 문제 수정

/config

현재 사용법

이전 버전 근거 기록

v2.0.71 이상
별칭 /settings는 공식 Commands 문서에 명시되어 있습니다.

이전 변경 메모

v2.1.79에서 "Show turn duration"(showTurnDuration) 토글 추가 — 각 턴의 소요 시간 표시
v2.1.144에서 무관한 설정을 토글할 때 /config 종료 요약이 auto-compact·theme에 대한 허위(phantom) 변경을 보고하던 버그가 수정되었습니다.

/context

현재 사용법

이전 변경 메모

v2.1.139부터 스킬별 토큰 추정치가 모델 토크나이저를 반영하고, v2.1.69에서 동일 MCP 서버 도구가 같은 토큰으로 표시되던 버그가 수정됐습니다.
v2.1.69 이전에는 동일 MCP 서버의 모든 도구가 같은 토큰 수로 표시되는 버그가 있었으며, v2.1.69에서 수정됨

/copy

현재 사용법

이전 버전 근거 기록

v2.1.59 이상
v2.1.72: 선택기에서 w 키로 파일에 직접 쓰기 지원
v2.1.77: /copy N으로 N번째 최근 응답 지정 복사

/cost

현재 사용법

이전 버전 근거 기록

초기 내장(legacy) 항목으로 보이며, 공식 문서·Changelog에 /cost의 최초 도입 버전이나 별도의 최소 버전이 명시되어 있지 않습니다.
현재 공식 문서에서 /cost는 /usage의 별칭으로 등재되어 있으며, /stats 역시 /usage의 별칭입니다(/stats는 Stats 탭으로 열림).
v2.1.251: 세션별 prompt-cache line과 statusline prompt_cache 입력이 추가됐습니다.

이전 변경 메모

v2.1.251: 세션별 prompt-cache line과 statusline prompt_cache 입력이 추가됐습니다.

/debug

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스 표에는 /debug에 대한 별도 최소 버전 표기가 없습니다.
디버그 로깅이 기본 비활성화로 전환된 변경(claude --debug 미사용 시 자동 기록하지 않음)은 Changelog 기준 v2.1.71 부근에서 반영되었습니다.

/desktop

현재 사용법

이전 버전 근거 기록

현재 공식 Commands 문서에는 들어 있지만, 공개 Changelog에 최초 도입 버전이 따로 적혀 있지 않습니다. 정확한 버전이 확인되지 않아 임의로 기재하지 않습니다.

/diff

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스에 별도의 최소 지원 버전(min-version) 표기가 없는 기본 내장 명령입니다.
v2.1.260: fullscreen 모드에서 대화 옆에 열리는 diff 패널이 추가됐고 /diff로 토글합니다. 뷰어 자체는 그 이전부터 있던 기능입니다.
bundled skill/workflow가 아닌 일반 내장 명령으로 분류됩니다(공식 표에 Skill/Workflow 배지가 없음).

이전 변경 메모

v2.1.260: fullscreen 모드에서 대화 옆에 열리는 diff 패널이 추가됐고 /diff로 토글합니다. 뷰어 자체는 그 이전부터 있던 기능입니다.

/doctor

현재 사용법

이전 버전 근거 기록

/doctor: v2.1.3 이상
전체 setup checkup과 /checkup 별칭: v2.1.205 이상

/effort

현재 사용법

이전 버전 근거 기록

v2.1.68: Opus 4.6에서 Max/Team 플랜 기본값 medium effort 적용, "ultrathink" 키워드 재도입
v2.1.72: /effort 명령 간소화
v2.1.73: 응답 중에도 /effort 변경 가능
v2.1.80: "auto" 해석값 표시, 스킬/슬래시 커맨드 effort frontmatter 지원
v2.1.111: xhigh 추가, 인수 없이 실행 시 인터랙티브 슬라이더 제공 (xhigh_effort 기능 capability 도입)
v2.1.154: Opus 4.8 출시(요구 버전). Opus 4.8 기본 effort는 high이며 가장 어려운 작업에는 /effort xhigh 사용 가능
v2.1.170: Fable 5 추가. Fable 5 기본 effort는 high이며 xhigh와 max를 지원
v2.1.197: Sonnet 5 추가. Sonnet 5 기본 effort는 high이며 xhigh와 max를 지원
v2.1.251: 모델별 effort 저장과 Opus xhigh·max/thinking-disabled 상태 보정
v2.1.257: Fable 5.1 추가(기본 effort high, xhigh·max 지원). /effort picker에 세션 한정 적용 키 s 추가. --effort가 새 모델의 기본 effort hold를 영구 해제하지 않고 그 세션에서만 해제하도록 변경
v2.1.260: Fable 5.1에서 세션 중 effort 변경이 prompt cache를 무효화하지 않도록 개선

이전 변경 메모

v2.1.111: xhigh 추가, 인수 없이 실행 시 인터랙티브 슬라이더 제공 (xhigh_effort 기능 capability 도입)
v2.1.170: Fable 5 추가. Fable 5 기본 effort는 high이며 xhigh와 max를 지원
v2.1.197: Sonnet 5 추가. Sonnet 5 기본 effort는 high이며 xhigh와 max를 지원
v2.1.257: Fable 5.1 추가(기본 effort high, xhigh·max 지원). /effort picker에 세션 한정 적용 키 s 추가. --effort가 새 모델의 기본 effort hold를 영구 해제하지 않고 그 세션에서만 해제하도록 변경

/export

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스에 별도의 최소 지원 버전이 명시되어 있지 않습니다. 초기부터 제공된 내장 명령으로 보이며, Changelog에도 최초 도입 버전이 따로 기록되어 있지 않습니다.

/fast

현재 사용법

이전 버전 근거 기록

fast mode는 Claude Code v2.1.36 이상이 필요합니다 (claude --version으로 확인).
fast mode의 기본 모델 버전:
- v2.1.219 이상: Opus 5 지원. Opus 4.7 fast mode는 지원 대상에서 제거
- v2.1.154 이상: Opus 4.8이 fast mode 기본값
- v2.1.142 ~ v2.1.153: Opus 4.7이 fast mode 기본값
- Opus 4.6으로 고정하려면 CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1 설정 (Opus 4.6 fast mode 은퇴 시 이 override도 제거됨)

/fewer-permission-prompts

현재 사용법

이전 버전 근거 기록

공식 Commands 문서 표에는 이 명령에 대한 명시적 최소 버전(min-version) 주석이 없습니다. 따라서 정확한 도입 버전은 공식 문서상 단정하기 어렵습니다.
다만 GitHub Releases v2.1.111 노트에 초기 명칭 /less-permission-prompts가 등장하므로, 기능 자체는 그 무렵부터 제공됐다고 볼 수 있습니다. 이후 /fewer-permission-prompts로 이름이 정리됐습니다.

/focus

현재 사용법

이전 버전 근거 기록

v2.1.110 이상 (GitHub Releases 기준). 이 릴리스에서 /focus 명령이 신설되었습니다.
같은 릴리스에서 Ctrl+O의 역할이 바뀌었습니다. 이제 Ctrl+O는 일반/상세(verbose) 트랜스크립트 전환만 담당하고 focus view 토글은 /focus로 분리되었습니다.

공식 명령어 레퍼런스 표에는 별도의 최소 버전 표기가 없습니다. 위 버전은 변경 이력(GitHub Releases)에서 확인한 도입 시점입니다.

/fork

현재 사용법

버전 이력

v2.1.71: 대화 fork/branch의 plan 파일 공유 문제 수정
v2.1.77: 당시 /fork를 /branch로 이름 변경
v2.1.116: 50MB 초과 transcript의 /branch 제한 수정
v2.1.117: inherited-context fork 서브에이전트 실험 도입
v2.1.212: /fork를 별도 백그라운드 세션 명령으로 재정의하고, inherited-context 서브에이전트 명령을 /subtask로 변경

이전 변경 메모

v2.1.71: 대화 fork/branch의 plan 파일 공유 문제 수정
v2.1.77: 당시 /fork를 /branch로 이름 변경
v2.1.116: 50MB 초과 transcript의 /branch 제한 수정

/goal

현재 사용법

이전 버전 근거 기록

v2.1.139 이상 (공식 문서 /en/goal 페이지의 Note 기준)

/hooks

현재 사용법

이전 버전 근거 기록

명령 자체는 초기 내장 항목이며, Changelog에 /hooks 명령의 최초 도입 버전이 따로 적혀 있지 않습니다.
공식 명령 레퍼런스에는 별칭(alias)·제거·이름 변경 표기가 없습니다. 아래 사용 예에 적은 개별 훅 기능들의 도입 버전은 Changelog 기준입니다.
v2.1.251: PreModelSwitch·PostModelSwitch 추가, resume 시 SessionStart payload의 staleness/cache cost 보강.

이전 변경 메모

v2.1.77에서 PreToolUse의 allow 반환이 deny 규칙을 우회하던 보안 버그가 수정됐습니다.
v2.1.251: PreModelSwitch·PostModelSwitch 추가, resume 시 SessionStart payload의 staleness/cache cost 보강.
v2.1.69에서 훅 이벤트 입력에 agent_id/agent_type/worktree 관련 필드가 추가되어 에이전트·워크트리를 구분할 수 있습니다.
v2.1.77에서 PreToolUse 훅의 "allow" 반환이 deny 퍼미션 규칙을 우회하던 보안 버그가 수정되었습니다.
v2.1.78에서 StopFailure 훅 이벤트가 추가되었습니다 — API 에러로 턴이 종료될 때 발생합니다.
v2.1.78에서 ${CLAUDE_PLUGIN_DATA} 변수가 추가되었습니다 — 플러그인 업데이트에도 보존되는 영구 데이터 디렉터리 경로입니다.

/ide

현재 사용법

이전 버전 근거 기록

공식 Commands 레퍼런스에는 별도의 도입/최소 버전이 명시되어 있지 않습니다.
v2.1.73: /ide 실행 시 발생하던 onInstall is not defined 크래시 수정. 이 버전 이전에는 동작이 불안정할 수 있으니 최신 버전을 쓰세요.

이전 변경 메모

v2.1.73에서 실행 시 발생하던 onInstall is not defined 크래시가 수정됐으니 최신 버전을 쓰세요.
v2.1.73: /ide 실행 시 발생하던 onInstall is not defined 크래시 수정. 이 버전 이전에는 동작이 불안정할 수 있으니 최신 버전을 쓰세요.

/init

현재 사용법

이전 버전 근거 기록

공식 명령어 문서에 최초 도입 버전이나 최소 지원 버전이 따로 적혀 있지 않습니다. 초기부터 들어 있던 기본 내장 명령입니다.

/keybindings

현재 사용법

이전 버전 근거 기록

v2.1.18 이상 (공식 키 바인딩 문서 명시: "Customizable keyboard shortcuts require Claude Code v2.1.18 or later")
현재 버전은 claude --version으로 확인할 수 있습니다.

/loop

현재 사용법

이전 버전 근거 기록

v2.1.72 이상 — 공식 문서가 "Scheduled tasks require Claude Code v2.1.72 or later"로 명시. claude --version으로 확인하세요.
v2.1.72: CLAUDE_CODE_DISABLE_CRON 환경변수로 스케줄러 비활성화 지원
v2.1.105: /proactive 별칭 추가
v2.1.113: 대기 중인 wakeup을 Esc로 취소, wakeup 메시지 명확화

/mcp

현재 사용법

이전 버전 근거 기록

v1.0.18 이상 (Changelog 기준 — 공식 명령어 문서에는 별도 최소 버전 표기가 없습니다)

이전 변경 메모

v2.1.248~251은 handshake timeout·재연결·오류 전달을 보강했으므로 연결 실패 시 /mcp 상태와 최신 로그를 함께 확인한다.
v2.1.80에서 --channels 연구 프리뷰 추가 — MCP 서버가 세션에 메시지를 직접 푸시 가능
v2.1.81에서 MCP OAuth CIMD(SEP-991) 지원 추가
v2.1.78에서 deny: ["mcp__servername"] 퍼미션 규칙이 MCP 서버 도구를 정상 제거하도록 수정
v2.1.121에서 MCP server config의 alwaysLoad: true 옵션이 추가되어 해당 서버 도구를 ToolSearch deferral 없이 항상 사용할 수 있습니다.
v2.1.187의 misleading MCP status 수정 이후에도, 인증·도구 수·권한 문제를 분리해 확인하는 습관을 유지하세요.

/memory

현재 사용법

이전 버전 근거 기록

/memory 명령 자체는 내장 명령으로, 공식 명령어 표에 별도의 최소 버전 표기가 없습니다.
다만 자동 메모리(auto-memory) 기능은 Claude Code v2.1.59 이상이 필요합니다. claude --version으로 버전을 확인할 수 있습니다.

/model

현재 사용법

이전 버전 근거 기록

초기 내장/legacy 항목으로 보이며, Changelog에 최초 도입 버전이 명시되지 않았습니다.

2026-09-05 모델 기준

환경	`fable` / `best`	`opus` alias	`sonnet` alias	운영 메모
Anthropic API	Fable 5.1(접근 권한 있을 때, `v2.1.255`+)	Opus 5	Sonnet 5	Opus 5는 Claude Code `v2.1.219` 이상 필요
Claude Platform on AWS	Fable 5.1(접근 권한 있을 때)	Opus 5	Sonnet 4.6	재현 작업은 full model name으로 pinning
Amazon Bedrock / Google Cloud Agent Platform	provider model ID pinning(`anthropic.claude-fable-5-1` / `claude-fable-5-1`)	Opus 5	Sonnet 4.5	`ANTHROPIC_DEFAULT_*_MODEL` pinning 권장
Microsoft Foundry	provider model ID pinning(`claude-fable-5-1`)	Opus 4.6	Sonnet 4.5	provider별 alias 차이를 운영 문서에 명시
Claude apps gateway 세션	Fable 5 유지(v2.1.257)	Opus 5	Sonnet 5	gateway가 Fable 5.1을 아직 거부할 수 있어 alias는 Fable 5로 남김. Fable 5.1은 `/model`에서 직접 선택

Alias는 provider별 권장 버전을 따라갑니다. 재현성이 중요한 CI, 벤치마크, 고객 재현, 장기 문서화 작업은 full model name으로 고정하세요.

fable alias는 ANTHROPIC_DEFAULT_FABLE_MODEL을 지정하지 않는 한 Fable 5.1로 해석됩니다. v2.1.255 이전 빌드에서는 Fable 5로 해석되므로, 팀 내 버전이 섞여 있으면 claude --version으로 어느 Fable이 뜨는지 먼저 확인하세요. Fable 5를 계속 써야 하면 /model claude-fable-5 또는 claude --model claude-fable-5로 full ID를 지정합니다. availableModels allowlist의 버전 prefix claude-fable-5는 Fable 5와 Fable 5.1을 모두 허용합니다.

ANTHROPIC_DEFAULT_MODEL은 v2.1.236부터 --model, ANTHROPIC_MODEL, settings model, 조직 기본값이 모두 없을 때만 새 세션의 기본 모델을 정합니다. default·inherit·opusplan·haiku, 조직 allowlist 밖 모델, 계정에서 사용할 수 없는 모델에는 적용되지 않으므로 CI pinning에는 --model 또는 full model ID를 계속 사용하세요.

2026-06-25 제한/경고 메모

v2.1.184 이후 main model restriction은 Opus/Sonnet/Haiku/Fable family 중심으로 더 엄격히 적용됩니다.
Haiku는 이 경로에서 main model로는 사용할 수 없지만, subagent model로는 사용할 수 있습니다. 저비용 보조 작업은 subagent에 Haiku를 지정하고 main session은 Sonnet/Opus/Fable 계열로 유지하세요.
v2.1.187부터 deprecated model을 사용할 때 경고가 강화됐습니다. 팀 설정에 오래된 full model ID가 남아 있으면 /model, /status, startup header에서 경고를 확인하고 최신 alias/full ID로 갱신합니다.

이전 변경 메모

v2.1.251은 모델 전환·fallback 후 도구와 reasoning 구성이 선택 모델에 맞게 갱신되도록 수정하고 PreModelSwitch·PostModelSwitch 훅을 추가했다.
v2.1.257~261은 Fable 5.1 추가, Claude apps gateway의 fable/best Fable 5 유지, picker의 Fable 5.1 노출·prompt caching 수정, Bedrock·Vertex·gateway raw ID 대신 모델 이름 표시를 반영했다.
v2.1.74에서 full model ID(예: claude-opus-4-5)가 에이전트 frontmatter에서 정상 인식되도록 수정
v2.1.78에서 ANTHROPIC_CUSTOM_MODEL_OPTION 환경변수로 /model 피커에 커스텀 항목 추가 가능
v2.1.126에서 ANTHROPIC_BASE_URL gateway의 /v1/models 목록을 /model picker에 표시하는 기능이 추가되었고, v2.1.129부터는 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1로 opt-in해야 합니다.

/permissions

현재 사용법

이전 버전 근거 기록

공식 명령어 문서에 별도의 최소 버전 표기는 없습니다(현행 버전에서 기본 제공되는 명령).
단, Auto 모드 거부 검토(Recently denied 탭)는 Auto 모드가 활성화된 환경에서만 의미가 있습니다.
v2.1.246부터 /permissions에 Auto 모드 규칙 탭이 추가됐습니다.

이전 변경 메모

v2.1.248~251은 file tool·plugin command·workflow scriptPath의 symlink/path traversal과 Grep/Glob deny-rule 우회를 보강했으므로 오래된 로컬 허용 규칙을 다시 점검해야 한다.
v2.1.246부터 /permissions에 Auto 모드 규칙 탭이 추가됐습니다.

/plan

현재 사용법

이전 버전 근거 기록

v2.1.0에서 /plan 명령 단축키가 추가되어 프롬프트에서 바로 계획 모드로 진입할 수 있게 되었습니다.
선택적 설명 인자(/plan fix the auth bug)는 v2.1.72부터 지원됩니다.

이전 변경 메모

v2.1.0에서 /plan 명령 단축키가 추가되어 프롬프트에서 바로 계획 모드로 진입할 수 있게 되었습니다.

/plugin

현재 사용법

이전 버전 근거 기록

v2.0.12 이상
공식 명령어 레퍼런스에는 별도의 최소 버전이 명시돼 있지 않습니다. /plugin 명령이 보이지 않으면 최신 버전으로 업데이트가 필요합니다(Homebrew brew upgrade claude-code, npm npm install -g @anthropic-ai/claude-code@latest 등 후 재시작).

이전 변경 메모

v2.1.118에서 claude plugin tag가 추가되어 플러그인 release git tag를 version validation과 함께 만들 수 있습니다.
v2.1.121에서 claude plugin prune 및 plugin uninstall --prune이 추가되어 자동 설치된 orphan dependency를 정리할 수 있습니다.

/powerup

현재 사용법

이전 버전 근거 기록

v2.1.90 이상 (GitHub Releases 기준 — 해당 릴리스 노트에 "Added /powerup"으로 도입이 명시됨)
공식 명령어 레퍼런스 표에는 /powerup에 별도의 min-version 주석이 붙어 있지 않습니다. 위 버전은 도입 시점을 알려주는 GitHub 릴리스 기록 기준입니다.

이전 변경 메모

v2.1.90 이상 (GitHub Releases 기준 — 해당 릴리스 노트에 "Added /powerup"으로 도입이 명시됨)

/pr-comments

현재 사용법

이전 버전 근거 기록

도입 버전: 초기 내장(legacy) 명령으로, Changelog에 최초 도입 버전이 명시되지 않았습니다.
마지막 지원 버전: v2.1.90
제거 버전: v2.1.91 (이 버전부터 명령이 사라짐)

/recap

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스에는 /recap에 대한 별도의 최소 버전 표기가 없습니다(현재 일반 명령으로 안내됨).
자동 세션 요약(Session recap)은 모든 플랜·프로바이더에서 기본 활성화되어 있습니다.

/release-notes

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스는 /release-notes에 min-version/max-version 표시를 달지 않았습니다. 그래서 정확한 도입 버전은 공식 문서만으로는 확정되지 않습니다.
같은 표에는 버전이 명시된 항목도 있습니다. 예를 들어 /reload-skills는 v2.1.152부터, /pr-comments는 v2.1.91에서 제거됐다고 표기합니다. /release-notes에는 그런 표기가 없습니다.
버전별 동작 변화를 정확히 추적하려면 명령 자체가 여는 변경 로그(또는 GitHub CHANGELOG.md)를 직접 확인하는 편이 가장 믿을 만합니다.

/reload-plugins

현재 사용법

이전 버전 근거 기록

공식 명령어 문서에는 /reload-plugins에 대한 별도의 최소 버전 표기가 없습니다. 따라서 특정 도입 버전을 단정하지 않습니다.
변경 로그(Changelog)를 보면 적어도 v2.1.119 시점에는 이미 존재했습니다(이 버전에 /reload-plugins와 /doctor의 버그 수정 항목이 들어 있습니다).

이전 변경 메모

v2.1.119·v2.1.141에서 비활성화된 플러그인에 대해 로드 오류를 잘못 보고하던 문제가 수정됐다.
v2.1.119와 v2.1.141에서 /reload-plugins와 /doctor가 비활성화된 플러그인에 대해 로드 오류를 잘못 보고하던 문제가 수정되었습니다.

/reload-skills

현재 사용법

이전 버전 근거 기록

v2.1.152 이상 (공식 Commands 문서의 min-version: 2.1.152 표기 기준)

/remote-env

현재 사용법

이전 버전 근거 기록

공식 명령 레퍼런스에 별도의 최소 버전(min-version) 표기가 없습니다. --remote 기반 웹 세션 기능과 함께 제공됩니다.
Claude Code on the web은 Pro·Max·Team 사용자 및 일부 Enterprise 좌석을 대상으로 한 리서치 프리뷰 단계입니다.

/rename

현재 사용법

이전 버전 근거 기록

공식 명령어 문서(code.claude.com/docs/en/commands)에는 /rename에 대한 별도 최소 버전 표기가 없습니다. 기본 내장 명령으로 제공됩니다.
v2.1.70: Claude가 응답을 처리하는 중에도 /rename을 실행할 수 있게 됐습니다. 변경 이력(Changelog)에는 적혀 있지만 현행 명령어 문서 본문에는 나오지 않습니다.

/resume

현재 사용법

이전 버전 근거 기록

공식 문서는 명령 도입 버전을 밝히지 않습니다. 다만 v2.1.144부터 백그라운드 세션이 피커에 bg 표식으로 나타나는 동작이 추가됐다고 적혀 있습니다.
그 외 동작 변경 이력은 Changelog 기준입니다. 현재 운영 조건은 resume 주의사항에서 확인합니다.

이전 변경 메모

v2.1.73에서 현재 활성 세션이 picker 목록에 표시되지 않도록 수정되었습니다.

공식 commands 문서의 /rewind 항목에는 별도의 최소 버전(min-version) 표기가 없습니다. 체크포인팅은 현재 정식 기능으로 문서화되어 있고, 최소 버전을 따로 명시한 부분은 확인되지 않습니다.

/run

현재 사용법

이전 버전 근거 기록

Claude Code v2.1.145 이상 (공식 Commands 문서 기준, /verify·/run-skill-generator와 동일)

/run-skill-generator

현재 사용법

이전 버전 근거 기록

v2.1.145 이상 (Commands 문서 기준, "Requires Claude Code v2.1.145 or later")
관련 번들 스킬 /run, /verify도 동일하게 v2.1.145+를 요구합니다.
디스크에 새로 만들어진 스킬을 세션 재시작 없이 다시 읽어들이는 /reload-skills는 v2.1.152+가 필요합니다.

/sandbox

현재 사용법

이전 버전 근거 기록

Changelog에 별도의 도입 버전이 명시되지 않은 내장 명령입니다. 공식 문서 명령 표에도 /sandbox에 대한 min-version 주석이 없습니다. 정확한 도입 버전이 확인되지 않아 임의로 버전을 적지 않습니다.

/schedule

현재 사용법

이전 버전 근거 기록

Claude Code v2.1.81 이상이 필요합니다. CLI 버전이 v2.1.81보다 낮으면 /schedule이 숨겨지며 Unknown command로 처리됩니다(claude update로 갱신). 출처: Commands 문서의 Routines 트러블슈팅 섹션.
routine 기능 자체는 아직 research preview 단계라 동작·제한·API 표면이 바뀔 수 있습니다.

/security-review

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스에 별도의 최소 버전(min-version) 주석이 없는, 오래전부터 제공된 내장 명령입니다.
Changelog에 최초 도입 버전이 명시되어 있지 않으나, 적어도 v2.1.70 이전부터 존재했습니다.
v2.1.108부터는 모델이 Skill 도구로 /init, /review와 함께 /security-review를 직접 발견·호출합니다.

이전 변경 메모

v2.1.70에서 이전 git 버전에서 발생하던 unknown option merge-base 오류가 수정됨

/simplify

현재 사용법

이전 버전 근거 기록

공식 문서 명령 표 기준 v2.1.154 (min-version 주석)
v2.1.154부터 cleanup-only 동작으로 역할 분리 (버그 탐지는 /code-review로 이관)
그 이전 버전에서는 /code-review --fix와 동등하게 동작

/skills

현재 사용법

이전 버전 근거 기록

현재 공식 Commands 문서에 포함되어 있으며, 공식 표에 별도의 최소 버전 표기(min-version)는 없습니다.
함께 자주 쓰는 /reload-skills는 공식 문서 기준 v2.1.152부터 제공됩니다. 세션 도중 디스크에서 추가/변경된 skill과 명령 디렉터리를 다시 스캔합니다.

/stats

현재 사용법

이전 버전 근거 기록

v2.1.118 (2026-04-23): /cost와 /stats가 /usage로 통합되었습니다. 두 명령은 관련 탭을 바로 여는 타이핑 단축키로 그대로 유지됩니다.
v2.1.149 (2026-05-22): /usage에 한도를 소모하는 요소(스킬·서브에이전트·플러그인·MCP 서버별 비용)를 카테고리별로 분해해 보여주는 기능이 추가되었습니다. /stats로 진입하는 통계 화면에도 이 정보가 반영됩니다.

통합 이후 /stats는 /usage 화면의 Stats 탭으로 진입하는 단축키입니다. 동작·표시 내용은 /usage를 따릅니다.

이전 변경 메모

v2.1.118에서 /cost·/stats가 /usage로 통합되었고, v2.1.149부터 스킬·서브에이전트·플러그인·MCP 서버별 분해가 추가되었습니다.
v2.1.149 (2026-05-22): /usage에 한도를 소모하는 요소(스킬·서브에이전트·플러그인·MCP 서버별 비용)를 카테고리별로 분해해 보여주는 기능이 추가되었습니다. /stats로 진입하는 통계 화면에도 이 정보가 반영됩니다.

/statusline

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스 및 전용 문서(/en/statusline)에 별도의 최소 버전 표기는 없습니다. 다만 개별 기능에는 도입 버전이 명시되어 있습니다.
- context_window.total_input_tokens / total_output_tokens: v2.1.132부터 컨텍스트 창에 남아 있는 토큰 수를 반환(이전에는 세션 누적 합계).
- COLUMNS / LINES 환경변수로 터미널 크기 읽기: v2.1.153부터 지원.
- rate_limits.spend_limit / prompt_cache: v2.1.251부터 지원.

/tasks

현재 사용법

이전 버전 근거 기록

공식 명령 레퍼런스 표에 /tasks의 최초 도입 버전이 별도로 명시되어 있지 않습니다. 백그라운드 세션/태스크 워크플로(/background, /stop 등)와 함께 제공되는 내장 명령입니다.

/team-onboarding

현재 사용법

이전 버전 근거 기록

v2.1.101 이상 (GitHub Releases 기준 — "Added /team-onboarding command to generate a teammate ramp-up guide from your local Claude Code usage"로 도입)
공식 Commands 문서에는 별도의 최소 버전 표기가 없습니다. 위 버전은 도입 릴리스 노트를 근거로 합니다.

이전 변경 메모

v2.1.101 이상 (GitHub Releases 기준 — "Added /team-onboarding command to generate a teammate ramp-up guide from your local Claude Code usage"로 도입)

/teleport

현재 사용법

이전 버전 근거 기록

공식 문서는 별도의 최소 CLI 버전을 명시하지 않습니다. 대신 claude.ai 구독(Pro/Max/Team, 또는 Enterprise premium·Chat + Claude Code 시트) 인증이 필요하고, Claude Code on the web 기능 자체가 아직 리서치 프리뷰 상태입니다.

/terminal-setup

현재 사용법

이전 버전 근거 기록

v1.0.110 이상
공식 명령어 레퍼런스에는 별도의 최소 버전 표기가 없습니다. 위 값은 Changelog에서 확인된 등장 시점 기준이며, 환경에 따라 노출 여부가 달라질 수 있습니다.

/theme

현재 사용법

이전 버전 근거 기록

/theme 명령 자체에 명시된 최소 버전은 공식 문서에 별도로 기재되어 있지 않습니다.
custom theme(~/.claude/themes/ 또는 plugin 제공 테마, New custom theme… 흐름)은 공식 문서가 Claude Code v2.1.118 이상을 요구한다고 명시합니다.

/tui

현재 사용법

이전 버전 근거 기록

/tui 명령과 tui 설정: v2.1.110에서 도입 ("Added /tui command and tui setting").
fullscreen 렌더링 자체(research preview): v2.1.89 이상 필요.
v2.1.110 이전 버전에서는 /tui 대신 환경 변수로 켰습니다: CLAUDE_CODE_NO_FLICKER=1.

공식 Commands 레퍼런스의 /tui 항목에는 별도의 최소 버전 주석이 표기되어 있지 않습니다. 위 버전은 전용 fullscreen 문서와 v2.1.110 릴리스 노트를 근거로 합니다.

/ultrareview

현재 사용법

이전 버전 근거 기록

v2.1.86 이상에서 사용 가능한 research preview 기능입니다(공식 ultrareview 문서 기준).
참고: /code-review 스킬에서 ultra 인자를 포함한 전체 명령 표기는 v2.1.154부터 문서화되었으며, 같은 버전부터 /simplify가 버그 탐색 없이 정리만 수행하는 별도 리뷰로 분리되었습니다.

/upgrade

현재 사용법

이전 버전 근거 기록

공식 명령 레퍼런스에 별도의 최소 버전 표기가 없습니다. 사용 환경의 Claude Code를 최신 버전으로 유지하는 것을 권장합니다.

/usage

현재 사용법

이전 버전 근거 기록

v2.1.118부터: /cost와 /stats가 /usage로 통합되었습니다. 두 명령은 해당 탭을 여는 타이핑 shortcut으로 남았습니다. (2026-04-23)
v2.1.121: 큰 transcript history가 있는 머신에서 /usage가 최대 약 2GB 메모리를 누수하던 문제가 수정되었습니다. (2026-04-28)
v2.1.144: "extra usage"가 CLI 문구 전반에서 "usage credits"로 변경되었고, /extra-usage가 /usage-credits로 바뀌었습니다(이전 이름도 계속 동작). (2026-05-19)
v2.1.149: /usage가 한도를 소모하는 요인을 skill, subagent, plugin, per-MCP-server 단위로 나눈 per-category breakdown을 표시하기 시작했습니다. (2026-05-22)
v2.1.152: /usage breakdown이 큰 세션 파일까지 포함하며, streaming read로 스캔해 메모리 사용량을 일정하게 유지합니다. (2026-05-27)
v2.1.243: Loops breakdown에 실행 횟수, 총 토큰, 실행당 토큰, 마지막 실행 시각이 추가됐습니다. (2026-08-25)
v2.1.251: gateway spend-limit 막대와 rate_limits.spend_limit statusline 입력이 추가됐습니다. (2026-08-28)

이전 변경 메모

v2.1.121: 큰 transcript history가 있는 머신에서 /usage가 최대 약 2GB 메모리를 누수하던 문제가 수정되었습니다. (2026-04-28)
v2.1.243: Loops breakdown에 실행 횟수, 총 토큰, 실행당 토큰, 마지막 실행 시각이 추가됐습니다. (2026-08-25)
v2.1.251: gateway spend-limit 막대와 rate_limits.spend_limit statusline 입력이 추가됐습니다. (2026-08-28)

/usage-credits

현재 사용법

이전 버전 근거 기록

공식 명령 참조 문서에는 /usage-credits(구 /extra-usage)에 대한 별도의 최소 버전(min-version) 표기가 없습니다. 따라서 특정 버전을 단정하지 않습니다. (/run, /verify, /reload-skills 등은 공식 표에 min-version이 명시되어 있지만 이 명령에는 그런 표기가 없습니다.)
명령이 실제로 보이느냐는 버전보다 플랜·플랫폼·환경에 달려 있습니다. 공식 문서도 "모든 명령이 모든 사용자에게 보이는 것은 아니며, 가용성은 플랫폼·플랜·환경에 따라 달라진다"고 못박습니다.

이전 변경 메모

v2.1.248에서 Enterprise seat·조직 구성별 usage-credit 표시가 확대되고 잔액이 0일 때 관리자 화면 표기가 수정됐습니다.

/verify

현재 사용법

이전 버전 근거 기록

v2.1.145 이상 (Commands 문서의 min-version: 2.1.145 표기, "Requires Claude Code v2.1.145 or later")
v2.1.215부터 사용자 수동 호출 전용

/vim

현재 사용법

이전 버전 근거 기록

마지막 지원 버전: v2.1.91
제거: v2.1.92부터 (이후 버전에서는 호출 불가)

/web-setup

현재 사용법

이전 버전 근거 기록

현재 공식 Commands 문서에 내장 명령으로 포함되어 있습니다. 공식 문서에 별도의 최소 버전 표기는 없으며, 공개 Changelog에서도 최초 도입 버전이 명시적으로 확인되지 않았습니다.

/workflows

현재 사용법

이전 버전 근거 기록

v2.1.154 이상 (dynamic workflows research preview 요구 버전, 공식 문서 기준)
/workflow-authoring 번들 skill은 v2.1.248 이상이 필요합니다.

/approved-tools

현재 사용법

이전 버전 근거 기록

공식 문서는 /permissions(별칭 /allowed-tools)에 대해 별도의 최소 지원 버전을 명시하지 않습니다.
/approved-tools는 현재 공식 명령 표에 등재되어 있지 않으므로, 특정 버전부터 동작한다고 단정할 수 없습니다. 레거시 문서에 등장하는 표기로만 취급하세요.

/commands

현재 사용법

이전 버전 근거 기록

/commands라는 단일 명령이 공식적으로 존재한 적이 없으므로 별도의 최소 지원 버전은 명시되지 않습니다.
사용 가능한 명령 목록을 보는 방식(/ 입력)은 인터랙티브 모드의 기본 동작입니다.
커스텀 명령을 만드는 권장 경로인 스킬은 /skills, /reload-skills(v2.1.152부터) 등으로 관리합니다.

/extra-usage

현재 사용법

이전 버전 근거 기록

공식 명령 참조 문서에는 /usage-credits(구 /extra-usage)에 대한 별도의 최소 버전(min-version) 표기가 없습니다. 따라서 특정 버전을 단정하지 않습니다.
명령의 실제 노출 여부는 버전보다 플랜·환경을 따릅니다. 공식 문서는 "모든 명령이 모든 사용자에게 보이는 것은 아니며, 플랫폼·플랜·환경에 따라 가용성이 달라진다"고 명시합니다.

/project-purge

현재 사용법

이전 버전 근거 기록

v2.1.126 이상 (공식 Changelog, 2026-05-01 릴리스에서 추가)

이전 변경 메모

v2.1.126 이상 (공식 Changelog, 2026-05-01 릴리스에서 추가)

/settings

현재 사용법

이전 버전 근거 기록

/settings는 /config의 별칭으로, 현재 버전에서 정상 동작합니다.
공식 Changelog에는 /settings 별칭이 처음 도입된 정확한 버전이 나와 있지 않습니다. 특정 버전을 단정하지 말고, 설치된 버전에서 /를 입력해 목록에 뜨는지 확인하세요.

/tag

현재 사용법

이전 버전 근거 기록

최초 도입 버전은 공개 changelog에서 명확히 확인되지 않음
제거: v2.1.92 (릴리스 노트의 Removed /tag command 항목으로 확인)

/todos

현재 사용법

이전 버전 근거 기록

/todos: 공식 명령어 표에 없으므로 별도의 최소 지원 버전이 명시되어 있지 않습니다.
대체 명령 /tasks(별칭 /bashes)는 공식 문서의 "All commands" 표에 수록되어 있으며, 문서상 별도의 최소 버전 표기는 없습니다.

핵심 요약

이 페이지는 이전 검증 당시의 기록입니다. 지원 상태와 현재 사용법은 개별 명령 페이지와 전체 목록을 기준으로 확인하세요. 과거의 “최소 지원 버전” 기록은 도입 버전을 새로 보증하지 않습니다.

/add-dir

현재 사용법

이전 버전 근거 기록

공식 명령어 문서에 별도의 최소 버전이 명시되어 있지 않습니다. (Working directories 기능 일부로 제공)

/agents

현재 사용법

이전 변경 메모

v2.1.143: background session의 worktree isolation을 끄는 worktree.bgIsolation: "none" 설정이 추가되었습니다.
v2.1.139: Agent View가 research preview로 추가되었습니다. claude agents로 모든 session의 working/needs input/completed 상태를 관리합니다.

/autofix-pr

현재 사용법

이전 버전 근거 기록

공식 Commands 문서의 명령어 표에는 버전 컬럼이 없으며, 도입 버전이 별도로 명시되어 있지 않습니다. 다만 기능 자체가 Claude Code on the web에 의존하므로, 해당 기능을 사용할 수 있는 플랜·환경이 사실상의 전제 조건입니다.
Claude Code on the web은 Pro·Max·Team 사용자, 그리고 premium seat 또는 Chat + Claude Code seat을 가진 Enterprise 사용자를 대상으로 한 research preview 단계입니다.

/background

현재 사용법

이전 버전 근거 기록

Agent View(background agent)는 research preview이며 Claude Code v2.1.139 이상이 필요합니다. (claude --version으로 확인)
worktree.bgIsolation 설정은 v2.1.143 이상에서 동작합니다.
v2.1.144부터 background 세션은 /resume 세션 선택기에 bg 표시와 함께 나타납니다.
v2.1.251부터 background session 관리용 attach, logs, stop, respawn, rm이 top-level CLI subcommand로 제공됩니다.

/batch

현재 사용법

이전 버전 근거 기록

공식 명령어 문서(/commands)에는 별도 최소 버전이 명시되어 있지 않습니다.
bundled skill 및 백그라운드 서브에이전트, 워크트리 기능을 모두 활용하는 명령이므로, 이 기능들이 모두 제공되는 최신 버전의 Claude Code에서 사용하는 것을 권장합니다.

/claude-api

현재 사용법

이전 버전 근거 기록

공식 명령 레퍼런스(commands)에는 /claude-api의 최소 버전이 별도로 명시되어 있지 않습니다.
아래 "최근 변경"의 버전 정보는 Changelog/릴리스 노트 기준의 역사적 맥락입니다.

최근 변경

v2.1.91: /claude-api skill 가이드가 agent design patterns까지 확장되어, 도구 표면(tool surface), 컨텍스트 관리, 캐싱 전략 판단을 함께 다룹니다.
v2.1.97~v2.1.98: /claude-api skill이 Managed Agents alongside Claude API 기준으로 갱신되어, 단순 SDK 호출 예제뿐 아니라 에이전트 기반 서비스 설계의 출발점으로 쓸 수 있습니다.
v2.1.236+: 현재 Commands reference가 명시한 /claude-api upgrade 최소 버전입니다.
v2.1.247: /claude-api cost-optimize와 Admin API 전반의 안내가 추가됐습니다.
v2.1.259: /claude-api build-eval·hillclimb 추가.

이전 변경 메모

v2.1.247: /claude-api cost-optimize와 Admin API 전반의 안내가 추가됐습니다.
v2.1.259: /claude-api build-eval·hillclimb 추가.

/code-review

현재 사용법

이전 버전 근거 기록

v2.1.147 이전: 이 명령은 /simplify라는 이름이었고 기본적으로 수정을 적용
v2.1.151+: 로컬 /code-review가 correctness bug와 reuse/simplification/efficiency 정리를 함께 리포트
v2.1.154+: /simplify가 cleanup-only 리뷰로 분리되어 /code-review와 역할 구분 확정
v2.1.215+: Claude의 자동 호출 제거, 사용자 수동 호출 전용
v2.1.218: 백그라운드 서브에이전트 실행 도입; v2.1.274부터 모델별 inline 경로 적용

(공식 문서의 min-version 주석을 기준으로 한 값입니다.)

/color

현재 사용법

이전 버전 근거 기록

공식 Commands 문서는 /color에 대한 별도 도입 버전을 명시하지 않습니다. 다만 Changelog 기준으로 다음 동작 변화가 확인됩니다.

v2.1.70: /color reset 동작 수정
v2.1.118: Remote Control 연결 시 session accent color가 claude.ai/code에도 동기화
v2.1.128: 인자 없는 /color가 random session color를 선택

이전 변경 메모

v2.1.70: /color reset 동작 수정

/compact

현재 사용법

이전 버전 근거 기록

초기 내장(legacy) 명령. 별도 alias 없음 (/clear와 달리 /reset·/new 같은 별칭이 없습니다).
v2.1.69: 이미지 보존 개선(summarizer 요청에 이미지를 유지해 prompt cache 재사용 효율 향상), compaction 후 resume 시 preamble recap 생략, VS Code에서 접을 수 있는 "Compacted chat" 카드 표시
v2.1.72: --continue가 compact 후 가장 최근 지점에서 재개되지 않던 문제 수정

이전 변경 메모

v2.1.72: --continue가 compact 후 가장 최근 지점에서 재개되지 않던 문제 수정

/config

현재 사용법

이전 버전 근거 기록

v2.0.71 이상
별칭 /settings는 공식 Commands 문서에 명시되어 있습니다.

이전 변경 메모

v2.1.79에서 "Show turn duration"(showTurnDuration) 토글 추가 — 각 턴의 소요 시간 표시
v2.1.144에서 무관한 설정을 토글할 때 /config 종료 요약이 auto-compact·theme에 대한 허위(phantom) 변경을 보고하던 버그가 수정되었습니다.

/context

현재 사용법

이전 버전 근거 기록

v1.0.86 이상

이전 변경 메모

v2.1.139부터 스킬별 토큰 추정치가 모델 토크나이저를 반영하고, v2.1.69에서 동일 MCP 서버 도구가 같은 토큰으로 표시되던 버그가 수정됐습니다.
v2.1.69 이전에는 동일 MCP 서버의 모든 도구가 같은 토큰 수로 표시되는 버그가 있었으며, v2.1.69에서 수정됨

/copy

현재 사용법

이전 버전 근거 기록

v2.1.59 이상
v2.1.72: 선택기에서 w 키로 파일에 직접 쓰기 지원
v2.1.77: /copy N으로 N번째 최근 응답 지정 복사

/cost

현재 사용법

이전 버전 근거 기록

초기 내장(legacy) 항목으로 보이며, 공식 문서·Changelog에 /cost의 최초 도입 버전이나 별도의 최소 버전이 명시되어 있지 않습니다.
현재 공식 문서에서 /cost는 /usage의 별칭으로 등재되어 있으며, /stats 역시 /usage의 별칭입니다(/stats는 Stats 탭으로 열림).
v2.1.251: 세션별 prompt-cache line과 statusline prompt_cache 입력이 추가됐습니다.

이전 변경 메모

v2.1.251: 세션별 prompt-cache line과 statusline prompt_cache 입력이 추가됐습니다.

/debug

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스 표에는 /debug에 대한 별도 최소 버전 표기가 없습니다.
디버그 로깅이 기본 비활성화로 전환된 변경(claude --debug 미사용 시 자동 기록하지 않음)은 Changelog 기준 v2.1.71 부근에서 반영되었습니다.

/desktop

현재 사용법

이전 버전 근거 기록

현재 공식 Commands 문서에는 들어 있지만, 공개 Changelog에 최초 도입 버전이 따로 적혀 있지 않습니다. 정확한 버전이 확인되지 않아 임의로 기재하지 않습니다.

/diff

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스에 별도의 최소 지원 버전(min-version) 표기가 없는 기본 내장 명령입니다.
v2.1.260: fullscreen 모드에서 대화 옆에 열리는 diff 패널이 추가됐고 /diff로 토글합니다. 뷰어 자체는 그 이전부터 있던 기능입니다.
bundled skill/workflow가 아닌 일반 내장 명령으로 분류됩니다(공식 표에 Skill/Workflow 배지가 없음).

이전 변경 메모

v2.1.260: fullscreen 모드에서 대화 옆에 열리는 diff 패널이 추가됐고 /diff로 토글합니다. 뷰어 자체는 그 이전부터 있던 기능입니다.

/doctor

현재 사용법

이전 버전 근거 기록

/doctor: v2.1.3 이상
전체 setup checkup과 /checkup 별칭: v2.1.205 이상

/effort

현재 사용법

이전 버전 근거 기록

v2.1.68: Opus 4.6에서 Max/Team 플랜 기본값 medium effort 적용, "ultrathink" 키워드 재도입
v2.1.72: /effort 명령 간소화
v2.1.73: 응답 중에도 /effort 변경 가능
v2.1.80: "auto" 해석값 표시, 스킬/슬래시 커맨드 effort frontmatter 지원
v2.1.111: xhigh 추가, 인수 없이 실행 시 인터랙티브 슬라이더 제공 (xhigh_effort 기능 capability 도입)
v2.1.154: Opus 4.8 출시(요구 버전). Opus 4.8 기본 effort는 high이며 가장 어려운 작업에는 /effort xhigh 사용 가능
v2.1.170: Fable 5 추가. Fable 5 기본 effort는 high이며 xhigh와 max를 지원
v2.1.197: Sonnet 5 추가. Sonnet 5 기본 effort는 high이며 xhigh와 max를 지원
v2.1.251: 모델별 effort 저장과 Opus xhigh·max/thinking-disabled 상태 보정
v2.1.257: Fable 5.1 추가(기본 effort high, xhigh·max 지원). /effort picker에 세션 한정 적용 키 s 추가. --effort가 새 모델의 기본 effort hold를 영구 해제하지 않고 그 세션에서만 해제하도록 변경
v2.1.260: Fable 5.1에서 세션 중 effort 변경이 prompt cache를 무효화하지 않도록 개선

이전 변경 메모

v2.1.111: xhigh 추가, 인수 없이 실행 시 인터랙티브 슬라이더 제공 (xhigh_effort 기능 capability 도입)
v2.1.170: Fable 5 추가. Fable 5 기본 effort는 high이며 xhigh와 max를 지원
v2.1.197: Sonnet 5 추가. Sonnet 5 기본 effort는 high이며 xhigh와 max를 지원
v2.1.257: Fable 5.1 추가(기본 effort high, xhigh·max 지원). /effort picker에 세션 한정 적용 키 s 추가. --effort가 새 모델의 기본 effort hold를 영구 해제하지 않고 그 세션에서만 해제하도록 변경

/export

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스에 별도의 최소 지원 버전이 명시되어 있지 않습니다. 초기부터 제공된 내장 명령으로 보이며, Changelog에도 최초 도입 버전이 따로 기록되어 있지 않습니다.

/fast

현재 사용법

이전 버전 근거 기록

fast mode는 Claude Code v2.1.36 이상이 필요합니다 (claude --version으로 확인).
fast mode의 기본 모델 버전:
- v2.1.219 이상: Opus 5 지원. Opus 4.7 fast mode는 지원 대상에서 제거
- v2.1.154 이상: Opus 4.8이 fast mode 기본값
- v2.1.142 ~ v2.1.153: Opus 4.7이 fast mode 기본값
- Opus 4.6으로 고정하려면 CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1 설정 (Opus 4.6 fast mode 은퇴 시 이 override도 제거됨)

/fewer-permission-prompts

현재 사용법

이전 버전 근거 기록

공식 Commands 문서 표에는 이 명령에 대한 명시적 최소 버전(min-version) 주석이 없습니다. 따라서 정확한 도입 버전은 공식 문서상 단정하기 어렵습니다.
다만 GitHub Releases v2.1.111 노트에 초기 명칭 /less-permission-prompts가 등장하므로, 기능 자체는 그 무렵부터 제공됐다고 볼 수 있습니다. 이후 /fewer-permission-prompts로 이름이 정리됐습니다.

/focus

현재 사용법

이전 버전 근거 기록

v2.1.110 이상 (GitHub Releases 기준). 이 릴리스에서 /focus 명령이 신설되었습니다.
같은 릴리스에서 Ctrl+O의 역할이 바뀌었습니다. 이제 Ctrl+O는 일반/상세(verbose) 트랜스크립트 전환만 담당하고 focus view 토글은 /focus로 분리되었습니다.

공식 명령어 레퍼런스 표에는 별도의 최소 버전 표기가 없습니다. 위 버전은 변경 이력(GitHub Releases)에서 확인한 도입 시점입니다.

/fork

현재 사용법

버전 이력

v2.1.71: 대화 fork/branch의 plan 파일 공유 문제 수정
v2.1.77: 당시 /fork를 /branch로 이름 변경
v2.1.116: 50MB 초과 transcript의 /branch 제한 수정
v2.1.117: inherited-context fork 서브에이전트 실험 도입
v2.1.212: /fork를 별도 백그라운드 세션 명령으로 재정의하고, inherited-context 서브에이전트 명령을 /subtask로 변경

이전 변경 메모

v2.1.71: 대화 fork/branch의 plan 파일 공유 문제 수정
v2.1.77: 당시 /fork를 /branch로 이름 변경
v2.1.116: 50MB 초과 transcript의 /branch 제한 수정

/goal

현재 사용법

이전 버전 근거 기록

v2.1.139 이상 (공식 문서 /en/goal 페이지의 Note 기준)

/hooks

현재 사용법

이전 버전 근거 기록

명령 자체는 초기 내장 항목이며, Changelog에 /hooks 명령의 최초 도입 버전이 따로 적혀 있지 않습니다.
공식 명령 레퍼런스에는 별칭(alias)·제거·이름 변경 표기가 없습니다. 아래 사용 예에 적은 개별 훅 기능들의 도입 버전은 Changelog 기준입니다.
v2.1.251: PreModelSwitch·PostModelSwitch 추가, resume 시 SessionStart payload의 staleness/cache cost 보강.

이전 변경 메모

v2.1.77에서 PreToolUse의 allow 반환이 deny 규칙을 우회하던 보안 버그가 수정됐습니다.
v2.1.251: PreModelSwitch·PostModelSwitch 추가, resume 시 SessionStart payload의 staleness/cache cost 보강.
v2.1.69에서 훅 이벤트 입력에 agent_id/agent_type/worktree 관련 필드가 추가되어 에이전트·워크트리를 구분할 수 있습니다.
v2.1.77에서 PreToolUse 훅의 "allow" 반환이 deny 퍼미션 규칙을 우회하던 보안 버그가 수정되었습니다.
v2.1.78에서 StopFailure 훅 이벤트가 추가되었습니다 — API 에러로 턴이 종료될 때 발생합니다.
v2.1.78에서 ${CLAUDE_PLUGIN_DATA} 변수가 추가되었습니다 — 플러그인 업데이트에도 보존되는 영구 데이터 디렉터리 경로입니다.

/ide

현재 사용법

이전 버전 근거 기록

공식 Commands 레퍼런스에는 별도의 도입/최소 버전이 명시되어 있지 않습니다.
v2.1.73: /ide 실행 시 발생하던 onInstall is not defined 크래시 수정. 이 버전 이전에는 동작이 불안정할 수 있으니 최신 버전을 쓰세요.

이전 변경 메모

v2.1.73에서 실행 시 발생하던 onInstall is not defined 크래시가 수정됐으니 최신 버전을 쓰세요.
v2.1.73: /ide 실행 시 발생하던 onInstall is not defined 크래시 수정. 이 버전 이전에는 동작이 불안정할 수 있으니 최신 버전을 쓰세요.

/init

현재 사용법

이전 버전 근거 기록

공식 명령어 문서에 최초 도입 버전이나 최소 지원 버전이 따로 적혀 있지 않습니다. 초기부터 들어 있던 기본 내장 명령입니다.

/keybindings

현재 사용법

이전 버전 근거 기록

v2.1.18 이상 (공식 키 바인딩 문서 명시: "Customizable keyboard shortcuts require Claude Code v2.1.18 or later")
현재 버전은 claude --version으로 확인할 수 있습니다.

/loop

현재 사용법

이전 버전 근거 기록

v2.1.72 이상 — 공식 문서가 "Scheduled tasks require Claude Code v2.1.72 or later"로 명시. claude --version으로 확인하세요.
v2.1.72: CLAUDE_CODE_DISABLE_CRON 환경변수로 스케줄러 비활성화 지원
v2.1.105: /proactive 별칭 추가
v2.1.113: 대기 중인 wakeup을 Esc로 취소, wakeup 메시지 명확화

이전 변경 메모

v2.1.105: /proactive 별칭 추가

/mcp

현재 사용법

이전 버전 근거 기록

v1.0.18 이상 (Changelog 기준 — 공식 명령어 문서에는 별도 최소 버전 표기가 없습니다)

이전 변경 메모

v2.1.248~251은 handshake timeout·재연결·오류 전달을 보강했으므로 연결 실패 시 /mcp 상태와 최신 로그를 함께 확인한다.
v2.1.80에서 --channels 연구 프리뷰 추가 — MCP 서버가 세션에 메시지를 직접 푸시 가능
v2.1.81에서 MCP OAuth CIMD(SEP-991) 지원 추가
v2.1.78에서 deny: ["mcp__servername"] 퍼미션 규칙이 MCP 서버 도구를 정상 제거하도록 수정
v2.1.121에서 MCP server config의 alwaysLoad: true 옵션이 추가되어 해당 서버 도구를 ToolSearch deferral 없이 항상 사용할 수 있습니다.
v2.1.187의 misleading MCP status 수정 이후에도, 인증·도구 수·권한 문제를 분리해 확인하는 습관을 유지하세요.

/memory

현재 사용법

이전 버전 근거 기록

/memory 명령 자체는 내장 명령으로, 공식 명령어 표에 별도의 최소 버전 표기가 없습니다.
다만 자동 메모리(auto-memory) 기능은 Claude Code v2.1.59 이상이 필요합니다. claude --version으로 버전을 확인할 수 있습니다.

/model

현재 사용법

이전 버전 근거 기록

초기 내장/legacy 항목으로 보이며, Changelog에 최초 도입 버전이 명시되지 않았습니다.

2026-09-05 모델 기준

환경	`fable` / `best`	`opus` alias	`sonnet` alias	운영 메모
Anthropic API	Fable 5.1(접근 권한 있을 때, `v2.1.255`+)	Opus 5	Sonnet 5	Opus 5는 Claude Code `v2.1.219` 이상 필요
Claude Platform on AWS	Fable 5.1(접근 권한 있을 때)	Opus 5	Sonnet 4.6	재현 작업은 full model name으로 pinning
Amazon Bedrock / Google Cloud Agent Platform	provider model ID pinning(`anthropic.claude-fable-5-1` / `claude-fable-5-1`)	Opus 5	Sonnet 4.5	`ANTHROPIC_DEFAULT_*_MODEL` pinning 권장
Microsoft Foundry	provider model ID pinning(`claude-fable-5-1`)	Opus 4.6	Sonnet 4.5	provider별 alias 차이를 운영 문서에 명시
Claude apps gateway 세션	Fable 5 유지(v2.1.257)	Opus 5	Sonnet 5	gateway가 Fable 5.1을 아직 거부할 수 있어 alias는 Fable 5로 남김. Fable 5.1은 `/model`에서 직접 선택

Alias는 provider별 권장 버전을 따라갑니다. 재현성이 중요한 CI, 벤치마크, 고객 재현, 장기 문서화 작업은 full model name으로 고정하세요.

2026-06-25 제한/경고 메모

v2.1.184 이후 main model restriction은 Opus/Sonnet/Haiku/Fable family 중심으로 더 엄격히 적용됩니다.
Haiku는 이 경로에서 main model로는 사용할 수 없지만, subagent model로는 사용할 수 있습니다. 저비용 보조 작업은 subagent에 Haiku를 지정하고 main session은 Sonnet/Opus/Fable 계열로 유지하세요.
v2.1.187부터 deprecated model을 사용할 때 경고가 강화됐습니다. 팀 설정에 오래된 full model ID가 남아 있으면 /model, /status, startup header에서 경고를 확인하고 최신 alias/full ID로 갱신합니다.

이전 변경 메모

v2.1.251은 모델 전환·fallback 후 도구와 reasoning 구성이 선택 모델에 맞게 갱신되도록 수정하고 PreModelSwitch·PostModelSwitch 훅을 추가했다.
v2.1.257~261은 Fable 5.1 추가, Claude apps gateway의 fable/best Fable 5 유지, picker의 Fable 5.1 노출·prompt caching 수정, Bedrock·Vertex·gateway raw ID 대신 모델 이름 표시를 반영했다.
v2.1.74에서 full model ID(예: claude-opus-4-5)가 에이전트 frontmatter에서 정상 인식되도록 수정
v2.1.78에서 ANTHROPIC_CUSTOM_MODEL_OPTION 환경변수로 /model 피커에 커스텀 항목 추가 가능
v2.1.126에서 ANTHROPIC_BASE_URL gateway의 /v1/models 목록을 /model picker에 표시하는 기능이 추가되었고, v2.1.129부터는 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1로 opt-in해야 합니다.

/permissions

현재 사용법

이전 버전 근거 기록

공식 명령어 문서에 별도의 최소 버전 표기는 없습니다(현행 버전에서 기본 제공되는 명령).
단, Auto 모드 거부 검토(Recently denied 탭)는 Auto 모드가 활성화된 환경에서만 의미가 있습니다.
v2.1.246부터 /permissions에 Auto 모드 규칙 탭이 추가됐습니다.

이전 변경 메모

v2.1.248~251은 file tool·plugin command·workflow scriptPath의 symlink/path traversal과 Grep/Glob deny-rule 우회를 보강했으므로 오래된 로컬 허용 규칙을 다시 점검해야 한다.
v2.1.246부터 /permissions에 Auto 모드 규칙 탭이 추가됐습니다.

/plan

현재 사용법

이전 버전 근거 기록

v2.1.0에서 /plan 명령 단축키가 추가되어 프롬프트에서 바로 계획 모드로 진입할 수 있게 되었습니다.
선택적 설명 인자(/plan fix the auth bug)는 v2.1.72부터 지원됩니다.

이전 변경 메모

v2.1.0에서 /plan 명령 단축키가 추가되어 프롬프트에서 바로 계획 모드로 진입할 수 있게 되었습니다.

/plugin

현재 사용법

이전 버전 근거 기록

v2.0.12 이상
공식 명령어 레퍼런스에는 별도의 최소 버전이 명시돼 있지 않습니다. /plugin 명령이 보이지 않으면 최신 버전으로 업데이트가 필요합니다(Homebrew brew upgrade claude-code, npm npm install -g @anthropic-ai/claude-code@latest 등 후 재시작).

이전 변경 메모

v2.1.118에서 claude plugin tag가 추가되어 플러그인 release git tag를 version validation과 함께 만들 수 있습니다.
v2.1.121에서 claude plugin prune 및 plugin uninstall --prune이 추가되어 자동 설치된 orphan dependency를 정리할 수 있습니다.

/powerup

현재 사용법

이전 버전 근거 기록

v2.1.90 이상 (GitHub Releases 기준 — 해당 릴리스 노트에 "Added /powerup"으로 도입이 명시됨)
공식 명령어 레퍼런스 표에는 /powerup에 별도의 min-version 주석이 붙어 있지 않습니다. 위 버전은 도입 시점을 알려주는 GitHub 릴리스 기록 기준입니다.

이전 변경 메모

v2.1.90 이상 (GitHub Releases 기준 — 해당 릴리스 노트에 "Added /powerup"으로 도입이 명시됨)

/pr-comments

현재 사용법

이전 버전 근거 기록

도입 버전: 초기 내장(legacy) 명령으로, Changelog에 최초 도입 버전이 명시되지 않았습니다.
마지막 지원 버전: v2.1.90
제거 버전: v2.1.91 (이 버전부터 명령이 사라짐)

/recap

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스에는 /recap에 대한 별도의 최소 버전 표기가 없습니다(현재 일반 명령으로 안내됨).
자동 세션 요약(Session recap)은 모든 플랜·프로바이더에서 기본 활성화되어 있습니다.

/release-notes

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스는 /release-notes에 min-version/max-version 표시를 달지 않았습니다. 그래서 정확한 도입 버전은 공식 문서만으로는 확정되지 않습니다.
같은 표에는 버전이 명시된 항목도 있습니다. 예를 들어 /reload-skills는 v2.1.152부터, /pr-comments는 v2.1.91에서 제거됐다고 표기합니다. /release-notes에는 그런 표기가 없습니다.
버전별 동작 변화를 정확히 추적하려면 명령 자체가 여는 변경 로그(또는 GitHub CHANGELOG.md)를 직접 확인하는 편이 가장 믿을 만합니다.

/reload-plugins

현재 사용법

이전 버전 근거 기록

공식 명령어 문서에는 /reload-plugins에 대한 별도의 최소 버전 표기가 없습니다. 따라서 특정 도입 버전을 단정하지 않습니다.
변경 로그(Changelog)를 보면 적어도 v2.1.119 시점에는 이미 존재했습니다(이 버전에 /reload-plugins와 /doctor의 버그 수정 항목이 들어 있습니다).

이전 변경 메모

v2.1.119·v2.1.141에서 비활성화된 플러그인에 대해 로드 오류를 잘못 보고하던 문제가 수정됐다.
v2.1.119와 v2.1.141에서 /reload-plugins와 /doctor가 비활성화된 플러그인에 대해 로드 오류를 잘못 보고하던 문제가 수정되었습니다.

/reload-skills

현재 사용법

이전 버전 근거 기록

v2.1.152 이상 (공식 Commands 문서의 min-version: 2.1.152 표기 기준)

/remote-env

현재 사용법

이전 버전 근거 기록

공식 명령 레퍼런스에 별도의 최소 버전(min-version) 표기가 없습니다. --remote 기반 웹 세션 기능과 함께 제공됩니다.
Claude Code on the web은 Pro·Max·Team 사용자 및 일부 Enterprise 좌석을 대상으로 한 리서치 프리뷰 단계입니다.

/rename

현재 사용법

이전 버전 근거 기록

공식 명령어 문서(code.claude.com/docs/en/commands)에는 /rename에 대한 별도 최소 버전 표기가 없습니다. 기본 내장 명령으로 제공됩니다.
v2.1.70: Claude가 응답을 처리하는 중에도 /rename을 실행할 수 있게 됐습니다. 변경 이력(Changelog)에는 적혀 있지만 현행 명령어 문서 본문에는 나오지 않습니다.

/resume

현재 사용법

이전 버전 근거 기록

공식 문서는 명령 도입 버전을 밝히지 않습니다. 다만 v2.1.144부터 백그라운드 세션이 피커에 bg 표식으로 나타나는 동작이 추가됐다고 적혀 있습니다.
그 외 동작 변경 이력은 Changelog 기준입니다. 현재 운영 조건은 resume 주의사항에서 확인합니다.

이전 변경 메모

v2.1.73에서 현재 활성 세션이 picker 목록에 표시되지 않도록 수정되었습니다.

공식 commands 문서의 /rewind 항목에는 별도의 최소 버전(min-version) 표기가 없습니다. 체크포인팅은 현재 정식 기능으로 문서화되어 있고, 최소 버전을 따로 명시한 부분은 확인되지 않습니다.

/run

현재 사용법

이전 버전 근거 기록

Claude Code v2.1.145 이상 (공식 Commands 문서 기준, /verify·/run-skill-generator와 동일)

/run-skill-generator

현재 사용법

이전 버전 근거 기록

v2.1.145 이상 (Commands 문서 기준, "Requires Claude Code v2.1.145 or later")
관련 번들 스킬 /run, /verify도 동일하게 v2.1.145+를 요구합니다.
디스크에 새로 만들어진 스킬을 세션 재시작 없이 다시 읽어들이는 /reload-skills는 v2.1.152+가 필요합니다.

/sandbox

현재 사용법

이전 버전 근거 기록

Changelog에 별도의 도입 버전이 명시되지 않은 내장 명령입니다. 공식 문서 명령 표에도 /sandbox에 대한 min-version 주석이 없습니다. 정확한 도입 버전이 확인되지 않아 임의로 버전을 적지 않습니다.

/schedule

현재 사용법

이전 버전 근거 기록

Claude Code v2.1.81 이상이 필요합니다. CLI 버전이 v2.1.81보다 낮으면 /schedule이 숨겨지며 Unknown command로 처리됩니다(claude update로 갱신). 출처: Commands 문서의 Routines 트러블슈팅 섹션.
routine 기능 자체는 아직 research preview 단계라 동작·제한·API 표면이 바뀔 수 있습니다.

/security-review

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스에 별도의 최소 버전(min-version) 주석이 없는, 오래전부터 제공된 내장 명령입니다.
Changelog에 최초 도입 버전이 명시되어 있지 않으나, 적어도 v2.1.70 이전부터 존재했습니다.
v2.1.108부터는 모델이 Skill 도구로 /init, /review와 함께 /security-review를 직접 발견·호출합니다.

이전 변경 메모

v2.1.70에서 이전 git 버전에서 발생하던 unknown option merge-base 오류가 수정됨

/simplify

현재 사용법

이전 버전 근거 기록

공식 문서 명령 표 기준 v2.1.154 (min-version 주석)
v2.1.154부터 cleanup-only 동작으로 역할 분리 (버그 탐지는 /code-review로 이관)
그 이전 버전에서는 /code-review --fix와 동등하게 동작

/skills

현재 사용법

이전 버전 근거 기록

현재 공식 Commands 문서에 포함되어 있으며, 공식 표에 별도의 최소 버전 표기(min-version)는 없습니다.
함께 자주 쓰는 /reload-skills는 공식 문서 기준 v2.1.152부터 제공됩니다. 세션 도중 디스크에서 추가/변경된 skill과 명령 디렉터리를 다시 스캔합니다.

/stats

현재 사용법

이전 버전 근거 기록

v2.1.118 (2026-04-23): /cost와 /stats가 /usage로 통합되었습니다. 두 명령은 관련 탭을 바로 여는 타이핑 단축키로 그대로 유지됩니다.
v2.1.149 (2026-05-22): /usage에 한도를 소모하는 요소(스킬·서브에이전트·플러그인·MCP 서버별 비용)를 카테고리별로 분해해 보여주는 기능이 추가되었습니다. /stats로 진입하는 통계 화면에도 이 정보가 반영됩니다.

통합 이후 /stats는 /usage 화면의 Stats 탭으로 진입하는 단축키입니다. 동작·표시 내용은 /usage를 따릅니다.

이전 변경 메모

v2.1.118에서 /cost·/stats가 /usage로 통합되었고, v2.1.149부터 스킬·서브에이전트·플러그인·MCP 서버별 분해가 추가되었습니다.
v2.1.149 (2026-05-22): /usage에 한도를 소모하는 요소(스킬·서브에이전트·플러그인·MCP 서버별 비용)를 카테고리별로 분해해 보여주는 기능이 추가되었습니다. /stats로 진입하는 통계 화면에도 이 정보가 반영됩니다.

/statusline

현재 사용법

이전 버전 근거 기록

공식 명령어 레퍼런스 및 전용 문서(/en/statusline)에 별도의 최소 버전 표기는 없습니다. 다만 개별 기능에는 도입 버전이 명시되어 있습니다.
- context_window.total_input_tokens / total_output_tokens: v2.1.132부터 컨텍스트 창에 남아 있는 토큰 수를 반환(이전에는 세션 누적 합계).
- COLUMNS / LINES 환경변수로 터미널 크기 읽기: v2.1.153부터 지원.
- rate_limits.spend_limit / prompt_cache: v2.1.251부터 지원.

/tasks

현재 사용법

이전 버전 근거 기록

공식 명령 레퍼런스 표에 /tasks의 최초 도입 버전이 별도로 명시되어 있지 않습니다. 백그라운드 세션/태스크 워크플로(/background, /stop 등)와 함께 제공되는 내장 명령입니다.

/team-onboarding

현재 사용법

이전 버전 근거 기록

v2.1.101 이상 (GitHub Releases 기준 — "Added /team-onboarding command to generate a teammate ramp-up guide from your local Claude Code usage"로 도입)
공식 Commands 문서에는 별도의 최소 버전 표기가 없습니다. 위 버전은 도입 릴리스 노트를 근거로 합니다.

이전 변경 메모

v2.1.101 이상 (GitHub Releases 기준 — "Added /team-onboarding command to generate a teammate ramp-up guide from your local Claude Code usage"로 도입)

/teleport

현재 사용법

이전 버전 근거 기록

공식 문서는 별도의 최소 CLI 버전을 명시하지 않습니다. 대신 claude.ai 구독(Pro/Max/Team, 또는 Enterprise premium·Chat + Claude Code 시트) 인증이 필요하고, Claude Code on the web 기능 자체가 아직 리서치 프리뷰 상태입니다.

/terminal-setup

현재 사용법

이전 버전 근거 기록

v1.0.110 이상
공식 명령어 레퍼런스에는 별도의 최소 버전 표기가 없습니다. 위 값은 Changelog에서 확인된 등장 시점 기준이며, 환경에 따라 노출 여부가 달라질 수 있습니다.

/theme

현재 사용법

이전 버전 근거 기록

/theme 명령 자체에 명시된 최소 버전은 공식 문서에 별도로 기재되어 있지 않습니다.
custom theme(~/.claude/themes/ 또는 plugin 제공 테마, New custom theme… 흐름)은 공식 문서가 Claude Code v2.1.118 이상을 요구한다고 명시합니다.

/tui

현재 사용법

이전 버전 근거 기록

/tui 명령과 tui 설정: v2.1.110에서 도입 ("Added /tui command and tui setting").
fullscreen 렌더링 자체(research preview): v2.1.89 이상 필요.
v2.1.110 이전 버전에서는 /tui 대신 환경 변수로 켰습니다: CLAUDE_CODE_NO_FLICKER=1.

공식 Commands 레퍼런스의 /tui 항목에는 별도의 최소 버전 주석이 표기되어 있지 않습니다. 위 버전은 전용 fullscreen 문서와 v2.1.110 릴리스 노트를 근거로 합니다.

/ultrareview

현재 사용법

이전 버전 근거 기록

v2.1.86 이상에서 사용 가능한 research preview 기능입니다(공식 ultrareview 문서 기준).
참고: /code-review 스킬에서 ultra 인자를 포함한 전체 명령 표기는 v2.1.154부터 문서화되었으며, 같은 버전부터 /simplify가 버그 탐색 없이 정리만 수행하는 별도 리뷰로 분리되었습니다.

/upgrade

현재 사용법

이전 버전 근거 기록

공식 명령 레퍼런스에 별도의 최소 버전 표기가 없습니다. 사용 환경의 Claude Code를 최신 버전으로 유지하는 것을 권장합니다.

/usage

현재 사용법

이전 버전 근거 기록

v2.1.118부터: /cost와 /stats가 /usage로 통합되었습니다. 두 명령은 해당 탭을 여는 타이핑 shortcut으로 남았습니다. (2026-04-23)
v2.1.121: 큰 transcript history가 있는 머신에서 /usage가 최대 약 2GB 메모리를 누수하던 문제가 수정되었습니다. (2026-04-28)
v2.1.144: "extra usage"가 CLI 문구 전반에서 "usage credits"로 변경되었고, /extra-usage가 /usage-credits로 바뀌었습니다(이전 이름도 계속 동작). (2026-05-19)
v2.1.149: /usage가 한도를 소모하는 요인을 skill, subagent, plugin, per-MCP-server 단위로 나눈 per-category breakdown을 표시하기 시작했습니다. (2026-05-22)
v2.1.152: /usage breakdown이 큰 세션 파일까지 포함하며, streaming read로 스캔해 메모리 사용량을 일정하게 유지합니다. (2026-05-27)
v2.1.243: Loops breakdown에 실행 횟수, 총 토큰, 실행당 토큰, 마지막 실행 시각이 추가됐습니다. (2026-08-25)
v2.1.251: gateway spend-limit 막대와 rate_limits.spend_limit statusline 입력이 추가됐습니다. (2026-08-28)

이전 변경 메모

v2.1.121: 큰 transcript history가 있는 머신에서 /usage가 최대 약 2GB 메모리를 누수하던 문제가 수정되었습니다. (2026-04-28)
v2.1.243: Loops breakdown에 실행 횟수, 총 토큰, 실행당 토큰, 마지막 실행 시각이 추가됐습니다. (2026-08-25)
v2.1.251: gateway spend-limit 막대와 rate_limits.spend_limit statusline 입력이 추가됐습니다. (2026-08-28)

/usage-credits

현재 사용법

이전 버전 근거 기록

공식 명령 참조 문서에는 /usage-credits(구 /extra-usage)에 대한 별도의 최소 버전(min-version) 표기가 없습니다. 따라서 특정 버전을 단정하지 않습니다. (/run, /verify, /reload-skills 등은 공식 표에 min-version이 명시되어 있지만 이 명령에는 그런 표기가 없습니다.)
명령이 실제로 보이느냐는 버전보다 플랜·플랫폼·환경에 달려 있습니다. 공식 문서도 "모든 명령이 모든 사용자에게 보이는 것은 아니며, 가용성은 플랫폼·플랜·환경에 따라 달라진다"고 못박습니다.

이전 변경 메모

v2.1.248에서 Enterprise seat·조직 구성별 usage-credit 표시가 확대되고 잔액이 0일 때 관리자 화면 표기가 수정됐습니다.

/verify

현재 사용법

이전 버전 근거 기록

v2.1.145 이상 (Commands 문서의 min-version: 2.1.145 표기, "Requires Claude Code v2.1.145 or later")
v2.1.215부터 사용자 수동 호출 전용

/vim

현재 사용법

이전 버전 근거 기록

마지막 지원 버전: v2.1.91
제거: v2.1.92부터 (이후 버전에서는 호출 불가)

/web-setup

현재 사용법

이전 버전 근거 기록

현재 공식 Commands 문서에 내장 명령으로 포함되어 있습니다. 공식 문서에 별도의 최소 버전 표기는 없으며, 공개 Changelog에서도 최초 도입 버전이 명시적으로 확인되지 않았습니다.

/workflows

현재 사용법

이전 버전 근거 기록

v2.1.154 이상 (dynamic workflows research preview 요구 버전, 공식 문서 기준)
/workflow-authoring 번들 skill은 v2.1.248 이상이 필요합니다.

/approved-tools

현재 사용법

이전 버전 근거 기록

공식 문서는 /permissions(별칭 /allowed-tools)에 대해 별도의 최소 지원 버전을 명시하지 않습니다.
/approved-tools는 현재 공식 명령 표에 등재되어 있지 않으므로, 특정 버전부터 동작한다고 단정할 수 없습니다. 레거시 문서에 등장하는 표기로만 취급하세요.

/commands

현재 사용법

이전 버전 근거 기록

/commands라는 단일 명령이 공식적으로 존재한 적이 없으므로 별도의 최소 지원 버전은 명시되지 않습니다.
사용 가능한 명령 목록을 보는 방식(/ 입력)은 인터랙티브 모드의 기본 동작입니다.
커스텀 명령을 만드는 권장 경로인 스킬은 /skills, /reload-skills(v2.1.152부터) 등으로 관리합니다.

/extra-usage

현재 사용법

이전 버전 근거 기록

공식 명령 참조 문서에는 /usage-credits(구 /extra-usage)에 대한 별도의 최소 버전(min-version) 표기가 없습니다. 따라서 특정 버전을 단정하지 않습니다.
명령의 실제 노출 여부는 버전보다 플랜·환경을 따릅니다. 공식 문서는 "모든 명령이 모든 사용자에게 보이는 것은 아니며, 플랫폼·플랜·환경에 따라 가용성이 달라진다"고 명시합니다.

/project-purge

현재 사용법

이전 버전 근거 기록

v2.1.126 이상 (공식 Changelog, 2026-05-01 릴리스에서 추가)

이전 변경 메모

v2.1.126 이상 (공식 Changelog, 2026-05-01 릴리스에서 추가)

/settings

현재 사용법

이전 버전 근거 기록

/settings는 /config의 별칭으로, 현재 버전에서 정상 동작합니다.
공식 Changelog에는 /settings 별칭이 처음 도입된 정확한 버전이 나와 있지 않습니다. 특정 버전을 단정하지 말고, 설치된 버전에서 /를 입력해 목록에 뜨는지 확인하세요.

/tag

현재 사용법

이전 버전 근거 기록

최초 도입 버전은 공개 changelog에서 명확히 확인되지 않음
제거: v2.1.92 (릴리스 노트의 Removed /tag command 항목으로 확인)

/todos

현재 사용법

이전 버전 근거 기록

/todos: 공식 명령어 표에 없으므로 별도의 최소 지원 버전이 명시되어 있지 않습니다.
대체 명령 /tasks(별칭 /bashes)는 공식 문서의 "All commands" 표에 수록되어 있으며, 문서상 별도의 최소 버전 표기는 없습니다.