跳到主要内容

工具配置

把每个工具连接到它期望的网关路径，然后在正式工作前先发送一个小测试请求。

先准备三个值​

每次配置都从这三个值开始：

  • 网关 URL
  • Prysm API 密钥
  • 网关公开的准确模型名

请使用 模型市场 或 模型路由 中显示的准确模型名。很多工具界面会分别展示显示标签和请求模型名。

选择正确的配置路径​

网关支持多种协议形态。具体工具决定应该使用哪条路径。

工具Base URL / 环境变量值认证方式协议最适合场景
Cursor{{BASE_URL}}/cursorCursor 的 OpenAI API Key 字段Cursor passthroughAsk、Plan
Claude CodeANTHROPIC_BASE_URL={{BASE_URL}}ANTHROPIC_AUTH_TOKEN通过网关转换的 Anthropic /v1/messages终端编码工作流
OpenAI Codex CLIOPENAI_BASE_URL={{BASE_URL}}OPENAI_API_KEY通过网关转换的 OpenAI /responsesCodex CLI 智能体工作流
OpenCode{{BASE_URL}}/v1OpenCode provider keyOpenAI 兼容 /v1多模型终端工作流
Cline{{BASE_URL}}OpenAI Compatible key 字段OpenAI 兼容VS Code Chat、Plan、Agent
VS Code / Continue{{BASE_URL}}OpenAI-compatible API keyOpenAI 兼容VS Code 助手工作流
GitHub CopilotVS Code proxy override URL = {{BASE_URL}}编辑器会话认证OpenAI 兼容代理覆盖行内补全、聊天
Gemini CLIGOOGLE_GEMINI_BASE_URL={{BASE_URL}}GEMINI_API_KEY通过网关路由的 Gemini CLIGemini 风格终端工作流
Qwen Code CLIOPENAI_BASE_URL={{BASE_URL}}OPENAI_API_KEYOpenAI 兼容Qwen 风格终端工作流
Open WebUIconnection URL = {{BASE_URL}}Prysm API 密钥OpenAI 兼容后端团队聊天工作区
Retool Assistcustom provider base URL = 公开 {{BASE_URL}}Prysm API 密钥OpenAI 兼容自定义 providerAI 辅助内部应用构建
OpenClawprovider base URL = {{BASE_URL}}Prysm API 密钥OpenAI 兼容 provider 后端聊天应用助手和智能体
SDK / Curl{{BASE_URL}} 或完整端点Bearer keyOpenAI 兼容应用集成、验证

先做通用验证​

在打开任何编码工具前，先跑一个请求。这个请求用于确认密钥、模型和网关路径都有效。

Python SDK​

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_PROXY_KEY",
    base_url="{{BASE_URL}}",
)

response = client.chat.completions.create(
    model="MODEL_NAME",
    messages=[
        {"role": "user", "content": "Reply with the word connected."}
    ],
)

print(response.choices[0].message.content)

JavaScript SDK​

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_PROXY_KEY",
  baseURL: "{{BASE_URL}}",
});

const response = await client.chat.completions.create({
  model: "MODEL_NAME",
  messages: [{ role: "user", content: "Reply with the word connected." }],
});

console.log(response.choices[0].message.content);

Curl​

curl {{CHAT_COMPLETIONS_URL}} \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_PROXY_KEY" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [
      {"role": "user", "content": "Reply with the word connected."}
    ]
  }'

Cursor​

Cursor 使用网关的 /cursor 路径。当前已验证的集成支持使用Prysm API 密钥的 Ask 和 Plan 模式。

  1. 打开 Cursor → Settings → Cursor Settings → Models。
  2. 在 OpenAI API Key 中填入你的Prysm API 密钥。
  3. 启用 Override OpenAI Base URL，并设置为 {{BASE_URL}}/cursor。
  4. 点击 Add Custom Model。
  5. 粘贴 模型路由 中的 Public Model Name。
  6. 打开 Ask 或 Plan，并选择该模型。

首次测试​

在 Ask 模式发送一条短消息，例如 Reply with: Cursor connected。

已知行为​

  • Ask 和 Plan 是自定义密钥配置的主要路径。
  • Agent 模式遵循 Cursor 自身的自定义密钥支持边界。
  • Model not responding 错误通常表示 URL 缺少 /cursor，或密钥没有目标模型权限。

Claude Code​

Claude Code 发送 Anthropic Messages API 请求。网关会把该格式转换到目标 provider。

环境变量​

export ANTHROPIC_BASE_URL="{{BASE_URL}}"
export ANTHROPIC_AUTH_TOKEN="YOUR_PROXY_KEY"

export ANTHROPIC_MODEL="MODEL_NAME"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="MODEL_NAME"
export ANTHROPIC_DEFAULT_OPUS_MODEL="MODEL_NAME"
export ANTHROPIC_DEFAULT_SONNET_MODEL="MODEL_NAME"
export ANTHROPIC_REASONING_MODEL="MODEL_NAME"

