핸드북 변경사항

Codex CLI: 최근 핸드북 구조 개선 내용을 확인하고 날짜별 릴리스·검증 기록으로 이동하는 변경 안내입니다.

2026-10-23 · Codex CLI 0.163.0

안정판 **0.163.0(2026-10-15)**과 Developer Commands를 대조했습니다. npm latest=0.163.0, alpha=0.164.0-alpha.12입니다. alpha 변경은 안정판 사용법으로 반영하지 않습니다.

설정·입력: /config 검색 패널에서 지원 설정을 즉시 바꾸고 재시작 필요 여부를 확인합니다. 응답 도중 보낸 후속 입력은 기본으로 즉시 전달되며, turn을 중단하면 실행 중인 Code Mode cell과 중첩 도구 호출도 중단됩니다.
단축키·서버: /keymap의 기본 leader는 Ctrl+X이고 힌트는 선택·취소까지 유지됩니다. 음성 음소거는 F9로 이동했습니다. /daemon에서 managed background server를 재시작하면 중단될 작업을 알린 뒤 자동 재연결합니다.
권한·Daybreak: 재개 시 저장된 권한과 네트워크 승인을 복원하되 명시적 override·현재 managed policy가 우선합니다. Daybreak는 적격 계정에서 기본 활성화되어 0.161.0의 opt-in 안내를 대체합니다. 서버가 허용하면 OpenAI API key로 인증한 codex exec에서도 프로그램을 지정할 수 있습니다.
실행·복구: 서로 독립적인 읽기 전용 도구(스킬·메모리·대화 이력 조회 포함)를 병렬 실행할 수 있습니다. /side가 스레드 전환 뒤에도 기존 side 대화로 돌아가고 보류 질문의 답은 질문한 스레드로 전달됩니다. Windows 텍스트 붙여넣기·WSL clipboard timeout, 프로세스 종료 후 열린 pipe·원격 마지막 출력 회수도 수정됐습니다.
호환성: patched zsh 번들이 제거됐으며 이전 shell flag 설정에는 이전 안내가 나옵니다. Linux sandbox 설명은 bubblewrap 파일시스템 격리와 seccomp 필터 기준으로 바뀌었습니다. proxy는 DNS 조회 전 권한을 검사하고 중복 Host 헤더·credential alias 우회를 차단합니다.
공식 표 재검증: slash 표는 50→57행입니다. /agents(서버 command center)와 /subagents(하위 스레드)가 분리됐고 /tui·/export·/recap·/cd·/pwd(/cwd)·/worktree·/daemon·/warnings가 등재됐습니다. /agent·/personality·/sandbox-add-read-dir는 현재 표에 없어 이전 앵커를 보존하고 상태를 구분했습니다. CLI overview는 27→29행으로 codex agents·codex queue가 추가됐습니다. global·exec 옵션 변경과 Linux sandbox 표도 반영했습니다. /config·/voice는 여전히 릴리스 근거로 추적합니다.
GPT-5.5 종료 완료: 2026-10-14 19:00 UTC(한국 10-15 04:00)부터 ChatGPT 로그인 Codex에서 종료됐습니다. 플랜·클라이언트에서 제공되는 GPT-6.1 Sol(gpt-6.1-sol) 등으로 저장 설정·custom agent·scheduled task·스크립트를 갱신합니다. OpenAI API와 API-key 인증 Codex는 영향받지 않습니다.

근거: 0.163.0 릴리스, Developer Commands, 공식 Changelog, Models, npm dist-tags.

2026-10-22

명령 검증 기준은 2026-10-10 · Codex CLI 0.162.1 그대로이고, 책 구조를 바꿨습니다.

템플릿 문구가 대부분이던 명령 페이지 43개를 전체 명령 목록의 명령별 사용법으로 합쳤습니다. 예전 주소는 목록 안 해당 명령으로 영구 이동(308)합니다.
내용이 많은 15개 명령(/model, /mcp, /hooks, /statusline 등)은 별도 페이지로 남기고, 모든 페이지에 반복되던 요약 문구와 일반 주의사항을 명령별 내용으로 바꿨습니다.
/hooks에 훅을 두는 곳, 최소 설정 예, 이벤트 12종, 입력·출력 규칙을, /statusline에 항목 고르는 법과 tui.status_line·tui.terminal_title 저장 위치를 공식 Hooks 문서·config reference와 대조해 적었습니다.

2026-10-10

공식 명령 검증 기준: Codex CLI 0.162.1.

