OpenAI 공식 문서 — Commands 단축키

8. 단축키, Slash Command, Deeplink

Codex app을 더 빠르고 편하게 사용하는 세 가지 방법을 알아봅니다. 마우스 클릭 없이도 Codex의 모든 기능을 자유자재로 다룰 수 있게 됩니다.

한 줄 요약

반복 탐색은 키보드 단축키로, 상태 확인과 특수 동작은 Slash Command로, 외부에서 Codex를 여는 것은 Deeplink로 처리하면 작업 속도가 크게 올라갑니다. 이 세 가지만 익히면 Codex 사용이 훨씬 수월해집니다.

이 페이지에서 배우는 것

  • 키보드 단축키가 무엇이고, Codex에서 어떤 단축키를 쓸 수 있는지
  • Slash Command의 개념과 각 명령어의 구체적인 사용법
  • Deeplink를 활용해 외부에서 Codex 화면을 바로 여는 방법
  • 초보자가 가장 자주 쓰는 조합 TOP 5
  • 자주 묻는 질문(FAQ) 모음

키보드 단축키란?

키보드 단축키(Keyboard Shortcut)란, 두 개 이상의 키를 동시에 눌러서 특정 기능을 실행하는 것입니다. 여러분이 이미 사용하고 있는 것들이 있습니다.

  • Ctrl + C : 복사하기 (워드, 메모장 등 어디서나)
  • Ctrl + V : 붙여넣기
  • Ctrl + Z : 실행 취소 (되돌리기)

이처럼 Codex app에도 자체 단축키가 있습니다. 메뉴를 찾아 클릭하는 대신, 키 조합 하나로 원하는 기능을 바로 실행할 수 있어서 작업 속도가 훨씬 빨라집니다. Mac에서는 Cmd 키를 사용하고, Windows에서는 Ctrl 키를 사용합니다.

주요 키보드 단축키

Codex app에서 자주 사용하는 키보드 단축키입니다. 마우스 없이 빠르게 앱을 조작할 수 있습니다. 하나씩 눌러보면서 익혀 보세요.

새 스레드 (새 대화 시작) Cmd N
Settings(설정) 열기 Cmd ,
폴더(프로젝트) 열기 Cmd O
터미널 열기/닫기 Cmd J
사이드바 토글 Cmd B
명령 팔레트(Command Menu) Cmd Shift P
빠른 액션 (Quick Open) Cmd K
이전/다음 화면 Cmd [ / ]
이전/다음 스레드 Cmd Shift [ / ]
Diff 패널 열기 Cmd Option B
스레드 안에서 찾기 Cmd F
폰트 크기 키우기/줄이기 Cmd + / −
터미널 화면 비우기 Ctrl L
음성 입력 (Voice Dictation, 누르고 있는 동안 / push-to-talk) Hold Ctrl M
팝아웃 새 스레드 Cmd Shift O
In-app 브라우저 열기 Cmd Shift B

참고 1. Cmd+W(탭 닫기), Cmd+Q(종료), Cmd+Shift+F(전체 화면)는 macOS 시스템 기본 단축키이며 Codex 전용 단축키가 아니므로 위 목록에서 제외했습니다.
참고 2. Cmd+O(Open folder), Cmd+J(Toggle terminal), Cmd+B(Toggle sidebar), Cmd+F(Find in thread), Cmd+Shift+B(In-app browser)는 모두 공식 Codex 단축키입니다(공식 commands / browser 문서). Windows에서는 Cmd를 Ctrl로 바꿔 사용합니다.
참고 3. 음성 입력은 Hold Ctrl+M 즉 키를 누르고 있는 동안에만 음성이 전사되는 push-to-talk 방식입니다(공식 features 문서).

팁: 처음에는 2~3개만 외워도 충분합니다. Cmd+N(새 대화), Cmd+,(설정), Cmd+J(터미널) 이 세 가지부터 시작해 보세요.

초보자를 위한 자주 쓰는 조합 TOP 5

"이런 상황에서는 이 단축키를 쓰세요!" -- 구체적인 상황별로 정리했습니다.

