코딩 에이전트 업데이트 점검: Codex와 Claude Code의 적용 조건

코딩 에이전트를 업데이트할 때는 버전 번호와 함께 내 환경에서 기능이 제공되는 조건, 자동으로 실행되는 도구의 범위를 확인해야 한다. 릴리스에 새 도구가 적혀 있어도 모든 프로젝트에 나타나는 것은 아니고, 서브에이전트 설정 하나가 다른 에이전트까지 바꾸는 것도 아니다.

이 글은 한국시간 2026년 10월 12일 확인한 공식 릴리스 노트의 해설이다. 설치 후 재현 실험이나 성능 측정을 수행한 후기는 아니며, 뒤의 확인 순서는 자료를 바탕으로 제안하는 운영 방법이다. 같은 날 정리한 다른 소식은 10월 12일 AI 테크 브리핑에서 볼 수 있다.

안정 버전과 새 기능이 들어온 버전을 나누어 기록하자

이번에 확인한 Codex CLI의 안정 릴리스는 0.162.1, Claude Code는 2.1.296이다. Codex의 0.163.0-alpha.5도 공개돼 있지만 명시적인 프리릴리스다. 버전 숫자만 비교해 업데이트 대상을 정하면 안정 채널과 시험 채널을 섞게 된다.

확인한 릴리스	구분	이번 글에서 확인할 변화
Codex CLI 0.162.0	공식 변경 로그 10월 8일	조건을 충족하는 프로젝트에 관리형 worktree 도구 추가
Codex CLI 0.162.1	10월 12일 확인 시 안정 릴리스	여러 줄 비동기 질문의 TUI 충돌과 서버 설정 차이에 따른 시작 실패 수정
Codex CLI 0.163.0-alpha.5	프리릴리스	안정 릴리스와 구분해 검토
Claude Code 2.1.296	10월 12일 확인 시 안정 릴리스	workflow agent 설정과 MCP·로그 관련 동작 수정

OpenAI 공식 변경 로그는 0.162.1을 10월 9일 항목으로 정리한다. 관리형 worktree 추가는 앞선 0.162.0의 변화다. 두 버전을 묶어 읽더라도 기능 도입과 수정 버전을 나눠 기록해 두면 이후 문제를 비교하기 쉽다.

Codex worktree는 생성 조건과 실제 작업 경로를 확인한다

구현을 설명한 공식 PR에 따르면 관리형 worktree 도구를 사용하려면 세 조건이 필요하다.

worktrees 기능이 활성화돼 있어야 한다.
신뢰할 수 있는 로컬 프로젝트여야 한다.
작업과 checkout의 연결 정보를 보관하는 attachment storage를 사용할 수 있어야 한다.

이 조건에서 생성·진행 상태 조회·목록 도구가 노출된다. ref를 지정하지 않으면 원격 기본 브랜치를 기준으로 만들며, 생성은 비동기로 진행된다. 새 checkout을 만드는 동안 현재 작업 디렉터리와 실행 환경은 바뀌지 않고, 원래 checkout의 미커밋 변경도 그대로 남는다.

따라서 작업을 분리하려는 팀은 도구가 보이는지부터 확인하고, 생성 완료 뒤 반환된 경로와 기준 브랜치를 읽는 순서가 적절하다. 원래 디렉터리에서 계속 작업하면서 분리가 끝났다고 판단하거나, 미커밋 파일도 새 checkout에 따라갔다고 가정해서는 안 된다. 이 글에서는 확인하지 않은 feature flag 활성화 명령을 제시하지 않는다.

CLI와 백그라운드 서버를 함께 쓰는 환경에서는 별도의 확인이 필요하다. 0.162.1 릴리스는 서버의 기능 설정과 CLI 기본값 차이로 발생하던 시작 실패를 수정했으며, 호환성 검사를 명시적인 명령행 기능 override에만 적용한다고 설명한다. 문제가 있었다면 업데이트 전후에 같은 실행 옵션으로 시작되는지 비교할 수 있다.

Claude의 모델 설정은 workflow agent에 적용된다

Claude Code 2.1.296 릴리스의 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL은 workflow agent의 모델을 통일하는 설정이다. 다른 subagent는 각자의 모델을 유지한다. 팀 전체 모델을 일괄 변경하는 기능으로 해석하면 기대와 실제 설정이 달라질 수 있다.

