使用指南

Cursor 配置

LLMs Text

Cursor 配置 4AICode API

Cursor 是基于 VS Code 的 AI 编程 IDE。可以通过自定义 OpenAI 兼容接口,或安装 Claude Code 扩展,把请求转到 4AICode,统一管理 Token、团队额度与用量。

准备工作

  1. 登录 4AICode,进入 仪表盘 → 管理 Tokens 新建 Token(sk-4ai-...)。
  2. 选择线路:
    • 中国大陆:https://relay.4aicode.net
    • 国际网络:https://relay.4aicode.com

方式一:Cursor 模型设置(OpenAI 兼容)

适合使用 Cursor 自带 Chat / Agent,并希望走 GPT 类模型。

  1. 打开 Cursor Settings → Models。
  2. 打开 OpenAI API Key / 自定义接口相关选项(不同版本菜单位置可能略有差异)。
  3. 填入:
    • API Key:sk-4ai-<your-token>
    • Base URL / Override OpenAI Base URL:https://relay.4aicode.net/v1(海外用 .com)
  4. 在模型列表中选择 4AICode 支持的模型 ID,例如 gpt-6-astra、gpt-5.6-sol。完整清单见 模型目录。
  5. 新开一个 Chat,发送 ping;再到 用量 确认出现对应记录。

Cursor 原生 Chat 与 Claude Code 扩展互不影响。原生 Chat 走你在 Models 里配置的 OpenAI 兼容接口;Claude Code 扩展走 Anthropic Messages 协议。

方式二:Claude Code 扩展

若你主要用 Anthropic Claude Code 面板,可按 VS Code / Cursor / Windsurf 指南 配置 claudeCode.environmentVariables:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://relay.4aicode.net" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-4ai-xxxxxxxxxxxxxxxx" }
  ]
}

改完后务必完全退出 Cursor 再打开,否则环境变量不会刷新。

常见问题

Q:配置后仍要求登录 Cursor / Anthropic 账号?

检查 Base URL 是否带了 /v1(OpenAI 兼容)或未带 /v1(Claude Code 的 ANTHROPIC_BASE_URL)。二者路径规则不同。

Q:模型名填错会怎样?

上游或网关会返回明确的不支持错误。请对照 模型目录 使用准确 ID。

Q:出现 401 / 429?

见 401 排查 与 429 排查。

相关页面