Cmd + N
새 작업을 시작하고 싶을 때
이전 대화와 별개로 새로운 질문이나 작업을 하고 싶다면 이 단축키를 누르세요. 새로운 빈 대화창이 열립니다. 마치 메모장에서 "새 문서"를 여는 것과 같습니다.
Cmd + ,
설정을 빠르게 열고 싶을 때
AI 모델 변경, 테마(밝기/어둡기) 전환, 자동 승인 설정 등을 바꾸고 싶을 때 사용합니다. 메뉴를 찾아 헤매지 않아도 됩니다.
Cmd + O
다른 프로젝트로 전환할 때
현재 작업 중인 폴더가 아닌, 다른 프로젝트 폴더를 열고 싶을 때 사용합니다. 폴더 선택 창이 나타나서 원하는 프로젝트를 골라 열 수 있습니다.
Cmd + J
터미널(명령어 입력 창)을 열고 싶을 때
터미널은 컴퓨터에 직접 명령어를 입력하는 창입니다. Git 명령어를 실행하거나, 프로그램을 실행할 때 사용합니다. 다시 누르면 터미널이 닫힙니다.
/status
현재 작업 상태를 확인할 때
Codex가 지금 무엇을 하고 있는지, 어떤 파일을 변경했는지 한눈에 확인할 수 있습니다. 대화 입력창에 /status라고 입력하면 됩니다.

Slash Command란?

Slash Command(슬래시 커맨드)는 대화 입력창에 /(슬래시) 기호를 입력한 뒤 명령어 이름을 적는 방식입니다.

카카오톡이나 슬랙(Slack) 같은 메신저 앱에서 /help라고 치면 도움말이 나오는 것과 비슷합니다. 일반 대화가 아니라, Codex에게 "특별한 동작을 해 줘"라고 지시하는 것입니다.

사용 방법:

  1. Codex 하단의 대화 입력창(Composer)을 클릭합니다.
  2. / 를 입력합니다. 사용 가능한 명령어 목록이 자동으로 나타납니다.
  3. 원하는 명령어를 선택하거나 직접 타이핑합니다.
  4. Enter를 누르면 해당 명령이 실행됩니다.

Slash Command 완전 가이드

각 Slash Command가 무엇을 하는지, 언제 사용하면 좋은지 하나씩 알아봅시다.

공식 앱 빌트인 슬래시는 6개입니다. 현재 Codex 앱이 정식 문서에 등재한 슬래시 명령은 /feedback, /mcp, /plan-mode, /review, /status, /pet입니다. 다만 활성화된 Skill은 이 외에도 슬래시 메뉴에 자동 등록되며 (공식 Skills 문서: "In CLI/IDE, run /skills or type $ to mention a skill"), CLI 인터랙티브 세션에서는 /model 등 추가 명령을 사용할 수 있습니다. 임의 사용자 정의 슬래시는 없지만 Skills($ 접두사)로 같은 효과를 만들 수 있습니다.
$ 접두사 — 스킬 명시 호출. Composer에 $를 입력하면 활성화된 Skill 목록이 자동완성으로 표시됩니다. 예: $skill-creator, $skill-installer eslint. /가 슬래시 명령(앱 동작)을 호출한다면, $는 스킬을 명시적으로 호출하는 1급 접두사입니다(공식 Commands 문서).
@ 접두사 — 파일·심볼 참조. Composer에서 @를 입력하면 자동완성이 뜹니다. @src/app.ts처럼 적으면 그 파일이 컨텍스트에 첨부되고, @calculateTotal처럼 함수·클래스 이름을 적으면 심볼 단위로 참조됩니다(공식 Commands 문서). 긴 설명 대신 정확한 위치를 짚어 줄 수 있어 답이 빠르고 정확해집니다. 이미지(스크린샷·UI 모형)는 Composer에 드래그&드롭으로 첨부합니다. 정리하면 — /는 앱 명령, $는 스킬 호출, @는 컨텍스트 참조.
명령어 하는 일 이럴 때 사용하세요
/status 현재 Codex가 뭘 하고 있는지, 어떤 파일을 변경했는지 전체 상태를 한눈에 보여줍니다. Codex가 작업을 진행 중인데 지금 어디까지 했는지 궁금할 때. 변경된 파일 목록을 확인하고 싶을 때.
/review Codex가 수정한 코드의 변경사항을 리뷰 화면으로 보여줍니다. 어떤 줄이 추가/삭제되었는지 색깔로 구분해서 볼 수 있습니다. Codex가 코드를 수정한 후, 변경 내용을 꼼꼼히 확인하고 싶을 때. 승인하기 전에 내용을 검토할 때.
/mcp MCP(외부 도구 연결) 상태를 확인합니다. 현재 어떤 외부 도구가 연결되어 있는지, 정상 작동 중인지 보여줍니다. 외부 도구(예: GitHub, 데이터베이스 등)와의 연결이 제대로 되어 있는지 확인하고 싶을 때.
/plan-mode 다단계 계획 기능을 켜거나 끕니다(Toggle plan mode). 공식 commands 문서에는 토글 동작만 정의되어 있으며, 실제 사용 시에는 Codex가 계획부터 제시하고 변경에 들어가는 흐름이 일반적입니다. 파일 변경을 차단하는 안전 잠금이 아니며, 실제 권한은 별도의 승인 정책/샌드박스가 결정합니다. 복잡한 작업의 전체 경로를 미리 합의하고 시작하고 싶을 때. 단계가 많은 리팩토링 전에 방향을 점검하고 싶을 때.
/feedback OpenAI 팀에 피드백(의견, 버그 신고, 개선 요청)을 보냅니다. 명령 실행 시 세션 ID가 함께 생성되므로, 지원팀이 해당 세션의 로그를 추적해 디버그할 수 있습니다. Codex 사용 중 불편한 점이나 버그를 발견했을 때. 새로운 기능을 제안하고 싶을 때. 세션 ID를 보고서/메일에 함께 첨부하면 응답이 빨라집니다.
/pet Codex의 애니메이션 컴패니언(Codex Pets)을 켭니다. 스레드 상태와 진행 정도를 작은 오버레이로 표시합니다. Settings → Appearance → Pets의 Wake Pet/Tuck Away Pet 토글로도 같은 기능을 제어할 수 있습니다. 긴 자동화/장시간 작업이 진행되는 동안 곁눈으로 상태를 확인하고 싶을 때. 직접 펫을 만들고 싶다면 $hatch-pet Skill을 설치하세요.
Slash command 목록은 환경 및 접근 권한에 따라 다를 수 있습니다. 실제 사용 가능한 명령은 Composer에서 / 를 입력해 직접 확인하세요. $ 기호를 입력하면 skill(스킬)을 호출할 수도 있습니다.

