코덱스 툴 사용법 17: Slash Commands로 세션을 조종하기 | DAKER 커뮤니티

코덱스 툴 사용법 17: Slash Commands로 세션을 조종하기

Codex를 잘 쓰는 사람은 프롬프트를 길게 쓰는 사람이라기보다, 지금 바꿔야 하는 것이 작업 목표인지, 세션 상태인지, 재사용 절차인지를 빨리 구분하는 사람입니다.

OpenAI Codex 문서 기준으로 slash command는 Codex 앱이나 CLI의 composer 안에서 /로 여는 제어 표면입니다. 앱에서는 /status, /plan, /goal, /mcp, /review 같은 명령이 있고, CLI에서는 /permissions, /model, /skills, /apps, /plugins, /hooks, /compact, /diff처럼 세션과 도구 상태를 조정하는 명령이 더 넓게 제공됩니다. 사용 가능한 명령은 환경과 권한에 따라 달라질 수 있습니다.

한 줄 요약

Slash command는 “일을 설명하는 문장”이 아니라, 현재 Codex 세션의 모드, 권한, 도구, 상태를 조정하는 스위치입니다.

`/`로 할 일과 프롬프트로 할 일

초보자가 자주 하는 실수는 모든 문제를 프롬프트로 해결하려는 것입니다. “좀 더 조심해서 해줘”, “테스트도 봐줘”, “긴 작업이니 계획 세워줘”도 말로 쓸 수 있지만, Codex가 제공하는 명령이 있는 경우에는 명령으로 세션 상태를 바꾸는 편이 더 명확합니다.

필요	먼저 볼 표면	이유
현재 모델, 권한, 컨텍스트 상태 확인	`/status`	세션 상태를 추측하지 않음
구현 전에 계획을 보고 싶음	`/plan`	작업 모드를 계획 중심으로 전환
긴 목표를 계속 추적하고 싶음	`/goal`	단발 프롬프트보다 목표 유지에 적합
MCP 서버가 붙었는지 확인	`/mcp`	외부 도구 연결 상태 확인
반복 workflow를 쓰고 싶음	`/skills` 또는 `$skill-name`	긴 지침을 매번 붙여 넣지 않음
권한을 조정하고 싶음	`/permissions`	도구 실행 정책을 세션 수준에서 조정
대화가 길어져 정리가 필요	`/compact`	핵심 맥락을 보존하고 잡음을 줄임

반대로 “무엇을 만들지”, “어떤 파일을 바꾸지 말지”, “완료 기준이 무엇인지”는 slash command가 아니라 일반 프롬프트에 써야 합니다. 명령은 조종간이고, 프롬프트는 작업 지시서입니다.

명령 선택 흐름

이 흐름에서 중요한 분기점은 “반복 가능한 절차인가?”입니다. 한 번만 필요한 작업이면 프롬프트로 충분합니다. 하지만 같은 형식의 리뷰, 릴리스 노트, 보안 점검, 리포트 생성을 계속 반복한다면 slash command 자체보다 skill로 절차를 빼는 편이 낫습니다.

CLI와 앱에서 기대할 수 있는 차이

Codex 앱과 CLI는 둘 다 slash command를 제공하지만, 실제 목록은 다를 수 있습니다. OpenAI 문서는 앱 명령에서 command menu, settings, thread search, /status, /plan, /goal, /mcp, /review 같은 흐름을 설명합니다. CLI 문서는 /permissions, /model, /fast, /personality, /apps, /plugins, /hooks, /diff, /compact, /archive 등 터미널 세션 운영에 가까운 명령까지 다룹니다.

표면	잘 맞는 명령	쓰임
Codex 앱	`/plan`, `/goal`, `/mcp`, `/review`, `/status`	데스크톱 thread에서 계획, 목표, 리뷰, 연결 상태 확인
Codex CLI	`/permissions`, `/model`, `/skills`, `/apps`, `/plugins`, `/hooks`, `/compact`, `/diff`	터미널 기반 구현, 권한 조정, 도구 확인, diff 검토
IDE 확장	`/skills`, custom prompt 계열	편집기 문맥과 재사용 지침 연결

따라서 글이나 팀 가이드에 “항상 /permissions를 쓰세요”처럼 쓰면 안 됩니다. 더 정확한 표현은 “현재 표면의 slash menu에서 권한 조정 명령이 제공되면 그 명령을 사용하고, 없으면 세션 설정이나 앱 설정에서 확인한다”입니다.

Custom Prompts보다 Skills를 우선하기

Codex 문서에는 Custom Prompts가 deprecated라고 명시되어 있고, 재사용 가능한 지침은 Skills 사용을 권장합니다. Custom Prompt는 로컬 ~/.codex/prompts 아래 Markdown 파일을 slash command처럼 호출하는 방식이지만, 공유성이나 암묵 호출, 리소스/스크립트 패키징 면에서는 Skills가 더 적합합니다.

