Codex CLI 0.167.0 에이전트 운영과 네트워크 승인 점검

Codex CLI 0.167.0의 커맨드 센터와 백엔드 전환을 운영에 적용하고 Vertex AI 인증 및 네트워크 승인 변경을 점검한다.

2026-11-11

백엔드를 바꾸기 전에 이어갈 작업을 구분한다

터미널 세션 피커에서 연결된 백엔드를 바꿔도 작성 중인 초안이 유지된다. 제공자를 전환한 뒤 저장된 대화가 보이지 않던 문제도 수정됐다. 백엔드를 오가며 작업한다면 전환 후 초안을 다시 입력하거나 이전 대화를 찾는 동선부터 점검할 만하다.

이 글의 기준은 **Codex CLI 0.167.0 (2026-11-06)**이다. 기능과 수정 사항의 근거는 공식 릴리스노트이며, 설정 문법이나 승인 범위처럼 릴리스노트에 없는 세부 동작은 다루지 않는다.

운영에서 구분할 대상은 작성 중인 초안과 저장된 대화다. 초안 보존은 백엔드를 바꿀 때 입력 내용을 이어 쓰게 해준다. 저장된 대화의 가시성은 이전 작업을 다시 찾게 해준다. 다만 목록에 대화가 보인다고 해서 그 대화를 반드시 재개할 수 있는 것은 아니다. 재개할 수 없다면 기록을 읽고, 새 대화에서 이어갈 편집 가능한 프롬프트를 준비하는 경로가 제공된다.

아래 흐름은 백엔드 전환 중 보존되는 초안과 저장된 대화의 재개 여부를 서로 다른 점검 대상으로 보여준다.

⤢✕가능불가연결된 백엔드 전환작성 중인 초안 유지저장된 대화 표시대화 재개 가능 여부기존 대화 재개기록 읽기새 대화에서 이어갈 프롬프트편집

전환 기능을 확인할 때는 작성 중인 초안이 있는 상태에서 연결된 다른 백엔드를 선택한다. 전환 뒤에는 초안의 내용과 저장된 대화의 표시 여부를 따로 확인한다. 재개할 수 없는 대화가 있다면 기록 열람과 프롬프트 편집 경로까지 확인해야 전환 이후의 작업 동선을 검증할 수 있다.

커맨드 센터에서 읽지 않은 결과를 찾는다

커맨드 센터를 여는 명령은 다음과 같다.

codex agents --no-daemon

이번 릴리스에서는 커맨드 센터와 세션 피커가 읽지 않은 결과를 표시한다. 에이전트 작업을 확인할 때는 이 표시를 활용해 아직 읽지 않은 결과로 이동하는 동선을 만들 수 있다. 도입 점검에서도 명령 실행 여부만 확인하기보다 실제 결과 표시가 보이는 화면까지 확인하는 편이 유용하다.

백엔드 선택은 터미널 세션 피커에서 수행한다. 연결된 백엔드를 선택하는 기능과 읽지 않은 결과를 찾는 기능이 함께 있으므로, 운영 안내에서는 다음 동작의 목적을 구분해 적어두면 된다.

운영 목적 사용할 진입점 또는 동작 확인할 결과
에이전트 결과 확인 codex agents --no-daemon 커맨드 센터의 읽지 않은 결과 표시
연결된 백엔드 선택 터미널 세션 피커 전환 후 작성 중인 초안 유지
이전 작업 확인 제공자 전환 후 저장된 대화 열기 대화 표시와 재개 가능 여부
재개 불가 대화 이어가기 기록 열람 후 프롬프트 편집 새 대화에서 이어갈 입력 준비

터미널 화면을 정리하는 동작도 함께 확인할 수 있다. Ctrl+L은 터미널 표시를 지우되 이전 메시지는 Ctrl+T로 계속 볼 수 있게 한다. 화면을 비운 뒤에도 이전 메시지를 조회할 수 있으므로, 화면 정리와 대화 확인을 별도 동작으로 안내하면 된다.

Vertex AI 인증 경로와 시스템 프록시를 따로 설정한다

API 키와 클라우드 제공자 옵션은 **“Sign in another way”**에서 찾는다. Vertex AI를 사용할 때는 gcp_setup_wizard를 활성화하면 Google Cloud Vertex AI 설정을 진행할 수 있다. 이때 제공되는 인증 경로는 Application Default Credentials와 자격 증명 파일이다.

실무에서는 먼저 사용할 인증 경로를 정하고 설정 과정에서 해당 경로를 선택한다. 릴리스노트에는 gcp_setup_wizard의 구체적인 활성화 명령이나 설정 파일 문법이 제시돼 있지 않다. 따라서 이 글에서는 기능 이름과 지원하는 인증 방식까지만 적용 기준으로 삼는다.

시스템 프록시는 별도의 선택 항목이다. macOS 또는 Windows에서 /experimental을 통해 운영체제의 시스템 프록시 설정 사용을 선택할 수 있다. Vertex AI 인증 설정을 진행했다는 이유로 시스템 프록시도 적용됐다고 판단하지 말고, 프록시가 필요한 환경이라면 해당 옵션을 따로 확인한다.

아래 비교는 인증을 준비하는 경로와 시스템 프록시를 선택하는 경로의 진입점 및 적용 대상을 나란히 보여준다.