CLI 0.161.0~0.162.1 릴리스와 Developer Commands 표를 다시 대조했습니다. 공식 슬래시 표 50행과 CLI 표의 명령·옵션 구성은 10-07 대조와 같습니다. 공식 Changelog 페이지가 통합 changelog로 개편되어 CLI 버전은 GitHub 릴리스와 npm으로 추적합니다.
/mcp에 실행 중인 세션에서 MCP 서버에 로그인하는 /mcp login <name>(0.161.0)을, /voice에 마이크·스피커·마이크 입력 채널 선택(0.161.0)을 적었습니다.
/copy에 transcript 블록 이동 복사와 Ctrl+Insert(0.162.0)를, /tui에 tui.mouse_scroll_speed(0.162.0)를 추가했습니다.
/worktree에 managed worktree 생성·조회 도구(0.162.0)를, /agent에 agent Command Center의 p 고정(0.162.0)을 반영했습니다.
터미널 CLI 참조의 릴리스 추가 명령에 codex exec --cyber-access-program과 Daybreak opt-in(--enable cli_daybreak, 0.161.0)을 넣었습니다.
/model의 GPT-6.1 Sol 속도 설명을 공식 Models 문서에 맞춰 Ultrafast 제공 플랜으로 고쳤습니다. 릴리스별 변경은 날짜별 반영 이력에 기록했습니다.

2026-10-07

공식 명령 검증 기준: Codex CLI 0.160.1.

CLI 0.158.0~0.160.1 릴리스와 Developer Commands 표를 다시 대조했습니다. 공식 슬래시 표 50행과 CLI 표의 명령·옵션 구성은 그대로이고, /model 설명과 --model 예시가 gpt-6.1-sol로 바뀌었습니다.
/model에 GPT-6.1 Sol(gpt-6.1-sol)을 추가했습니다. 0.159.1부터 모델을 지정하지 않은 세션의 번들 기본값이 GPT-6 Astra에서 GPT-6.1 Sol로 바뀌었습니다.
/tui에 tui.copy_on_select·tui.right_click_paste(0.158.0)와 X11 가운데 클릭 붙여넣기(0.160.0)를, /mcp에 codex mcp add --oauth-client-secret(0.158.0)을 적었습니다.
/permissions·/resume·/cd에 0.160.0의 projectless 세션 기본 권한, 재개 시 저장 권한 복원, folder trust 확인을 반영했습니다.
0.159.0에서 제거된 tui.prompt_suggestions 설정과 번들 plugin-creator 스킬을 포함해 릴리스별 변경을 날짜별 반영 이력에 기록했습니다.

2026-09-26

공식 명령 검증 기준: Codex CLI 0.157.1.

CLI 0.156.0~0.157.1 릴리스와 Developer Commands 표를 다시 대조했습니다. 공식 슬래시 표 50행과 CLI 표의 명령·옵션 구성은 바뀌지 않았고, /model·/diff·/app·/import 설명과 --model 예시가 바뀌었습니다.
/model에 GPT-6 Sol(gpt-6-sol)·GPT-6 Luna(gpt-6-luna)를 추가하고, 2026-10-14 ChatGPT 로그인 경로의 GPT-5.5 종료 일정을 적었습니다.
0.156.0에서 추가된 /tui(fullscreen UI 선택)와 /daemon(로컬 background server 업데이트) 상세 페이지를 새로 만들었습니다.
/voice와 /worktree는 0.156.0부터 기본 활성화되어 실험 기능 표시를 릴리스 추적으로 바꿨습니다. /usage 분석 대시보드, /personality의 friendly·pragmatic deprecated 처리도 반영했습니다.

2026-09-22

공식 명령 검증 기준: Codex CLI 0.155.1.

시작 페이지를 작업별 경로로 정리하고, 전체 목록에 종류·지원 상태를 표시했습니다.
개별 명령을 역할 → 사용 조건 → 사용 예 → 실행 결과와 유지 범위 → 주의사항 → 공식 근거 순서로 맞췄습니다.
문법·별칭·지원 정보·출처를 공통 데이터에서 관리해 한·영판 목록과 상세가 일치하도록 했습니다.
현재 안내에서 날짜별 기록을 분리하고, 기존 명령 주소를 유지했습니다.

지난 기록

날짜별 릴리스 반영 이력 · 이전 검증 기록 · 명령별 변경 기록

현재 수록 범위와 확인 방법은 현재 검증 범위에서 확인합니다.

