Checked

공식 문서에 공개된 범위만 먼저 정리

Codex는 CLI, 데스크톱 앱, IDE 확장, 클라우드 작업 흐름이 함께 움직입니다. 이 페이지는 2026년 6월 8일 기준 OpenAI Codex 매뉴얼에 직접 나온 항목 위주로 정리했습니다.

Last checked · 2026-06-08

CLI First

터미널에서 가장 먼저 다시 찾는 명령과 슬래시 커맨드

codex login

인증 다시 연결

ChatGPT OAuth, device auth, API key, stdin access token 방식으로 Codex 인증을 복구합니다.

codex update

CLI 최신화

현재 설치 버전이 self-update를 지원할 때 Codex CLI 업데이트를 확인하고 적용합니다.

codex doctor

설치와 설정 진단

설치, 인증, config, Git, 터미널, app-server, thread inventory 문제를 지원 리포트 형태로 점검합니다.

codex exec

비대화형 실행

스크립트나 자동화에서 Codex를 한 번 실행하고 stdout 또는 JSONL로 결과를 받을 때 씁니다.

codex --model

모델 지정

설정 파일의 기본 모델 대신 해당 세션에서만 모델을 바꿔 시작합니다.

--sandbox / --ask-for-approval

권한 경계 설정

로컬 작업은 보통 workspace-writeon-request 조합이 낮은 마찰과 안전성의 균형점입니다.

/permissions

세션 중 승인 정책 조정

Read Only, Auto 같은 권한 프리셋을 세션 중 바꿔 파일 수정과 명령 실행의 자율성을 조절합니다.

/model / /status

모델과 세션 상태 확인

활성 모델, reasoning effort, 승인 정책, writable roots, 남은 컨텍스트를 빠르게 확인합니다.

/plan / /goal

큰 작업을 먼저 구조화

구현 전에 계획 모드로 범위를 잡고, 장기 작업은 목표를 붙여 진행 상태를 유지합니다.

/diff / /review

커밋 전 점검

현재 Git diff를 보고, 작업 트리에 대한 리뷰 관점의 재검토를 요청합니다.

App Workflow

명령 말고도 자주 다시 찾는 핵심 포인트

AGENTS.md

반복되는 리뷰 기준, 빌드 명령, 저장소 규칙은 AGENTS.md에 둡니다. 가까운 하위 디렉터리의 지침이 더 구체적인 규칙으로 작동합니다.

Skills

반복 절차는 .agents/skills$HOME/.agents/skills에 스킬로 둡니다. Codex는 설명을 보고 필요할 때 전체 SKILL.md를 읽습니다.

MCP

GitHub, Figma, 브라우저, 내부 문서처럼 외부 시스템이 필요하면 codex mcpconfig.toml의 MCP 설정으로 연결합니다.

Automations + worktrees

반복 점검은 Automations로 돌리고, Git 저장소에서는 전용 worktree를 선택해 미완성 로컬 작업과 분리하는 편이 안전합니다.

App modes

Codex 앱 스레드는 Local, Worktree, Cloud 모드로 나뉩니다. 같은 저장소의 독립 작업은 Worktree 모드가 가장 다루기 쉽습니다.

Browser / Computer Use

웹앱 검증은 in-app browser와 Browser plugin, 데스크톱 앱 검증은 Computer Use 설정으로 분리해 생각하면 됩니다.

Use Cases

이 페이지를 열어두면 좋은 순간

복귀

Codex CLI를 오랜만에 다시 켰을 때

codex login, codex doctor, codex update, /status로 인증, 설치, 버전, 세션 상태를 먼저 확인하세요.

확장

팀 플레이북을 붙이려 할 때

규칙은 AGENTS.md, 반복 절차는 Skills, 외부 시스템은 MCP, 반복 실행은 Automations로 나눠 설계하면 유지보수가 쉽습니다.

검증

커밋 전 마지막 점검을 맡길 때

/diff로 변경을 확인하고 /review로 작업 트리 리뷰를 받은 뒤, 필요한 테스트를 직접 실행하게 하세요.

Official Sources

공식 문서 원문 링크