⤢✕ Vertex AI 인증과 시스템 프록시의 설정 경계 비교 축: 목적 · 진입점 · 선택 대상 Vertex AI 인증 시스템 프록시 별도 확인 목적 진입점 선택 대상 Google Cloud Vertex AI 설정 운영체제의 시스템 프록시 설정 사용 “Sign in another way”의 클라우드 제공자 옵션 과 활성화한 gcp_setup_wizard /experimental Application Default Credentials 또는 자격 증명 파일 macOS 또는 Windows 의 시스템 프록시 설정

이 구분을 운영 문서에도 유지하면 확인 항목이 명확해진다. 인증 쪽에는 선택한 인증 경로를, 프록시 쪽에는 사용 대상 운영체제와 실험 옵션 선택 여부를 기록한다. 인증 경로와 네트워크 경로를 한 항목으로 묶으면 어느 설정까지 확인했는지 알기 어렵다.

네트워크 승인은 동시 요청과 요청 종료를 함께 확인한다

같은 엔드포인트에 동시 요청이 발생하면 네트워크 승인 프롬프트가 한 번에 하나씩 나타난다. 요청이 끝나면 해당 요청의 승인 프롬프트도 닫힌다. 운영 점검에서는 프롬프트가 나타나는 순간뿐 아니라 요청 종료 뒤 화면까지 확인해야 한다.

여기서 직렬화되는 대상은 승인 프롬프트다. 릴리스노트의 “한 번에 하나씩”을 한 번의 승인으로 같은 엔드포인트의 모든 요청을 처리한다는 뜻으로 해석할 근거는 없다. 확인할 동작은 동시 프롬프트의 표시 순서와 종료된 요청에 대한 프롬프트 정리다.

아래 흐름은 같은 엔드포인트에 대한 동시 요청에서 프롬프트 표시와 종료를 확인하는 지점을 보여준다.

⤢✕같은 엔드포인트의 동시 요청승인 프롬프트를 한 번에 하나씩표시요청 종료해당 요청의 승인 프롬프트 닫기

승인 프롬프트가 열린 동안에는 대화 기록에서 패치 세부 내용을 직접 펼쳐볼 수도 있다. 패치 검토가 필요한 승인 상황이라면, 프롬프트가 열린 상태에서 변경 내용을 확인할 수 있는지 점검한다. 네트워크 프롬프트의 직렬화와 패치 세부 내용 확장은 서로 다른 변경 사항이므로 각각 확인해야 한다.

새 사람 승인을 요구하는 명령은 운영 체크포인트로 둔다

앱 서버 README에는 [permissions.network] 아래의 관리형 네트워크 제약과, **새 사람 승인(fresh human approval)**을 요구하는 prompt-user 명령 규칙에 관한 설명이 추가됐다.

에이전트 운영 절차에서는 prompt-user 규칙이 적용되는 명령을 사람이 새로 승인해야 하는 체크포인트로 취급한다. 작업 초안을 유지하거나 이전 대화를 이어가는 기능과 실행 승인은 별도로 점검해야 한다. 대화가 이어졌다는 사실만으로 승인 요건까지 충족했다고 처리해서는 안 된다.

네트워크 관련 운영 문서를 갱신할 때도 다음 내용을 나눠 기록할 수 있다.

점검 대상 릴리스노트가 명시한 내용 운영 문서에 반영할 내용
관리형 네트워크 제약 [permissions.network] 아래에서 설명 네트워크 제약 설정을 확인할 위치
명령 승인 규칙 prompt-user는 새 사람 승인 요구 사람의 새 승인이 필요한 실행 지점
동시 네트워크 요청 같은 엔드포인트의 프롬프트를 한 번에 하나씩 표시 동시 요청 상황의 화면 확인 항목
요청 종료 해당 승인 프롬프트 닫기 종료 후 남은 프롬프트 확인 항목

자료에는 [permissions.network]의 세부 필드나 prompt-user 규칙의 전체 문법이 없다. 이 표는 설정을 복사하기 위한 예제가 아니라 운영 점검의 경계를 정리한 것이다. 실제 규칙을 작성할 때는 릴리스노트가 안내하는 앱 서버 README의 해당 설명을 기준으로 삼아야 한다.

긴 대화의 압축과 입력 복구도 확인한다

자동 컨텍스트 압축은 실패한 응답에서 유지된 출력과 토큰 사용량 데이터가 없는 응답까지 계산에 반영하도록 수정됐다. 긴 대화를 운영한다면 성공한 응답만 이어지는 경우 외에 실패한 응답이 남아 있는 작업도 압축 확인 대상으로 삼을 이유가 있다. 다만 이 수정만으로 특정 길이에서 압축이 발생한다거나 정해진 토큰 수를 절약한다고 말할 수는 없다.

입력 편집에서는 텍스트를 삭제한 결과 맨 앞에 !가 드러나더라도 일반 초안이 채팅 모드를 유지하도록 수정됐다. 초안을 정리하는 과정에서 해당 상황을 겪었다면, 같은 편집 동작 후에도 일반 채팅 초안으로 남는지 확인한다.

업데이트 검증은 실제 사용하는 동선에 맞춰 끝낼 수 있다. 백엔드를 자주 바꾸는 환경은 초안 보존과 저장된 대화의 복구 경로를, Vertex AI를 도입하는 환경은 인증 경로와 프록시 선택을, 승인 요청이 겹치는 환경은 프롬프트 직렬화와 요청 종료 처리를 확인한다. 여기에 prompt-user 명령의 새 사람 승인 지점을 명시하면, 작업을 이어가는 편의 기능과 실행을 통제하는 승인 절차를 각각 운영에 반영할 수 있다.

Codex CLI에이전트 운영Vertex AI네트워크 승인터미널