Delega a qualsiasi LLM da Claude Code
cc-fleet trasforma qualsiasi modello linguistico di grandi dimensioni (DeepSeek, GLM, Qwen, Kimi, MiniMax e altri) in un vero compagno di squadra di Claude Code o in un subagente headless one-shot. Sostituisce il backend LLM predefinito con un modello di un fornitore che espone un'API compatibile con Anthropic, consentendo una delega LLM economicamente vantaggiosa senza condividere le proprie credenziali principali.
Le chiavi API dei fornitori vengono archiviate in modo sicuro su disco (~/.config/cc-fleet/secrets/, permessi 0600) e iniettate tramite un meccanismo apiKeyHelper.
Non compaiono mai nelle variabili d'ambiente, negli argomenti della riga di comando o nella cronologia della shell.
Lo strumento è composto da una CLI Go per la gestione dei profili dei fornitori e la distribuzione delle chiavi, oltre a una competenza di Claude Code che decide quando e come delegare il lavoro.
Prerequisiti e installazione rapida
Requisiti
- Claude Code CLI nel tuo
PATH - tmux (la modalità compagno di squadra viene eseguita all'interno di riquadri tmux)
- macOS o Linux (amd64/arm64); Windows non è testato
- Per la modalità compagno di squadra, abilita il flag sperimentale agent‑teams: aggiungi
{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }a~/.claude/settings.jsone riavvia Claude Code
L'installatore in una riga raccomandato configura il binario, un alias ccf e la competenza di Claude Code in un unico passaggio.
È possibile passare flag di personalizzazione (ad es. --skill plugin, --version vX.Y.Z) dopo | sh -s --.
curl -fsSL https://raw.githubusercontent.com/ethanhq/cc-fleet/main/install.sh | sh
Aggiunta della competenza dopo un'installazione solo del binario
Quando si installa tramite npm (npm install -g @ethanhq/cc-fleet), go install o compilazione dal sorgente, solo il binario viene installato sul sistema.
La competenza di Claude Code deve essere installata separatamente:
claude plugin marketplace add ethanhq/cc-fleet claude plugin install cc-fleet@ethanhq
L'installatore in una riga e l'archivio precompilato eseguono già automaticamente questo passaggio. Se hai ancora bisogno della competenza dopo un'installazione solo del binario, esegui i due comandi sopra.
Registrazione dei fornitori nella TUI
Esegui cc-fleet senza argomenti per aprire l'interfaccia utente testuale interattiva (TUI).
Fornisci il nome del fornitore, l'URL base compatibile con Anthropic, l'endpoint dei modelli, il modello predefinito e la chiave API.
La chiave viene salvata immediatamente in ~/.config/cc-fleet/secrets/ con permessi 0600; la directory di configurazione viene creata al primo salvataggio—non è necessario alcun passaggio di inizializzazione separato.
La TUI elenca tutti i fornitori registrati, supporta la modifica e gestisce più chiavi per fornitore.
Passa alla bacheca Stato degli agenti (premi tab) per vedere i compagni di squadra attivi raggruppati per sessione e team, con il loro fornitore, modello, riquadro tmux, PID, salute e stato nascosto.
Da questa bacheca puoi nascondere o mostrare i riquadri (h/s) e aggiornare la visualizzazione (r).
Modalità compagno di squadra – Un lavoratore persistente
I compagni di squadra sono membri a pieno titolo del team di agenti di Claude Code, guidati da un modello del fornitore.
La competenza richiama il meccanismo nativo TeamCreate; cc-fleet avvia un processo claude specifico per il fornitore in un riquadro tmux e comunica tramite SendMessage.
Il compagno di squadra rimane attivo tra un turno e l'altro e più compagni possono essere eseguiti in parallelo.
Per la massima visibilità , avvia sempre all'interno di una sessione tmux (tmux new-session -s cc-fleet).
Se non ti trovi all'interno di tmux, il compagno di squadra viene eseguito in una sessione server separata denominata cc-fleet-swarm-<team>.
Puoi collegarti con tmux -L cc-fleet-swarm-<team> attach.
Solo il riquadro del compagno di squadra addebita costi sulla chiave del fornitore; l'autenticazione della tua sessione principale rimane invariata.
Modalità Subagent – Headless e One‑Shot
La modalità subagent viene eseguita in modo sincrono, headless, e non richiede pannelli o la funzionalità agent‑teams.
È ideale per analisi one‑off e per distribuire subagent AI indipendenti su task paralleli.
Il comando CLI sottostante è cc-fleet subagent <vendor>.
Claude lo invoca per te, ma puoi anche eseguirlo direttamente con una di queste flag:
| Flag | Uso |
|---|---|
--background | Esegui in modalità detached; verifica lo stato con cc-fleet subagent-status |
--resume <id> | Continua un subagent precedente (multi‑turn) |
--max-budget-usd | Limita il costo monetario |
--max-turns | Limita il numero di turni |
Le conversazioni multi‑turn sono possibili con --resume, sebbene la continuazione automatica del contesto non sia descritta.
La skill sceglie automaticamente tra modalità teammate e subagent in base al task.
Best Practices e Vincoli
- Avvia sempre una sessione tmux prima di lanciare i teammate.
- Lascia che sia la skill a decidere la modalità di esecuzione; sceglie tra teammate e subagent a seconda del lavoro.
- Preferisci la modalità subagent per analisi rapide e one‑off (revisioni diff, riepiloghi di log).
- Per task indipendenti e paralleli, distribuisci subagent in fan‑out invece di creare molti teammate.
- Al di fuori di tmux, i teammate vengono eseguiti in sessioni detached; collegati con
tmux -L cc-fleet-swarm-<team> attach.
Limitazioni note: testato solo su macOS e Linux; la modalità teammate richiede tmux e il flag agent‑teams; le API dei vendor devono essere compatibili con Anthropic; nessun refresh automatico delle chiavi; i subagent multi‑turn richiedono la ripresa manuale; non sono descritti limiti di scalabilità o di risorse per worker concorrenti.
