Connettere strumenti esterni all'API Cloud di OpenDesign

Gestisci sul web le chiavi API di OpenDesign e usa i modelli supportati dal piano in un agente esterno. L'app desktop OpenDesign non è necessaria. La configurazione con un clic importa la connessione tramite CC Switch sul computer.

Scegliere la connessione necessaria

Per importare la chiave di un provider in OpenDesign, segui la procedura di configurazione BYOK. Questa guida illustra il percorso inverso: usare l'API dei modelli Cloud di OpenDesign da uno strumento esterno come Claude Code o Codex.

Prima di iniziare

La Cloud API di OpenDesign è disponibile con i piani Go, Plus, Pro e Max. Il piano Free non è supportato. L’elenco dei modelli del tuo account determina quali modelli di testo puoi utilizzare; i modelli mostrati negli screenshot sono esempi e non sono necessariamente inclusi in tutti i piani.

Gli agenti supportati sono Claude Code, Codex, Grok Build, OpenCode, OpenClaw e Hermes Agent. Installa prima l'agente che preferisci. Se CC Switch è già installato, puoi saltare il relativo passaggio di installazione.

Aprire le chiavi API sul web

Accedi alla gestione dell'account OpenDesign sul web e scegli API keys (chiavi API) nella barra laterale. Seleziona One-click agent setup (configurazione dell'agente con un clic) in alto a destra. Puoi iniziare anche senza una chiave esistente.

La pagina completa API keys: One-click agent setup si trova in alto a destra; Connection setup contiene i formati API e i relativi URL di base.

Per la configurazione manuale, apri Connection setup (configurazione della connessione), seleziona il formato API richiesto dal tuo strumento—Chat Completions, Responses o Messages—e copia il relativo URL di base dell’API. Assicurati che endpoint e protocollo corrispondano. I passaggi seguenti mostrano l’importazione con un clic.

Passaggio 1: installare e aprire CC Switch

In One-click agent setup, seleziona Download for Mac o Download for Windows.
Installa e apri CC Switch. Salta questo passaggio se è già installato.

Passaggio 2: scegliere un agente e un modello

Seleziona l'agente di destinazione. Claude Code è selezionato per impostazione predefinita.
Scegli dall'elenco Model un modello di testo disponibile per il tuo piano. Se non è disponibile alcun modello, scegli un altro agente o verifica il piano; copiare il nome di un modello da una schermata non concede l'accesso.

La finestra di configurazione: scegli l'agente di destinazione, quindi un modello disponibile per il tuo account.

Passaggio 3: importare e riavviare

Seleziona Import into CC Switch. Verrà creata una nuova chiave il cui nome corrisponde all'agente e al sistema, ad esempio Claude Code · Mac, e si aprirà CC Switch.
Nel messaggio del browser, consenti Open CC Switch. Controlla API Endpoint, la chiave e il modello in CC Switch, quindi seleziona Import.
Torna alla pagina web e seleziona Done oppure Set up another agent per configurare un'altra connessione.
Riavvia l'agente di destinazione. Per Claude Code, esci dalla sessione corrente ed esegui claude in un nuovo terminale.

La finestra di conferma di CC Switch: controlla l'endpoint e il modello prima dell'importazione. La chiave in questa schermata è mascherata.

Ogni configurazione con un clic crea una nuova chiave e non può riutilizzarne una esistente. Le chiavi esistenti non subiscono modifiche. La configurazione precedente dell'agente rimane disponibile in CC Switch.

Verificare la connessione attiva

Invia un breve messaggio nell'agente riavviato e verifica che risponda.
In Claude Code, esegui /status e confronta il modello con quello selezionato. Negli altri agenti, usa la visualizzazione di stato equivalente.
Nella pagina web API keys, controlla se l'orario Last used della nuova chiave viene aggiornato.

Se il vecchio modello è ancora attivo, chiudi la vecchia sessione e riavvia l'agente. Se il browser non ha aperto CC Switch, controlla il messaggio di conferma vicino alla barra degli indirizzi, apri CC Switch e seleziona nuovamente Open. In seguito, potrai cambiare modello in CC Switch senza ripetere la configurazione.

Ripristinare la configurazione precedente o revocare l'accesso

In CC Switch, trova la configurazione precedente dell'agente e abilitala per ripristinarla. La rimozione di una configurazione da CC Switch non disabilita la chiave API. Quando vuoi che la chiave smetta di funzionare, revocala nella pagina web API keys.

Controlla nella pagina dell'account il piano attuale e la disponibilità dei modelli. Consulta il tutorial sulla configurazione dell'agente con un clic per la registrazione completa e le schermate, oppure Abbonamenti e fatturazione per la configurazione dell'account.

Le chiamate API condividono i crediti dell'app?

Sì. Le normali chiamate API condividono con l'app le quote del piano e le finestre di utilizzo. La creazione di un'altra chiave o il passaggio a un altro agente non le azzera. I crediti promozionali possono avere condizioni di idoneità API distinte. Consulta crediti e utilizzo.

Apri la console Cloud per gestire chiavi e utilizzo. Gli strumenti come Zcode che accettano un endpoint e una chiave per un modello personalizzato possono essere configurati per il protocollo API corrispondente. Ciò non significa che OpenDesign possa avviare lo strumento come agente locale integrato.

Le richieste con immagini superano il limite di dimensione

Le attuali indicazioni del supporto specificano un limite di 50 MiB per il corpo delle richieste API. Il limite si applica all'intero corpo, non a ciascuna immagine; anche la codifica delle immagini ne aumenta le dimensioni. Riduci il numero o le dimensioni delle immagini e riprova con una richiesta di piccole dimensioni. Se il problema persiste, comunica al supporto lo stato della risposta, l'ora della richiesta e il modello senza esporre la chiave.