Base de coñecemento desenvolvedores

Ferramentas de codificación

Os axentes de codificación que che permiten escoller onde van as súas solicitudes de modelo poden executarse en Nymbot. Cada un necesita unha URL de base, unha clave e un id de modelo; esta páxina dá as opcións exactas para cada un.

Esta páxina está traducida por máquina para maior comodidade. O orixinal en inglés é a versión que se aplica.

Antes de comezar

Necesitas unha clave de API, feita na app fogueira Menú (ver chaves de lumeCada ferramenta fala dun dos tres formatos da API, e que decide a súa URL de base:

ferramenta	Formatos	Páxina de URL
Claude Código	Mensaxes antropolóxicas	`https://nymbot.ai/api`
Código CLI	Respostas	`https://nymbot.ai/api/v1`
Cline, Kilo Código, Roo Código, Continuar	Chat Complementos	`https://nymbot.ai/api/v1`

Modelos de identificación veñen de A listaxe de modelos, GET https://nymbot.ai/api/v1/models, que non necesita unha clave.Os exemplos a continuación usan anthropic/claude-sonnet-5 e, para un modelo doutro fabricante, moonshotai/kimi-k3Comprobe que o modelo que elixe aínda está listado.

Elixe un modelo que poida chamar ferramentas. Estes axentes están lendo ficheiros, editándoos e executando comandos chamando ferramentas, en cada paso. capabilities.tools poñer true. nymbot/auto Rexeita calquera solicitude con ferramentas (400 unsupported_tool), polo que non funciona con ningún deles.
Copie os límites do modelo na ferramenta. A maioría das ferramentas solicitan unha fiestra de contexto e unha saída máxima. context_length e max_output_tokens Unha ferramenta que solicite máis saída do que o modelo permite non é rexeitada; a solicitude é reducida ao máximo do modelo.
Os pasos chegan enteiros. Unha solicitude con ferramentas execútase nunha peza e entón é enviada de volta como un fluxo, con pings vivos mentres o modelo funciona.

Dar a cada ferramenta a súa propia chave

Un axente de codificación fai moitas chamadas de modelo para unha tarefa, cada unha levando a conversa ata agora, de xeito que unha única tarefa pode custar moito máis que unha mensaxe de chat.

Claude Código

Claude Code fala con Nymbot a través das súas opcións de gateway.

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

A URL de base é exactamente https://nymbot.ai/api: Non /v1 e ningunha desfeita ao final, xa que Claude Code engade /v1/messages propia de si mesma.
A chave entra en ANTHROPIC_AUTH_TOKEN, que Claude Code envía como Authorization: BearerMentres estea configurado, un rexistro gardado claude.ai non se usa para estas solicitudes e os límites da súa subscrición non se aplican.
Por defecto, Claude Code pide os nomes de modelos máis recentes de Anthropic, e Nymbot responde a un nome de Claude só coa mesma ou unha versión máis nova do seu catálogo, nunca unha máis antiga; unha versión que o catálogo non leva aínda devolve 404Puntuación opus, sonnet e haiku no catálogo ids evita iso. fable A Coruña, Set ANTHROPIC_DEFAULT_FABLE_MODEL do mesmo xeito.
Pinning o slot Haiku tamén move o traballo de fondo de Claude Code, como títulos de sesión, a ese modelo máis barato.

Comezar Claude Code e executar /statusOs Estatuto O tab debe mostrar unha Anthropic base URL liña con https://nymbot.ai/api e unha Auth token Nome da liña ANTHROPIC_AUTH_TOKEN.

Para manter as configuracións para cada sesión, coloque-as no env Bloqueo de ~/.claude/settings.json (%USERPROFILE%\.claude\settings.json en Windows) en vez. Nunca coloque a clave no .claude/settings.json, que está comprometido co proxecto.

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

Algúns outros parámetros valen a pena coñecer:

Lonxitude de saída. conxunto CLAUDE_CODE_MAX_OUTPUT_TOKENS para o modelo max_output_tokens, polo que Claude Code planea as súas respostas para o límite que o modelo realmente ten.
O modelo Picker. con CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, Claude Code le a lista de modelos de Nymbot na startup e engade os modelos de Claude nel a /model.
Deixar fóra o conselleiro. O asesor de Claude Code é unha ferramenta que se executa nos servidores propios de Anthropic, que Nymbot non pode executar, e unha solicitude que o leve é rexeitada. /advisorou set CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 para eliminalo por completo.
Deixar MCP ferramenta de busca fóra. Claude Code apaga-lo para unha URL de base personalizada, e Nymbot non pode tomar as referencias da ferramenta que envía, así que non configure ENABLE_TOOL_SEARCH=trueAs ferramentas de MCP aínda funcionan; en vez diso, son cargadas de fronte.

Claude Code tamén pode executarse nun modelo que non sexa Claude: apunta as ranuras do modelo a outro id de catálogo, como moonshotai/kimi-k3e poñer CLAUDE_CODE_MAX_CONTEXT_TOKENS Para ese modelo context_lengthAnthropic non soporta Claude Code noutros modelos, polo que espera marxes ásperas.

Código en VS Código

A extensión de Código VS executa o mesmo Código Claude, pero verifica as credenciais antes de comezar, polo que lle dá as opcións nas configuracións do propio usuario de Código VS. Configuracións de usuario abertas (JSON) e engade:

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

Desactivar o Login Prompt detén a extensión pedíndolle que se rexistrase en Anthropic. Claude Código O anterior tamén se aplica á extensión; configuracións en ~/.claude/settings.json tamén, pero o control de inicio de sesión da extensión só le a súa propia configuración.

Código CLI

Codex usa a API Responses. Engadir Nymbot como provedor en ~/.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

Despois de poñer NYMBOT_API_KEY no seu entorno e correr codex.

multi_agent = false É necesario As ferramentas multi-axente de Codex veñen como un grupo de ferramentas que Nymbot non pode tomar, e mentres están en cada solicitude é rexeitado con 400 unsupported_toolNymbot só toma ferramentas funcionais e busca web; se o Codex informa unsupported_tool, unha característica ou servidor MCP que engade outro tipo de ferramenta está activado.
Elixe un modelo que non sexa un dos propios de OpenAI. Para os ids de modelo recoñece como OpenAI, como openai/gpt-5.6-sol, Codex cambia a un formato de solicitude Nymbot non pode ler, e a solicitude é rexeitada.
model_context_window indica Codex o tamaño de contexto do modelo, desde context_length na lista de modelos; se non, asume 272.000 tokens.
Codex ofrece ao modelo unha ferramenta de busca web, que Nymbot executa coa súa propia Busca web cando a pregunta a necesite. web_search = "disabled" na parte superior do ficheiro para desactivalo.
Nymbot non almacena respostas. Codex xa envía toda a conversa cada vez, polo que non hai nada que cambiar.

Clínica

As seguintes páxinas ligan con VS Code:

conxunto Provedor de lume Dúas Compatible con OpenAI.
conxunto Páxina de URL Dúas https://nymbot.ai/api/v1.
Pon a túa chave en Key API compatible con OpenAI.
Seleccione o modelo baixo Modelo IDCline carga a lista desde Nymbot unha vez que a URL e a clave están en; tamén pode escribir un id como anthropic/claude-sonnet-5.

Aberto Modelo de configuración e enche o Tamaño da fiestra Contexto e Max Tokens de saída desde a lista de modelos, e tick Soporte de imaxes Se o modelo ten capabilities.vision, polo que Cline xestiona o seu contexto correctamente.

Código de quilo

Na extensión de código VS, abre configuraciónsVaia para o Provedores Desprácese, desprácese ata o fondo e fai clic Provedor CustomEnche a túa:

Provedor ID: nymbot
Mostrar Nome: Nymbot
Provedor de API: Compatible con OpenAI
Páxina de URL: https://nymbot.ai/api/v1
A chave do lumeA túa chave
Modelos: selecciona-los da lista Kilo loads de Nymbot

Clicade Subliña, e os modelos aparecen no selector de modelos. Para o CLI, ou para definir os límites dun modelo e o soporte de ferramentas, defina o provedor en ~/.config/kilo/kilo.json En lugar de:

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 é o Nymbot modelo id e a clave por riba é o propio nome de Kilo para el, usado en "model" como nymbot/…Toma limit da lista de modelos; sen ela Kilo non pode xestionar o contexto.

Roo Código

Roo Code foi descontinuado o 15 de maio de 2026.Se aínda o tes instalado, funciona con Nymbot deste xeito: Provedor de lume Dúas Compatible con OpenAI, Páxina de URL Dúas https://nymbot.ai/api/v1Pon a túa chave en A chave do lume e un modelo de identificación en ModeloRoo Code só funciona a través de chamadas de ferramentas, polo que o modelo debe ter capabilities.toolsEn función da configuración do modelo, o Max Tokens de saída, Contexto da fiestra e Imaxe de apoio da lista de modelos.

Continúa

A versión final de Continue é 2.0.0 e xa non se mantén, pero a extensión e o seu CLI aínda funcionan. ~/.continue/config.yaml (%USERPROFILE%\.continue\config.yaml Para o 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 Continúa di o que o modelo pode facer, xa que non pode dicir a partir dun Nymbot id. tool_use é o que necesita o modo de axente; deixa fóra image_input Un modelo sen capabilities.vision.
A segunda entrada usa un Nymbot Modelo de embalaxe Para continuar coa busca de codebase.

O que envían as ferramentas

Un axente de codificación envía ao modelo calquera cousa que funcione: as súas instrucións, os arquivos que abre, a saída dos comandos que executa. O que o lume pode ver: non está cifrado de extremo a extremo, Nymbot non o almacena e o provedor do modelo o ve.

As ferramentas manteñen as súas propias historias na súa máquina, e algunhas falan cos seus creadores ademais. Claude Code, por unha, aínda envía a súa telemetría a Anthropic cando se executa en Nymbot; CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 para deter ese e o seu outro tráfico de fondo. A súa ferramenta WebFetch aínda comproba cada dominio con Anthropic a menos que configure skipWebFetchPreflight Dúas true nas súas configuracións.
As claves nos ficheiros de configuración só son tan seguras como o ficheiro, manténdoas fóra de calquera cousa que se comprometa e léndoas desde o ambiente onde a ferramenta o permita.