Deeplink란?

Deeplink(딥링크)는 클릭하면 Codex app의 특정 화면을 바로 여는 특별한 링크입니다.

비유하자면, Zoom 회의 링크를 클릭하면 자동으로 Zoom 앱이 열리면서 해당 회의에 바로 들어가는 것과 같습니다. 마찬가지로 codex://settings라는 링크를 클릭하면 Codex 앱이 열리면서 설정 화면으로 바로 이동합니다.

Deeplink의 구조: 일반 웹 주소가 https://로 시작하듯, Codex deeplink는 codex://로 시작합니다.

codex://settings - 설정 화면 codex://skills - 스킬 목록 codex://automations - 자동화 설정 codex://new - 새 작업 시작 codex://threads/<thread-id> - 특정 로컬 스레드 열기

참고: codex://threads/<id>는 로컬 스레드 전용입니다. Cloud 스레드(chatgpt.com/codex에서 시작한 스레드)는 codex:// 스킴으로 열리지 않으며 일반 웹 URL을 그대로 사용합니다.

codex://new 파라미터

codex://new는 다음 query 파라미터를 조합해 미리 채워진 새 스레드를 열 수 있습니다(공식 Commands 문서).

파라미터설명예시
prompt Composer에 미리 입력될 메시지 codex://new?prompt=README%20요약
path 열어야 할 프로젝트의 절대 경로 codex://new?path=/Users/me/repo
originUrl 이 호출의 출처 URL(분석/감사용) codex://new?originUrl=https://wiki.team/runbook

Deeplink 활용법

Deeplink는 혼자 쓸 때도 편하지만, 팀과 함께 쓸 때 특히 유용합니다. 아래 두 가지 활용법을 확인해 보세요.

팀 위키에 Codex 링크 걸기
팀 위키(Notion, Confluence 등)나 문서에 codex://new?path=/Users/team/project 형태의 링크를 걸어 두면, 팀원이 클릭 한 번으로 해당 프로젝트를 Codex에서 바로 열 수 있습니다. 새 팀원이 합류했을 때 특히 유용합니다.
브라우저 북마크로 등록하기
자주 여는 Codex 화면의 deeplink를 브라우저 북마크에 저장해 두세요. 예를 들어 codex://settings를 북마크하면, 브라우저에서 클릭 한 번으로 Codex 설정 화면을 열 수 있습니다.

