Pular para o conteúdo
Voltar para Nymbot

Base de conhecimento Desenvolvedores

Ferramentas de codificação

Os agentes de codificação que permitem que você escolha onde seus pedidos de modelo vão podem ser executados no Nymbot. Cada um precisa de um URL de base, uma chave e um id de modelo; esta página fornece as configurações exatas para cada um.

Antes de começar

Você precisa de uma chave de API, feita no aplicativo Fogo Menu (Veja aqui) Chaves de fogoCada ferramenta fala um dos três formatos da API, e isso determina sua URL de base:

FerramentasFormataçãoBase de URLs
Código ClaudeMensagens Antropológicashttps://nymbot.ai/api
Código CLIRespostashttps://nymbot.ai/api/v1
Cline, Kilo Código, Roo Código, ContinuarChat Completohttps://nymbot.ai/api/v1

Modelos de IDs vêm de A lista de modelos, GET https://nymbot.ai/api/v1/models, que não precisa de chave. Os exemplos abaixo usam anthropic/claude-sonnet-5 e, para um modelo de outro fabricante, moonshotai/kimi-k3Verifique se o modelo que você escolheu ainda está listado.

  • Escolha um modelo que possa chamar ferramentas. Estes agentes lêem arquivos, editam-nos e executam comandos chamando ferramentas, em cada passo. capabilities.tools Coloque em true. nymbot/auto Rejeitar qualquer solicitação com ferramentas (400 unsupported_toolPor isso, não funciona com nenhum deles.
  • Copie os limites do modelo na ferramenta. A maioria das ferramentas solicita uma janela de contexto e uma saída máxima. context_length e max_output_tokens Uma ferramenta que solicita mais saída do que o modelo permite não é recusada; a solicitação é reduzida ao máximo do modelo.
  • Os passos chegam inteiros. Um pedido com ferramentas é executado em uma peça e é então enviado de volta como um fluxo, com pings ao vivo enquanto o modelo funciona.
Dê a cada ferramenta sua própria chave

Faça uma chave separada para cada ferramenta, com uma chave diária.Um agente de codificação faz muitas chamadas de modelo para uma tarefa, cada uma levando a conversa até agora, então uma única tarefa pode custar muito mais do que uma mensagem de bate-papo.

Código Claude

Claude Code fala com o Nymbot através de suas configurações de gateway. Defina essas configurações na casca a partir da qual você a 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
  • A URL de base é exatamente https://nymbot.ai/api• Não /v1 E não há nada de errado no final, já que Claude Code adiciona /v1/messages do próprio.
  • A chave entra em ANTHROPIC_AUTH_TOKEN, que Claude Code envia como Authorization: BearerEnquanto estiver configurado, um login salvo claude.ai não é usado para esses pedidos e os limites da sua assinatura não se aplicam.
  • Por padrão, Claude Code pede os nomes de modelos mais recentes da Anthropic, e Nymbot responde a um nome Claude apenas com a mesma ou uma versão mais recente de seu catálogo, nunca uma versão mais antiga; uma versão que o catálogo não carrega ainda retorna 404• Ponto opus, sonnet e haiku no catálogo ids evita isso. fable Água, Set ANTHROPIC_DEFAULT_FABLE_MODEL do mesmo modo.
  • Colar o slot Haiku também move o trabalho de fundo de Claude Code, como títulos de sessão, para esse modelo mais barato.

Iniciar Claude Code e executar /status• O Estatuto A tabela deve mostrar um Anthropic base URL Linha com https://nymbot.ai/api e um Auth token Linha de Nome ANTHROPIC_AUTH_TOKEN.

Para manter as configurações para cada sessão, coloque-as no env Bloco de ~/.claude/settings.json (%USERPROFILE%\.claude\settings.json no Windows) em vez disso. Nunca coloque a chave no .claude/settings.jsonque se comprometeu com o projeto.

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

Algumas outras configurações valem a pena conhecer:

  • comprimento da saída. Set CLAUDE_CODE_MAX_OUTPUT_TOKENS Para o modelo max_output_tokens, então Claude Code planeja suas respostas para o limite que o modelo realmente tem.
  • O modelo Picker. com CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, Claude Code lê a lista de modelos do Nymbot na startup e adiciona os modelos Claude nele para /model.
  • Deixe o conselheiro de lado. O Advisor de Claude Code é uma ferramenta que é executada nos próprios servidores da Anthropic, que o Nymbot não pode executar, e um pedido que o carregue é recusado. /advisorOu um set CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 para removê-lo completamente
  • Deixe a ferramenta de pesquisa do MCP desligada. Claude Code desliga-o para um URL de base personalizado, e o Nymbot não pode aceitar as referências de ferramentas que ele envia, por isso não defina ENABLE_TOOL_SEARCH=trueAs ferramentas do MCP ainda funcionam; elas são carregadas na frente em vez disso.

Claude Code também pode ser executado em um modelo que não é Claude: aponte os slots do modelo em outro id do catálogo, como por exemplo: moonshotai/kimi-k3E o set CLAUDE_CODE_MAX_CONTEXT_TOKENS Para esse modelo context_lengthAnthropic não suporta Claude Code em outros modelos, por isso espere margens ásperas.

Código vs. Código

A extensão VS Code executa o mesmo Claude Code, mas verifica as credenciais antes de começar, então dê as configurações nas próprias configurações do usuário do VS Code. Preferências: Configurações de usuário abertas (JSON) E acrescenta:

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

Desativar o Login Prompt interrompe a extensão pedindo que você faça login no Anthropic. Código Claude acima também se aplica à extensão; configurações em ~/.claude/settings.json também, mas a verificação de login da extensão lê apenas suas próprias configurações.

Código CLI

O Codex usa a API Responses. Adicione Nymbot como provedor em ~/.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

Em seguida, set NYMBOT_API_KEY Em seu ambiente e correndo codex.

  • multi_agent = false é necessário . As ferramentas multi-agente do Codex vêm como um grupo de ferramentas que o Nymbot não pode tomar, e enquanto eles estão em cada pedido é recusado com 400 unsupported_toolNymbot usa apenas ferramentas de função e pesquisa na web; se o Codex relatar unsupported_tool, um recurso ou servidor MCP que adiciona outro tipo de ferramenta está ativado.
  • Escolha um modelo que não seja do próprio OpenAI. Para ids de modelo, ele reconhece como OpenAI, como openai/gpt-5.6-sol, Codex muda para um formato de solicitação Nymbot não pode ler, e o pedido é recusado.
  • model_context_window diz ao Codex o tamanho do contexto do modelo, a partir context_length na lista de modelos; caso contrário, assume 272.000 tokens.
  • O Codex oferece ao modelo uma ferramenta de pesquisa na web, que o Nymbot executa com sua própria ferramenta. Pesquisa Web Quando a pergunta precisa ser feita. web_search = "disabled" no topo do arquivo para desligá-lo.
  • O Nymbot não armazena respostas.O Codex já envia toda a conversa de cada vez, então nada precisa mudar.

Clínica

Na configuração de Cline em VS Code:

  1. Set Fornecedor de Fogo Dois Compatível com OpenAI.
  2. Set Base de URLs Dois https://nymbot.ai/api/v1.
  3. Coloque sua chave em Chave API compatível com OpenAI.
  4. Escolha o modelo abaixo Modelo IDCline carrega a lista do Nymbot uma vez que a URL e a chave estão inseridas; você também pode digitar um id como anthropic/claude-sonnet-5.

Abrir Modelo de Configuração e preencha em Tamanho da janela Contexto e Max tokens de saída a partir da lista de modelos, e tick Suporte Imagens Se o modelo tiver capabilities.vision, então Cline gerencia seu contexto corretamente.

Quilômetro Código

Na extensão VS Code, abra ConfiguraçõesVá para o Provedores Tab, deslize para baixo e clique Fornecedor CustomPreencha em:

  • Provedor de ID: nymbot
  • Exibição Nome: Nymbot
  • Fornecedor de API: Compatível com OpenAI
  • Base de URLs: https://nymbot.ai/api/v1
  • A chave do fogoA sua chave
  • Modelos: escolha-os da lista Kilo loads de Nymbot

Clique em SubmissãoPara o CLI, ou para definir os limites de um modelo e o suporte a ferramentas, defina o provedor em ~/.config/kilo/kilo.json Em vez disso:

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 chave acima é o próprio nome do Kilo para ele, usado em "model" como nymbot/…Tome limit da lista de modelos; sem ela, Kilo não pode gerenciar o contexto.

Roo Código

Roo Code foi descontinuado em 15 de maio de 2026.Se você ainda tem ele instalado, ele funciona com o Nymbot assim: Fornecedor de Fogo Dois Compatível com OpenAI, Base de URLs Dois https://nymbot.ai/api/v1Coloque sua chave em A chave do fogo e um modelo de ID em ModeloRoo Code só funciona através de chamadas de ferramentas, portanto, o modelo deve ter capabilities.toolsNa configuração do modelo, o Max tokens de saída, janela de contexto e Suporte Imagem da lista de modelos.

Continuação

A versão final do Continue é 2.0.0 e não é mais mantida, mas a extensão e seu CLI ainda funcionam. ~/.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 diz Continue o que o modelo pode fazer, uma vez que não pode dizer a partir de um Nymbot id. tool_use é o que o modo Agente precisa; deixe fora image_input Para um modelo sem capabilities.vision.
  • A segunda entrada usa um Nymbot Modelo embutido Continuando a pesquisa de codebase.

O que as ferramentas enviam

Um agente de codificação envia o modelo com o que quer que funcione: suas instruções, os arquivos que abre, a saída dos comandos que executa.Através do Nymbot, tudo isso é um pedido de API comum, com as proteções e limites descritos em O que a fogueira pode ver: não é end-to-end criptografado, Nymbot não o armazena, e o provedor do modelo o vê.

  • As ferramentas mantêm suas próprias histórias em sua máquina, e algumas conversam com seus criadores além disso. Claude Code, por um lado, ainda envia sua telemetria para o Anthropic quando ele é executado no Nymbot; CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 Sua ferramenta WebFetch ainda verifica cada domínio com o Anthropic, a menos que você defina skipWebFetchPreflight Dois true em suas configurações.
  • As chaves nos arquivos de configuração são apenas tão seguras quanto o arquivo. Mantenha-as fora de qualquer coisa que você se comprometa, e leia-as do ambiente onde a ferramenta permite.