可选配置文件路径​

  • macOS / Linux：~/.claude/settings.json
  • Windows：C:\Users\your-user-name\.claude\settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "{{BASE_URL}}",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_PROXY_KEY",
    "ANTHROPIC_MODEL": "MODEL_NAME",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MODEL_NAME",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MODEL_NAME",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MODEL_NAME",
    "ANTHROPIC_REASONING_MODEL": "MODEL_NAME"
  }
}

首次测试​

打开 Claude Code 前先验证协议：

curl -X POST {{BASE_URL}}/v1/messages \
  -H "Authorization: Bearer YOUR_PROXY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "max_tokens": 128,
    "messages": [
      {"role": "user", "content": "Reply with the word connected."}
    ]
  }'

然后用同一个模型启动 Claude Code：

claude --model MODEL_NAME

Responses API 说明​

较新的网关版本默认会把 /v1/messages 通过 /responses 路由。这是推荐的后续路径。

如果你的 Claude Code 请求已经到达 Prysm，但仍在模型层失败，请让 Prysm 管理员检查网关的 Anthropic 兼容模式。

gateway_settings:
  use_chat_completions_url_for_anthropic_messages: true

这个设置适用于在网关后方需要 chat-completions 兼容性的 provider 组合。

OpenAI Codex CLI​

OpenAI Codex CLI 使用网关根 URL 和标准 OpenAI 兼容认证变量。

版本说明​

请使用已经支持 /responses 路由的网关版本来运行 Codex 工作流。

环境变量​

export OPENAI_BASE_URL="{{BASE_URL}}"
export OPENAI_API_KEY="YOUR_PROXY_KEY"

网关就绪条件​

Codex 在 Prysm 已经具备以下条件时效果最好：

  • 已启用 /responses 支持
  • 有一个稳定的公开模型名供 Codex 选择
  • 网关配置已经匹配 Codex 的参数形态

如果 Codex 已连接 Prysm，但在开始生成前失败，请让 Prysm 管理员确认这些条件。

首次测试​

codex --model gpt-5

Responses API 说明​

Codex 是最适合按 /responses 思路理解的工具。网关的 /responses 支持覆盖流式输出、日志、成本追踪、get、delete，以及跨支持模型的 provider 桥接。

OpenCode​

OpenCode 最适合使用 OpenAI 兼容的 /v1 base。

配置文件​

全局配置通常位于：

~/.config/opencode/opencode.json

示例配置：

{
  "provider": {
    "prysm": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Prysm",
      "options": {
        "baseURL": "{{BASE_URL}}/v1"
      },
      "models": {
        "gpt-5": {
          "name": "GPT-5"
        },
        "claude-sonnet-4-6-stable": {
          "name": "Claude Sonnet 4.6"
        }
      }
    }
  }
}

连接并测试​

opencode

在 OpenCode 内输入：

/connect

然后填写：

  • provider name：Prysm
  • API key：你的Prysm API 密钥

之后输入：

/models

选择一个已配置模型，并发送一条短测试 prompt。

Cline​

Cline 通过 OpenAI Compatible 模式工作，并使用网关根路径。

  1. 在 VS Code 中打开项目文件夹。
  2. 在 VS Code 中打开 Cline。
  3. 打开 Cline 面板中的设置。
  4. 选择 OpenAI Compatible 作为 provider。
  5. 填写：
    • Base URL：{{BASE_URL}}
    • API Key：YOUR_PROXY_KEY
    • Model ID：MODEL_NAME
  6. 保存并开始 chat 或 plan 流程。

首次测试​

使用短 prompt，例如 Reply with: Cline connected。

已验证路径​

内部验证显示，Cline 在 OpenAI 兼容模型以及已经通过基础 curl 测试的网关公开国内模型上体验最顺畅。

VS Code / Continue​

Continue 使用 OpenAI-compatible provider 接入网关后端模型时最顺畅。这样可以让请求模型名与网关返回的模型身份保持一致。

新增或更新一个模型配置：

  • provider：OpenAI-compatible
  • base URL：{{BASE_URL}}
  • API key：YOUR_PROXY_KEY
  • model：MODEL_NAME

首次测试​

打开需要 Continue 编辑的同一个 VS Code workspace folder，然后发送短 prompt，例如 Reply with: Continue connected。

配置说明​

  • 网关后端模型使用 OpenAI-compatible 配置。
  • Claude 系列真实模型路由使用 Anthropic 专用配置。
  • 让 Continue、Cline 或其他扩展创建和编辑文件前，先打开 VS Code workspace folder。

更多支持工具​

网关还可以配合多种使用 OpenAI 兼容、Gemini 风格或编辑器代理覆盖流程的工具。