3가지 조작 방식 한눈에 비교

지금까지 배운 세 가지 조작 방식을 표로 정리했습니다. 상황에 따라 가장 편한 방식을 골라 쓰면 됩니다.

구분 용도 접근 방식 예시
단축키 앱 안에서 빠르게 화면을 이동하거나 기능을 실행할 때 키보드 키 조합을 동시에 누름 Cmd+N 새 스레드 열기
Slash Command 상태 확인, 모드 전환 등 특수 동작을 실행할 때 대화 입력창에 / + 명령어 입력 /status 현재 상태 확인
Deeplink 외부(브라우저, 문서 등)에서 Codex의 특정 화면을 바로 열 때 codex:// 주소를 클릭 codex://settings 설정 열기

자주 묻는 질문 (FAQ)

Q: Windows에서 Cmd 대신 뭘 누르나요?
Windows에서는 Cmd 대신 Ctrl 키를 사용합니다. 예를 들어 Mac에서 Cmd+N이라면, Windows에서는 Ctrl+N을 누르면 됩니다. 대부분의 단축키가 이 규칙을 따릅니다.
Q: 단축키를 커스텀(변경)할 수 있나요?
현재 Codex app의 기본 단축키는 변경할 수 없습니다. 하지만 향후 업데이트에서 커스텀 기능이 추가될 수 있으니, Settings 페이지를 주기적으로 확인해 보세요.
Q: Slash Command를 입력했는데 아무 반응이 없어요
먼저 명령어 앞에 /(슬래시)를 정확히 입력했는지 확인하세요. 역슬래시 \와 혼동하는 경우가 많습니다. 또한 대화 입력창(Composer)에 입력해야 하며, 다른 곳에서는 동작하지 않습니다. 그래도 안 된다면 앱을 다시 시작해 보세요.
Q: Deeplink를 다른 사람에게 공유할 수 있나요?
네, 가능합니다. Deeplink는 일반 텍스트 형태의 URL이므로 슬랙, 이메일, 문서 등 어디든 복사해서 공유할 수 있습니다. 단, 상대방의 컴퓨터에도 Codex app이 설치되어 있어야 링크가 정상적으로 작동합니다.
Q: 키보드 없이 마우스로만 쓸 수 있나요?
네, Codex app의 모든 기능은 마우스로도 사용할 수 있습니다. 단축키는 필수가 아니라 "더 빠르게" 쓰기 위한 도구입니다. 처음에는 마우스로 메뉴를 탐색하면서 익히고, 자주 쓰는 기능부터 하나씩 단축키로 바꿔 보세요.
Q: /plan-mode와 일반 모드의 차이가 뭔가요?
일반 모드에서는 요청 즉시 작업이 진행됩니다. /plan-mode는 공식적으로는 단순히 "다단계 계획 기능 켜기/끄기"(Toggle plan mode) 동작입니다. 실제 사용해 보면 Codex가 계획을 먼저 제시한 뒤 실행으로 넘어가는 흐름이 자연스러우나, plan-mode 자체가 파일 변경을 강제로 차단하지는 않습니다 — 변경을 실제로 막고 싶다면 Settings의 승인 정책을 read-only로 두거나, 결과를 Review Pane에서 한 번 더 검토하세요.

다음 단계

이 페이지의 내용을 익혔다면, 다음 단계로 넘어가 보세요.

장점 / 단점 / 한계점

✅ 장점

  • 키보드 단축키로 대부분의 작업을 마우스 없이 수행 가능
  • Slash Command로 빠르게 특정 기능 호출
  • Deeplink로 외부에서 Codex 작업을 직접 시작 가능
  • 커스텀 단축키 설정으로 개인 워크플로 최적화

❌ 단점

  • 단축키를 외우기까지 초기 학습 곡선 존재
  • macOS와 Windows 간 단축키 차이로 혼동 가능
  • Slash Command 목록이 많아지면 원하는 명령 찾기 어려움

⚠️ 한계점

  • 모든 기능이 단축키로 제공되지는 않음
  • Deeplink는 앱이 설치된 환경에서만 동작
  • 사용자 정의 Slash Command 생성은 현재 미지원

공식 출처