Codex CLI 0.163.0 사용법: 응답 중 방향 수정·설정 검색과 보안 점검
OpenAI가 2026년 10월 15일 Codex CLI 0.163.0 안정판을 공개했습니다. 이번 버전은 단순한 모델 교체가 아니라, 작업 중인 에이전트를 바로 수정하고 설정을 찾고 중단된 세션을 더 안전하게 이어 가는 조작 체계를 손본 업데이트입니다. 특히 응답이 끝날 때까지 기다리지 않고 추가 지시를 보내는 기능, 검색 가능한 /config, 세션 권한 복원과 네트워크 프록시 보강은 긴 코딩 작업을 맡길 때 체감 차이가 큰 변화입니다.
- 응답 중 후속 메시지를 보내 작업 방향을 즉시 바꿀 수 있습니다.
/config에서 설정을 검색하고, 즉시 적용 또는 재시작 필요 여부를 확인합니다./keymap의 리더 키,/daemon재시작, 읽기 전용 도구 병렬 실행이 추가됐습니다.- 저장된 스레드의 권한·네트워크 승인 복원과 프록시 검사가 강화됐습니다.
업데이트 전에 준비할 것
먼저 변경 내용을 되돌릴 수 있도록 Git 작업 트리를 정리합니다. 새 브랜치를 만들거나 현재 변경을 커밋한 뒤 git status가 예상한 상태인지 확인하는 편이 안전합니다. Codex는 기본적으로 현재 작업 공간을 중심으로 파일을 읽고 수정하지만, 프로젝트 설정과 실행 모드에 따라 실제 권한은 달라질 수 있습니다.
- 설치 경로 확인: standalone installer, npm, Homebrew 가운데 현재 사용 중인 한 가지 경로를 확인합니다.
- 프로젝트 체크포인트: 업데이트 전 커밋 또는 별도 브랜치를 남깁니다.
- 권한 기준: 읽기만 필요한 조사라면
read-only, 코드 수정이 필요하면 기본 Auto 또는workspace-write를 사용합니다. - 네트워크 기준: 명령의 외부 접속이 필요한 도메인과 불필요한 접속을 미리 구분합니다.
Codex CLI와 IDE 확장, 데스크톱 앱은 같은 제품군이지만 화면과 지원 시점이 완전히 같지는 않습니다. 터미널 중심 흐름과 VS Code의 세션 관리 차이가 궁금하다면 VS Code 1.140 Agent Host 가이드도 함께 참고할 수 있습니다.
0.163.0에서 달라진 여섯 가지
| 변화 | 실제 의미 | 확인할 점 |
|---|---|---|
/config 검색 | 카테고리를 넘나들며 설정을 찾고 지원되는 항목을 바로 변경 | 즉시 적용인지 재시작 필요인지 표시 확인 |
| 응답 중 방향 수정 | 긴 응답이나 작업이 끝나기 전에 추가 조건 전달 | 중단하면 Code Mode 셀과 내부 도구 호출도 멈춤 |
/keymap 리더 키 | 단축키 묶음의 시작 키를 구성 | 기본값은 Ctrl+X, 음성 음소거는 F9 |
/daemon 재시작 | 관리형 백그라운드 서버를 터미널에서 재시작 | 중단될 작업 경고를 읽은 뒤 진행 |
| 읽기 도구 병렬 실행 | 스킬·메모리·대화 기록처럼 독립적인 조회를 겹쳐 처리 | 쓰기 작업이나 명령 전체가 자동 병렬화된다는 뜻은 아님 |
| Daybreak 기본 활성화 | 대상 계정에서 기본으로 제공 | 계정 자격과 서버 제공 여부에 따라 보이지 않을 수 있음 |
설치와 업데이트 순서
1. 현재 버전을 기록합니다
codex --version현재 버전과 Codex 실행 파일의 위치를 메모합니다. 여러 설치 방식을 섞어 썼다면 터미널이 예전 실행 파일을 먼저 찾을 수 있으므로, 업데이트 후에도 버전이 바뀌지 않을 때 원인을 찾는 데 도움이 됩니다.
2. 기존 설치 방식으로 업데이트합니다
공식 변경 기록에 적힌 고정 버전 npm 명령은 다음과 같습니다.
npm install -g @openai/codex@0.163.0macOS와 Linux의 standalone installer를 사용했다면 공식 빠른 시작 문서의 설치 명령을 다시 실행해 업데이트할 수 있습니다.
curl -fsSL https://chatgpt.com/codex/install.sh | shWindows는 공식 저장소에 안내된 PowerShell 설치 경로를 사용하고, Homebrew 사용자는 기존 Homebrew 설치를 업데이트합니다. npm과 standalone installer를 동시에 덮어쓰지 말고 원래 사용하던 경로를 유지하는 것이 좋습니다.
3. 버전과 기본 권한을 확인합니다
codex --version
codex버전이 0.163.0 이상인지 확인한 뒤 프로젝트 폴더에서 Codex를 실행합니다. 세션 안에서는 /status로 현재 디렉터리와 실행 상태를 보고, /permissions에서 샌드박스와 승인 정책이 작업 목적에 맞는지 확인합니다. 단순 분석은 읽기 전용으로 시작하고, 실제 수정이 필요한 시점에만 작업 공간 쓰기를 허용하면 검토 범위가 분명해집니다.
새 기능을 안전하게 쓰는 방법
/config: 파일을 직접 고치기 전에 검색
/config를 열고 바꾸려는 설정 이름이나 목적을 검색합니다. 지원되는 설정은 세션 안에서 변경할 수 있고, 재시작이 필요한 항목은 화면에 표시됩니다. 화면에서 변경했다고 해서 모든 조직 정책을 덮어쓰는 것은 아닙니다. 관리형 환경에서는 사용자 설정보다 관리자 요구사항이 우선할 수 있으므로, 변경 후 /status나 관련 상태 화면으로 실제 적용값을 확인합니다.
응답 중 방향 수정: “멈춤”과 “추가 조건”을 구분
새 버전에서는 Codex가 응답하거나 작업하는 동안 후속 메시지를 보내 즉시 방향을 바꿀 수 있습니다. 예를 들어 전체 저장소를 손대려는 흐름이 보이면 “설정 파일은 수정하지 말고 테스트 코드만 제안해 줘”라고 바로 범위를 좁힐 수 있습니다. 반면 현재 작업을 완전히 중단해야 한다면 인터럽트를 사용합니다. 공식 변경 기록에 따르면 이때 활성 Code Mode 셀과 그 안의 중첩 도구 호출도 함께 중단됩니다.
방향 수정은 이미 발생한 파일 변경을 자동으로 되돌리는 기능이 아닙니다. 지시를 보낸 뒤 git diff를 확인하고, 원하지 않는 변경은 별도로 되돌려야 합니다.
/keymap과 /daemon: 조작 속도보다 상태 확인이 먼저
/keymap은 기본 Ctrl+X 리더 키와 이어지는 단축키를 구성합니다. 힌트는 선택하거나 취소할 때까지 열려 있으므로 처음부터 외우기보다 화면을 보고 한두 개씩 익히는 편이 낫습니다. 0.163.0에서는 음성 음소거가 F9로 이동했습니다.
/daemon의 재시작은 관리형 백그라운드 서버가 응답하지 않거나 설정 반영에 재연결이 필요할 때 사용합니다. 재시작 전에 Codex가 중단될 수 있는 작업을 경고하며, 수락하면 재연결을 시도합니다. 실행 중인 명령이나 중요한 출력이 있다면 먼저 저장하고 재시작합니다.
보안 수정이 중요한 이유
이번 버전은 저장된 스레드를 다시 열 때 그 스레드의 권한과 네트워크 승인을 복원하도록 수정했습니다. 단, 명시적으로 준 재정의와 현재 조직 정책은 계속 우선합니다. 따라서 “예전에 허용했으니 지금도 같을 것”이라고 가정하지 말고, 재개 직후 /permissions와 네트워크 범위를 확인하는 습관이 필요합니다.
네트워크 프록시는 허용 여부를 DNS 조회보다 먼저 확인하고, 중복 Host 헤더를 거부하며, 자격증명 별칭이 검사 훅을 우회하지 못하도록 보강됐습니다. 이는 중요한 방어선이지만 네트워크를 자동으로 안전하게 만들어 주는 만능 설정은 아닙니다. Codex의 기본 로컬 샌드박스는 명령 네트워크를 꺼 두며, 네트워크를 켤 때는 필요한 도메인만 허용하고 로컬·사설 주소 접근은 별도로 검토해야 합니다.
실용적인 활용 예시 3가지
예시 1. 긴 리팩터링의 범위를 중간에 좁히기
목적: 대규모 컴포넌트 리팩터링 중 예상보다 변경 파일이 늘어나는 것을 막습니다. 먼저 “계획과 영향 파일을 보여 주고 수정은 기다려”라고 요청합니다. 작업이 진행되는 동안 범위가 넓어지면 “공용 API는 유지하고 테스트와 해당 컴포넌트만 수정”이라는 후속 메시지를 보냅니다. 결과에서는 변경 파일 목록, 공개 API 차이, 테스트 실행 여부를 검토합니다. 이미 만들어진 변경은 git diff로 따로 확인합니다.
예시 2. 팀 공통 설정을 찾고 재시작 여부 확인하기
목적: 설정 파일의 정확한 키를 외우지 않고도 샌드박스·UI·단축키 관련 항목을 찾습니다. /config에서 목적어로 검색하고, 즉시 적용 가능한 항목과 재시작이 필요한 항목을 나눕니다. 적용 뒤 새 세션을 열기 전에 현재 상태를 기록하면 팀 문서에 “어디서 바꾸고 무엇을 다시 시작해야 하는지”를 정확히 남길 수 있습니다.
예시 3. 중단된 세션을 안전하게 재개하기
목적: 어제 중단한 작업을 이어 가되 예전 권한을 무심코 확대하지 않습니다. codex resume으로 스레드를 고른 뒤 /status와 /permissions를 먼저 확인합니다. 네트워크 승인이 필요한 명령은 대상 도메인과 목적을 다시 읽고, 작업 공간 밖 파일 접근은 거부하거나 범위를 좁힙니다. 최종 산출물은 코드뿐 아니라 실행한 명령, 테스트 결과, 남은 미검증 항목까지 함께 검토합니다.
자주 막히는 상황과 해결 순서
- 업데이트했는데 버전이 그대로: 터미널을 다시 열고
codex --version을 확인합니다. npm, Homebrew, standalone installer가 섞여 있지 않은지 실행 경로를 점검합니다. /config가 보이지 않음: 0.163.0 이상인지 먼저 확인합니다. 프리릴리스와 안정판을 혼동하지 말고 공식 안정판 태그를 기준으로 합니다.- 설정이 바로 반영되지 않음:
/config가 재시작 필요로 표시하는지 확인하고, 진행 중 작업을 저장한 뒤 재시작합니다. /daemon재시작 항목이 없음: 이 기능은 관리형 백그라운드 서버를 대상으로 하므로 현재 실행 방식에서 제공되지 않을 수 있습니다.- Daybreak가 보이지 않음: 공식 기록은 “대상 계정”과 서버가 접근을 제공하는 경우로 범위를 한정합니다. 제공되지 않는 계정에서 강제로 활성화됐다고 가정하지 않습니다.
- 재개한 세션의 권한이 예상과 다름: 현재 관리 정책과 명시적 재정의가 우선할 수 있으므로
/permissions에서 다시 확인합니다.
업데이트 후 최소 검증 체크리스트
codex --version이 0.163.0 이상인지 확인/config검색과 적용·재시작 표시 확인- 테스트 작업에서 응답 중 추가 지시와 인터럽트 차이 확인
/keymap리더 키와F9변경 확인- 재개 세션의
/permissions와 네트워크 승인 재검토 - 실제 코드 변경은
git diff와 테스트 결과로 별도 검증
정리하면, Codex CLI 0.163.0의 핵심은 더 많은 일을 자동으로 맡기는 데 있지 않습니다. 실행 중 방향을 바로 수정하고, 설정과 재시작 조건을 눈으로 확인하고, 세션을 재개할 때 권한 경계를 보존하는 데 있습니다. 업데이트 후 작은 저장소와 읽기 전용 작업으로 조작을 익힌 다음 실제 수정 작업으로 넓히는 순서가 안전합니다.
English version: Read the Codex CLI 0.163.0 guide in English
공식 자료
- OpenAI ChatGPT & Codex changelog
- Codex CLI 0.163.0 GitHub release
- OpenAI Codex CLI documentation
- Sandboxing, approvals, and network access
자료 확인일: 2026년 10월 17일
댓글
댓글 쓰기