Base di conoscenza sviluppatori

Strumenti di codifica

Gli agenti di codifica che ti permettono di scegliere dove vanno le loro richieste di modello possono essere eseguiti su Nymbot. Ognuno ha bisogno di un URL di base, di una chiave e di un ID di modello; questa pagina fornisce le impostazioni esatte per ciascuno.

Questa pagina è tradotta automaticamente per comodità. Si applica l'originale inglese.

Prima di iniziare

Hai bisogno di una chiave API, realizzata nell'app Fuoco Il menu (vedi chiavi di fuocoOgni strumento parla uno dei tre formati dell'API, e questo determina la sua URL di base:

strumento	Il formato	URL di base
Claude Codice	Messaggi antropologici	`https://nymbot.ai/api`
Codice CLI	risposte	`https://nymbot.ai/api/v1`
Cline, Kilo Code, Roo Code, Continua	Chat di completamento	`https://nymbot.ai/api/v1`

I modelli ID provengono da La lista dei modelli, GET https://nymbot.ai/api/v1/models, che non ha bisogno di una chiave. Gli esempi di seguito usano anthropic/claude-sonnet-5 e, per un modello di un altro produttore, moonshotai/kimi-k3Verifica che il modello che hai scelto sia ancora elencato.

Scegli un modello che può chiamare strumenti. Questi agenti leggono i file, li modificano e eseguono i comandi chiamando strumenti, a ogni passo. capabilities.tools Impostazione true. nymbot/auto rifiuta qualsiasi richiesta con strumenti (400 unsupported_toolPer questo non funziona con nessuno di loro.
Copia i limiti del modello nello strumento. La maggior parte degli strumenti richiede una finestra di contesto e una uscita massima. context_length E max_output_tokens Uno strumento che richiede più output di quello consentito dal modello non viene rifiutato; la richiesta viene ridotta al massimo del modello.
Le tappe arrivano intere. Una richiesta con gli strumenti viene eseguita in un singolo pezzo e viene poi inviata indietro come flusso, con pings permanenti mentre il modello funziona. Lo streaming funziona in ogni strumento qui sotto, ma ogni passo appare in una volta piuttosto che parola per parola.

Ogni strumento ha la sua chiave

Crea una chiave separata per ogni strumento, con una copertura giornaliera. Un codificatore fa molte chiamate di modello per una singola attività, ognuna portando la conversazione finora, in modo che una singola attività possa costare molto più di un messaggio di chat.

Claude Codice

Claude Code parla con Nymbot attraverso le impostazioni del suo gateway. Impostare queste nel guscio da cui si avvia:

Shell

export ANTHROPIC_BASE_URL=https://nymbot.ai/api
export ANTHROPIC_AUTH_TOKEN=sk-nymbot-...
export ANTHROPIC_DEFAULT_OPUS_MODEL=anthropic/claude-opus-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=anthropic/claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=anthropic/claude-haiku-4.5
claude

L’URL è esattamente https://nymbot.ai/api: no /v1 e nessun slash alla fine, dal momento che Claude Code aggiunge /v1/messages di sé.
La chiave entra in ANTHROPIC_AUTH_TOKENche Claude Code invia come Authorization: BearerMentre è impostato, un login salvato claude.ai non viene utilizzato per queste richieste e i limiti dell'abbonamento non si applicano.
Per impostazione predefinita Claude Code chiede i nomi dei modelli più recenti di Anthropic, e Nymbot risponde a un nome Claude solo con la stessa o una versione più recente dal suo catalogo, mai una versione più vecchia; una versione che il catalogo non porta ancora restituisce 404- segnalare opus, sonnet E haiku In questo modo, l’ID del catalogo evita di farlo. fable Alessandro, il set ANTHROPIC_DEFAULT_FABLE_MODEL Lo stesso modo.
Pining la slot Haiku sposta anche il lavoro di background di Claude Code, come i titoli di sessione, a quel modello più economico.

Avviare Claude Code e eseguire /statuse il Statuto Tab deve mostrare un Anthropic base URL linea con https://nymbot.ai/api e un Auth token Nome di linea ANTHROPIC_AUTH_TOKEN.

Per mantenere le impostazioni per ogni sessione, metterle nel env Blocco di ~/.claude/settings.json (%USERPROFILE%\.claude\settings.json Windows) invece. Non mettere mai la chiave in un progetto .claude/settings.jsonche si impegnano con il progetto.

settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://nymbot.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-nymbot-...",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5"
  }
}