같은 릴리스의 autoCompactWindow는 subagent frontmatter와 --agents 정의에 추가됐다. 주 대화의 컨텍스트 창보다 이른 시점에 subagent가 자동 압축하도록 할 수 있다. 이번에 확인한 공개 문서에서는 값의 단위와 범위를 확정하지 못해 설정 코드 예시는 생략했다.

운영할 때는 workflow agent와 별도로 정의한 subagent를 나누어 현재 모델을 기록해 두는 편이 좋다. 압축 설정을 바꾼다면 작업에 필요한 지시와 결과가 이어지는지 별도로 관찰하자. 모델 지정이나 압축 옵션의 존재만으로 요금 할인·품질 개선을 약속할 수는 없다.

headless 세션과 공유 로그는 실행 조건을 맞춰 살핀다

2.1.296의 수정 목록에는 폴더 이동이나 플러그인 재로드 뒤 headless 세션이 해당 폴더에서 꺼둔 .mcp.json 또는 플러그인 MCP 서버를 시작하던 문제가 포함된다. 공유 transcript와 debug log에서 값이 없는 키 뒤에 오는 일부 secret 값의 마스킹을 놓치던 문제도 수정했다. 셸 문자열에 담긴 JSON이 포함된 경우도 해당한다.

이를 확인하려면 평소 쓰는 실행 형태를 재현해야 한다. 대화형 세션만 확인하고 끝내기보다, headless 작업에서 폴더별 비활성 서버 목록이 유지되는지 살피는 편이 수정 내용과 맞는다. 로그를 검토할 때는 실제 인증정보를 시험 입력으로 사용하지 않고 가짜 값으로 필요한 마스킹을 확인하자. 특정 누락 수정이 모든 로그의 안전성을 보장하는 것은 아니다.

자동 시작 제어와 접근 권한의 차이는 10월 11일 브리핑의 개발 환경 점검에서도 다뤘다. 설치 스크립트, 서버 자동 시작, 도구의 읽기·쓰기 권한은 서로 다른 경계이므로 한 항목의 수정으로 나머지까지 확인됐다고 판단하지 않는 것이 좋다.

설치 후 확인할 항목은 쓰는 환경에 맞춰 고른다

다음은 이 글에서 제안하는 점검표다. 공식 필수 절차나 직접 수행한 테스트 결과는 아니며, 사용하지 않는 기능까지 시험할 필요는 없다.

사용하는 환경	업데이트 전에 남길 기록	설치 후 확인할 결과
Codex CLI와 백그라운드 서버	실행 버전, 명시적인 기능 옵션	같은 옵션으로 시작되고 여러 줄 질문이 표시되는가
관리형 worktree	원격 기본 브랜치, 미커밋 변경, 도구 제공 상태	생성 완료 경로와 실제 작업 경로가 일치하는가
Claude workflow와 custom subagent	각 agent의 모델과 작업 목적	바꾸려던 agent에만 모델 선택이 적용되는가
headless 작업과 MCP	폴더별 비활성 서버·플러그인 목록	폴더 이동·재로드 뒤에도 실행 범위가 유지되는가
공유 transcript·debug log	공유 경로, 보관 정책, 테스트용 가짜 값	필요한 값이 가려지고 불필요한 로그 공유가 없는가

버전만 적는 것보다 실행 조건과 관찰 결과를 함께 남기면 다음 업데이트 때 비교할 근거가 생긴다. 테스트 결과를 어떻게 해석하고 권한 경계를 나눌지는 AI 코드 생성 이후의 백엔드 검증에서 이어서 볼 수 있다.

참고 자료

ChatGPT·Codex 공식 변경 로그 — OpenAI, 0.162.0 항목 2026-10-08·0.162.1 항목 2026-10-09, 확인일 2026-10-12
Codex CLI 0.162.0 릴리스 — OpenAI, 확인일 2026-10-12
Codex CLI 0.162.1 릴리스 — OpenAI, 확인일 2026-10-12
Codex CLI 0.163.0-alpha.5 릴리스 — OpenAI, 프리릴리스, 확인일 2026-10-12
Add managed worktree tools to the TUI, PR #50148 — OpenAI, 병합일 2026-10-02
Claude Code 2.1.296 릴리스 — Anthropic, 확인일 2026-10-12
Create custom subagents — Anthropic, 확인일 2026-10-12