Skip to main content
엔지니어들은 이미 매일 OpenAI Codex를 사용하고 있습니다. Codex 세션 캡처는 이러한 코딩 세션을 AgentEye에 일반 세션 및 이벤트로 가져와, 다른 모든 관찰 대상과 함께 검색하고, 재생하며, 평가할 수 있게 해줍니다. 이 기능은 Python SDK를 보완합니다. SDK는 직접 작성한 에이전트를 계측하는 반면, 이 기능은 팀이 이미 사용 중인 Codex 작업을 — 실행 방식의 변경 없이 — 캡처합니다. 소형 백그라운드 수집기가 Codex의 로컬 세션 트랜스크립트를 작성되는 즉시 읽어 AgentEye로 전송합니다. 머신당 하나의 수집기로 모든 로컬 Codex 인터페이스를 한 번에 캡처할 수 있어 인터페이스별 별도 설정이 필요하지 않습니다. 동일한 수집기가 다른 에이전트도 캡처합니다 — OpenClaw 및 Hermes를 참조하세요. 사용 중인 각 에이전트를 활성화하면 하나의 수집기로 여러 에이전트를 동시에 캡처할 수 있습니다.

​
캡처 대상

로컬에서 실행되는 모든 Codex 인터페이스는 동일한 온디스크 세션 트랜스크립트를 생성하며, 수집기가 이를 모두 수집합니다:
  • Codex CLI 및 codex exec
  • VS Code / IDE 확장
  • 데스크톱 앱 (로컬에서 세션을 실행하는 경우)
각 Codex 세션은 AgentEye 세션이 되며, 사용자 및 어시스턴트 메시지, 추론, 도구 호출, 도구 결과, 토큰 사용량이 대응하는 이벤트가 됩니다. 각 세션의 출처(CLI, IDE 또는 데스크톱)도 기록되어 구분할 수 있습니다.
클라우드 세션은 캡처되지 않습니다. 데스크톱 앱은 점점 더 많은 세션을 Codex 클라우드에서 실행하고 메타데이터만 로컬에 보관하므로 읽을 수 있는 로컬 트랜스크립트가 존재하지 않습니다. 로컬에서 실행된 세션만 캡처됩니다.

​
활성화 방법

캡처는 활성화하기 전까지 비활성 상태입니다. events:add 권한이 있는 API 키로 수집기를 설치하고(API keys 참조), Codex 캡처를 활성화하세요:
이 명령은 수집기를 설치하고, 백그라운드 서비스로 등록하며, 캡처를 시작합니다. 실행 중인지 확인하세요:
최초 실행 시 기존 Codex 세션이 한 번 백필되며, 이후 새로운 활동은 수 초 내에 스트리밍됩니다. Codex의 파일은 읽기만 할 뿐 — 수정, 이동, 삭제되지 않으며 — 재시작이 발생하더라도 각 세션은 정확히 한 번만 전송됩니다.

​
확인 위치

캡처된 세션은 Sessions에, 해당 이벤트는 Events 스트림에 표시됩니다. 다른 에이전트와 동일하게 세션 재생, 검색, 평가, 알림이 모두 적용됩니다. Codex 에이전트로 필터링하면 해당 세션만 별도로 볼 수 있습니다.

​
개인정보 보호

Codex 트랜스크립트에는 명령 출력, 파일 내용, Codex가 읽거나 쓴 모든 내용을 포함한 전체 세션이 담겨 있으며, 시크릿 정보가 포함될 수 있습니다. 캡처된 세션은 있는 그대로 전송되므로, AgentEye에 해당 콘텐츠를 중앙 집중화하는 것이 적절한 머신과 팀에서만 캡처를 활성화하고, 수집기에는 events:add만으로 범위가 제한된 키를 사용하세요. 데이터 격리 방법에 대한 자세한 내용은 보안을 참조하세요.