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:

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

1. 配置令牌

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

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

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

   

3. 额度与限制设置:

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

   

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

2. Claude 配置

2.1 安装 Claude CLI

打开终端 (Terminal)，运行以下命令安装 Claude Code CLI：

npm install -g @anthropic-ai/claude-code

注意: 需要 Node.js 18+ 环境。

2.2 安装 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 安装

2.3 配置 API Key 和 Base URL

Claude Code for VS Code 会读取 Claude Code CLI 的配置文件和环境变量。

推荐配置方式 (修改 settings.json):

• Windows: C:\Users\{用户名}\.claude\settings.json
• macOS / Linux: ~/.claude/settings.json

配置文件内容示例：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
        "ANTHROPIC_BASE_URL": "https://www.nextai-code.com",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
    },
    "alwaysThinkingEnabled": true
}

提示: 配置完成后需完全重启 VS Code 生效。

2.4 使用 Claude

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

使用方式:

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

  

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

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

3. Codex 配置

3.1 安装 Codex CLI

打开终端，运行以下命令安装 Codex CLI：

npm install -g @openai/codex

3.2 安装 Codex 扩展

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

3.3 配置 API Key 和 Base URL

Codex 扩展 会读取 Codex CLI 的配置文件。

配置文件路径:

• config.toml: ~/.codex/config.toml
• auth.json: ~/.codex/auth.json

1. 创建或编辑 config.toml

model_provider = "nextai"
model = "gpt-5.2"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.nextai]
name = "nextai"
base_url = "https://www.nextai-code.com/v1"
wire_api = "responses"
requires_openai_auth = true

2. 创建或编辑 auth.json

{
  "OPENAI_API_KEY": "你的API密钥"
}

提示: 配置完成后需完全重启 VS Code 生效。

3.4 使用 Codex

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

  

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

  

4. Gemini 配置 (Roo Code 扩展)

4.1 安装 Roo Code

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

4.2 配置 NextAI Code API

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

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

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

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

4.3 使用 Roo Code

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

支持的 Gemini 模型:

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

5. 常见问题 (QA)

Claude Code 连接失败?

1. 检查配置文件: 检查 settings.json 路径和内容是否正确
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

VS Code 没有生效?

请确保:

1. 配置文件路径正确
2. 完全退出并重启 VS Code (不是重新加载窗口)

额度不足

登录 NextAI Code 控制台 检查余额,必要时充值。

如何选择使用哪个模型?

• Claude Sonnet: 综合能力强，推荐复杂代码任务
• GPT-5.2: 知识面广，适合代码生成
• Gemini Pro: 多模态能力强，适合处理图像
• Haiku/Flash: 速度快，适合简单任务