Codex CLI 치트시트

/goal로 설정한 목표는 매 턴마다 컨텍스트에 포함돼 에이전트가 부차 작업을 처리하는 중에도 최상위 목표를 놓치지 않는다. 일시 정지·재개·초기화가 지원돼 유연하게 관리할 수 있다.
(0.128.0~)

활용

• 작업 시작 시 목표 설정:
  /goal "이 PR의 모든 리뷰 코멘트 해결 — 기존 테스트 깨뜨리지 않기"
• 부차 작업 중 일시 정지 후 재개:
  /goal pause /goal resume
• 목표 초기화:
  /goal clear

외부 에이전트에서 진행된 세션을 Codex로 가져와 이어받을 수 있다.
가져오기는 백그라운드에서 비동기로 실행되며, 임포트된 세션은 제목이 자동으로 설정된다.
타 에이전트 도구에서 시작한 작업을 Codex 환경에서 끊김 없이 계속할 수 있어 혼합 워크플로우에 유용하다. (0.128.0~)

활용

• 외부 에이전트 세션 파일 임포트:

  codex resume --import <EXPORT_FILE>

  복사
• 임포트 후 세션 목록에서 확인 및 재개:

  codex resume
  # 목록에서 임포트된 세션 선택

  복사

주의

임포트된 세션의 컨텍스트 크기가 클 경우 백그라운드 임포트가 완료되기까지 잠시 대기가 발생할 수 있다.

codex update 명령 하나로 Codex CLI를 최신 버전으로 업그레이드할 수 있다.
npm·DotSlash 등 설치 방식에 무관하게 동작하며, 별도 패키지 매니저를 수동으로 실행하거나 재설치 없이 업데이트 흐름을 완결할 수 있다. (0.128.0~)

활용

• 현재 설치된 Codex를 최신 릴리스로 업데이트:

  codex update

  복사
• CI/스크립트에서 버전 고정 없이 항상 최신 상태 유지:

  codex update && codex exec "run the full test suite"

  복사

TUI 입력 창(composer)에서 모달 Vim 편집을 사용할 수 있다.
/vim 명령으로 즉시 전환하거나, config.toml에서 기본 모드를 설정할 수 있다.
노멀·인서트 모드 전환, Vim 전용 키맵 컨텍스트가 모두 지원돼 터미널에서도 익숙한 편집 흐름을 그대로 유지할 수 있다. (0.129.0~)

활용

• 현재 세션에서 Vim 모드 즉시 활성화:
  /vim
• config.toml에서 기본 Vim 모드로 설정:

  [tui]
  composer_mode = "vim"

  복사

주의

Vim 모드가 활성화된 상태에서 Esc 키는 인서트→노멀 전환에 사용되므로, 메뉴 닫기 등 기존 Esc 동작은 노멀 모드에서만 동작한다.

config.toml의 [keymap] 섹션에서 TUI 단축키를 원하는 키 조합으로 재정의할 수 있다.
기본 키가 다른 터미널 앱과 충돌하거나, 접근성·작업 흐름에 맞게 조정이 필요한 경우 손쉽게 변경할 수 있다. (0.128.0~)

활용

• config.toml에서 특정 액션 키 재정의:

  [keymap]
  submit = "ctrl+j"
  new_line = "shift+enter"

  복사
• /keymap debug로 터미널이 실제로 전달하는 키 이벤트 확인 (0.129.0~):
  /keymap debug

주의

키맵 설정은 TUI 모드에서만 적용된다.
codex exec 비대화형 실행에는 영향 없다.