codex update 는 설치된 릴리스가 자체 업데이트를 지원할 때 Codex CLI 업데이트를 확인하고 적용하는 Stable 셸 하위 명령입니다. 먼저 codex update --help 가 열리는지 확인하고 실행 전후의 codex --version 과 도움말을 함께 기록하세요. 명령이 없으면 설치 방식을 추측해 다른 명령을 실행하지 말고 현재 공식 문서와 조직의 설치 절차를 확인해야 합니다.

이 글은 codex update 를 어디에서 찾는지, 현재 설치본이 명령을 지원하는지, 실행 전에 무엇을 기록할지, 실행 뒤 어떤 출력으로 완료를 판정할지를 다룹니다. 패키지 관리자 교체, 강제 재설치, 설정 파일 수정, 인증 초기화는 첫 완료 범위에서 제외합니다.

OpenAI 공식 Codex CLI 레퍼런스는 codex update 를 설치된 릴리스가 self-update를 지원할 때 업데이트를 확인하고 적용하는 Stable 명령으로 설명합니다. 문서에 명령이 있다는 사실만으로 모든 설치본에서 동작한다고 단정하면 안 됩니다.

이번 검증 환경의 codex-cli 0.144.6 에서는 codex --help 에 update 가 보였고 codex update --help 도 종료 코드 0으로 열렸습니다.

해당 설치본에서 명령을 발견했다는 뜻일 뿐, 보편적인 최소 버전이나 모든 설치 방식의 지원을 보장하지는 않습니다.

목표: Codex CLI 업데이트 전후 출력을 근거로 현재 설치본의 self-update 실행 결과를 검토한다.

허용 입력: codex --version의 실행 전후 출력, codex --help의 update 항목, codex update --help의 Usage 줄, codex update의 실제 종료 결과, 확인 날짜와 검토자.

제외 입력: 비밀값, 개인·고객 데이터, 저장소 원문, config.toml 원문, MCP 인증 정보, 조직 내부 경로.

출력 형식: 사전 버전 | update 명령 인식 | 실행 결과 | 사후 버전 | 도움말 재확인 | 미확인 사항 | 승인 상태의 7개 항목으로 작성한다.

완료 기준: codex update가 오류 없이 끝나고 사후에 codex --version, codex update --help, codex --help가 모두 정상적으로 열린다. 버전이 같다면 이미 최신인지 여부를 실제 출력에 근거해 별도로 기록한다.

추정 금지: 출력에 없는 최소 버전, 모든 운영체제 지원, 설치 경로, 패키지 관리자, 프로젝트 파일 보존, config.toml 호환성, 로그인·MCP·플러그인 정상 작동을 만들어 내지 않는다.

승인 지점: codex update 실행, 권한 상승, 패키지 관리자 변경, 재설치, 설정·인증 수정은 담당자가 범위와 되돌림 방법을 검토한 뒤 승인한다.

이 프롬프트는 사람이 모은 출력을 정리하는 용도입니다. 업데이트 실행이나 후속 복구 명령을 자동으로 수행하라는 지시가 아닙니다.

업데이트 기록은 길게 쓸 필요가 없습니다. 사전 버전, 실행 결과, 사후 버전, 도움말 재확인, 미확인 사항만 남기면 다음 점검에 재사용하기 쉽습니다. 버전 번호가 바뀌었더라도 도움말이 열리지 않으면 성공으로 덮어쓰지 마세요.

여러 사람이 같은 업무 환경을 쓴다면 개인의 셸 출력과 조직이 관리하는 배포 기준을 분리해서 기록합니다. 공식 config 레퍼런스도 업데이트가 중앙 관리되는 환경을 별도로 언급합니다. 개인이 임의로 설정을 바꾸거나 재설치하기 전에 관리 주체를 확인해야 합니다.

• codex update 를 Codex 대화창에 프롬프트처럼 보내지 않습니다.
• 도움말이 열리지 않는데 문서의 구문만 보고 실행을 강행하지 않습니다.
• 오류가 나도 확인 없이 sudo , 강제 재설치, 패키지 관리자 변경, 설정·인증 삭제로 이어 가지 않습니다.
• codex --version 숫자가 바뀌었다는 사실만으로 프로젝트, 로그인, MCP, 플러그인의 호환성이 확인됐다고 보지 않습니다.
• 공식 문서는 보편적인 최소 버전, 플랜, 지역, 언어, 모든 설치 방식의 지원 조건을 명시하지 않습니다. 현재 설치본의 help를 먼저 확인합니다.

codex update는 어디에 입력하나요?

Codex 대화형 composer가 아니라 운영체제 셸에 입력합니다. 먼저 codex update --help 가 열리는지 확인하세요.

update help가 열리지 않으면 어떻게 하나요?

이 글의 절차를 멈춥니다. 설치 방식을 추측해 다른 명령을 붙이지 말고 현재 공식 문서와 조직의 배포 절차에서 해당 설치본의 업데이트 경로를 확인합니다.

업데이트 뒤 버전이 같으면 실패인가요?

버전 숫자만으로 단정하지 않습니다. 실제 update 출력과 사후 codex --version , codex update --help , codex --help 결과를 함께 기록하고 이미 최신인지 확인합니다.

check_for_update_on_startup이 켜져 있으면 codex update가 필요 없나요?

두 기능은 다릅니다. check_for_update_on_startup 은 시작 시 업데이트 확인 여부를 다루고 codex update 는 지원되는 설치본에서 업데이트를 확인하고 적용합니다.

• OpenAI Codex CLI 명령 레퍼런스
• OpenAI Codex config 레퍼런스