Cmd. /run
프로젝트 앱을 직접 띄우고 조작해 변경이 실제 실행 환경에서 동작하는지 확인하는 번들 skill
핵심 요약
/run은 테스트·타입 체크로 끝내지 않고 앱을 실제로 실행·조작해 변경이 동작하는 모습을 확인하는 번들 skill입니다.- 별도 설정 없이 프로젝트 유형과
README·package.json·Makefile을 보고 실행 방법을 추론합니다. - DB·환경변수·그래픽 세션·다단계 빌드처럼 표준을 벗어나면
/run-skill-generator로 실행 레시피를 미리 기록해 두는 편이 안정적입니다. /verify가 의도한 결과까지 검증한다면,/run은 화면·엔드포인트가 실제로 도는지 눈으로 확인하는 데 적합합니다.- 외부 서비스·결제·production write가 연결되는 실행은 sandbox나 환경변수로 차단하세요.
명령어 원본 선언
/run공식 설명 요약
/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 부팅·엔드포인트 응답처럼 테스트 통과만으로는 보장되지 않는 실제 동작 확인에 적합합니다.
최소 지원 버전
- Claude Code
v2.1.145이상 (공식 Commands 문서 기준,/verify·/run-skill-generator와 동일)
사용법
/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-generator로 clean environment에서 실행 절차(설치 명령, 환경변수, 실행 스크립트)를 기록한 뒤/run을 쓰면, 같은 저장소의 다른 에이전트도 같은 레시피를 재사용합니다. - PR 검토 전
/run으로 핵심 화면/엔드포인트를 한 번 띄워 보고, 더 엄밀한 검증이 필요하면/verify로 이어집니다.
주의사항
- clean environment에서 재현 가능한 실행 절차가 있어야 CI/팀 표준으로 쓸 수 있습니다. 빌드·실행 과정이 바뀌면
/run-skill-generator를 다시 실행해 레시피를 갱신하세요. - 외부 서비스, 결제, production write가 연결되는 실행은 sandbox/환경변수로 차단하세요.
출처
- Commands: https://code.claude.com/docs/en/commands
- Run and verify your app (Skills): https://code.claude.com/docs/en/skills