AX LABS
← 블로그 에이전트 제품 설계

커맨드가 팀의 표준이다

Claude Code는 프롬프트가 아니라 절차를 실행한다

AX LABS 5분 읽기

개발팀에서 Claude Code를 쓰기 시작하면 처음에는 속도가 오른다. 곧 다른 문제가 보인다. 같은 리뷰 요청인데 사람마다 프롬프트가 다르고, 같은 장애 분석인데 확인 순서가 다르고, 같은 PR 설명인데 산출물 품질이 흔들린다. 도구 도입은 끝났는데 일하는 방식은 여전히 개인기다.

Claude Code 슬래시 커맨드는 이 지점을 바로 찌른다. 2026년 현재 공식 문서 기준으로 기존 .claude/commands/ 파일은 계속 동작하지만, 커스텀 커맨드는 skills와 합쳐졌고 .claude/skills/<name>/SKILL.md 방식이 권장된다. 핵심은 변하지 않았다. 팀의 반복 절차를 Markdown으로 저장하고 /review, /debug, /deploy-check처럼 호출한다는 점이다.

슬래시 커맨드는 프롬프트 단축키가 아니다

많은 팀이 커맨드를 “자주 쓰는 문장 저장소”로 만든다. 이 방식은 금방 한계가 온다. 좋은 커맨드는 문장이 아니라 절차다.

예를 들어 /review-pr은 “코드 리뷰해줘”가 아니다. 어떤 파일을 읽고, 어떤 위험을 먼저 보고, 어떤 기준으로 코멘트를 나누고, 최종 산출물을 어떤 형식으로 남길지 정의해야 한다. 그래야 리뷰어가 바뀌어도 팀의 리뷰 방식은 유지된다.

AX에서 표준화할 대상은 AI 사용법이 아니다. AI가 따라야 할 팀의 작업 절차다.

Anthropic은 Claude Code 플러그인을 소개하면서 slash commands, subagents, MCP servers, hooks를 팀과 공유 가능한 확장 지점으로 설명했다. 커맨드는 그중 가장 낮은 마찰로 시작할 수 있는 표준화 단위다.

저장소 안에 넣어야 팀 표준이 된다

개인 커맨드는 개인 생산성을 높인다. 팀 워크플로는 프로젝트 커맨드로 관리해야 한다. 저장소 안에 있어야 리뷰되고, 버전 관리되고, 신규 입사자가 같은 절차를 즉시 따른다.

구분 위치 용도 운영 판단
개인 커맨드 ~/.claude/skills/ 또는 사용자 설정 개인 습관, 메모, 설명 방식 팀 표준으로 보지 않는다
프로젝트 커맨드 .claude/skills/ 또는 .claude/commands/ PR, 테스트, 배포 전 점검 코드처럼 리뷰한다
플러그인 플러그인 패키지 여러 저장소 공통 운영 플랫폼팀이 관리한다

AX Ops 관점에서는 세 가지를 먼저 만든다.

  • /understand-change: 변경 범위와 영향면을 먼저 정리한다.
  • /review-pr: 보안, 회귀, 운영 리스크 순서로 검토한다.
  • /write-runbook: 장애 대응 기록을 실행 가능한 절차로 바꾼다.

이 세 개만 제대로 만들어도 팀은 “Claude에게 무엇을 시킬지”가 아니라 “우리 절차가 무엇인지”를 논의하게 된다.

커맨드와 에이전트를 섞으면 운영성이 생긴다

커맨드는 시작 버튼이다. 복잡한 작업은 subagent, hooks, MCP와 연결해야 한다.

Claude Code 문서는 subagent가 별도 context에서 동작하고, 특정 도구 권한과 전용 프롬프트를 가질 수 있다고 설명한다. 따라서 /review-pr 커맨드는 리뷰 절차를 시작하고, 실제 보안 검토는 security-reviewer subagent에 맡기는 구조가 맞다.

Hooks는 통제 장치다. 공식 hooks reference는 PreToolUse, UserPromptSubmit, SubagentStart, Stop 같은 이벤트를 제공한다. 팀은 여기에 금지 파일 수정, 테스트 누락, 위험 명령 차단 같은 규칙을 붙인다. 커맨드가 표준 절차라면 hooks는 가드레일이다.

MCP는 업무 시스템 연결이다. GitHub, Jira, 내부 문서, 배포 시스템을 프롬프트 복붙으로 연결하면 금방 무너진다. MCP prompt가 slash command로 노출되는 구조를 쓰면 업무 데이터 접근도 절차 안으로 들어온다.

지금 할 일은 커맨드 목록이 아니라 운영 설계다

첫 스프린트에서 많은 커맨드를 만들 필요가 없다. 반복 빈도가 높고 실패 비용이 큰 작업 세 개를 고른다. 각 커맨드에는 입력, 확인 순서, 금지 행동, 산출물 형식, 사람 승인 지점을 넣는다. 그리고 PR처럼 리뷰한다.

Anthropic 내부 활용 자료에서도 보안 엔지니어링 팀이 커스텀 slash command를 반복 업무 정리에 적극 사용한다고 밝힌다. 중요한 대목은 생산성 수치가 아니다. 강한 팀은 AI에게 자유를 많이 주는 팀이 아니라, 반복 절차를 실행 단위로 잘게 만든 팀이라는 점이다.

얕은 요약은 이렇다. Claude Code 슬래시 커맨드는 개발자 편의 기능이 아니다. 팀의 작업 방식을 저장소에 박아 넣는 운영 인터페이스다. AX LABS는 이 인터페이스를 역할, 권한, 평가, 산출물 기준까지 묶어 AX Ops로 설계한다. AX Ops 방법론 →

참고