Skip to content

VS Code / Cursor / Trae 配置指南 ​

最近更新:2026 年 10 月 17 日(Asia/Shanghai)

关联:帮助中心 · Claude Code · Codex · 大模型 API

适用 IDE(均基于 VS Code 生态,扩展大体兼容):

IDE说明
VS CodeMicrosoft 官方编辑器
CursorAI 增强编辑器
Trae字节系 AI 编辑器

常见扩展路径:Claude Code 扩展、Codex 扩展、Cline / Roo Code 等「OpenAI Compatible」Agent。


1. 准备令牌 ​

控制台创建专用令牌(如 vscode),复制 sk-xxxxxxxx。建议设额度上限。


2. Cursor 内置模型设置 ​

  1. 打开 Settings → Models(或 Cursor Settings)。
  2. OpenAI API Key 填入 sk-xxxxxxxx。
  3. 开启 Override OpenAI Base URL,填入:https://ai.afp.net/v1(带 /v1)。
  4. Add model,手动添加平台模型 ID,例如:
    • claude-sonnet-4-6
    • gemini-3.1-pro
    • kimi-k3
    • deepseek-v4-flash
  5. 点击 Verify / 保存。

INFO

Cursor 部分请求从 Cursor 云端发出,因此 https://ai.afp.net 须公网可达。Tab 补全等功能可能仍走 Cursor 自有模型,不会使用你的自定义 Key。


3. Claude Code for VS Code ​

  1. 终端安装 CLI(扩展常依赖同一套配置):
bash
npm install -g @anthropic-ai/claude-code
  1. 扩展市场搜索 Claude Code,安装发布者为 Anthropic 的扩展。
  2. 配置 ~/.claude/settings.json(与 Claude Code CLI 相同):
json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://ai.afp.net",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "alwaysThinkingEnabled": true
}

注意:Claude 路径的 Base URL 不带 /v1。改完后完全退出并重启 IDE。


4. Codex 扩展 ​

  1. npm install -g @openai/codex
  2. 安装 OpenAI Codex 扩展。
  3. 按 Codex CLI 配置 ~/.codex/config.toml(base_url 带 /v1)与 auth.json。
  4. 重启 IDE。模型字段请填平台实测可用的 ID。

5. Cline / Roo Code(OpenAI Compatible) ​

  1. 安装 Cline 或 Roo Code 扩展。
  2. API Provider 选 OpenAI Compatible。
  3. 填写:
    • Base URL:https://ai.afp.net/v1
    • API Key:sk-xxxxxxxx
    • Model ID:如 gemini-3.1-pro 或 claude-sonnet-4-6
  4. 保存后在侧边栏对话测试。

若扩展支持 Anthropic 自定义 Base URL,可改为:

  • Provider:Anthropic
  • Custom Base URL:https://ai.afp.net(无 /v1)
  • Key:同一 sk-

6. 其它 OpenAI 兼容扩展 ​

凡要求 OpenAI Base URL 的插件,通常填 https://ai.afp.net/v1。报 404 时按「带 / 不带 /v1」对照本页与 大模型 API 排查。


7. 故障排查 ​

现象处理
Claude 连不上Base URL 是否误加 /v1;是否重启 IDE
Roo / Cline 404Base URL 是否缺少 /v1
Cursor Verify 失败Key、公网可达性、模型 ID 是否与 /v1/models 一致
改配置不生效完全退出进程再开,不要只 Reload Window
额度不足控制台查余额与令牌额度

模型怎么选? ​

类型示例场景
综合编码claude-sonnet-4-6日常推荐
重推理claude-opus-4-8、claude-opus-5复杂重构
多模态gemini-3.1-pro读图、宽上下文
高性价比claude-haiku-4-5、gemini-3.5-flash、deepseek-v4-flash小改动、补全式任务

返回:帮助中心