跳至內容
回到 Nymbot

知識庫 開發者

程式開發工具

允許您選擇模型請求去向的編碼代理（Coding agents）可以在 Nymbot 上執行。每個代理都需要一個基礎 URL、一個金鑰和一個模型 ID；本頁面提供了 各個代理的確切設定。

為了方便起見，此頁面是機器翻譯的。英文原件為適用版本。

在你開始之前

您需要一個在應用程式中生成的 API 金鑰 API 菜單 (見 API 金鑰). 每種工具都使用 API 三種格式之一， 而這決定了其基本 URL：

工具格式基礎 URL
Claude CodeAnthropic 訊息https://nymbot.ai/api
Codex CLI回覆https://nymbot.ai/api/v1
Cline, Kilo Code, Roo Code, Continue聊天補全https://nymbot.ai/api/v1

模型 ID 來自 模型列表, GET https://nymbot.ai/api/v1/models，不需要金鑰。下方的範例使用 anthropic/claude-sonnet-5 而且，對於另一個製造商的模型， moonshotai/kimi-k3請檢查您選擇的模型是否仍列在其中。

  • 選擇一個可以呼叫工具的模型。 這些代理程式在每一步都會透過呼叫工具來讀取檔案、編輯檔案並執行 指令。請使用其條目具有以下內容的模型 capabilities.tools 設定為 true. nymbot/auto 拒絕任何 使用工具的請求 (400 unsupported_tool), 所以它無法與其中任何一個配合使用。
  • 將模型的限制複製到工具中。 大多數工具會要求上下文視窗 以及最大輸出。從...中取得 context_length 和 max_output_tokens 在模型列表中。要求輸出量超過模型 允許範圍的工具不會被拒絕；請求會被降低至模型的最大值。
  • 步驟完整到達。 帶有工具的請求會整塊執行，然後以串流形式傳回，在模型運作時會發送 keep-alive ping。 以下每個工具都支援串流，但每個步驟是同時出現，而不是逐字顯示。
為每個工具分配專屬金鑰

為每個工具建立獨立的金鑰，並設定每日上限。程式碼代理在執行單一任務時會進行多次模型調用，每次調用都會攜帶至今為止的對話內容，因此單一任務的成本可能遠高於單一聊天訊息。為金鑰設定上限是掌握工具最高支出的最簡單方法，且撤銷該金鑰可以單獨停止該工具。

Claude Code

Claude Code 透過其閘道器設定與 Nymbot 通訊。請在啟動它的 shell 中設定這些內容：

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
  • 基礎 URL 正是 https://nymbot.ai/api：否 /v1 而且結尾不要有 斜線，因為 Claude Code 會加上 /v1/messages 本身
  • 鑰匙插進去 ANTHROPIC_AUTH_TOKEN, Claude Code 會將其發送為 Authorization: Bearer當設定此項時，這些請求不會使用已儲存的 claude.ai 登入狀態，且您的訂閱限制也不會適用。
  • 釘定模型插槽。預設情況下，Claude Code 會要求 Anthropic 最新的模型名稱，而 Nymbot 僅會以其目錄中相同或更新的版本來回答 Claude 名稱，絕不會回覆 較舊的版本；目錄尚未提供的版本則會回傳 404. 指向 opus, sonnet 和 haiku 在目錄 ID 時可以避免該問題。如果 你使用 fable 別名, 設定 ANTHROPIC_DEFAULT_FABLE_MODEL 以同樣的方式。
  • 釘定 Haiku 插槽也會將 Claude Code 的背景工作（例如對話標題） 移至該較便宜的模型。若不使用它，該工作將會在您的主要模型上執行。

啟動 Claude Code 並執行 /status. 的 狀態 tab 應該顯示一個 Anthropic base URL 與...連線 https://nymbot.ai/api 和一個 Auth token 行命名 ANTHROPIC_AUTH_TOKEN.

若要保留每個工作階段的設定，請將它們放在 env 塊 ~/.claude/settings.json (%USERPROFILE%\.claude\settings.json 在 Windows) 代替。絕不要將金鑰放在專案的 .claude/settings.json, 其 隨專案一併提交。

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

還有一些值得了解的設定：

  • 輸出長度 集合 CLAUDE_CODE_MAX_OUTPUT_TOKENS 至 模型的 max_output_tokens，因此 Claude Code 會針對模型實際擁有的限制來規劃其回覆。
  • 模型選擇器 與 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, Claude Code 在啟動時讀取 Nymbot 的模型 列表，並將其中的 Claude 模型加入其中 /model.
  • 不要包含顧問。 Claude Code 的顧問是一個運行在 Anthropic 自身伺服器上的工具，Nymbot 無法運行它，且攜帶該工具的請求會被拒絕。不要用...來開啟它。 /advisor，或集合 CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 將其完全移除。
  • 關閉 MCP 工具搜尋。 Claude Code 會針對自定義的基礎 URL 將其關閉， 而 Nymbot 無法接收它所傳送的工具引用，所以不要設定 ENABLE_TOOL_SEARCH=true. MCP 工具仍可運作；只是改為預先載入。

Claude Code 也可以在非 Claude 模型上執行：將模型插槽指向另一個目錄 id，例如 moonshotai/kimi-k3, 以及設定 CLAUDE_CODE_MAX_CONTEXT_TOKENS 到那個模型的 context_length，因為 Claude Code 無法得知。Anthropic 不支援在其他模型上使用 Claude Code，因此可能會有一些不完善之處。

VS Code 中的 Claude Code

