Codex CLI 0.169.0: CI의 프로젝트 신뢰와 --trust 적용 기준

Codex CLI 0.169.0의 비신뢰 디렉터리 정책을 기준으로 CI와 스크립트의 신뢰 설정을 점검하고 터미널 작업 기능을 적용한다.

2026-11-19

CI에서 먼저 확인할 것은 프로젝트 신뢰다

비신뢰 디렉터리에서 실행한 codex exec는 --sandbox workspace-write를 지정해도 프로젝트 설정과 MCP 서버를 비활성 상태로 유지한다. CI나 스크립트에서 이 옵션을 사용하고 있다면, 옵션의 존재만으로 프로젝트 설정과 MCP 서버가 사용될 것이라고 전제해서는 안 된다.

기준 릴리스는 **openai/codex rust-v0.169.0 (2026-11-13)**이다. 공식 릴리스노트는 이 동작을 버그 수정으로 명시하고, codex exec와 codex review의 --trust를 프로젝트 신뢰를 명시적으로 저장하는 방법으로 제시한다.

실무에서는 샌드박스 옵션을 검토하는 일과 프로젝트 신뢰를 결정하는 일을 구분해야 한다. 프로젝트 설정이나 MCP 서버에 의존하는 자동화라면, 실행 디렉터리가 신뢰된 상태인지부터 점검할 필요가 있다.

아래 그림은 비신뢰 디렉터리라는 조건에서 샌드박스 옵션과 프로젝트 설정·MCP 서버의 관계를 보여 준다.

⤢✕지정함지정하지 않음지정함지정하지 않음비신뢰 디렉터리에서 codexexec 실행--sandbox workspace-write지정프로젝트 설정 비활성MCP 서버 비활성

--trust는 프로젝트 신뢰를 저장하는 선택이다

--sandbox workspace-write가 있는 실행과 --trust가 있는 실행은 같은 의미가 아니다. 전자는 릴리스노트가 비신뢰 디렉터리 정책을 설명할 때 명시한 샌드박스 옵션이고, 후자는 프로젝트 신뢰를 명시적으로 저장하는 플래그다.

릴리스노트에 나온 명령과 옵션의 조합은 다음과 같다.

codex exec --sandbox workspace-write

codex exec --trust
codex review --trust

기존 CI나 스크립트를 점검할 때는 --trust를 모든 실행에 일괄 추가하기보다, 해당 프로젝트를 신뢰 대상으로 저장하려는지 먼저 결정한다. 프로젝트 설정과 MCP 서버를 사용하는 것이 작업의 전제라면 그 신뢰 결정을 실행 구성에 명시한다. 비신뢰 디렉터리로 실행하려는 경우에는 프로젝트 설정과 MCP 서버가 비활성인 조건을 작업의 전제로 삼는다.

점검 대상 릴리스에서 명시한 동작 실행 구성에서 확인할 내용
비신뢰 디렉터리의 codex exec 프로젝트 설정과 MCP 서버 비활성 작업이 해당 구성에 의존하는가
--sandbox workspace-write 비신뢰 디렉터리의 비활성 정책 유지 샌드박스 옵션을 신뢰 지정으로 간주하고 있는가
codex exec --trust 프로젝트 신뢰 명시 저장 이 프로젝트의 신뢰를 저장하려는가
codex review --trust 프로젝트 신뢰 명시 저장 리뷰 실행에서도 신뢰를 저장하려는가

자동화에서 프로젝트 설정이나 MCP 서버가 적용되지 않는 상황을 만났다면, 신뢰 상태는 확인할 조건이다. 샌드박스 옵션만 바꾸는 대응으로는 위 정책을 해결할 수 없다.

다음 비교는 실행 옵션을 검토할 때 구분해야 할 샌드박스 지정과 신뢰 저장의 의미를 나란히 놓는다.

⤢✕ 샌드박스 지정과 프로젝트 신뢰 저장 Codex CLI 0.169.0 — 명령·옵션과 릴리스가 명시한 동작 비교 비교 축 명령·옵션 릴리스가 명시한 동작 샌드박스 지정 codex exec --sandbox workspace-write 비신뢰 디렉터리에서 프로젝트 설정 비활성 비신뢰 디렉터리에서 MCP 서버 비활성 VS 프로젝트 신뢰 저장 codex exec --trust codex review --trust 프로젝트 신뢰 명시 저장 Codex CLI 0.169.0

커스텀 프로바이더 설정은 터미널에서 처리한다

커스텀 모델 프로바이더를 사용하는 환경이라면 터미널에서 프로바이더를 추가하거나 편집할 수 있다. 프로바이더 설정을 바꿀 일이 있을 때 사용할 수 있는 작업 경로다.

로그인 중 프로바이더 생성과 device code 인증에는 조건이 붙는다. 커스텀 게이트웨이 온보딩이 활성화되어 있으면 로그인 과정에서 프로바이더를 생성할 수 있다. SSH로 접속했거나 로컬 브라우저가 없는 환경에서는 지원되는 게이트웨이에 대해 device code를 사용할 수 있다.

따라서 원격 환경의 인증 절차를 정할 때는 다음 조건을 구분해서 확인한다.

  • 터미널에서 기존 프로바이더를 편집하려는지, 로그인 중 새 프로바이더를 생성하려는지 확인한다.
  • 로그인 중 생성이 필요하면 커스텀 게이트웨이 온보딩의 활성화 여부를 확인한다.
  • device code 인증을 사용할 때는 대상 게이트웨이가 이를 지원하는지 확인한다.

앱 서버 클라이언트를 구현하는 쪽에는 별도의 문서 변경도 있다. 설정된 프로바이더에 대해 기본 프로바이더를 변경하지 않고 모델을 나열하거나 게이트웨이를 인증하는 방법이 문서화됐다. 기본 프로바이더 변경이 필요 없는 작업인지 검토할 때 참고할 변경이다.

