跳到正文

其他客户端

只配置自己要用的先做完第 7 步验收,下面挑自己用的配。

各家软件的菜单叫法不太一样,但基本都有 Provider、Base URL、API Key、Protocol 和 Model 这几项。找到之后,照下表按协议填:

客户端Base URL协议模型
VS Code(Continue / Cline)、Cherry Studio、ChatBox、Cursorhttps://portdan.com/v1OpenAI Compatible当前分组支持的 GPT 模型
Claude Desktophttps://portdan.comAnthropic当前分组支持的 Claude 模型
OpenClawhttps://portdan.comanthropic-messages当前分组支持的 Claude 模型
Gemini CLIhttps://portdan.comGemini当前分组支持的 Gemini 模型
OpenCode Gemini providerhttps://portdan.com/v1betaGemini v1beta当前分组支持的 Gemini 模型
Hermeshttps://portdan.com/v1https://portdan.comchat_completionsanthropic_messages与所选协议匹配

VS Code、ChatBox、Cherry Studio、Cursor 和 Cline

用 VS Code 的话,先弄清楚自己装的是哪个扩展:

  • OpenAI Codex 扩展:下载并打开 Codex那页配,用 Responses、根地址 https://portdan.com 和本机的 Codex 配置,别在地址后面加 /v1
  • Continue 或 Cline: 就按本节来,选 OpenAI Compatible,Base URL 填 https://portdan.com/v1,模型从当前分组抄过来。

VS Code 里的 Cline、ChatBox、Cherry Studio 和 Cursor 都选 OpenAI Compatible / Custom OpenAI,API Key 把完整的 Key 粘进去。Base URL 别填成根地址,也别自己再补 /chat/completions

VS Code 用 Continue 的话,先装 Continue 扩展,再改用户级的 config.yaml。macOS / Linux 在 ~/.continue/config.yaml,Windows 在 %USERPROFILE%\.continue\config.yaml。文件里已经有别的配置就别整个覆盖,把下面的模型项合并进去:

yaml
name: Portdan
version: 1.0.0
schema: v1

models:
  - name: Portdan
    provider: openai
    model: "gpt-5.5"
    apiBase: "https://portdan.com/v1"
    apiKey: "sk-your-api-key"

存好后回到对应的扩展或客户端里,选刚加的那个模型,发一句 hi。Continue 没自动带出新模型的话,在 VS Code 命令面板跑一下 Developer: Reload Window。另外 Continue 现在用的是 config.yaml,旧的 config.json 改了也没用。

Claude Desktop

先从 Claude 下载页装好,然后把应用完全退掉。打开 CC Switch,在顶部选 Claude Desktop,别点成终端图标那个 Claude Code,然后新增一条自定义配置:

请求地址
https://portdan.com不加 /v1/messages
API Key
粘贴完整 Key不要添加 Bearer
模型
不用自己填最新版 CC Switch 会根据当前 Key 自动映射

保存并启用后,把 Claude Desktop 完全退出再打开,发一句 hi 试试。

OpenClaw(小龙虾)

先确认 Node.js 版本不低于 22.19,再装:

macOS / Linux / WSL2:

bash
curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell:

powershell
iwr -useb https://openclaw.ai/install.ps1 | iex

在 CC Switch 里选 OpenClaw,地址填 https://portdan.com,协议选 anthropic-messages。模型不用自己挑,最新版 CC Switch 会按当前 Key 自动映射。保存并启用后跑这几条:

bash
openclaw config validate
openclaw gateway restart
openclaw models list
openclaw dashboard

配置没生效的话,先看 openclaw config validate 报出来的具体路径和字段,再去重启 Gateway。

Gemini CLI

Gemini CLI 靠环境变量来配:

macOS / Linux:

bash
export GOOGLE_GEMINI_BASE_URL="https://portdan.com"
export GEMINI_API_KEY="sk-your-api-key"
export GEMINI_MODEL="gemini-2.0-flash"

Windows PowerShell:

powershell
$env:GOOGLE_GEMINI_BASE_URL="https://portdan.com"
$env:GEMINI_API_KEY="sk-your-api-key"
$env:GEMINI_MODEL="gemini-2.0-flash"

环境变量保存或导出之后,把软件完全退出再打开,发一句 hi

Hermes

在终端跑 hermes model,选 Custom endpoint。用 GPT 模型就是 https://portdan.com/v1chat_completions,用 Claude 模型就是 https://portdan.comanthropic_messages。想手动改的话,配置写在 ~/.hermes/config.yaml,Key 单独放 ~/.hermes/.env

text
PORTDAN_API_KEY=sk-your-api-key

GPT 分组示例:

yaml
model:
  provider: custom
  default: gpt-5.5
  base_url: https://portdan.com/v1
  api_mode: chat_completions
  api_key: ${PORTDAN_API_KEY}

换 Claude 分组的话,把 default 改成当前的 Claude 模型,base_url 换成 https://portdan.comapi_mode 换成 anthropic_messages。存好后跑 hermes,发一句 hi。不对劲就跑 hermes doctor 看看。

Antigravity 用的是独立地址,照 Antigravity 接入 那页来。

Portdan API 接入、配置与排查指南。