2026-10-23 · Codex CLI 0.163.0

설정·입력: /config 검색 패널에서 지원 설정을 즉시 바꾸고 재시작 필요 여부를 확인합니다. 응답 도중 보낸 후속 입력은 기본으로 즉시 전달되며, turn을 중단하면 실행 중인 Code Mode cell과 중첩 도구 호출도 중단됩니다.
단축키·서버: /keymap의 기본 leader는 Ctrl+X이고 힌트는 선택·취소까지 유지됩니다. 음성 음소거는 F9로 이동했습니다. /daemon에서 managed background server를 재시작하면 중단될 작업을 알린 뒤 자동 재연결합니다.
권한·Daybreak: 재개 시 저장된 권한과 네트워크 승인을 복원하되 명시적 override·현재 managed policy가 우선합니다. Daybreak는 적격 계정에서 기본 활성화되어 0.161.0의 opt-in 안내를 대체합니다. 서버가 허용하면 OpenAI API key로 인증한 codex exec에서도 프로그램을 지정할 수 있습니다.
실행·복구: 서로 독립적인 읽기 전용 도구(스킬·메모리·대화 이력 조회 포함)를 병렬 실행할 수 있습니다. /side가 스레드 전환 뒤에도 기존 side 대화로 돌아가고 보류 질문의 답은 질문한 스레드로 전달됩니다. Windows 텍스트 붙여넣기·WSL clipboard timeout, 프로세스 종료 후 열린 pipe·원격 마지막 출력 회수도 수정됐습니다.
호환성: patched zsh 번들이 제거됐으며 이전 shell flag 설정에는 이전 안내가 나옵니다. Linux sandbox 설명은 bubblewrap 파일시스템 격리와 seccomp 필터 기준으로 바뀌었습니다. proxy는 DNS 조회 전 권한을 검사하고 중복 Host 헤더·credential alias 우회를 차단합니다.
공식 표 재검증: slash 표는 50→57행입니다. /agents(서버 command center)와 /subagents(하위 스레드)가 분리됐고 /tui·/export·/recap·/cd·/pwd(/cwd)·/worktree·/daemon·/warnings가 등재됐습니다. /agent·/personality·/sandbox-add-read-dir는 현재 표에 없어 이전 앵커를 보존하고 상태를 구분했습니다. CLI overview는 27→29행으로 codex agents·codex queue가 추가됐습니다. global·exec 옵션 변경과 Linux sandbox 표도 반영했습니다. /config·/voice는 여전히 릴리스 근거로 추적합니다.
GPT-5.5 종료 완료: 2026-10-14 19:00 UTC(한국 10-15 04:00)부터 ChatGPT 로그인 Codex에서 종료됐습니다. 플랜·클라이언트에서 제공되는 GPT-6.1 Sol(gpt-6.1-sol) 등으로 저장 설정·custom agent·scheduled task·스크립트를 갱신합니다. OpenAI API와 API-key 인증 Codex는 영향받지 않습니다.

근거: 0.163.0 릴리스, Developer Commands, 공식 Changelog, Models, npm dist-tags.

2026-10-22

명령 검증 기준은 2026-10-10 · Codex CLI 0.162.1 그대로이고, 책 구조를 바꿨습니다.

템플릿 문구가 대부분이던 명령 페이지 43개를 전체 명령 목록의 명령별 사용법으로 합쳤습니다. 예전 주소는 목록 안 해당 명령으로 영구 이동(308)합니다.
내용이 많은 15개 명령(/model, /mcp, /hooks, /statusline 등)은 별도 페이지로 남기고, 모든 페이지에 반복되던 요약 문구와 일반 주의사항을 명령별 내용으로 바꿨습니다.
/hooks에 훅을 두는 곳, 최소 설정 예, 이벤트 12종, 입력·출력 규칙을, /statusline에 항목 고르는 법과 tui.status_line·tui.terminal_title 저장 위치를 공식 Hooks 문서·config reference와 대조해 적었습니다.

2026-10-10

공식 명령 검증 기준: Codex CLI 0.162.1.