대화 분리와 작업 재탐색을 구분해 활용한다

선택적으로 활성화하는 터미널 워크스페이스는 여러 side-chat 탭을 지원한다. 키보드나 마우스로 탭을 전환할 수 있고, Codex를 다시 시작한 뒤 저장된 로컬 side chat을 다시 열 수 있다. 작업 중 대화를 나눠 진행하고 재시작 후에도 저장된 대화를 이어서 확인하려는 경우에 해당한다.

이미 진행했던 작업을 찾는 목적이라면 에이전트 커맨드 센터의 검색을 사용한다. 검색 기준은 작업 이름, 프롬프트 미리보기, 작업 디렉터리다. 작업 이름이 기억나지 않더라도 프롬프트 내용이나 디렉터리를 기준으로 찾을 수 있다.

대화 자체가 길어져 읽기 어려운 경우에는 전체 화면 대화 기록의 Collapse turn details를 켠다. 완료된 활동은 각 프롬프트 아래로 접히지만 답변은 계속 보이고 도구 출력도 검색할 수 있다. 답변을 읽는 일과 실행 세부 내용을 찾아보는 일을 함께 지원하는 표시 방식이다.

작업 상황 사용할 기능 적용 범위와 조건
여러 대화를 오가며 작업 side-chat 탭 선택적으로 활성화하는 터미널 워크스페이스
재시작 후 저장된 대화 확인 로컬 side chat 다시 열기 저장된 로컬 side chat
이전 작업 찾기 에이전트 커맨드 센터 검색 이름·프롬프트 미리보기·작업 디렉터리
긴 기록에서 답변 확인 Collapse turn details 전체 화면 대화 기록, 도구 출력 검색 유지

Cloud 대화를 터미널에서 다루는 기능도 추가됐다. macOS와 Linux에서 선택적으로 활성화하는 Cloud 연결을 사용하면 이미지를 보내고, 모델과 추론 강도를 선택하고, Cloud 대화를 보관하거나 복원할 수 있다. 로컬 side chat의 재열기와 Cloud 대화의 보관·복원은 적용 대상이 다르므로 구분해서 사용한다.

MCP 대기와 진단 파일은 별도로 점검한다

MCP 관련 문제를 확인할 때는 비신뢰 디렉터리 정책과 대기 상태 수정을 구분해야 한다. 이번 릴리스는 공유 앱 서버가 보고하지 않은 MCP 서버를 기다리느라 터미널이 계속 바쁜 상태로 남는 문제도 수정했다. 이는 앞서 설명한 프로젝트 신뢰 정책과 별도로 명시된 수정이다.

따라서 프로젝트 설정과 MCP 서버의 사용 여부를 확인하는 상황에서는 신뢰 상태를 살피고, 터미널이 MCP 서버를 기다리며 바쁜 상태에 머무는 상황에서는 공유 앱 서버가 보고하지 않은 서버에 대한 대기 문제에 해당하는지 확인한다.

문제 보고용 자료가 필요하면 터미널 보고서 편집기에서 Ctrl+S를 누른다. 업로드가 비활성화되어 있어도 진단 ZIP을 로컬에 저장할 수 있다. 업로드 설정과 로컬 진단 파일 저장을 별도로 다룰 수 있는 기능이다.

아래 분기는 MCP와 관련해 확인하려는 현상에 따라 점검 대상을 나눈 것이다.

⤢✕프로젝트 설정·MCP 서버비활성터미널이 계속 바쁜 상태MCP 관련 현상 점검확인하려는 현상비신뢰 디렉터리 여부 확인프로젝트 신뢰 저장 여부 결정공유 앱 서버가 보고하지 않은MCP 서버 대기 문제 확인

업그레이드 검증은 실제 사용 경로에 맞춘다

릴리스 전체를 같은 비중으로 점검할 필요는 없다. codex exec를 자동화에 쓰는 환경에서는 프로젝트 신뢰 정책이 우선이고, 아래 수정은 해당 기능을 사용하는 환경의 검증 대상으로 잡으면 된다.

사용 경로 수정된 동작 확인할 상황
승인한 계획을 새 세션에 전달 전체 승인 계획 전달, 전달 실패 시 현재 세션 유지 Yes, clear context and implement 사용
Windows 샌드박스 따옴표로 감싼 cmd.exe 경로 처리 수정 해당 경로 형식 사용
PowerShell 작업 디렉터리의 상위 디렉터리를 읽을 수 없는 경우 처리 수정 상위 디렉터리 읽기가 불가능한 환경
macOS 이미지 붙여넣기 의도한 방향 유지, 사용 가능하면 네이티브 PNG·JPEG 클립보드 데이터 사용 이미지 입력 사용
턴 중단·승인 취소 중단된 턴 정리, 지연된 중단이나 파일 승인 취소가 이후 턴을 중단하는 문제 수정 중단 후 다음 턴 진행

유지보수 변경으로는 WAL 수정을 반영하기 위해 번들 SQLite가 3.54로 갱신됐다. 플러그인 마켓플레이스 업그레이드는 디스크에 이미 있는 Git 객체를 재사용해 반복 다운로드를 줄일 수 있게 됐다.

CI 적용의 완료 기준은 플래그를 추가했는지가 아니라 실행 전제가 명확해졌는지다. 프로젝트를 신뢰 대상으로 저장할지 결정하고, 비신뢰 실행에서는 프로젝트 설정과 MCP 서버가 비활성이라는 조건을 반영한다. 그 뒤 실제로 사용하는 인증·대화·중단 경로를 검증하면 된다.

Codex CLICI프로젝트 신뢰MCP터미널