Alcune altre impostazioni valgono la pena di conoscere:

Lunghezza di uscita. set CLAUDE_CODE_MAX_OUTPUT_TOKENS Per il modello max_output_tokensCosì Claude Code pianifica le sue risposte per il limite che il modello ha veramente.
Il modello Picker. con CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1Claude Code legge l'elenco dei modelli di Nymbot alla startup e aggiunge i modelli di Claude in esso. /model.
Lascia andare il consigliere. Claude Code's Advisor è uno strumento che funziona sui propri server di Anthropic, che Nymbot non può eseguire, e una richiesta che lo trasporta viene rifiutata. /advisoro set CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 per rimuoverlo del tutto.
Smettere di utilizzare lo strumento MCP Search. Claude Code lo spegne per un URL di base personalizzato, e Nymbot non può prendere i riferimenti degli strumenti che invia, quindi non impostare ENABLE_TOOL_SEARCH=trueGli strumenti MCP funzionano ancora; invece vengono caricati in anticipo.

Claude Code può anche essere eseguito su un modello che non è Claude: puntare le slot del modello ad un altro id catalogo, come ad esempio moonshotai/kimi-k3e set CLAUDE_CODE_MAX_CONTEXT_TOKENS A questo modello context_lengthAnthropic non supporta Claude Code su altri modelli, quindi si aspettano bordi rigidi.

Codice di Claude vs. Codice

L'estensione VS Code esegue lo stesso Claude Code, ma controlla le credenziali prima di iniziare, quindi date le impostazioni nelle impostazioni utente di VS Code. Preferenze: Aprire le impostazioni utente (JSON) e aggiungiamo:

settings.json

{
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://nymbot.ai/api" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-nymbot-..." },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "anthropic/claude-opus-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "anthropic/claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "anthropic/claude-haiku-4.5" }
  ]
}

Disattivare il login prompt interrompe l'estensione che ti chiede di accedere a Anthropic. Claude Codice applicabile anche all'estensione; le impostazioni in ~/.claude/settings.json raggiungerlo anche, ma il controllo di accesso dell'estensione legge solo la propria impostazione.

Codice CLI

Codex utilizza l'API Responses. Aggiungi Nymbot come fornitore in ~/.codex/config.toml:

config.toml

model = "anthropic/claude-sonnet-5"
model_provider = "nymbot"
model_context_window = 1000000

[model_providers.nymbot]
name = "Nymbot"
base_url = "https://nymbot.ai/api/v1"
env_key = "NYMBOT_API_KEY"
wire_api = "responses"

[features]
multi_agent = false

Poi set NYMBOT_API_KEY nel tuo ambiente e correre codex.

multi_agent = false è richiesto Gli strumenti multi-agenti di Codex vengono forniti come un gruppo di strumenti che Nymbot non può prendere, e mentre sono su ogni richiesta viene rifiutato con 400 unsupported_toolNymbot assume solo strumenti di funzione e ricerca web; se il Codex riferisce unsupported_tool, è attiva una funzione o un server MCP che aggiunge un altro tipo di strumento.
Scegli un modello che non sia quello di OpenAI. Per i model id riconosce come OpenAI, come ad esempio openai/gpt-5.6-sol, Codex passa a un formato di richiesta Nymbot non può leggere, e la richiesta viene rifiutata. Claude, Kimi e gli altri modelli catalogo funzionano.
model_context_window dice Codex la dimensione del contesto del modello, da context_length nella lista dei modelli; altrimenti suppone 272.000 token.
Codex offre al modello uno strumento di ricerca web, che Nymbot esegue con il proprio Ricerca web quando la domanda ne ha bisogno. set web_search = "disabled" nella parte superiore del file per spegnerlo.
Nymbot non memorizza le risposte. Codex invia già l'intera conversazione ogni volta, quindi non c'è bisogno di cambiare nulla.

Cline

Nelle impostazioni di Cline in VS Code:

set Fornitore di fuoco due Compatibile OpenAI.
set URL di base due https://nymbot.ai/api/v1.
Inserisci la chiave in OpenAI compatibile API Key.
Seleziona il modello sotto Modello IDCline carica l'elenco da Nymbot una volta che l'URL e la chiave sono in; puoi anche digitare un id come anthropic/claude-sonnet-5.