該 VS Code 擴充功能執行相同的 Claude Code，但在啟動前會先檢查憑證，因此 請在 VS Code 自己的使用者設定中提供相關設定。執行 偏好設定：開啟使用者設定 (JSON) 並加上：

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

停用登入提示 停止擴充功能要求您登入 Anthropic。 Everything in Claude Code 上述內容同樣適用於擴充功能；設定 中 ~/.claude/settings.json 也能觸及它，但該擴充功能的登入檢查僅讀取 它自己的設定。

Codex CLI

Codex 使用 Responses API。在...中新增 Nymbot 作為提供者 ~/.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

然後設定 NYMBOT_API_KEY 在您的環境中並執行 codex.

  • multi_agent = false 是必須的。 Codex 的多代理工具 是一組 Nymbot 無法取得的工具，且在它們存在時，每一項請求都會被 拒絕，原因為 400 unsupported_tool. Nymbot 僅使用函式工具與 網頁搜尋；如果 Codex 回報 unsupported_tool，一個新增另一種工具的 功能或 MCP 伺服器已開啟。
  • 選擇一個不是 OpenAI 自己的模型。 對於它識別為 OpenAI 的模型 ID，例如 openai/gpt-5.6-sol, Codex 切換到請求格式 Nymbot 無法閱讀，且請求被拒絕。Claude、Kimi 和其他目錄模型 可以運作。
  • model_context_window 告訴 Codex 模型的上下文大小，從 context_length 在模型列表中；否則它會假設為 272,000 個 token。
  • Codex 為模型提供了一個網頁搜尋工具，而 Nymbot 則使用其自身的工具來執行該功能 網路搜尋 當問題需要時。設定 web_search = "disabled" 在檔案頂端將其關閉。
  • Nymbot 不會儲存回應。Codex 每次已經會傳送整個對話內容，所以 不需要做任何變動。

Cline

在 VS Code 的 Cline 設定中：

  1. 集合 API 提供者 到 OpenAI 相容.
  2. 集合 基礎 URL 到 https://nymbot.ai/api/v1.
  3. 將您的金鑰貼入 OpenAI 相容 API 金鑰.
  4. 選擇下方的模型 模型 ID. Cline 在 URL 和金鑰輸入後，會從 Nymbot 載入清單；你也可以輸入一個 ID，例如 anthropic/claude-sonnet-5.

打開 模型配置 並填寫 上下文窗口大小 和 最大輸出權杖數 從模型列表中，並勾選 支援 圖片 如果模型具有 capabilities.vision，所以 Cline 正確地管理其上下文。

Kilo 程式碼

在 VS Code 擴充功能中，開啟 設定, 前往 供應商 按 Tab 鍵，滾動到最底部然後點擊 自訂提供者. 填寫：

  • 提供者 ID: nymbot
  • 顯示名稱: Nymbot
  • 供應商 API: OpenAI 相容
  • 基礎 URL: https://nymbot.ai/api/v1
  • API 金鑰：你的金鑰
  • 模型：從 Kilo 從 Nymbot 載入的清單中挑選它們

點擊 提交，且模型會出現在模型選擇器中。對於 CLI，或是為了設定模型的限制與工具支援，請在...中定義 provider ~/.config/kilo/kilo.json 改為：

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 Nymbot 模型 ID 以及其上方的金鑰是 Kilo 對其自身的稱呼，用於 "model" as nymbot/…. 拿 limit 來自模型 列表；沒有它 Kilo 就無法管理上下文。

Roo Code

Roo Code 已於 2026 年 5 月 15 日停止服務。如果您仍安裝著它，它可與 Nymbot 如下所示：set API 提供者 到 OpenAI 相容, 基礎 URL 到 https://nymbot.ai/api/v1，請插入您的鑰匙 API 金鑰 以及一個模型 ID 在內 模型. Roo Code 僅透過 工具調用 (tool calls) 運作，因此模型必須具備 capabilities.tools. 在模型 配置下，設定 最大輸出權杖數, 上下文窗口 和 圖片支援 從模型列表中。

繼續

Continue 的最終版本是 2.0.0 且已不再維護，但該擴充功能及其 CLI 仍可運作。將 Nymbot 模型新增至 ~/.continue/config.yaml (%USERPROFILE%\.continue\config.yaml (在 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 告訴模型它能做什麼，因為它無法從 Nymbot id 判斷。 tool_use 是 Agent 模式所需要的；刪除 image_input 對於一個沒有的模型 capabilities.vision.
  • 第二個項目使用了一個 Nymbot 嵌入模型 用於 Continue 的程式碼庫搜尋。

工具發送了什麼

程式碼代理程式會將它處理的一切內容傳送給模型：你的指令、它開啟的檔案、 以及它執行的指令輸出。透過 Nymbot，這一切都是一般的 API 請求，並受到 其中所述的保護與限制。 API 可以看到什麼它並非端到端加密，Nymbot 不會儲存它，且模型的提供者會看到它。

  • 工具會在您的機器上保留各自的紀錄，且有些工具還會與其開發者通訊。 例如 Claude Code，當它在 Nymbot 上執行時，仍會將其遙測數據傳送至 Anthropic；設定 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 要停止該行為及其其他的背景 流量。除非您進行設定，否則其 WebFetch 工具仍會針對每個網域向 Anthropic 進行檢查 skipWebFetchPreflight 到 true 在其設定中。
  • 設定檔中的金鑰安全性僅取決於該檔案本身的安全性。請避免將它們提交到任何版本控制中，並在工具允許的情況下，從環境變數中讀取它們。