外观
VS Code / Cursor / Trae 配置指南
最近更新:2026 年 10 月 17 日(Asia/Shanghai)
关联:帮助中心 · Claude Code · Codex · 大模型 API
适用 IDE(均基于 VS Code 生态,扩展大体兼容):
| IDE | 说明 |
|---|---|
| VS Code | Microsoft 官方编辑器 |
| Cursor | AI 增强编辑器 |
| Trae | 字节系 AI 编辑器 |
常见扩展路径:Claude Code 扩展、Codex 扩展、Cline / Roo Code 等「OpenAI Compatible」Agent。
1. 准备令牌
控制台创建专用令牌(如 vscode),复制 sk-xxxxxxxx。建议设额度上限。
2. Cursor 内置模型设置
- 打开 Settings → Models(或 Cursor Settings)。
- OpenAI API Key 填入
sk-xxxxxxxx。 - 开启 Override OpenAI Base URL,填入:
https://ai.afp.net/v1(带/v1)。 - Add model,手动添加平台模型 ID,例如:
claude-sonnet-4-6gemini-3.1-prokimi-k3deepseek-v4-flash
- 点击 Verify / 保存。
INFO
Cursor 部分请求从 Cursor 云端发出,因此 https://ai.afp.net 须公网可达。Tab 补全等功能可能仍走 Cursor 自有模型,不会使用你的自定义 Key。
3. Claude Code for VS Code
- 终端安装 CLI(扩展常依赖同一套配置):
bash
npm install -g @anthropic-ai/claude-code- 扩展市场搜索 Claude Code,安装发布者为 Anthropic 的扩展。
- 配置
~/.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 扩展
npm install -g @openai/codex- 安装 OpenAI Codex 扩展。
- 按 Codex CLI 配置
~/.codex/config.toml(base_url带/v1)与auth.json。 - 重启 IDE。模型字段请填平台实测可用的 ID。
5. Cline / Roo Code(OpenAI Compatible)
- 安装 Cline 或 Roo Code 扩展。
- API Provider 选 OpenAI Compatible。
- 填写:
- Base URL:
https://ai.afp.net/v1 - API Key:
sk-xxxxxxxx - Model ID:如
gemini-3.1-pro或claude-sonnet-4-6
- Base URL:
- 保存后在侧边栏对话测试。
若扩展支持 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 404 | Base 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 | 小改动、补全式任务 |
返回:帮助中心