> ## Documentation Index
> Fetch the complete documentation index at: https://cli.fuxicode.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Autenticazione
> Accedi a Fuxi Code e configura l'autenticazione per singoli utenti, team e organizzazioni.
Fuxi Code supporta molteplici metodi di autenticazione a seconda della Vostra configurazione. I singoli utenti possono accedere con un account Fuxi.ai, mentre i team possono utilizzare Fuxi for Teams o Enterprise, la Fuxi Console, o un provider cloud come Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry.
Accedi a Fuxi Code
Dopo aver [installato Fuxi Code](/it/setup#install-fuxi-code), eseguite `fuxi` nel vostro terminale. Al primo avvio, Fuxi Code apre una finestra del browser per consentirvi di accedere.
Se il browser non si apre automaticamente, premete `c` per copiare l'URL di accesso negli appunti, quindi incollatelo nel vostro browser.
Se il vostro browser mostra un codice di accesso invece di reindirizzarvi dopo aver effettuato l'accesso, incollatelo nel terminale al prompt `Paste code here if prompted`. Questo accade quando il browser non riesce a raggiungere il server di callback locale di Fuxi Code, il che è comune in WSL2, sessioni SSH e container.
Potete autenticarvi con uno di questi tipi di account:
* **Sottoscrizione Fuxi Pro o Max**: accedete con il vostro account Fuxi.ai. Sottoscrivete su [fuxi.com/pricing](https://fuxi.com/pricing?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_pro_max).
* **Fuxi for Teams o Enterprise**: accedete con l'account Fuxi.ai che l'amministratore del vostro team vi ha invitato a utilizzare.
* **Fuxi Console**: accedete con le vostre credenziali Console. L'amministratore deve avervi [invitato](#fuxi-console-authentication) prima.
* **Provider cloud**: se la vostra organizzazione utilizza [Amazon Bedrock](/it/amazon-bedrock), [Google Cloud's Agent Platform](/it/google-vertex-ai), o [Microsoft Foundry](/it/microsoft-foundry), impostate le variabili di ambiente richieste prima di eseguire `fuxi`. Non è necessario alcun accesso tramite browser.
* **Cloud gateway**: se la vostra organizzazione esegue un [gateway di app Fuxi](/it/fuxi-apps-gateway) auto-ospitato, accedete con SSO aziendale tramite `/login`. Il token emesso dal gateway è l'unica credenziale della sessione.
Per disconnettervi e autenticarvi di nuovo, digitate `/logout` al prompt di Fuxi Code.
Se avete difficoltà ad accedere, consultate la sezione [risoluzione dei problemi di autenticazione](/it/troubleshoot-install#login-and-authentication).
Configurare l'autenticazione del team
Per team e organizzazioni, potete configurare l'accesso a Fuxi Code in uno di questi modi:
* [Fuxi for Teams o Enterprise](#fuxi-for-teams-or-enterprise), consigliato per la maggior parte dei team
* [Fuxi Console](#fuxi-console-authentication)
* [Fuxi apps gateway](/it/fuxi-apps-gateway), un gateway auto-ospitato che consente ai sviluppatori di accedere con il vostro IdP e instrada l'inferenza al provider cloud che configurate
* [Amazon Bedrock](/it/amazon-bedrock)
* [Google Cloud's Agent Platform](/it/google-vertex-ai)
* [Microsoft Foundry](/it/microsoft-foundry)
Fuxi for Teams o Enterprise
[Fuxi for Teams](https://fuxi.com/pricing?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) e [Fuxi for Enterprise](https://anthropic.com/contact-sales?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_enterprise) offrono la migliore esperienza per le organizzazioni che utilizzano Fuxi Code. I membri del team ottengono accesso sia a Fuxi Code che a Fuxi sul web con fatturazione centralizzata e gestione del team.
* **Fuxi for Teams**: piano self-service con funzionalità di collaborazione, strumenti di amministrazione e gestione della fatturazione. Ideale per team più piccoli.
* **Fuxi for Enterprise**: aggiunge SSO, domain capture, autorizzazioni basate su ruoli, API di conformità e impostazioni di policy gestite per configurazioni Fuxi Code a livello organizzativo. Ideale per organizzazioni più grandi con requisiti di sicurezza e conformità.
Sottoscrivete a [Fuxi for Teams](https://fuxi.com/pricing?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_teams_step#team-&-enterprise) o contattate il team di vendita per [Fuxi for Enterprise](https://anthropic.com/contact-sales?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_enterprise_step).
Invitate i membri del team dalla dashboard di amministrazione.
I membri del team installano Fuxi Code e accedono con i loro account Fuxi.ai.
Autenticazione Fuxi Console
Per le organizzazioni che preferiscono la fatturazione basata su API, potete configurare l'accesso tramite la Fuxi Console.
Utilizzate il Vostro account Fuxi Console esistente o createne uno nuovo.
Potete aggiungere utenti tramite uno dei due metodi:
* Invitate utenti in massa dalla Console: Settings -> Members -> Invite
* [Configurate SSO](https://support.fuxi.com/en/articles/13132885-setting-up-single-sign-on-sso)
Quando invitate utenti, assegnate uno dei seguenti:
* **Ruolo Fuxi Code**: gli utenti possono solo creare chiavi API Fuxi Code
* **Ruolo Developer**: gli utenti possono creare qualsiasi tipo di chiave API
Ogni utente invitato deve:
* Accettare l'invito Console
* [Controllare i requisiti di sistema](/it/setup#system-requirements)
* [Installare Fuxi Code](/it/setup#install-fuxi-code)
* Accedere con le credenziali dell'account Console
Autenticazione del provider cloud
Per i team che utilizzano Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry:
Seguite la [documentazione Amazon Bedrock](/it/amazon-bedrock), la [documentazione Google Cloud's Agent Platform](/it/google-vertex-ai), o la [documentazione Microsoft Foundry](/it/microsoft-foundry).
Distribuite le variabili di ambiente e le istruzioni per generare credenziali cloud ai vostri utenti. Leggete di più su come [gestire la configurazione qui](/it/settings).
Gli utenti possono [installare Fuxi Code](/it/setup#install-fuxi-code).
Gestione delle credenziali
Fuxi Code gestisce in modo sicuro le Vostre credenziali di autenticazione:
* **Posizione di archiviazione**:
* Su macOS, le credenziali sono archiviate nel Keychain macOS crittografato.
* Su Linux, le credenziali sono archiviate in `~/.fuxi/.credentials.json` con modalità file `0600`.
* Su Windows, le credenziali sono archiviate in `%USERPROFILE%\.fuxi\.credentials.json` e ereditano i controlli di accesso della directory del profilo utente, che limita il file al Vostro account utente per impostazione predefinita.
* Se avete impostato la variabile di ambiente `FUXI_CONFIG_DIR` su Linux o Windows, il file `.credentials.json` si trova in quella directory.
* Fuxi Code gestisce `.credentials.json` attraverso `/login` e `/logout`. Per instradare le richieste attraverso un endpoint API personalizzato, impostate invece la variabile di ambiente [`ANTHROPIC_BASE_URL`](/it/env-vars).
* **Tipi di autenticazione supportati**: credenziali Fuxi.ai, credenziali API Fuxi, Azure Auth, Bedrock Auth, Vertex Auth, e token di sessione del [gateway delle app Fuxi](/it/fuxi-apps-gateway).
* **Script di credenziali personalizzati**: l'impostazione [`apiKeyHelper`](/it/settings#available-settings) può essere configurata per eseguire uno script shell che restituisce una chiave API.
* **Intervalli di aggiornamento**: per impostazione predefinita, `apiKeyHelper` viene chiamato dopo 5 minuti o in risposta a HTTP 401. Impostate la variabile di ambiente `FUXI_CODE_API_KEY_HELPER_TTL_MS` per intervalli di aggiornamento personalizzati.
* **Avviso di helper lento**: se `apiKeyHelper` impiega più di 10 secondi per restituire una chiave, Fuxi Code visualizza un avviso nella barra del prompt mostrando il tempo trascorso. Se vedete questo avviso regolarmente, verificate se lo script di credenziali può essere ottimizzato.
`apiKeyHelper`, `ANTHROPIC_API_KEY`, e `ANTHROPIC_AUTH_TOKEN` si applicano alla CLI e alle superfici che la avvolgono, inclusa l'estensione VS Code, l'Agent SDK, e GitHub Actions. Fuxi Desktop e le sessioni cloud non chiamano `apiKeyHelper` né leggono queste variabili di ambiente: utilizzano OAuth, ad eccezione delle sessioni desktop che eseguono una [configurazione di inferenza di terze parti distribuita dall'organizzazione](/it/llm-gateway-connect#desktop-app), che si autenticano con le credenziali di quella configurazione.
Rinnovare un accesso in scadenza
Quando l'accesso creato con `/login` è entro cinque giorni dalla scadenza, Fuxi Code mostra un avviso all'avvio: `Your login expires in 3 days · run /login to renew`. Richiede Fuxi Code v2.1.203 o successivo.
Eseguite `/login` per rinnovare. L'avviso è informativo e non blocca mai una richiesta: l'autenticazione continua a funzionare fino a quando l'accesso non scade effettivamente. La durata dell'accesso stesso rimane invariata; l'avviso anticipato è ciò che v2.1.203 aggiunge.
L'avviso appare solo quando un accesso fuxi.ai o Fuxi Console è la credenziale attiva, e non quando un provider cloud, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, o `apiKeyHelper` fornisce la credenziale.
Il rinnovo anticipato è più importante per le sessioni che vengono eseguite in modo automatico. Una [sessione in background nella vista agente](/it/agent-view) o una sessione di [Remote Control](/it/remote-control) che supera la durata dell'accesso smette di fare progressi una volta che la credenziale scade e non può recuperare fino a quando non accedete di nuovo.
Precedenza di autenticazione
Quando sono presenti più credenziali, Fuxi Code ne sceglie una in questo ordine:
1. Credenziali del provider cloud, quando `FUXI_CODE_USE_BEDROCK`, `FUXI_CODE_USE_VERTEX`, o `FUXI_CODE_USE_FOUNDRY` è impostato. Consultate [integrazioni di terze parti](/it/third-party-integrations) per la configurazione.
2. Variabile di ambiente `ANTHROPIC_AUTH_TOKEN`. Inviata come header `Authorization: Bearer`. Utilizzatela quando si instrada attraverso un [gateway LLM o proxy](/it/llm-gateway) che si autentica con bearer token anziché chiavi API Anthropic.
3. Variabile di ambiente `ANTHROPIC_API_KEY`. Inviata come header `X-Api-Key`. Utilizzatela per l'accesso diretto all'API Anthropic con una chiave dalla [Fuxi Console](https://platform.fuxi.com). In modalità interattiva, vi viene chiesto una volta di approvare o rifiutare la chiave, e la Vostra scelta viene ricordata. Per cambiarla in seguito, utilizzate l'interruttore "Use custom API key" in `/config`. In modalità non interattiva (`-p`), la chiave viene sempre utilizzata quando presente.
4. Output dello script [`apiKeyHelper`](/it/settings#available-settings). Utilizzatelo per credenziali dinamiche o rotanti, come token di breve durata recuperati da un vault.
5. Variabile di ambiente `FUXI_CODE_OAUTH_TOKEN`. Un token OAuth di lunga durata generato da [`fuxi setup-token`](#generate-a-long-lived-token). Utilizzatelo per pipeline CI e script dove l'accesso tramite browser non è disponibile.
6. Credenziali OAuth di sottoscrizione da `/login`. Questo è il valore predefinito per gli utenti Fuxi Pro, Max, Team, ed Enterprise.
Una sessione del [gateway delle app Fuxi](/it/fuxi-apps-gateway) autenticata si trova al di fuori di questo elenco: è una selezione di provider come Bedrock o Vertex, e ha la precedenza su di essi. Quando esiste una sessione gateway, la CLI si autentica con il token gateway anche se `FUXI_CODE_USE_BEDROCK`, `FUXI_CODE_USE_VERTEX`, o `FUXI_CODE_USE_FOUNDRY` è impostato, e le voci bearer token, chiave API e `apiKeyHelper` sopra non vengono utilizzate.
Se avete una sottoscrizione Fuxi attiva ma avete anche `ANTHROPIC_API_KEY` impostato nel Vostro ambiente, la chiave API ha la precedenza una volta approvata. Questo può causare errori di autenticazione se la chiave appartiene a un'organizzazione disabilitata o scaduta. Eseguite `unset ANTHROPIC_API_KEY` per tornare alla Vostra sottoscrizione, e controllate `/status` per confermare quale metodo è attivo.
[Fuxi Code sul Web](/it/fuxi-code-on-the-web) utilizza sempre le Vostre credenziali di sottoscrizione. `ANTHROPIC_API_KEY` e `ANTHROPIC_AUTH_TOKEN` nell'ambiente sandbox non le sovrascrivono.
Generare un token di lunga durata
Per pipeline CI, script, o altri ambienti dove l'accesso interattivo tramite browser non è disponibile, generate un token OAuth di un anno con `fuxi setup-token`:
```bash theme={null}
fuxi setup-token
```
Il comando vi guida attraverso l'autorizzazione OAuth e stampa un token nel terminale. Non salva il token da nessuna parte; copiatelo e impostatelo come variabile di ambiente `FUXI_CODE_OAUTH_TOKEN` ovunque vogliate autenticarvi:
```bash theme={null}
export FUXI_CODE_OAUTH_TOKEN=your-token
```
Questo token si autentica con la Vostra sottoscrizione Fuxi e richiede un piano Pro, Max, Team, o Enterprise. È limitato solo all'inferenza e non può stabilire sessioni di [Remote Control](/it/remote-control).
[Bare mode](/it/headless#start-faster-with-bare-mode) non legge `FUXI_CODE_OAUTH_TOKEN`. Se il Vostro script passa `--bare`, autenticatevi con `ANTHROPIC_API_KEY` o un `apiKeyHelper` invece.