Cmd. /run
프로젝트 앱을 직접 띄우고 조작해 변경이 실제 실행 환경에서 동작하는지 확인하는 번들 skill
핵심 요약
- app을 실제 실행·조작해 변경 확인 (skill)
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
app을 실제 실행·조작해 변경 확인 (skill)
/run사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 번들 스킬 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/run- 인자(arguments)나 별칭(alias)은 없습니다. 명령은 메시지 맨 앞에서만 인식됩니다.
선택 시점
- 프론트엔드 변경 후 브라우저에서 실제 화면/흐름 확인
- API 서버가 부팅되고 핵심 endpoint가 응답하는지 확인
- 테스트가 부족한 legacy 프로젝트에서 최소 실행 검증 확보
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/run | 앱을 실행·조작해 변경이 도는지 관찰 | 변경이 실제로 동작하는지 눈으로 확인 |
/verify | 앱을 빌드·실행해 의도한 결과까지 검증 | acceptance 기준 충족 여부 확인 |
/run-skill-generator | 프로젝트별 실행 skill을 .claude/skills/run-<name>/에 생성 | /run이 실행 방법을 추론하지 못할 때 |
/run,/verify,/run-skill-generator는 함께 동작하는 세 개의 번들 skill로, "Run and verify your app" 워크플로를 구성합니다.
실행 결과와 유지 범위
프로젝트 앱을 실행하고 조작해 실제 변경 결과를 확인합니다.
/run은 번들 skill(bundled skill)입니다. 공식 문서는 "Launch and drive your project's app to see a change working in the running app, not just in tests"로 설명합니다. 테스트나 타입 체크만으로 끝내지 말고, 프로젝트 앱을 실제로 실행하고 직접 조작(drive) 해서 변경이 동작하는 모습을 눈으로 확인하라는 뜻입니다.
별도 설정 없이도 동작합니다. 프로젝트 유형(CLI, 서버, TUI, 브라우저 구동형)과 README, package.json, Makefile 같은 내용을 보고 실행 방법을 추론합니다. 다만 데이터베이스·환경변수 파일·그래픽 세션·여러 단계의 빌드처럼 표준 실행을 벗어나는 프로젝트에서는 추론이 흔들립니다. 이럴 때 /run-skill-generator로 프로젝트별 실행 레시피를 미리 기록해 두면 /run이 그 절차를 그대로 따릅니다.
UI 화면/흐름, API 부팅·엔드포인트 응답처럼 테스트 통과만으로는 보장되지 않는 실제 동작 확인에 적합합니다.
주의사항
- clean environment에서 재현 가능한 실행 절차가 있어야 CI/팀 표준으로 쓸 수 있습니다. 빌드·실행 과정이 바뀌면
/run-skill-generator를 다시 실행해 레시피를 갱신하세요. - 외부 서비스, 결제, production write가 연결되는 실행은 sandbox/환경변수로 차단하세요.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록