3.1 AI 커맨드란 무엇인가
AI 툴에서
/로 시작하는 단축 명령어로, 반복되는 긴 지시를 짧은 커맨드 한 줄로 대체할 수 있다. 업데이트: 2026-03-08
핵심 요약
| 구분 | 내용 |
|---|---|
| 📖 정의 | /커맨드명을 입력하면 미리 정해둔 지시사항이 AI에게 전달되는 단축 명령어 |
| 💡 핵심 | 마크다운 파일 하나를 지정 경로에 두면 그것이 바로 커맨드가 된다 (Claude Code 기준) |
| 🎯 대상 | 반복 타이핑을 줄이고 팀 표준을 공유하려는 개발자 |
| ⚠️ 주의 | 플랫폼마다 파일 형식(.md vs .toml)과 인자 전달 방식이 다르다 |
문서 탐색
목차
- 커맨드란 무엇인가
- 기본 내장 커맨드 vs 커스텀 커맨드
- Claude Code의 커맨드
- Gemini CLI의 커맨드
- OpenAI Codex의 커맨드
- 플랫폼별 커맨드 비교
- 커맨드 vs 에이전트 vs 스킬
1. 커맨드란 무엇인가
AI 툴에서 **커맨드(Command)**란 /로 시작하는 단축 명령어다.
매번 긴 설명을 타이핑하는 대신, /리뷰 처럼 짧게 입력하면 Claude가 미리 정해둔 동작을 수행한다.
비유: 스마트폰 단축어 기능과 유사하다. “퇴근”이라고 입력하면 자동으로 “지금 퇴근해, 30분 뒤 도착해”가 전송되는 것처럼, /리뷰라고 입력하면 Claude가 “코드 전체를 검토하고 문제점을 정리”하는 작업을 수행한다.
# 커맨드 없이
"이 코드의 로직 오류, 성능 문제, 보안 취약점을 찾아서
심각도별로 정리하고 수정 방법도 알려줘"
# 커맨드 사용
/review
2. 기본 내장 커맨드 vs 커스텀 커맨드
| 종류 | 설명 | 예시 |
|---|---|---|
| 내장 커맨드 | AI 툴에 처음부터 포함된 커맨드 | /help, /clear, /model |
| 커스텀 커맨드 | 사용자가 직접 만든 나만의 커맨드 | /deploy, /리뷰, /일간보고 |
3. Claude Code의 커맨드
Claude Code는 가장 풍부한 커맨드 시스템을 갖고 있다. 13개 이상의 내장 커맨드와 무제한 커스텀 커맨드를 지원한다.
핵심 내장 커맨드
| 커맨드 | 하는 일 | 언제 사용하나 |
|---|---|---|
/help | 사용 가능한 모든 커맨드 목록 표시 | 어떤 커맨드가 있는지 확인할 때 |
/init | 프로젝트에 CLAUDE.md 파일 자동 생성 | 새 프로젝트 시작 시 가장 먼저 |
/clear | 대화 기록 초기화 (파일은 유지) | 새로운 주제로 전환 시 |
/compact | 대화 내용 압축 (토큰 절약) | 대화가 너무 길어졌을 때 |
/cost | 지금까지 사용한 토큰·비용 확인 | 비용 확인이 필요할 때 |
/model | 사용할 AI 모델 변경 (Opus/Sonnet/Haiku) | 속도/품질 조절 시 |
/memory | CLAUDE.md 파일 편집 | 프로젝트 규칙 수정 시 |
/agents | 서브에이전트 관리 | 에이전트 추가·확인 시 |
/permissions | 도구 사용 권한 설정 | 보안 수준 조절 시 |
/doctor | 환경 문제 진단 | 동작이 이상할 때 |
/login / /logout | 계정 로그인·로그아웃 | 계정 전환 시 |
💡
/compact는 대화가 길어졌을 때 활용하면 효과적이다. 토큰을 50~70% 절약하면서도 중요한 내용은 그대로 유지된다.
커스텀 커맨드 만들기
.claude/commands/ 폴더에 마크다운 파일을 넣으면 그것이 커맨드가 된다.
.claude/
└── commands/
├── review.md → /review 커맨드
├── deploy.md → /deploy 커맨드
└── 일간보고.md → /일간보고 커맨드
→ 자세한 방법은 3.2 커맨드 만드는 방법 참고
4. Gemini CLI의 커맨드
Gemini CLI도 슬래시 커맨드를 지원하며, 커스텀 커맨드는 TOML 형식 파일로 만든다.
핵심 내장 커맨드
| 커맨드 | 하는 일 |
|---|---|
/help | 사용 가능한 커맨드 목록 표시 |
/clear | 대화 초기화 |
/quit | Gemini CLI 종료 |
/commands reload | 커스텀 커맨드 파일 변경 후 재로드 |
커스텀 커맨드 — TOML 형식
Claude Code와 달리 Gemini CLI는 TOML 파일로 커맨드를 정의한다.
# .gemini/commands/review.toml
description = "코드를 검토하고 문제점을 정리한다"
prompt = """
이 코드를 리뷰해줘:
- 로직 오류
- 성능 문제
- 보안 취약점
심각도별로 정리해줘.
"""저장 위치:
- 프로젝트 전용:
.gemini/commands/커맨드명.toml - 글로벌(모든 프로젝트):
~/.gemini/commands/커맨드명.toml
네임스페이스 지원:
.gemini/commands/git/commit.toml → /git:commit 으로 호출
5. OpenAI Codex의 커맨드
Codex도 슬래시 커맨드를 지원한다. 주로 세션 관리와 모드 전환에 사용된다.
핵심 내장 커맨드
| 커맨드 | 하는 일 |
|---|---|
/clear | 대화 초기화 |
/model | 사용 모델 변경 |
/plan | 계획 모드 진입 |
/permissions | 권한 설정 |
/status | 현재 모델·토큰 사용량 확인 |
/copy | 마지막 응답 복사 |
/experimental | 실험적 기능 토글 |
커스텀 프롬프트
Codex는 /prompts:프롬프트명 형식으로 저장된 프롬프트를 불러온다.
/prompts:draftpr → PR 초안 작성 프롬프트 실행
/prompts:review → 코드 리뷰 프롬프트 실행
6. 플랫폼별 커맨드 비교
| 항목 | Claude Code | Gemini CLI | OpenAI Codex |
|---|---|---|---|
| 커맨드 형식 | /커맨드명 | /커맨드명 | /커맨드명 |
| 커스텀 파일 형식 | .md (마크다운) | .toml | Custom Prompts |
| 저장 경로 | .claude/commands/ | .gemini/commands/ | 앱 내 설정 |
| 인자(파라미터) 전달 | $ARGUMENTS, $1, $2 | 프롬프트 내 변수 | 미지원 |
| 네임스페이스 | 미지원 | /git:commit 형식 | 미지원 |
| 글로벌 커맨드 | ~/.claude/commands/ | ~/.gemini/commands/ | 제한적 |
| 내장 커맨드 수 | 13개 이상 | 기본 5~6개 | 10개 내외 |
| 팀 공유 | Git으로 공유 가능 | Git으로 공유 가능 | 제한적 |
| 성숙도 | 가장 높음 | 성장 중 | 성장 중 |
7. 커맨드 vs 에이전트 vs 스킬 — 차이점
AI를 처음 접하는 경우 가장 혼동하기 쉬운 부분이다.
| 구분 | 커맨드 | 에이전트 | 스킬 |
|---|---|---|---|
| 트리거 | /커맨드명 직접 입력 | Claude가 자동 판단 | /스킬명 직접 입력 |
| 실행 위치 | 메인 대화 안에서 | 독립된 컨텍스트 창 | 메인 대화 안에서 |
| 복잡도 | 단순 프롬프트 | 복잡한 다단계 작업 | 프롬프트 + 리소스 패키지 |
| 용도 | 반복되는 지시사항 단축 | 전문화된 독립 작업 | 체계적 워크플로우 |
| 초보자 난이도 | 쉬움 | 중간 | 중간 |
커맨드를 사용하기 좋은 상황:
- 매번 같은 내용을 타이핑하는 것이 번거로울 때
- 팀원들과 동일한 방식으로 작업하고 싶을 때
- 프로젝트마다 반복되는 루틴 작업을 자동화하고 싶을 때
문서 탐색
참고 자료
- Claude Code 슬래시 커맨드 공식 문서
- Gemini CLI 커스텀 커맨드 공식 문서
- OpenAI Codex 슬래시 커맨드 공식 문서
- Shipyard: Claude Code CLI 치트시트
- awesome-claude-code (커스텀 커맨드 모음)