Codex CLI 기능 플래그 확인 방법: codex features list로 처음 상태 읽는 법
TL;DR
codex features list
는 현재 설치된 Codex CLI가 아는 기능 이름, 단계, 적용 상태를 읽는 명령입니다. 운영체제 셸에서 도움말을 먼저 확인한 다음 목록을 실행하면 됩니다. 첫 점검은 조회에서 끝냅니다.
enable
·
disable
이나
config.toml
편집은 별도 승인 뒤 진행합니다.
핵심 3줄 요약
codex features --help
로 설치본이
list
·
enable
·
disable
을 인식하는지 먼저 확인합니다.codex features list
의 feature name, stage, effective state는 각각 이름·성숙 단계·현재 적용 상태를 뜻합니다.이 글에서 다룰 내용
-
codex features를 어디에서 실행하는지 - 현재 기능 플래그를 읽는 5단계
- stage와 effective state를 구분하는 법
- 복사해서 쓸 수 있는 상태 해석 프롬프트
- 첫 점검에서 하지 말아야 할 변경
codex features list
란 무엇인가
codex features
는 기능 플래그를 나열하고
config.toml
에 영구적으로 켜거나 끌 수 있는 Stable Codex CLI 명령입니다. 공식 CLI 레퍼런스는
list
,
enable
,
disable
을 같은 명령군으로 설명합니다.
이 글에서는 그중
list
만 사용합니다. 설치된 실행 파일이 아는 기능과 현재 적용 상태를 읽습니다. 설정 파일은 건드리지 않습니다. 어떤 항목이 목록에 있다는 사실과 그 기능을 업무에 써도 된다는 판단은 다릅니다.
시작 전에 확인할 세 가지
- 이 명령은 Codex 대화 입력창의 slash action이 아니라 운영체제 셸에서 실행합니다.
- 공식 문서는 모든 운영체제·플랜·지역·언어·최소 버전을 한꺼번에 보장하지 않습니다.
- 목록의 행과 단계 표기는 CLI 버전에 따라 바뀔 수 있으므로 다른 사람의 화면보다 현재 설치본의 도움말을 우선합니다.
이번 검증 환경에서는
codex-cli 0.144.6
이
list
·
enable
·
disable
을 인식했습니다.
codex features list
를 다시 실행하기 전후로
~/.codex/config.toml
의 크기, 수정 시각, SHA-256을 대조했고 값이 같았습니다. 이 결과는 해당 설치본에서 확인한 읽기 전용 관찰입니다. 이후 버전에서도 같다고 보장하지는 않습니다.
현재 상태를 읽는 5단계
1. 설치된 Codex CLI 버전을 기록합니다
운영체제 셸에서 다음 명령을 실행합니다.
codex --version
버전 문자열을 검토 기록에 남깁니다. 목록이 동료나 문서와 다를 때 설치본 차이를 먼저 확인할 수 있습니다.
2.
features
하위 명령이 있는지 확인합니다
codex features --help
도움말에
list
,
enable
,
disable
이 보이는지 확인합니다. 명령이 인식되지 않으면 이 글의 절차를 그대로 적용하지 말고 현재 설치본과 공식 문서를 다시 확인합니다. 확인되지 않은 업데이트·재설치 절차를 임의로 덧붙이지 않습니다.
3. 기능 플래그 목록을 읽습니다
codex features list
설치본이 기능 이름, 단계, 적용 상태를 행 단위로 출력합니다. 여기서는 목록을 읽기만 합니다.
enable
이나
disable
을 이어서 실행하지 않습니다.
4. 검토할 한 행만 기록합니다
관심 있는 기능의 이름, stage, effective state를 출력 그대로 옮깁니다. 이름을 번역하거나 줄여 쓰지 않습니다. 목록 전체를 영구적인 지원표로 복사하지 않습니다. 확인 날짜와 Codex CLI 버전도 함께 적습니다.
5. 설정 변경 없이 점검을 마칩니다
다음 네 항목이 기록됐는지 확인합니다.
- Codex CLI 버전
- 확인한 기능 이름
- stage
- effective state
첫 실행은 여기서 끝냅니다. 특정 기능을 켜거나 끄려면 현재 공식 설명과 조직 정책, 테스트 범위, 되돌림 조건을 따로 검토한 뒤 사람의 승인을 받습니다.
출력의 세 열을 읽는 법
Feature name은 CLI가 기능을 식별하는 이름입니다. 설정이나 공식 문서를 찾을 때 출력 문자열을 그대로 사용합니다.
Stage는 현재 설치본이 표시하는 성숙 단계입니다. 이 환경의
codex-cli 0.144.6
에서는
stable
,
experimental
,
under development
,
deprecated
,
removed
표기가 관찰됐습니다. 이 목록과 개별 기능의 단계는 버전에 따라 달라질 수 있습니다.
Effective state는 현재 계산된 적용 상태입니다. 이 환경에서는
true
또는
false
로 표시됐습니다. 하지만
true
가 곧 안정성·보안성·조직 승인을 뜻하지는 않습니다.
stable
이라고 해서 모든 계정과 업무에 자동으로 적합한 것도 아닙니다.
따라서 한 행은 다음처럼 읽습니다.
- 이름: 어떤 기능인지 찾는 식별자
- 단계: 현재 설치본이 보여 주는 성숙도 표기
- 적용 상태: 지금 계산된 켜짐 또는 꺼짐 상태
- 결론: 변경 여부는 아직 결정하지 않음
그대로 복사해 쓸 상태 해석 프롬프트
목표: 선택한 Codex 기능 플래그 한 행을 변경 없이 해석하고 검토 질문을 만든다.
허용 입력: Codex CLI 버전, 확인 날짜, 기능 이름, stage, effective state, 현재 공식 문서의 해당 기능 설명
제외 입력: 전체 config.toml, 인증 토큰, API 키, 고객 데이터, 저장소 비밀값, 다른 기능의 추정 정보
출력 형식: 1. 관찰 사실 2. 아직 확인되지 않은 조건 3. 변경 전 검토 질문 4. 다음 승인 지점
완료 기준: 기능 이름·stage·effective state를 입력과 동일하게 보존한다. 설정 변경 명령 없이 검토 질문만 제시한다.
추정 금지: 목록에 있다는 이유만으로 사용 가능 플랜, 지역, 보안성, 성능, 기본값, 향후 지원을 만들지 않는다.
승인 지점: enable·disable 실행, config.toml 편집, 테스트 환경 적용 전에 사람이 공식 문서와 조직 정책을 확인하고 승인한다.
아래 프롬프트에는 비밀값이나 전체 설정 파일을 넣지 않습니다.
codex features list
에서 검토할 한 행과 공식 문서의 해당 기능 설명만 입력합니다.
실전 활용 팁
기능 플래그 점검 기록은 길 필요가 없습니다. 버전·날짜·한 행·판단 보류 사유만 남겨도 다음 검토자가 같은 출발점에서 확인할 수 있습니다.
여러 항목이 궁금해도 처음에는 한 행만 고릅니다. stage와 effective state를 따로 적어 두면 나중에 변경을 검토할 때도 관찰과 결정을 구분하기 쉽습니다.
주의할 점
-
codex features list결과를 영구적인 제품 지원표로 인용하지 않습니다. -
experimental이나under development항목을 호기심만으로 켜지 않습니다. -
deprecated나removed표기를 오류라고 단정하지 않습니다. -
true를 안정성·권한·조직 승인으로 해석하지 않습니다. - 이 글의 완료 범위에
enable,disable,config.toml편집, 업데이트, 재설치는 포함되지 않습니다. - 설정을 바꿔야 한다면 비민감 테스트 환경, 한 기능씩의 변경, 되돌림 조건, 사람 승인을 별도 절차로 둡니다.
자주 묻는 질문
codex features list
는 어디에 입력하나요?
Codex 대화 입력창이 아니라 운영체제 셸에 입력합니다. 먼저
codex features --help
가 인식되는지 확인합니다.
목록에 보이면 바로 사용할 수 있나요?
아닙니다. 목록은 현재 설치본이 아는 기능과 상태를 보여 줍니다. 플랜·지역·정책·기능별 제한은 해당 공식 문서와 현재 계정 환경에서 따로 확인해야 합니다.
true
이면 안정 기능이라는 뜻인가요?
아닙니다. effective state와 stage는 별도 정보입니다.
true
는 현재 적용 상태를 나타내며 안정성이나 조직 승인을 보장하지 않습니다.
기능을 켜는 방법도 이 글에 포함되나요?
포함되지 않습니다. 공식 명령군에는
enable
과
disable
이 있지만
config.toml
에 상태를 영구 저장하는 변경 작업입니다. 이 글은
list
로 읽고 기록하는 데서 끝납니다.
출처
- OpenAI Codex CLI reference —
codex features의 Stable 상태와 기능 플래그 나열·영구 활성화·비활성화 범위를 확인했습니다.
마무리
codex features list
의 첫 목적은 숨은 기능을 켜는 것이 아니라 현재 설치본의 상태를 정확히 읽는 것입니다. 운영체제 셸에서 버전과 도움말을 확인합니다. 기능 이름·stage·effective state 한 행을 기록하면 첫 점검은 완료됩니다.
변경은 그다음 문제입니다. 공식 문서와 조직 정책, 테스트 범위, 되돌림 조건을 검토하기 전까지는
list
에서 멈추는 편이 안전합니다.