CLI 0.161.0~0.162.1 릴리스와 Developer Commands 표를 다시 대조했습니다. 공식 슬래시 표 50행과 CLI 표의 명령·옵션 구성은 10-07 대조와 같습니다. 공식 Changelog 페이지가 통합 changelog로 개편되어 CLI 버전은 GitHub 릴리스와 npm으로 추적합니다.
/mcp에 실행 중인 세션에서 MCP 서버에 로그인하는 /mcp login <name>(0.161.0)을, /voice에 마이크·스피커·마이크 입력 채널 선택(0.161.0)을 적었습니다.
/copy에 transcript 블록 이동 복사와 Ctrl+Insert(0.162.0)를, /tui에 tui.mouse_scroll_speed(0.162.0)를 추가했습니다.
/worktree에 managed worktree 생성·조회 도구(0.162.0)를, /agent에 agent Command Center의 p 고정(0.162.0)을 반영했습니다.
터미널 CLI 참조의 릴리스 추가 명령에 codex exec --cyber-access-program과 Daybreak opt-in(--enable cli_daybreak, 0.161.0)을 넣었습니다.
/model의 GPT-6.1 Sol 속도 설명을 공식 Models 문서에 맞춰 Ultrafast 제공 플랜으로 고쳤습니다. 릴리스별 변경은 날짜별 반영 이력에 기록했습니다.

2026-10-07

공식 명령 검증 기준: Codex CLI 0.160.1.

CLI 0.158.0~0.160.1 릴리스와 Developer Commands 표를 다시 대조했습니다. 공식 슬래시 표 50행과 CLI 표의 명령·옵션 구성은 그대로이고, /model 설명과 --model 예시가 gpt-6.1-sol로 바뀌었습니다.
/model에 GPT-6.1 Sol(gpt-6.1-sol)을 추가했습니다. 0.159.1부터 모델을 지정하지 않은 세션의 번들 기본값이 GPT-6 Astra에서 GPT-6.1 Sol로 바뀌었습니다.
/tui에 tui.copy_on_select·tui.right_click_paste(0.158.0)와 X11 가운데 클릭 붙여넣기(0.160.0)를, /mcp에 codex mcp add --oauth-client-secret(0.158.0)을 적었습니다.
/permissions·/resume·/cd에 0.160.0의 projectless 세션 기본 권한, 재개 시 저장 권한 복원, folder trust 확인을 반영했습니다.
0.159.0에서 제거된 tui.prompt_suggestions 설정과 번들 plugin-creator 스킬을 포함해 릴리스별 변경을 날짜별 반영 이력에 기록했습니다.

2026-09-26

공식 명령 검증 기준: Codex CLI 0.157.1.

CLI 0.156.0~0.157.1 릴리스와 Developer Commands 표를 다시 대조했습니다. 공식 슬래시 표 50행과 CLI 표의 명령·옵션 구성은 바뀌지 않았고, /model·/diff·/app·/import 설명과 --model 예시가 바뀌었습니다.
/model에 GPT-6 Sol(gpt-6-sol)·GPT-6 Luna(gpt-6-luna)를 추가하고, 2026-10-14 ChatGPT 로그인 경로의 GPT-5.5 종료 일정을 적었습니다.
0.156.0에서 추가된 /tui(fullscreen UI 선택)와 /daemon(로컬 background server 업데이트) 상세 페이지를 새로 만들었습니다.
/voice와 /worktree는 0.156.0부터 기본 활성화되어 실험 기능 표시를 릴리스 추적으로 바꿨습니다. /usage 분석 대시보드, /personality의 friendly·pragmatic deprecated 처리도 반영했습니다.

2026-09-22

공식 명령 검증 기준: Codex CLI 0.155.1.

시작 페이지를 작업별 경로로 정리하고, 전체 목록에 종류·지원 상태를 표시했습니다.
개별 명령을 역할 → 사용 조건 → 사용 예 → 실행 결과와 유지 범위 → 주의사항 → 공식 근거 순서로 맞췄습니다.
문법·별칭·지원 정보·출처를 공통 데이터에서 관리해 한·영판 목록과 상세가 일치하도록 했습니다.
현재 안내에서 날짜별 기록을 분리하고, 기존 명령 주소를 유지했습니다.

지난 기록

날짜별 릴리스 반영 이력 · 이전 검증 기록 · 명령별 변경 기록

현재 수록 범위와 확인 방법은 현재 검증 범위에서 확인합니다.

2026-10-23 · Codex CLI 0.163.0

2026-10-22

2026-10-10

2026-10-07

2026-09-26

2026-09-22

지난 기록

On this page

핸드북 변경사항

2026-10-23 · Codex CLI 0.163.0

2026-10-22

2026-10-10

2026-10-07

2026-09-26

2026-09-22

지난 기록

On this page