帮助中心 返回首页
最近更新：2025年12月15日 12:15

VS Code / Cursor / Trae 配置指南

适用 IDE:

  • VS Code: Microsoft Visual Studio Code
  • Cursor: AI-powered code editor (基于 VS Code)
  • Trae: ByteDance AI code editor (基于 VS Code)

说明: 以上三个 IDE 都基于 VS Code 构建,完全兼容 VS Code 扩展,配置方式完全相同。

支持的模型:

  • Claude: 官方 Claude Code for VS Code 扩展
  • GPT: 官方 Codex 扩展
  • Gemini: Roo Code 扩展

关于 IDE 兼容性

本文档适用于以下 IDE:

IDE 说明 扩展兼容性
VS Code Microsoft 官方开源代码编辑器 ✅ 原生支持
Cursor AI 增强的代码编辑器,基于 VS Code ✅ 完全兼容
Trae ByteDance AI 代码编辑器,基于 VS Code ✅ 完全兼容

重要: Cursor 和 Trae 都基于 VS Code 构建,所有 VS Code 扩展和配置方式在这三个 IDE 中完全相同。

1. 配置令牌

  1. 访问 NextAI Code 控制台 - 令牌管理 页面。

  2. 点击 添加令牌,参照下图进行配置:

    • 名称:随意填写(例如 vscode)
    • 令牌分组:选择对应的分组
    • 过期时间:建议选择 永不过期
    • 新建数量:1

    令牌基本信息

  3. 额度与限制设置:

    • 额度:建议开启 无限额度
    • 访问限制:留空(不建议启用模型限制)
    • IP白名单:留空(不建议填写)

    额度与限制

  4. 提交后,复制生成的 sk- 开头的令牌。

2. 关于 cc-switch 配置工具

2.1 什么是 cc-switch?

cc-switch 是一个可视化的配置管理工具,用于管理 AI CLI 工具的环境变量配置。

支持的 CLI 工具:

  • Claude Code CLI
  • Codex CLI
  • Gemini CLI

主要作用:

  • 可视化配置 API Key 和 Base URL
  • 自动管理环境变量
  • 支持多个配置快速切换

2.2 cc-switch 与 VS Code 扩展的关系

Codex 扩展 与 Claude Code for VS Code 类似,会读取 Codex CLI 的环境变量配置。因此:

  • ✅ 可以使用 cc-switch 配置 Codex CLI
  • ✅ Codex 扩展会自动读取这些配置
  • ✅ 无需在 VS Code 中重复配置

Roo Code 扩展:

  • ❌ 不读取 CLI 环境变量
  • ✅ 有自己独立的配置界面

2.3 安装 cc-switch

访问 GitHub Releases 下载对应版本:

  • macOS: .dmg 文件
  • Windows: .exe 安装包
  • Linux: .AppImage 或 .deb

3. Claude 配置

3.1 安装 Claude Code for VS Code

  1. 打开 VS Code
  2. 按 Ctrl+Shift+X (Mac: Cmd+Shift+X) 打开扩展视图
  3. 搜索 "Claude Code for VS Code"
  4. 找到发布者为 Anthropic (带认证标志 ✓) 的扩展
  5. 点击 Install 安装

安装Claude code 插件

3.2 配置 API Key 和 Base URL

你可以选择使用 cc-switch 工具 (推荐) 或 手动配置环境变量。

方式一:使用 cc-switch (推荐)

  1. 打开 cc-switch,选择 Claude,点击 + 按钮。

    添加供应商

  2. 填写配置:

    • 选择 自定义配置
    • API Key: 你的 NextAI Code 令牌 (sk-...)
    • 请求地址: https://www.nextai-code.com (无需 /v1)
    • 模型可不写,用默认即可。

    添加配置

  3. 保存并确保状态为 已启用。

  4. 重启 VS Code,Claude Code for VS Code 会自动读取配置。

方式二:手动配置环境变量

macOS / Linux:

export ANTHROPIC_AUTH_TOKEN="sk-..." # 你的 NextAI Code 令牌
export ANTHROPIC_BASE_URL="https://www.nextai-code.com"

Windows (PowerShell):

$env:ANTHROPIC_AUTH_TOKEN="sk-..."
$env:ANTHROPIC_BASE_URL="https://www.nextai-code.com"

Windows (CMD):

set ANTHROPIC_AUTH_TOKEN=sk-...
set ANTHROPIC_BASE_URL=https://www.nextai-code.com

重要:配置环境变量后需要重启 VS Code

3.3 使用 Claude

配置完成后,Claude Code for VS Code 会自动读取环境变量配置。

使用方式:

  • 打开一个文件，在右上角有一个 Anthropic 的图标，点击就可以进入对话面板

    使用Claude code

特别说明，在 Windows 版本的Cursor中，打开文件后，右上角没有 Anthropic 图标，需要点击 "..." 打开

