Codex CLI 입력창이 대기 상태일 때 /keymap 을 실행하면 TUI 단축키를 검색하고 바꾸는 Keymap 화면이 열립니다.

이번 첫 설정은 현재 unbound인 Global 의 Toggle Vim Mode 에 F6 을 연결합니다. 키를 누르는 순간 root override가 저장되므로 별도 저장 버튼을 찾지 말고 완료 메시지와 config.toml 을 확인해야 합니다.

마지막으로 일반 입력 화면에서 F6 을 두 번 눌러 Vim 모드가 켜졌다 꺼지는지 봅니다. 실제 작업 중인 설정 파일은 변경 전 사본과 diff를 확인한 뒤 사람이 승인합니다.

• /keymap 이 여는 설정 화면과 쓰기 좋은 때
• Toggle Vim Mode 에 F6 한 개를 연결하는 순서
• 완료 메시지, tui.keymap 저장값, 실제 동작을 나눠 확인하는 법
• 기존 단축키를 건드리지 않는 검토 프롬프트와 되돌리기 경계

터미널에서 Codex를 쓰다 보면 자주 여는 기능에 익숙한 키를 붙이고 싶을 때가 있습니다. 이때 설정 파일의 키 이름을 추측해 직접 편집하기보다 현재 설치본이 보여 주는 action과 context를 먼저 확인하는 편이 안전합니다.

/keymap 은 Codex CLI TUI의 키보드 단축키를 조회하고 바인딩을 저장하는 대화형 설정 기능입니다. 공식 문서에 따르면 변경한 키는 active keymap에 반영되고 config.toml 의 tui.keymap 에 저장됩니다.

공식 문서는 binding 이름의 예로 ctrl-a , shift-enter , page-down 을 제시합니다. context별 binding은 tui.keymap.global 보다 우선합니다. 빈 binding 목록은 해당 action을 unbind합니다.

목표: Codex CLI의 현재 keymap에서 Global > Toggle Vim Mode에 F6을 연결하기 전 검토안을 만들어 줘.

허용 입력: 현재 /keymap 화면의 action·context·binding, 내 config.toml의 tui.keymap 부분, Codex 공식 CLI command 문서.

제외 입력: 프로젝트 소스, 대화 transcript, 인증정보, .env, 다른 action의 기존 binding, 운영체제·터미널 설정 변경.

출력 형식: 1) 현재 binding 2) 제안 변경 한 항목 3) 기존 키와의 충돌 여부 4) 예상 config diff 5) 설정 후 확인 순서 6) 되돌리기 순서.

완료 기준: 기존 keymap을 보존할 것. Global의 toggle_vim_mode 한 항목만 F6으로 연결하고 저장값과 켜기·끄기 확인 지점을 제시할 것.

추정 금지: 보이지 않는 기존 binding, 지원 플랫폼, 저장 위치, 터미널 키 전달 방식, 재시작 필요 여부를 만들어 내지 말 것.

승인 지점: 실제 /keymap 변경 또는 config.toml 수정 전에 전체 diff와 되돌리기 대상을 보여 주고 사람의 승인을 기다릴 것.

Keymap은 action 이름만 보지 말고 context까지 함께 읽어야 합니다. 공식 문서상 context별 binding은 global binding보다 우선하므로, 같은 물리 키라도 화면 상태에 따라 다른 action이 실행될 수 있습니다.

처음에는 unbound action 하나를 고르면 기존 동작을 덮어쓸 위험을 줄일 수 있습니다. 완료 뒤에는 Customized 그룹과 config diff를 함께 보면 내가 만든 override를 다시 찾기 쉽습니다.

Open Transcript , Copy , Clear Terminal 처럼 이미 키가 붙은 action은 첫 실험 대상으로 피하는 편이 낫습니다. 꼭 바꿔야 한다면 현재 키, 새 키, 되돌릴 키를 먼저 기록하세요.

• /keymap 은 Codex CLI 입력창에서 실행합니다. 셸에 입력하지 않습니다.
• current turn이나 startup task가 끝나기 전에 Enter를 반복하지 않습니다.
• F6 은 이 글의 격리 실험용 선택이며 모든 환경의 권장 키라는 뜻이 아닙니다.
• 기존 binding이 보이면 새 키를 덮어쓰기 전에 action과 context를 기록합니다.
• context별 binding은 global보다 우선할 수 있으므로 같은 키의 다른 context도 확인합니다.
• config 전체를 교체하지 말고 tui.keymap 의 실제 diff만 검토합니다.
• 삭제, 다른 action 변경, 운영체제·터미널 설정 수정은 첫 완료 범위에서 제외합니다.

/keymap 은 셸에서 실행하나요?

아닙니다. Codex CLI의 대화형 입력창에 넣는 slash action입니다. Enter 전 completion에서 /keymap remap TUI shortcuts 가 인식되는지 먼저 확인하세요.

F6 을 누른 뒤 별도 저장 버튼이 필요한가요?

codex-cli 0.144.6 격리 실험에서는 Set key 다음에 F6 을 누르자 즉시 remapped 메시지가 나오고 config.toml 에 root override가 기록됐습니다. UI가 다르면 현재 화면과 공식 문서를 우선하세요.

저장된 값은 어디에서 확인하나요?

공식 문서에 따르면 custom binding은 config.toml 의 tui.keymap 에 기록됩니다. 이번 설치본에서는 [tui.keymap.global] 아래 toggle_vim_mode = "f6" 으로 확인됐습니다.

원래대로 되돌리려면 어떻게 하나요?

/keymap 에서 같은 Toggle Vim Mode action을 다시 열어 현재 설치본이 제공하는 custom binding 제거 항목을 확인합니다. 제거 전후 tui.keymap diff를 비교한 뒤 다른 action이나 기존 binding이 그대로인지 사람이 승인합니다. 빈 binding 목록은 action을 unbind하는 의미이므로 직접 빈 값을 넣는 것과 root override 제거를 같은 동작으로 보지 마세요.

• OpenAI 공식 문서: Codex CLI command reference