Base di cunniscenza Sviluppatori

Strumenti di programmazione

I agenti di programmazione chì vi permettenu di sceglie induve mandà e richieste di u mudellu u ponu esse eseguiti nantu à Nymbot. Ogni unu hà bisognu di un URL di base, una chìave è un ID di mudellu; sta pagina dà i paràmetri esatti per ognunu.

Questa pagina hè tradutta in macchina per comodità. L'uriginale in inglese hè a versione chì si applica.

Prima chì iniziate

Avete bisognu di una chìave API, fatta in l'app API menù (vede Chiavi API). Ogni strumentu parla unu di i trè furmatu di l'API, è questu decide u so URL di base:

Utile	Formatu	URL di basa
Claude Code	Messaggi di Anthropic	`https://nymbot.ai/api`
Codex CLI	Risposte	`https://nymbot.ai/api/v1`
Cline, Kilo Code, Roo Code, Continue	Completazioni di Chat	`https://nymbot.ai/api/v1`

I ID di u mudellu venenu da a lista di i mudelli, GET https://nymbot.ai/api/v1/models, chì ùn hà bisognu di alcuna chjave. L'esempi sottuscritti usanu anthropic/claude-sonnet-5 è, per un mudellu di un altru produttore, moonshotai/kimi-k3Verificà chì u mudellu chì avete sceltu hè ancu in lista.

Scegghite un mudellu chì pò chjamà attrezzi. Sti agenti leggenu i file, i edithenu è eseguhenu cumandi chjamendu strumentii, in ogni passi. Utilizate un mudellu u cui l'entrata hà capabilities.tools impostatu à true. nymbot/auto rifiuta ogni richiesta cù i strumenti (400 unsupported_tool), quindi ùn funziona cù nisun d'ellu.
Copiate i limiti di u mudellu in l'utilizituri. A più di strumentazioni dumandan una finestra di cuntestu è un output massimu. Pigliate-li da context_length è max_output_tokens in a lista di i mudelli. Un strumentu chì dumanda più output di quantu u mudellu permette ùn hè micca rifiutatu; a dumanda hè ridotta à u massimu di u mudellu.
I passi arrivanu interi. Una dumanda cù i ghjitali rùssa in un solu pezzu è poi hè mandata indietro cum'è un stream, cù ping keep-alive mentra u mudellu lavora. U streaming funziona in ogni ghjitali sotto, ma ogni passu appare in una volta invece chì parolla per parolla.

Dà à ogni strumentu a so propria chìave

Fate una chìave separata per ogni strumentu, cù un capu di ghjurnu. Un agente di prugrammazione fà molti chiami di mudellu per una sulita, ognunu portendu a a cunversazione finu à quì, cusì una sulita pò custà assai più di un missaghju di chat. Un capu nantu à a chìave hè u modu più simplice per sapè u massimu chì un strumentu pò spende, è revucà quella ferma solu quellu strumentu.

Claude Code

Claude Code fala cù Nymbot trà i so settings di gateway. Setate questi in u shell da u quale u lanciate:

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 di basa hè esattamente https://nymbot.ai/api: no /v1 è micca una barra à a fine, sicchì Claude Code aghjettate /v1/messages stessu.
A chìave entra ANTHROPIC_AUTH_TOKEN, chì Claude Code manda cum'è Authorization: BearerTant chì hè amparatu, un login claude.ai salvatu ùn hè micca usatu per sti richieste è i limiti di a vostra sottoscrizzione ùn sò micca applicati.
Fissate i slot di u mudellu. Per difettu, Claude Code dumanda i nomi di u più novellu mudellu di Anthropic, è Nymbot risponde cù un nome di Claude solu cù una versione accugulata o più novella di u so catalocu, mai una vecchia; una versione chì u catalocu ùn porta ancu torna 404. Indice opus, sonnet è haiku à i ID di u catalughe evita ciò. S'ellu usate u fable alias, set ANTHROPIC_DEFAULT_FABLE_MODEL lu stessu modu.
U fissà u slot Haiku move ancasu u travagliu in bacu di Claude Code, cum'è i tìtoli di e sessioni, versu quellu mudellu più اقتص鄣icu. Senza ellu, quellu travagliu s'amparà nantu à u vostru mudellu principale.