使用Claude code

  • 在对话面板中，输入指令即可，比如输入：hi

使用Claude code

4. GPT 配置

4.1 安装 Codex 扩展

  1. 在 VS Code 扩展市场搜索 "Codex"
  2. 找到发布者为 OpenAI 的 "Codex - OpenAI's coding agent" 扩展
  3. 点击 Install 安装

安装codex 插件

4.2 配置 API Key 和 Base URL

Codex 扩展 与 Claude Code for VS Code 类似,会读取 Codex CLI 的环境变量配置。

你可以选择使用 cc-switch 工具 (推荐) 或 手动配置环境变量。

方式一:使用 cc-switch (推荐)

  1. 打开 cc-switch,选择 Codex,点击 + 按钮。

    添加供应商

  2. 填写配置:

    • 选择 自定义配置
    • API Key: 你的 NextAI Code 令牌 (sk-...)
    • 请求地址: https://www.nextai-code.com/v1 (必须包含 /v1)
    • 模型: 建议不写,用默认即可

    添加配置

  3. 保存并确保状态为 已启用。

  4. 重启 VS Code,Codex 扩展会自动读取配置。

方式二:手动配置环境变量

macOS / Linux:

export OPENAI_API_KEY="sk-..." # 你的 NextAI Code 令牌
export OPENAI_BASE_URL="https://www.nextai-code.com/v1"

Windows (PowerShell):

$env:OPENAI_API_KEY="sk-..."
$env:OPENAI_BASE_URL="https://www.nextai-code.com/v1"

Windows (CMD):

set OPENAI_API_KEY=sk-...
set OPENAI_BASE_URL=https://www.nextai-code.com/v1

重要:

  • GPT 使用 OpenAI 兼容协议,Base URL 必须包含 /v1 后缀
  • 配置环境变量后需要重启 VS Code

4.3 使用 Codex

  • 打开一个文件，在右上角有一个 openAI 的图标，点击就可以进入对话面板

    使用Codex

  • 在对话面板中输入指令即可，如：hi

    使用Codex

5. Gemini 配置 (Roo Code 扩展)

5.1 安装 Roo Code

  1. 在 VS Code 扩展市场搜索 "Roo Code"
  2. 找到发布者为 Roo Code 的 "Roo Code - A whole dev team of AI agents" 扩展
  3. 点击 Install 安装

安装Roo Code插件

5.2 配置 NextAI Code API

  1. 安装完成后,点击侧边栏的袋鼠图标打开 Roo Code 面板
  2. 点击面板右上角的齿轮图标进入设置

打开Roo Code设置

  1. 配置 API 信息:
    • API Provider: 选择 OpenAI Compatible
    • Base URL: 输入 https://www.nextai-code.com/v1
    • API Key: 输入你的 NextAI Code 令牌 (sk-...)
    • **Model **: 输入 gemini-3-pro-preview (或其他 Gemini 模型)

配置Roo Code API

  1. 点击 Save 保存配置，然后再点击 Deno

重要:Gemini 使用 OpenAI 兼容协议,Base URL 必须包含 /v1 后缀

5.3 使用 Roo Code

  • 点击侧边栏的袋鼠图标打开 Roo Code 面板
  • 在聊天面板中输入指令
  • Roo Code 会使用配置的 Gemini 模型回答

使用Roo Code

支持的 Gemini 模型:

  • gemini-3-pro-preview (下一代预览)
  • gemini-2.5-pro (当前旗舰)
  • gemini-2.5-flash (极速版)

6. 常见问题 (QA)

Claude Code 连接失败?
  1. 检查 cc-switch:打开 cc-switch,确认 Claude 供应商已启用
  2. 检查 Base URL:Claude 使用 https://www.nextai-code.com,不包含 /v1
  3. 验证 API Key:确认令牌完整复制,格式为 sk- 开头
  4. 重启 VS Code:修改配置后必须重启 VS Code
Roo Code 连接失败?
  1. 检查 API Provider:确保选择 OpenAI Compatible
  2. 检查 Base URL:必须为 https://www.nextai-code.com/v1,包含 /v1
  3. 验证 API Key:确认令牌完整复制,格式为 sk- 开头
  4. 检查 Model ID:确保模型名称正确,如 gemini-2.5-pro
cc-switch 配置后 VS Code 没有生效?

请确保:

  1. cc-switch 中的配置状态为 已启用
  2. 完全退出并重启 VS Code (不是重新加载窗口)
  3. 如果仍然不行,尝试手动配置环境变量
额度不足
登录 NextAI Code 控制台 检查余额,必要时充值。
如何选择使用哪个模型?
  • Claude Sonnet:综合能力强,推荐复杂代码任务
  • GPT-5.1:知识面广,适合代码生成
  • Gemini Pro:多模态能力强,适合处理图像
  • Haiku/Flash:速度快,适合简单任务