Codex CLI 0.165.0 도입 점검: Vertex AI와 memory v2 기본값

Codex CLI 0.165.0의 프로바이더 설정과 메모리 기본값, 중단 처리 및 보안 수정 사항을 팀 도입 점검 항목으로 바꿔 적용한다.

2026-11-02

신규 프로필과 기존 환경을 나눠 점검한다

Codex CLI 0.165.0에서는 새로 만든 프로필에 memory v2가 기본으로 켜진다. 기존 환경을 복제해 확인하는 것만으로는 신규 사용자에게 적용되는 기본값을 검증할 수 없다.

이 글의 기준은 **Codex CLI rust-v0.165.0 (2026-10-27)**이다. 공식 릴리스노트에 명시된 변경을 팀의 설정과 동작 점검으로 옮긴다.

점검 환경은 사용 조건에 따라 나눈다. 신규 프로필에서는 메모리 기본값을 확인하고, 지원 모델을 쓰는 대화에서는 reasoning effort 변경을 확인한다. 별도 승인 검토자 설정 없이 시작하는 새 TUI 세션에서는 서버 기본값의 반영을 확인한다. 이 조건들을 섞으면 어떤 변경을 검증했는지 불분명해진다.

아래 그림은 각 기본값의 적용 조건과 확인 대상을 연결한다.

⤢✕도입 점검신규 프로필지원 모델의 대화별도 승인 검토자 설정 없는 새TUI 세션memory v2 기본 활성화대화 중 reasoning effort 변경서버 기본 승인 검토자 반영

팀의 점검표에도 기능 이름 옆에 적용 조건을 적어 두자. 특히 “기본 활성화”라는 표현을 모든 프로필과 모든 모델에 적용되는 약속으로 바꾸지 않아야 한다.

Vertex AI 설정과 모델 오류를 함께 확인한다

Google Cloud Vertex AI를 사용할 팀은 새로 추가된 내장 프로바이더 선택값부터 확인한다. 릴리스노트가 제시한 설정은 다음과 같다.

model_provider = "gcp"

이 설정은 내장 Vertex AI 프로바이더를 선택한다. 인증이나 프로젝트 설정까지 포함하는 완성된 연결 예시는 자료에 없으므로, 위 한 줄만으로 연결 준비가 끝났다고 판단할 근거는 없다. 팀 설정을 검토할 때도 프로바이더 선택과 실제 연결 성공을 별도 항목으로 남겨야 한다.

연결 점검에는 모델 오류 처리도 포함한다. 이번 버전은 프로바이더가 모델을 찾을 수 없다고 응답하면 재시도를 중단하고 그 오류 메시지를 보존한다. 해당 오류가 발생했을 때는 반복 실행에 앞서 보존된 메시지로 지정한 모델을 확인하는 편이 이 변경의 취지에 맞다. 이 수정은 Vertex AI에만 한정된 항목으로 서술되어 있지 않다.

변경 해당 조건 도입 시 확인할 내용
내장 Vertex AI 프로바이더 Vertex AI를 사용할 때 프로바이더 선택값이 gcp인지 확인한다.
GPT-6.1 Terra 카탈로그 추가 모델 목록을 검토할 때 카탈로그 추가와 해당 환경의 사용 가능 여부를 구분한다.
모델 미발견 시 재시도 중단 프로바이더가 모델을 찾지 못했다고 응답할 때 재시도가 멈추고 원래 오류 메시지가 남는지 확인한다.

GPT-6.1 Terra가 모델 카탈로그에 추가되었다는 사실은 모든 프로바이더에서 사용할 수 있다는 뜻까지 담고 있지는 않다. 모델 선택 안내에는 카탈로그에 표시되는 이름과 팀 환경에서 확인한 결과를 구분해 기록하자.

메모리와 추론 설정은 적용 범위를 기록한다

memory v2의 기본 활성화 대상은 신규 프로필이다. 기존 프로필의 자동 전환 여부는 제공된 자료에서 확인할 수 없다. 신규 사용자 온보딩 결과를 기존 사용자의 환경 설명으로 그대로 재사용하지 말아야 하는 이유다.

외부 에이전트의 메모리를 memory v2로 가져오는 기능도 추가됐다. 다른 에이전트에서 사용하던 메모리를 옮길 팀이라면 가져오기 지원을 도입 검토 항목에 넣을 수 있다. 다만 릴리스노트에는 가져오기 명령, 지원 형식, 충돌 처리 방식이 없으므로 이를 전제로 실행 절차를 작성해서는 안 된다.

reasoning effort는 지원 모델에서 대화 중 변경할 수 있도록 기본 활성화됐다. 팀이 대화 도중 추론 설정을 바꾸는 작업 방식을 사용한다면, 검증에 쓴 모델과 변경이 적용된 조건을 함께 기록하자. 자료에는 지원 모델 전체 목록이나 구체적인 조작 명령이 제시되어 있지 않다.

다음 비교는 메모리와 추론 설정에서 릴리스가 명시한 범위와 추가 확인이 필요한 범위를 나눈다.

⤢✕ 기본값 변경의 적용 범위 Codex CLI 0.165.0 항목 릴리스가 명시한 범위 자료로 확인되지 않은 범위 memory v2 외부 에이전트 메모리 가져오기 reasoning effort 신규 프로필에서 기본 활성화 memory v2로 가져오기 지원 지원 모델에서 대화 중 변경 기본 활성화 기존 프로필의 자동 전환 여부 가져오기 명령·지원 형식·충돌 처리 방식 지원 모델 전체 목록·구체적인 조작 명령

설정 문서에는 확인한 범위까지만 적는 편이 낫다. “메모리가 기본으로 켜진다”보다 “신규 프로필에서 memory v2가 기본으로 켜진다”가 정확하고, 다음 사용자가 재현할 조건도 분명하다.

