03. Codex CLI · P1

codex update는 Codex CLI를 최신 버전으로 업데이트하는 명령어이다. 쉽게 말하면 현재 설치된 Codex 명령어 자체를 새 버전으로 바꾸는 기능이다. 일반 대화형 Codex 작업을 시작하는 명령이 아니다. 코드를 수정하거나 모델에게 작업을 맡기는 것이 아니라, 로컬 CLI 프로그램을 갱신하는 관리 명령이다.

기본 사용법

위 명령은 Codex CLI를 최신 버전으로 업데이트하려고 시도한다. 업데이트가 필요하면 새 버전을 내려받고 설치하는 흐름으로 이어질 수 있다.

codex update

다음은 codex update를 실행해 CLI 업데이트를 진행하는 예시 화면이다. 현재 버전 확인 업데이트 전후에는 현재 버전을 확인하는 것이 좋다. 위 명령은 현재 실행되는 Codex CLI 버전을 출력한다. 업데이트 전과 후에 한 번씩 실행하면 실제로 버전이 바뀌었는지 확인할 수 있다. 다음은 codex --version으로 현재 버전을 확인하는 예시 화면이다.

동작 방식

codex update는 현재 설치된 Codex CLI를 최신 버전으로 바꾸는 명령이다. 실제 업데이트 방식은 Codex CLI가 설치된 경로와 배포 방식에 따라 달라질 수 있다. 예를 들어 사용자의 환경에 따라 npm, nvm, Homebrew, 앱 번들, 직접 설치 방식이 섞여 있을 수 있다. codex update가 성공하면 보통 사용자가 따로 설치 명령을 외울 필요 없이 CLI가 갱신된다. 반대로 설치 방식이나 권한 문제 때문에 update가 실패할 수도 있다. 이 경우에는 현재 codex가 어디에서 실행되는지 확인한 뒤, 그 설치 방식에 맞는 업데이트 방법을 확인해야 한다. 현재 실행 파일 경로는 다음 명령으로 확인할 수 있다.

codex --version

command -v codex

실행 후 확인 흐름

업데이트할 때는 다음 순서로 확인하면 된다. 첫 번째 codex --version은 업데이트 전 버전을 확인하는 단계이다. codex update로 업데이트를 실행한다. 마지막 codex --version은 업데이트 후 실제 버전을 확인하는 단계이다. 업데이트 후에도 같은 버전이 나오면 두 가지 가능성이 있다. 이미 최신 버전이거나, 업데이트가 제대로 적용되지 않은 것이다. 터미널을 새로 열거나 shell hash 캐시를 갱신한 뒤 다시 확인해야 할 수도 있다.

언제 사용하나

codex update는 다음 상황에서 사용한다. 특히 새 명령어를 설명하는 문서를 보고 따라 하는데 내 CLI에 해당 명령이 없다면, 먼저 codex --version과 codex update를 확인하는 것이 좋다.

실행 중인 세션과의 관계 codex update는 CLI 프로그램을 갱신하는 명령이다. 이미 실행 중인 Codex 세션의 내부 상태가 즉시 모두 바뀐다고 생각하면 안 된다. 업데이트 후에는 새 터미널이나 새 Codex 세션에서 다시 실행하는 편이 안전하다. 특히 플러그인, MCP, 기능 플래그, 인증 흐름처럼 시작 시점에 로드되는 기능은 재시작 후 확인하는 것이 좋다. 설정값 덮어쓰기 codex update도 공통 -c 옵션을 사용할 수 있다.

codex --version

codex update

codex --version

최신 Codex CLI 기능을 사용하고 싶을 때 현재 CLI에 없는 명령어나 옵션이 필요할 때 Codex 실행 중 버전 업데이트 안내가 나왔을 때 버그 수정이나 인증, 플러그인, MCP 관련 개선 사항을 적용하고 싶을 때 매뉴얼이나 자동화 문서가 현재 CLI보다 최신 기능을 전제로 할 때 -c는 ~/.codex/config.toml에서 읽는 설정값을 현재 명령 실행 시점에만 덮어쓴다.

다만 update는 CLI 자체를 갱신하는 명령이므로, 일반 사용자가 -c를 함께 쓸 일은 많지 않다. 업데이트 동작을 특정 설정이나 기능 플래그 상태에서 재현해야 하는 고급 상황이 아니라면 기본 형태만 쓰면 된다.

기능 플래그 옵션

codex update에는 --enable과 --disable 옵션도 있다. 이 옵션은 내부적으로 -c features.=true 또는 false를 넘기는 것과 같은 의미이다. 업데이트 자체보다 특정 기능 플래그를 켠 상태에서 update 동작을 확인할 때 쓰는 옵션이다. 정확한 feature 이름은 codex features list로 먼저 확인한다. 일반 업데이트에서는 기능 플래그를 붙이지 않아도 된다.

주의사항

codex update는 설치된 CLI를 바꾸는 명령이다. 업데이트 후 명령어 옵션, help 출력, 기본 동작이 달라질 수 있다. 업데이트에는 인터넷 연결이 필요할 수 있다. 회사 네트워크, 프록시, VPN, 방화벽 환경에서는 다운로드가 실패할 수 있다. 설치 위치에 따라 파일 쓰기 권한이 필요할 수 있다. 권한 오류가 나면 현재 codex 실행 경로를 확인하고, 해당 설치 방식에 맞는 업데이트 방법을 사용해야 한다. 자동화 환경에서는 무작정 최신 버전으로 올리는 것이 위험할 수 있다. 스크립트가 특정 CLI 출력 형식이나 옵션에 의존한다면 업데이트 후 help와 실제 동작을 다시 확인해야 한다. 문제가 생기면 먼저 현재 버전과 실행 경로를 확인한다.

codex update -c model="gpt-5.4-mini"

codex update --enable some_feature

codex update --disable some_feature

codex --version

command -v codex

세부 도움말 확인

이 매뉴얼은 codex update가 어떤 명령어인지 이해하기 위한 개요이다. 세부 옵션 전체는 현재 설치된 CLI의 help에서 확인하는 것이 정확하다. 전체 Codex CLI 명령 목록은 다음 명령으로 확인한다. Codex CLI는 업데이트되면서 update 명령 자체의 동작이나 옵션이 바뀔 수 있다. 실제 업데이트 전에 현재 환경의 help 출력을 확인하는 것이 좋다.

정리

codex update는 Codex CLI를 최신 버전으로 갱신하는 명령어이다. 업데이트 전후에는 codex --version으로 버전을 확인하고, 필요하면 새 터미널이나 새 Codex 세션에서 다시 실 행한다. 일반 사용자는 codex update만 실행하면 된다. 권한, 네트워크, 설치 방식 때문에 실패하면 command -v codex로 실행 경로를 확인한 뒤 설치 방식에 맞게 처리 하면 된다.

codex completion

---