Accetta Claude Code è fà marchià /status. U Statutu u tab deve mostra un Anthropic base URL linea cù https://nymbot.ai/api è un Auth token nomination di linea ANTHROPIC_AUTH_TOKEN.

Per mantene i paràmetri per ogni sessione, metteghje illi in u env bloccu di ~/.claude/settings.json (%USERPROFILE%\.claude\settings.json instead in Windows) instead. Mai mette a chì in un prugettu .claude/settings.json, chì hè impegnatu cù u prugettu.

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"
  }
}

Qualche altra impostazione merita di esse conxciuta:

Lunghezza di l'output. Set CLAUDE_CODE_MAX_OUTPUT_TOKENS à u èle di u mudellu max_output_tokens, dunque Claude Code pianifica i so rispuesti per limità u limitu chì u mudellu hà veramente.
U seugliatore di u mudellu. Cun CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, Claude Code legge a lista di i mudelli di Nymbot à l'avviamentu è aghjunghje i mudelli Claude in essa /model.
Lassa l'assisore fora. L'assessoru di Claude Code hè un strumentu chì funziona nantu à i servidori stessi di Anthropic, chì Nymbot ùn pò micca fà girà, è una dumanda chì u porta hè rifiutata. ùn attivitelu micca cù /advisor, o set CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 per rimovelli interamente.
Laissez a ricerca di l'utilitaru MCP spenta. Claude Code u spegne per una URL di base custom, è Nymbot ùn pò micca piglià i riferimenti di l'utilizazione chì ellu manda, dunque ùn imposta micca ENABLE_TOOL_SEARCH=trueI strumenti MCP funzionanu ancu ; hè invece u caricamentu prima di tutto.

Claude Code pò ancu funziunà nantu à un mudellu chì ùn hè micca Claude: puntate i slot di u mudellu versu un altru ID di u cataloghju, cum'è moonshotai/kimi-k3, è set CLAUDE_CODE_MAX_CONTEXT_TOKENS à quellu mudellu di context_length, sicchì Claude Code ùn pò micca sapèlu. Anthropic ùn supporta micca Claude Code nantu à altri mudelli, dunque aspettate di l'imperfezzioni.

Claude Code in VS Code

L'estensione VS Code ferma u stessu Claude Code, ma verifica i credenziali prima di inizià, dunque dacci i settings in i settings di l'utilizatore di VS Code propiamente diti. Esegui Preferenze: Aperre i Settings di l'Utente (JSON) è aghjunghje:

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" }
  ]
}

Disattiva a Promptu di Login ferma l'estensione chì vi chiede di accede à Anthropic. Tuttu in Claude Code si applica ancu à l'estensione; settings in ~/.claude/settings.json raggiungi ancu ellu, ma a verificazione di login di l'estensione legge solu a so propria impostazione.

Codex CLI

Codex usa l'API di e Risposte. Aghjungi Nymbot cum'è un furnitore 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 mette NYMBOT_API_KEY in u vostru ambiente è executate codex.

multi_agent = false hè rìquisu. L'ozzi multi-agent di Codex venenu cum'è un gruppu di ozzi chì Nymbot ùn pò micca piglià, è mentre sò in ogni dumanda hè rifiutata cù 400 unsupported_tool. Nymbot pigghia hè i ferramentì di funziuna è a ricerca web solu; se Codex raporta unsupported_tool, una funzione o un servitore MCP chì aghjunge un altru tipu di strumentu hè attivatu.
Scegli un mudellu chì ùn hè micca unu di quelli di OpenAI. Per i ID di u mudellu chì ritene cum'è di OpenAI, cum'è openai/gpt-5.6-sol, Codex passa à un formatu di dumanda Nymbot ùn pò micca legge, è a dumanda hè rifiutata. Claude, Kimi è l'altri mudelli di u catalughe funzionanu.
model_context_window indica à Codex a dimensione di u cuntestu di u mudellu, da context_length in a lista di mudelli; sinon si assume 272.000 tokeni.
Codex offre u mudellu un strument di ricerca web, chì Nymbot eseghje cù u so propiu ricerca web quandu a dumanda u necessitate. Set web_search = "disabled" annu u cima di u filaghju per desligà ite.
Nymbot ùn almacena micca e risposte. Codex manda dja tutta a cunversazione ogni volta, donc micca nenti hà da cambià.

