> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Acquisizione sessioni Codex

> Registra le sessioni locali di OpenAI Codex del tuo team in AgentEye come sessioni ed eventi ordinari — senza modificare come eseguono Codex.

I tuoi ingegneri eseguono già OpenAI Codex ogni giorno. L'acquisizione sessioni Codex porta quelle sessioni di codifica in AgentEye come sessioni ed eventi ordinari, così puoi cercarle, riprodurle e valutarle insieme a tutto il resto che osservi. Completa l'[SDK Python](/it/agenteye/python-sdk): l'SDK strumenta gli agenti che scrivi, mentre questo acquisisce il lavoro Codex che il tuo team già svolge — senza alcuna modifica a come lo eseguono.

Un piccolo raccoglitore in background legge i trascritti delle sessioni locali di Codex mentre vengono scritti e li invia ad AgentEye. Un raccoglitore per macchina acquisisce tutte le superfici Codex locali contemporaneamente — non è necessaria alcuna configurazione per superficie.

Lo stesso raccoglitore acquisisce anche altri agenti — vedi [OpenClaw](/it/agenteye/openclaw-capture) e [Hermes](/it/agenteye/hermes-capture). Abilita quelli che esegui; un singolo raccoglitore può acquisirne diversi contemporaneamente.

***

## Cosa acquisisce

Ogni superficie Codex che viene eseguita **localmente** produce gli stessi trascritti di sessione su disco, e il raccoglitore li raccoglie tutti:

* il **CLI** di Codex e `codex exec`
* l'**estensione VS Code / IDE**
* l'**app desktop**, quando esegue una sessione localmente

Ogni sessione Codex diventa una [sessione](/it/agenteye/sessions) di AgentEye; i suoi messaggi utente e assistente, il ragionamento, le chiamate ai tool, i risultati dei tool e l'utilizzo dei token diventano gli [eventi](/it/agenteye/event-stream) corrispondenti. Viene registrata la superficie da cui proviene ogni sessione (CLI, IDE o desktop), così puoi distinguerle.

> **Le sessioni cloud non vengono acquisite.** L'app desktop esegue sempre più sessioni nel cloud Codex e mantiene solo i loro metadati sulla macchina — non c'è alcun trascritto locale da leggere. Solo le sessioni eseguite localmente vengono acquisite.

***

## Attivala

L'acquisizione è disattivata fino a quando non la abiliti. Installa il raccoglitore con una chiave API che dispone dell'autorizzazione `events:add` (vedi [Chiavi API](/it/agenteye/api-keys)) e attiva l'acquisizione Codex:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \
  | sh -s -- --key <YOUR_API_KEY> --codex-enabled
```

Questo installa il raccoglitore, lo registra come servizio in background e avvia l'acquisizione. Conferma che è in esecuzione:

```bash theme={null}
agenteye-collector health
```

Al primo avvio, le tue sessioni Codex esistenti vengono acquisite una volta e la nuova attività viene trasmessa entro pochi secondi. I file di Codex vengono solo letti — mai modificati, spostati o eliminati — e ogni sessione viene inviata esattamente una volta, anche dopo i riavvii.

***

## Dove appare

Le sessioni acquisite vengono visualizzate in **Sessions** e i loro eventi nel flusso **Events**, come qualsiasi altro agente che osservi — quindi la [riproduzione sessione](/it/agenteye/sessions), la [ricerca](/it/agenteye/queries), le [valutazioni](/it/agenteye/evaluations) e gli [avvisi](/it/agenteye/alerts) funzionano tutti su di esse. Filtra per l'agente Codex per vederle da sole.

***

## Privacy

I trascritti Codex contengono la sessione completa — incluso l'output dei comandi, i contenuti dei file e tutto ciò che Codex ha letto o scritto — e possono contenere segreti. Le sessioni acquisite vengono inviate così come sono, quindi abilita l'acquisizione solo su macchine e per team dove centralizzare quel contenuto in AgentEye è appropriato, e fornisci al raccoglitore una chiave limitata a `events:add` solamente. Vedi [Sicurezza](/it/agenteye/security) per scoprire come i tuoi dati vengono mantenuti isolati.
