Saltar al contenido
Volver a Nymbot

base de conocimientos desarrolladores

Herramientas de codificación

Los agentes de codificación que te permiten elegir dónde van sus solicitudes de modelo se pueden ejecutar en Nymbot. Cada uno necesita una URL de base, una clave y un id de modelo; esta página ofrece las configuraciones exactas para cada uno.

Antes de comenzar

Necesitas una clave de API, hecha en la app Fuego El menú (ver Llaves de fuegoCada herramienta habla de uno de los tres formatos de la API, y esto determina su URL de base:

herramientaFormatoURL de base
Claude CódigoMensajes antropológicoshttps://nymbot.ai/api
Código CLIRespuestashttps://nymbot.ai/api/v1
Cline, Kilo Code, Roo Code, Seguir leyendoComplementos de chathttps://nymbot.ai/api/v1

Los ids provienen de La lista de modelos, GET https://nymbot.ai/api/v1/models, que no necesita una llave. Los ejemplos a continuación usan anthropic/claude-sonnet-5 y, para un modelo de otro fabricante, moonshotai/kimi-k3Compruebe que el modelo que elija todavía está listado.

  • Elige un modelo que pueda llamar herramientas. Estos agentes leen archivos, los editan y ejecutan comandos llamando herramientas, en cada paso. capabilities.tools Establecimiento true. nymbot/auto rechaza cualquier solicitud con herramientas (400 unsupported_tool), por lo que no funciona con ninguno de ellos.
  • Copie los límites del modelo en la herramienta. La mayoría de las herramientas solicitan una ventana de contexto y una salida máxima. context_length y max_output_tokens Una herramienta que solicita más salida de la que el modelo permite no se rechaza; la solicitud se reduce al máximo del modelo.
  • Los pasos llegan enteros. Una solicitud con herramientas se ejecuta en una pieza y luego se envía de vuelta como un flujo, con pings vivos mientras el modelo funciona.
Dale a cada herramienta su propia clave

Un agente de codificación hace muchas llamadas de modelo para una tarea, cada una de las cuales lleva la conversación hasta ahora, por lo que una sola tarea puede costar mucho más que un mensaje de chat.

Claude Código

Claude Code habla con Nymbot a través de sus ajustes de puerta de entrada. Configure estos en la carcasa desde la que lo inicia:

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
  • La URL básica es exactamente https://nymbot.ai/api: No /v1 Y no hay escándalo al final, ya que Claude Code añade /v1/messages de sí mismo.
  • La llave entra en ANTHROPIC_AUTH_TOKEN, que Claude Code envía como Authorization: BearerMientras está configurado, un login salvado de claude.ai no se utiliza para estas solicitudes y los límites de su suscripción no se aplican.
  • Por defecto, Claude Code pide los nombres de modelos más recientes de Anthropic, y Nymbot responde a un nombre Claude sólo con la misma o una versión más reciente de su catálogo, nunca una versión más antigua; una versión que el catálogo no lleva todavía devuelve 404Puntuación opus, sonnet y haiku en el catálogo ids evita esto. Si utiliza el fable Alicia, el conjunto ANTHROPIC_DEFAULT_FABLE_MODEL de la misma manera.
  • Pining la ranura de Haiku también mueve el trabajo de fondo de Claude Code, como los títulos de sesión, a ese modelo más barato.

Iniciar Claude Code y correr /status• El Estatus La tabla debe mostrar un Anthropic base URL La línea con https://nymbot.ai/api y un Auth token Nombre de línea ANTHROPIC_AUTH_TOKEN.

Para mantener las configuraciones para cada sesión, coloquelas en el env Bloqueo de ~/.claude/settings.json (%USERPROFILE%\.claude\settings.json en Windows) en lugar. Nunca coloque la llave en el .claude/settings.jsonque se ha comprometido con el proyecto.

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

Algunas configuraciones más vale la pena conocer:

  • Longitud de salida. Set CLAUDE_CODE_MAX_OUTPUT_TOKENS Para el modelo max_output_tokens, por lo que Claude Code planea sus respuestas para el límite que el modelo realmente tiene.
  • El modelo picker. con CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1Claude Code lee la lista de modelos de Nymbot en la startup y agrega los modelos de Claude en ella. /model.
  • Deja el asesor. El asesor de Claude Code es una herramienta que se ejecuta en los propios servidores de Anthropic, que Nymbot no puede ejecutar, y una solicitud que la lleve es rechazada. /advisoro el set CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 para eliminarlo por completo.
  • Desactivar la búsqueda de herramientas de MCP. Claude Code lo apaga para una URL de base personalizada, y Nymbot no puede tomar las referencias de la herramienta que envía, así que no configure ENABLE_TOOL_SEARCH=trueLas herramientas de MCP todavía funcionan; se cargan de frente en lugar de eso.

Claude Code también puede ejecutarse en un modelo que no es Claude: apunte las ranuras del modelo en otro id de catálogo, como moonshotai/kimi-k3Y el set CLAUDE_CODE_MAX_CONTEXT_TOKENS En este modelo de context_lengthAnthropic no soporta Claude Code en otros modelos, por lo que espera bordes duros.

Código en VS Código

La extensión de Código VS ejecuta el mismo Código Claude, pero comprueba las credenciales antes de que comience, por lo que dé las configuraciones en la configuración del usuario de Código VS. Instalaciones de usuario abiertas (JSON) y añadiendo:

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 el login prompt detiene la extensión pidiéndole que se conecte a Anthropic. Claude Código también se aplica a la extensión; las configuraciones en ~/.claude/settings.json también, pero la verificación de inicio de sesión de la extensión sólo lee su propia configuración.

Código CLI

Codex utiliza la API Responses. Agregar Nymbot como proveedor 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

Luego se NYMBOT_API_KEY En tu entorno y corriendo codex.

  • multi_agent = false se requiere . Las herramientas multi-agente de Codex vienen como un grupo de herramientas que Nymbot no puede tomar, y mientras que están en cada solicitud se rechaza con 400 unsupported_toolNymbot solo toma herramientas de función y búsqueda web; si Codex reporta unsupported_tool, una función o servidor MCP que agrega otro tipo de herramienta está activado.
  • Elige un modelo que no sea el propio de OpenAI. Para los ids de modelo se reconoce como OpenAI, como openai/gpt-5.6-sol, Codex cambia a un formato de solicitud Nymbot no puede leer, y la solicitud es rechazada.
  • model_context_window dice Codex el tamaño de contexto del modelo, desde context_length en la lista de modelos; de lo contrario, asume 272.000 tokens.
  • Codex ofrece al modelo una herramienta de búsqueda web, que Nymbot ejecuta con su propia búsqueda web Cuando la pregunta la necesita. web_search = "disabled" en la parte superior del archivo para apagarlo.
  • Nymbot no almacena respuestas. Codex ya envía toda la conversación cada vez, por lo que nada tiene que cambiar.

Clínica

En la configuración de Cline en VS Code:

  1. Set Proveedores de fuego Dos Compatible con OpenAI.
  2. Set URL de base Dos https://nymbot.ai/api/v1.
  3. Pon tu llave en La clave API compatible con OpenAI.
  4. Seleccione el modelo bajo Modelo IDCline carga la lista de Nymbot una vez que la URL y la clave están en; también puede escribir un id como anthropic/claude-sonnet-5.

Abierto Modelo de configuración y llena en Tamaño de ventana Contexto y Max Tokens de salida de la lista de modelos, y tick Apoya las imágenes Si el modelo tiene capabilities.vision, por lo que Cline maneja su contexto correctamente.

Código de kilogramos

En la extensión de código VS, abierto ConfiguracionesVaya a la Proveedores Tab, desplazarse hacia abajo y hacer clic Proveedor CustomRellena en :

  • Proveedor de ID: nymbot
  • Nombre de muestra: Nymbot
  • Proveedores de API: Compatible con OpenAI
  • URL de base: https://nymbot.ai/api/v1
  • Claves de fuegoTu llave
  • Los modelos: seleccionarlos de la lista Kilo loads de Nymbot

Clique Submitido, y los modelos aparecen en el selector de modelos. Para el CLI, o para establecer los límites de un modelo y el soporte de herramientas, defina el proveedor 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 es el id modelo de Nymbot y la clave por encima es el nombre propio de Kilo para él, utilizado en "model" como nymbot/…Tome el limit de la lista de modelos; sin ella Kilo no puede gestionar el contexto.

Roo Código

Roo Code fue descontinuado el 15 de mayo de 2026.Si todavía lo tienes instalado, funciona con Nymbot de esta manera: Proveedores de fuego Dos Compatible con OpenAI, URL de base Dos https://nymbot.ai/api/v1Pon tu llave en Fuego clave Un modelo de identidad en ModeloRoo Code sólo funciona a través de llamadas de herramientas, por lo que el modelo debe tener capabilities.toolsEn la configuración del modelo, el Max Tokens de salida, Ventana de contexto y Imagen de soporte de la lista de modelos.

Continúa

La versión final de Continue es 2.0.0 y ya no se mantiene, pero la extensión y su CLI todavía funcionan. ~/.continue/config.yaml (%USERPROFILE%\.continue\config.yaml En el 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 dice Continuar lo que el modelo puede hacer, ya que no puede decir desde un id de Nymbot. tool_use es lo que el modo de agente necesita; salga fuera image_input Para un modelo sin capabilities.vision.
  • La segunda entrada utiliza un Nymbot Modelo de embalaje Para continuar la búsqueda de base de código.

Lo que envían las herramientas

Un agente de codificación envía al modelo lo que funcione con: sus instrucciones, los archivos que abre, la salida de los comandos que ejecuta.A través de Nymbot, todo esto es una solicitud API ordinaria, con las protecciones y límites descritos en Lo que el fuego puede ver: no está cifrado de extremo a extremo, Nymbot no lo almacena, y el proveedor del modelo lo ve.

  • Las herramientas mantienen sus propios historiales en su máquina, y algunas hablan con sus creadores además. Claude Code, por uno, todavía envía su telemetría a Anthropic cuando se ejecuta en Nymbot; CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 para detener ese y su otro tráfico de fondo. su herramienta WebFetch todavía comprueba cada dominio con Anthropic a menos que skipWebFetchPreflight Dos true en sus configuraciones.
  • Las claves en los archivos de configuración solo son tan seguras como el archivo. Manténlas fuera de todo lo que se comprometa, y leerlas desde el entorno donde la herramienta lo permite.