GitHub Copilot​

GitHub Copilot 可以通过覆盖编辑器设置中的代理 URL 走网关。

把以下内容加入 VS Code settings.json：

{
  "github.copilot.advanced": {
    "debug.overrideProxyUrl": "{{BASE_URL}}",
    "debug.testOverrideProxyUrl": "{{BASE_URL}}"
  }
}

首次测试​

重启 VS Code，打开 Copilot Chat，发送一条短消息，例如 Reply with: Copilot connected。

Gemini CLI​

Gemini CLI 通过指向网关的环境变量工作。

export GOOGLE_GEMINI_BASE_URL="{{BASE_URL}}"
export GEMINI_API_KEY="YOUR_PROXY_KEY"

启动 CLI：

gemini

模型路由说明​

Gemini CLI 最适合 Gemini 系列模型名。如果你希望 Gemini CLI 通过 Prysm 使用其他 provider，请让 Prysm 管理员公开一个兼容该 CLI 调用的模型别名。

首次测试​

运行一个短 prompt，例如 Reply with: Gemini connected。

Qwen Code CLI​

Qwen Code CLI 使用标准 OpenAI 兼容环境变量。

export OPENAI_BASE_URL="{{BASE_URL}}"
export OPENAI_API_KEY="YOUR_PROXY_KEY"
export OPENAI_MODEL="qwen-code"

启动 CLI：

qwen

模型路由说明​

当 Prysm 公开了稳定的模型名，例如 qwen-code 或其他供 CLI 请求的准确别名时，Qwen Code CLI 的效果最好。需要时请让 Prysm 管理员确认准确模型名。

首次测试​

运行一个短 prompt，例如 Reply with: Qwen connected。

Open WebUI​

Open WebUI 通过标准后端连接接入。

在 Settings → Connections 中创建新连接：

  • URL：{{BASE_URL}}
  • Key：YOUR_PROXY_KEY

首次测试​

打开模型选择器，选择一个网关公开模型，并发送短消息，例如 Reply with: Open WebUI connected。

适合场景​

Open WebUI 很适合共享聊天访问、模型对比，以及团队采用编辑器原生工具前的轻量内部试用。

Retool Assist​

Retool Assist 通过自定义 AI provider 接入。

Hosted Retool 需要公开 URL。本地 localhost 网关 URL 只适用于自托管或本地桥接的 Retool 设置。

如果你只有内部 Prysm 地址，请向 Prysm 管理员索取 Retool 可以访问的公开 URL。

在 Retool 中创建自定义 AI provider：

  • Provider Schema：OpenAI
  • Base URL：公开 {{BASE_URL}}
  • API Key：YOUR_PROXY_KEY
  • Model：网关公开的准确模型名

首次测试​

打开 Retool Assist 或 AI resource query，发送短 prompt，例如 Reply with: Retool connected。

适合场景​

Retool Assist 很适合构建内部工具的团队，用一个受治理的 AI 后端支持应用生成、编辑和查询辅助。

OpenClaw​

OpenClaw 通过 onboarding 流程把聊天渠道和智能体连接到网关。

运行 onboarding：

openclaw onboard --install-daemon

配置过程中：

  • 选择网关支持的 provider 选项
  • 把 base URL 设置为 {{BASE_URL}}
  • 输入 YOUR_PROXY_KEY
  • 输入网关公开的准确模型名

首次测试​

onboarding 完成后验证：

openclaw health
openclaw agent --agent main -m "Reply with: OpenClaw connected"

适合场景​

当你想在 WhatsApp、Telegram、Discord 和其他聊天界面后方统一使用同一个网关模型层时，OpenClaw 很合适。

SDK 和端点参考​

当工具要求完整端点而非 base URL 时，使用这些值：

  • base URL：{{BASE_URL}}
  • chat completions URL：{{CHAT_COMPLETIONS_URL}}
  • embeddings URL：{{EMBEDDINGS_URL}}
  • Anthropic messages URL：{{BASE_URL}}/v1/messages
  • Cursor base URL：{{BASE_URL}}/cursor
  • VS Code 扩展 OpenAI 兼容 base URL：{{BASE_URL}}
  • OpenCode /v1 base URL：{{BASE_URL}}/v1

排查清单​

  1. 确认工具正在使用该工具对应的正确协议路径。
  2. 确认密钥拥有所选模型的访问权限。
  3. 确认模型名与网关公开名称完全一致。
  4. 调试工具界面前，先用 curl 或 SDK 发送一个直接测试请求。
  5. 文件编辑前先打开目标 VS Code workspace folder。
  6. VS Code 扩展接入网关后端模型时使用 OpenAI-compatible 模式。
  7. 按请求时间查看 日志，区分 key、模型、路由和上游 provider 错误。