Amp ha riaperto BYOK (Bring Your Own Key) e AIHubMix ora lo supporta. Questa guida utilizza i modelli Claude di Anthropic come esempio e illustra come indirizzare Amp all'API di AIHubMix tramite URL personalizzato e instradamento dei modelli — coprendo la chiave API, la mappatura dei nomi dei modelli e la configurazione del progetto.
Se stai cercando "configurazione di Amp BYOK", "collegare Amp a AIHubMix", "chiave API di AIHubMix", "URL personalizzato di Amp" o "instradamento dei modelli di Amp", i passaggi seguenti lo coprono.
A cosa serve Amp?
- Flussi di lavoro multi-modello: assegna modelli diversi a modalità e agenti diversi — Claude, GPT o un modello veloce per lavori leggeri.
- Contesto di progetto completo: Amp legge attraverso il codice, modifica file, esegue comandi e esegue test.
- BYOK e instradamento personalizzato: scegli i tuoi modelli e fornitori tramite l'instradamento dei modelli, URL personalizzato e servizi API di terze parti.
- Web e CLI insieme: configura i modelli nel browser, poi continua a lavorare dal terminale.
- Progettato per team: condividi qualsiasi thread e lavora insieme ai tuoi compagni di squadra.
- Thread sincronizzati nel cloud: ogni thread si sincronizza automaticamente nel cloud, quindi il tuo team riprende sempre dallo stesso stato.
Il resto di questa guida utilizza i modelli Claude di Anthropic per mostrare come collegare AIHubMix ad Amp.
Perché instradare Amp tramite AIHubMix? Una chiave e un Base URL raggiungono oltre 400 modelli tra i fornitori, l'endpoint è compatibile con l'API di Anthropic Messages (quindi Amp comunica nativamente con essa), e la mappatura dei nomi dei modelli per chiave più i fallback degli errori ti consentono di adattarti a qualsiasi nomenclatura che un cliente si aspetta. Crea un account →
Parte 1 — Collega l'API
Passo 1: Apri le impostazioni personali
Dalla schermata principale di Amp, fai clic su Impostazioni personali nell'angolo in basso a sinistra.
Passo 2: Aggiungi un percorso modello personalizzato
Trova Instradamento modelli nella barra laterale sinistra, fai clic su Aggiungi a destra e scegli URL personalizzato.
Passo 3: Crea una chiave API e configura la mappatura dei nomi dei modelli
Vai alla console di AIHubMix e crea una chiave API, quindi configura una mappatura dei nomi dei modelli su di essa.
Amp si aspetta nomi di modelli nel formato provider/model — per esempio anthropic/claude-fable-5-1. Gli ID modello di AIHubMix non portano il prefisso provider/, quindi aggiungi una mappatura che riscrive il nome che Amp invia all'ID modello fornito da AIHubMix:
| Alias (ciò che Amp invia) | Target (ID modello AIHubMix) |
|---|---|
anthropic/claude-fable-5-1 | claude-fable-5-1 |
Le richieste che utilizzano l'alias vengono riscritte all'ID modello target. Ogni chiave supporta fino a 5 mappature e puoi opzionalmente aggiungere modelli di fallback che vengono riprovati, in ordine, quando una richiesta genera un errore.
Passo 4: Compila i dettagli di connessione
Torna alla schermata URL personalizzato di Amp e compila i campi:
- Chiave API: la chiave che hai appena creato in AIHubMix.
- Formato API: seleziona Compatibile con l'API di Anthropic Messages.
- Base URL:
https://aihubmix.com— Amp conferma sotto il campo che le richieste vanno ahttps://aihubmix.com/v1/messages. - Modelli: elenca gli alias che hai mappato, uno per riga (ad esempio
anthropic/claude-fable-5-1). Amp risolve ciascuno e mostra il suo nome visualizzato sotto.
Lascia selezionato Attiva dopo la creazione in modo che le nuove richieste inizino a essere instradate attraverso il fornitore immediatamente, quindi fai clic su Crea.
Passo 5: Verifica la connessione
Una volta salvato, la pagina Instradamento modelli elenca il tuo nuovo URL personalizzato. Fai clic su Controlla accesso per testare la connessione.
Una chiave funzionante restituisce Chiave valida insieme alla sonda GET https://aihubmix.com/v1/models, una risposta HTTP 200 e un conteggio dei modelli visibili. L'elenco dei modelli qui sotto mostra quindi tutto ciò che questo URL personalizzato può raggiungere.
Parte 2 — Crea un progetto e un thread
Passo 6: Crea un progetto
Fai clic sull'elemento progetti nell'angolo in basso a sinistra, quindi sul pulsante nuovo-progetto in alto a destra.
Scegli Inizia da zero, inserisci un nome per il progetto e completa la creazione del progetto.
Passo 7: Crea un thread
All'interno del progetto, fai clic su Nuovo thread per avviare un'attività.
Parte 3 — Assegna modelli e inizia a lavorare
Passo 8: Assegna un modello a ciascun ruolo
Torna a Impostazioni personali e apri Modalità. Ogni modalità seleziona automaticamente i suoi modelli; qui puoi fissare un modello specifico e uno sforzo di ragionamento per l'Agente principale di una modalità, il suo Oracolo e i suoi Subagenti. Qualsiasi cosa lasciata su Auto continua a seguire l'instradamento di Amp.
Passo 9: Scegli una modalità e inizia la conversazione
Fai clic su Nuovo thread, scegli la modalità e il modello che desideri e inizia a chattare o assegna a Amp un compito di sviluppo.
Questa è la configurazione completa. Con una chiave AIHubMix, Amp può raggiungere Claude, GPT e ogni altro modello sulla piattaforma — e puoi cambiare il modello dietro qualsiasi modalità senza toccare il resto della tua configurazione.
Ottieni la tua chiave API di AIHubMix →
- AIHubMix — https://aihubmix.com/
- Amp — https://ampcode.com/