Cline

In i settings di Cline in VS Code:

Set Fornitore API à Compatibile cù OpenAI.
Set URL di basa à https://nymbot.ai/api/v1.
Incollate a vostra chìave in Chiave API compatibile cù OpenAI.
Scegli u mudellu sottu ID di u mudellu. Cline carghja a lista da Nymbot una volta chì u URL è a chìave sò in; pudete ancu scrive un id cum'è anthropic/claude-sonnet-5.

Apertu Configurazione di u mudellu è riempì Dimensione di a finestra di cuntestu è Massimu di Token di Output da a lista di i mudelli, è spuntate Supporti Immagini se u mudellu hà capabilities.vision, hè dunque Cline gestisce u so cuntestu correttamente.

Codice Kilo

In l'estensione di VS Code, apre Impostazioni, andate à u Fornituri tab, scende à u fondu è cliccate Fornitore personalizatuRimpinghe :

ID di u fornitore: nymbot
Nome di cunvènu: Nymbot
API di u furnitore: Compatibile cù OpenAI
URL di basa: https://nymbot.ai/api/v1
Chiave APIa vostra chìave
Modelliscelteli da a lista chì Kilo carica da Nymbot

Clicca Sottomette, è i mudelli apparen in u seziunatore di mudelli. Per a CLI, o per settate i limiti di un mudellu è u supportu di l'utilitari, definisce u pruvudore in ~/.config/kilo/kilo.json invece:

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 hè l'ID di u mudellu Nymbot è a chìave sopra hè u propiu nomu di Kilo per ellu, usatu in "model" cumu nymbot/…Prendi limit da u mudellu lista; senza essa Kilo ù pò gestisce u cuntestu.

Roo Code

Roo Code hè statu discontinuatu u 15 di maggiu 2026. S'ellu site ancuellu installeratu, ellu funziona cù Nymbot cusì: set Fornitore API à Compatibile cù OpenAI, URL di basa à https://nymbot.ai/api/v1, mette a to chìave dintra Chiave API e un id di mudellu in Modellu. Roo Code funziona solu per tramite chiamate di strumentu, donc u mudellu deve avè capabilities.toolsSottu à a configurazione di u mudellu, imposta Massimu di Token di Output, Finestra di Cuntestu è Supportu di l'imaghjini da a lista di i mudelli.

Continuà

L'ultima rilascio di Continue hè 2.0.0 è ùn hè più mantenutu, ma l'estensione è u so CLI funzionanu ancu ancorsu. Aghjettate i mudelli Nymbot à ~/.continue/config.yaml (%USERPROFILE%\.continue\config.yaml su 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 dì continua ciò chì u mudellu pò fà, sicchì ùn pò micca dì da un ID Nymbot. tool_use è ciò chì u modu Agent necessita; lasciate fora image_input per un mudellu senza capabilities.vision.
A seconda entrata usa un Nymbot mudellu di embedding per a ricerca di u codice di Continue.

Chì mandanu i ferri

Un agent di prugrammazione manda à u mudellu tuttu ciò cù ellu travaglia: i vostri duistruzioni, i file chì ellu apre, lu risultati di i cumandi chì ellu eseghice. Trà Nymbot, tuttu questu hè una richiesta API ordinaria, cù e protezzioni è i limiti descritti in chì pò u API vedeellu ùn hè micca criptatu end-to-end, Nymbot ùn u stocca micca, è u furnituri di u mudellu u vede.

I ferru mantinuna i so storia nantu à a vostra machina, è alcuni parlanu ancu cù i so creatori. Claude Code, per esempiu, manda ancu a so telemetria à Anthropic quandu u runnaghju nantu à Nymbot; set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 per fermà quellu è u so altru trafficu di sfilu. U so strumentu WebFetch ferma micca di verificà ogni dominiu cù Anthropic hè fora di u situ s'ellu impustate skipWebFetchPreflight à true in e so impostazioni.
E chjavi in i file di configurazione sò solu quantu sicuri hè u file. Mantenetele fora di tuttu ciò chì sottemete, è leggeghjele da l'ambiente hà u strumentu permette di fà.