VS Code

VS Code 本身没有 AI 对话框，靠的是扩展。先分清你装的是哪一个：

• OpenAI Codex 扩展： 不用单独配。它读你本机的 Codex 配置，照 Codex 接入教程 配好 CC Switch 之后，它自动走 Portdan。
• Cline 扩展： 照这页配，全程在图形界面里点，不用改配置文件。

1. 安装 Cline

打开 VS Code 左侧的扩展面板（Ctrl / Cmd + Shift + X），搜 Cline，认准发布者 saoudrizwan，点安装。装完左侧边栏会多一个 Cline 图标。

也可以直接打开 Cline 扩展市场页（会新开一个标签页）安装。

2. 打开 Cline 设置

点左侧边栏的 Cline 图标打开面板，再点面板里的 ⚙️（设置）。

3. 选协议，填三项

API Provider 下拉选 OpenAI Compatible，然后填这三项：

Base URL

https://portdan.com/v1必须带 /v1，别再补 /chat/completions

API Key

粘贴你的完整 Key原样粘贴，别加引号或空格

Model

填 gpt-5.5想用别的模型，从你的分组模型列表里抄，一字不差

你的 Key 能用哪些模型，照查看 Key 的全部模型里那条命令查。

填完保存设置。

4. 发 hi 验证

回到 Cline 面板，开一个新任务，发一句 hi。正常回复，就配好了。

想再确认一遍：打开 Portdan 使用记录并刷新，发 hi 之后有一条新记录，才算真的走了 Portdan。

对不上就按症状查Invalid API Key：Key 粘错了，重新复制粘贴；Model Not Found：模型名没抄对，或这个分组没有该模型；连接报错：先查 Base URL 是不是带 /v1，再查网络。还搞不定，按问题排查清单一项项查。