Aprire Modello di configurazione e riempire in Contextual Window Dimensioni E Max token di uscita dalla lista dei modelli, e tick Supporto Immagini Se il modello ha capabilities.visionIn questo modo Cline gestisce correttamente il suo contesto.

Codice del chilo

Nell'estensione VS Code, aprire ImpostazioniVai alla fornitori scorrere verso il basso e cliccare Fornitore Customriempire in:

Fornitore ID: nymbot
Mostra Nome: Nymbot
Fornitore API: Compatibile OpenAI
URL di base: https://nymbot.ai/api/v1
chiave di fuocoLa tua chiave
Modelli: sceglierli dall'elenco Caricature da Kilo da Nymbot

clicca sottopostoPer il CLI, o per impostare i limiti di un modello e il supporto agli strumenti, definire il fornitore in ~/.config/kilo/kilo.json Invece di:

kilo.json

{
  "provider": {
    "nymbot": {
      "npm": "@ai-sdk/openai-compatible",
      "env": ["NYMBOT_API_KEY"],
      "options": {
        "baseURL": "https://nymbot.ai/api/v1"
      },
      "models": {
        "claude-sonnet-5": {
          "id": "anthropic/claude-sonnet-5",
          "name": "Claude Sonnet 5",
          "tool_call": true,
          "limit": { "context": 1000000, "output": 64000 }
        }
      }
    }
  },
  "model": "nymbot/claude-sonnet-5"
}

id è l'id modello Nymbot e la chiave sopra è il nome proprio di Kilo per esso, utilizzato in "model" come nymbot/…Prendiamo limit dalla lista dei modelli; senza di essa Kilo non può gestire il contesto.

Roo Codice

Roo Code è stato sospeso il 15 maggio 2026.Se lo hai ancora installato, funziona con Nymbot in questo modo: Fornitore di fuoco due Compatibile OpenAI, URL di base due https://nymbot.ai/api/v1Metti la chiave in chiave di fuoco Un modello di ID in ModelloRoo Code funziona solo attraverso le chiamate degli strumenti, quindi il modello deve avere capabilities.toolsSotto la configurazione del modello, set Max token di uscita, finestra di contesto E Immagini di supporto dalla lista dei modelli.

Continua

La versione finale di Continue è 2.0.0 e non viene più mantenuta, ma l'estensione e il suo CLI funzionano ancora. ~/.continue/config.yaml (%USERPROFILE%\.continue\config.yaml Per i Windows:

config.yaml

name: My Config
version: 0.0.1
schema: v1
models:
  - name: Claude Sonnet 5 (Nymbot)
    provider: openai
    model: anthropic/claude-sonnet-5
    apiBase: https://nymbot.ai/api/v1
    apiKey: sk-nymbot-...
    roles:
      - chat
      - edit
      - apply
    capabilities:
      - tool_use
      - image_input
    defaultCompletionOptions:
      contextLength: 1000000
      maxTokens: 64000
  - name: Nymbot embeddings
    provider: openai
    model: "@cf/baai/bge-m3"
    apiBase: https://nymbot.ai/api/v1
    apiKey: sk-nymbot-...
    roles:
      - embed

capabilities continua ciò che il modello può fare, poiché non può dire da un id Nymbot. tool_use è ciò di cui l'agente ha bisogno; lascia andare image_input Un modello senza capabilities.vision.
Il secondo ingresso utilizza un Nymbot Modello di embedded Continua la ricerca di codebase.

Cosa inviano gli strumenti

Un agente di codifica invia al modello qualsiasi cosa funzioni con: le tue istruzioni, i file che apre, l'uscita dei comandi che esegue. Attraverso Nymbot, tutto questo è una richiesta API ordinaria, con le protezioni e i limiti descritti in Cosa può vedere il fuoco: non è crittografato end-to-end, Nymbot non lo memorizza e il provider del modello lo vede.

Gli strumenti mantengono le proprie storie sulla vostra macchina, e alcuni parlano con i loro creatori oltre. Claude Code, per uno, invia ancora la sua telemetria ad Anthropic quando funziona su Nymbot; CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 Il suo strumento WebFetch controlla ancora ogni dominio con Anthropic a meno che non si impostino skipWebFetchPreflight due true nelle sue impostazioni.
Le chiavi nei file di impostazione sono solo altrettanto sicure come il file. Teneteli fuori da qualsiasi cosa si impegni, e leggerli dall'ambiente in cui lo strumento lo consente.