선택지	언제 쓰나	주의점
일반 프롬프트	이번 한 번만 필요한 지시	길어지면 재사용 어려움
Custom Prompt	과거 방식의 로컬 단축 명령	deprecated, 새 workflow에는 비추천
Skill	반복 workflow, 자료, 스크립트가 있는 절차	`SKILL.md`의 description을 명확히 써야 함
Plugin	skill과 app/MCP/assets를 배포하고 싶을 때	설치 단위가 커지므로 배포 목적일 때 사용

정리하면 /는 실행 중인 세션을 조정하는 입구이고, $skill-name은 반복 절차를 불러오는 입구입니다. 둘을 섞어 쓰되 역할을 분리해야 합니다.

바로 써먹는 세션 운영 패턴

긴 작업을 시작할 때는 이렇게 진행하면 좋습니다.

/status

먼저 현재 세션 상태를 확인합니다. 모델, 권한, 컨텍스트 사용량, 연결된 도구 상태를 추측하지 않는 것이 중요합니다.

/plan
이 저장소의 결제 리팩터링 범위를 파악하고, 변경 파일과 테스트 전략을 먼저 제안해줘.
아직 코드는 수정하지 마.

계획이 필요한 작업은 /plan으로 모드를 바꾼 뒤 범위를 줍니다. “아직 코드는 수정하지 마”는 계획 단계에서 매우 유용한 안전장치입니다.

/mcp

외부 문서, GitHub, Slack, Google Drive 같은 연결이 필요하면 작업을 시키기 전에 MCP나 앱 연결 상태를 먼저 확인합니다. 연결되지 않은 도구를 전제로 프롬프트를 길게 쓰는 것은 시간을 낭비합니다.

$security-review
현재 브랜치를 main과 비교해서 보안 관점으로 리뷰해줘.
심각도, 파일 경로, 근거, 추천 조치만 요약해줘.

반복 가능한 리뷰나 리포트는 skill로 호출합니다. slash command로 세션을 제어하고, skill로 절차를 재사용하고, 프롬프트로 이번 작업의 범위를 좁히는 식입니다.

명령을 남발하지 않는 기준

Slash command가 많아지면 오히려 흐름이 끊깁니다. 다음 기준으로만 쓰면 충분합니다.

세션 상태를 확인하거나 바꿔야 할 때
권한, 모델, 도구 연결처럼 프롬프트 밖의 설정이 중요할 때
대화가 길어져 compact가 필요할 때
반복 workflow를 skill로 불러올 때
구현 전에 계획 모드나 목표 모드가 필요한 때

작업 자체의 판단은 여전히 프롬프트에 남겨야 합니다. “무슨 문제를 해결하는가”, “어떤 위험을 피해야 하는가”, “완료되었다고 말할 증거는 무엇인가”는 slash command가 대신 써주지 않습니다.

팀 가이드에 넣을 문장

Codex를 팀에서 쓴다면 다음 문장을 AGENTS.md나 온보딩 문서에 넣어둘 만합니다.

긴 작업은 먼저 /status로 세션 상태를 확인하고, 구현 전 계획이 필요하면 /plan을 사용한다.
외부 도구가 필요하면 /mcp, /apps, /plugins로 연결 상태를 확인한다.
반복 절차는 custom prompt가 아니라 skill로 만든다.
프롬프트에는 목표, 금지 범위, 검증 명령, 완료 기준을 명시한다.

이 문장의 장점은 특정 명령 하나에 모든 것을 걸지 않는다는 점입니다. Codex 표면마다 slash command 목록은 달라질 수 있지만, 세션 제어와 작업 지시를 분리한다는 원칙은 유지됩니다.

선임 엔지니어 관점

Slash command는 생산성을 올리는 단축키라기보다, Codex와 사람이 같은 상태를 보고 있다는 것을 확인하는 장치입니다. 특히 긴 작업, 외부 도구 작업, 권한이 민감한 작업에서는 “지금 Codex가 어떤 모드와 권한으로 움직이는지”를 먼저 확인해야 합니다.

반대로 작은 수정 하나를 할 때마다 명령을 열 필요는 없습니다. 작은 일은 바로 시키고, 큰 일은 세션을 정렬하고, 반복되는 일은 skill로 빼세요. Codex 사용법의 핵심은 명령을 많이 아는 것이 아니라, 세션 제어, 재사용 절차, 작업 지시를 분리해서 쓰는 것입니다.

참고: OpenAI Codex manual의 Codex app commands, Slash commands in Codex CLI, Agent Skills, Custom Prompts 섹션을 기준으로 작성했습니다.