중단 처리는 원격 요청과 대기 메시지를 따로 검증한다

원격 MCP 도구를 사용하는 팀은 로컬 작업의 수명이 끝났을 때 원격 요청도 취소되는지 확인해야 한다. 이번 수정은 로컬 응답 future가 drop될 때 원격 MCP 도구 요청을 취소하도록 바꿨다.

별도로, 대기 중인 에이전트 메시지가 인터럽트나 Plan 모드 전환 뒤에 작업을 다시 시작시키던 문제도 수정됐다. 두 항목은 모두 중단과 관련되지만 확인 대상이 다르다. 하나는 원격 MCP 요청의 취소이고, 다른 하나는 대기 메시지에 의한 작업 재시작 방지다.

아래 그림은 중단 관련 회귀 점검에서 구분해야 할 원인과 결과를 보여 준다.

⤢✕중단 관련 회귀 점검로컬 응답 future drop인터럽트 또는 Plan 모드 전환원격 MCP 도구 요청 취소대기 중인 에이전트 메시지작업 재시작 방지

원격 MCP를 연결한 환경에서는 요청 취소 여부를, 대기 메시지가 있는 환경에서는 인터럽트와 Plan 모드 전환 뒤의 동작을 각각 확인하자. 단순히 화면에서 작업이 멈춘 모습을 본 것만으로 두 수정 사항을 모두 검증했다고 기록하면 확인 범위가 과장된다.

또한 요청 취소를 이미 수행된 작업의 되돌리기로 해석해서는 안 된다. 릴리스노트가 명시한 것은 요청 취소이며, 완료된 외부 작업의 복구 동작은 설명하지 않는다.

마켓플레이스는 검사한 호스트와 접속한 호스트를 맞춘다

마켓플레이스 URL 수정의 핵심은 허용 패턴 검사를 통과한 호스트와 Git이 실제 접속하는 호스트의 불일치다. 기존 검증에는 검사 대상과 다른 호스트로 Git이 접속하도록 허용할 수 있는 틈이 있었고, 이번 버전에서 이를 닫았다.

변경 목록에는 HTTP(S) 마켓플레이스 URL의 userinfo에서 백슬래시를 거부하는 수정이 명시되어 있다. 팀이 마켓플레이스 URL 허용 패턴을 운영한다면, 허용 목록의 내용만 검토할 것이 아니라 URL을 해석한 결과와 Git 접속 대상이 일치하는지도 회귀 점검의 기준으로 삼아야 한다.

점검 기록에는 허용 패턴으로 검사한 호스트, Git 접속 대상, URL 수락 또는 거부 결과를 구분해 남기자. 이 구분이 있어야 단순한 허용 목록 변경과 URL 해석 문제를 혼동하지 않는다. 제공된 자료에는 재현용 URL이 없으므로 구체적인 우회 문자열을 만들어 검증 사례로 제시할 수는 없다.

이 수정은 메모리나 모델 선택과 달리 마켓플레이스 접근 경계에 관한 변경이다. 마켓플레이스를 사용하는 팀이라면 새 기능을 사용하지 않더라도 업그레이드 검증 대상에 포함할 이유가 있다.

TUI와 작업 탐색까지 점검을 마무리한다

새 TUI 세션은 명시적인 재정의가 없을 때 서버의 기본 승인 검토자를 따르도록 수정됐다. 서버 기본값을 사용하는 팀은 별도 재정의 없이 시작한 세션에서 이를 확인해야 한다. 재정의가 있는 환경만 검사하면 이번 수정의 적용 조건을 놓친다.

실행 설정이 잘못된 경우에도 TUI 환경설정을 편집할 수 있고 변경이 즉시 적용되도록 수정됐다. 설정 오류에서 복구하는 흐름을 검증할 때는 오류 표시 여부에 그치지 말고, 그 상태에서 환경설정을 수정하고 적용할 수 있는지까지 확인하자.

연결된 워크트리 사이에서 세션을 오가는 팀에는 탐색 기능도 점검할 가치가 있다. 세션 선택기에 저장소 필터가 추가됐고, 에이전트 명령 센터에는 디렉터리 그룹화가 추가됐다. 저장소 필터와 디렉터리 그룹화는 적용되는 화면이 다르므로 각각 사용해 봐야 한다.

사용 환경 확인할 동작 결과를 기록할 조건
서버 기본 승인 검토자를 쓰는 새 TUI 세션 서버 기본값 반영 명시적인 재정의 없이 시작했는지
실행 설정이 잘못된 TUI 환경설정 편집과 즉시 적용 설정 오류가 있는 상태인지
연결된 워크트리의 세션 선택기 저장소 필터 필터로 세션을 탐색했는지
에이전트 명령 센터 디렉터리 그룹화 디렉터리별로 세션을 구분했는지

app-server API를 직접 사용하는 팀이라면 실험적으로 추가된 attached thread forks도 별도 검토 항목에 넣는다. 릴리스노트가 이를 실험 기능으로 구분하므로, 일반 CLI 도입 검증과 API 실험 결과를 섞어 기록하지 않는 편이 정확하다.

도입 완료 기록에는 버전과 함께 신규 프로필 여부, 사용 모델, 승인 검토자 재정의 여부를 남기자. 여기에 원격 MCP 취소, 대기 메시지의 작업 재시작 방지, 마켓플레이스 호스트 검증 결과를 붙이면 이번 릴리스에서 팀이 실제로 확인한 범위가 드러난다. 릴리스에 기능이 추가됐다는 사실과 우리 환경에서 그 동작을 관찰했다는 사실을 구분하는 것이 설정 점검의 마지막 기준이다.

Codex CLIVertex AIMCP에이전트 메모리개발 도구