Codex CLI 치트시트
명령어 · 실행 · 설정 · 자동화·통합을 한 페이지에.
어제 업데이트
최근 주요 변경
2codex remote-control은 원격 제어가 가능한 헤드리스 app-server를 한 번에 띄우는 전용 진입점이다.
이전에는codex --enable remote_control app-server --listen off처럼 플래그를 조합해야 했는데, 이 단축 커맨드는 로컬 transport를 끄고remote_controlfeature를 그 호출에서만 켠 상태로 포그라운드 app-server를 실행한다.
외우기 쉬운 단일 명령으로 원격 컨트롤 시나리오에 진입할 수 있어 봇·러너에서 Codex를 원격 제어할 때 부트스트랩이 단순해진다.활용
- 원격 제어 전용 app-server 실행:
codex remote-control - 기존(장황한) 방식과 동등 — 둘 다 가능:
codex --enable remote_control app-server --listen off
주의
루트의
--remote/--remote-auth-token-env플래그는 이 서브커맨드에서 거부된다.
다른 비-TUI 서브커맨드와 같은 정책이다.
일반 IDE 클라이언트 임베딩에는codex app-server를, 단발성 CI 자동화에는codex exec를 쓴다.- 원격 제어 전용 app-server 실행:
TUI 입력 창(composer)에서 모달 Vim 편집을 사용할 수 있다.
/vim명령으로 즉시 전환하거나,config.toml에서 기본 모드를 설정할 수 있다.
노멀·인서트 모드 전환, Vim 전용 키맵 컨텍스트가 모두 지원돼 터미널에서도 익숙한 편집 흐름을 그대로 유지할 수 있다. (0.129.0~)활용
- 현재 세션에서 Vim 모드 즉시 활성화:
/vim config.toml에서 기본 Vim 모드로 설정:[tui] composer_mode = "vim"
주의
Vim 모드가 활성화된 상태에서
Esc키는 인서트→노멀 전환에 사용되므로, 메뉴 닫기 등 기존Esc동작은 노멀 모드에서만 동작한다.- 현재 세션에서 Vim 모드 즉시 활성화:
⌘K