Lumina API

Appearance

Cursor 接入教程 ​

Cursor 是基于 VS Code 的 AI 原生代码编辑器。在 Cursor 中使用 Claude Code，需要安装 Claude Code 官方插件，Cursor 原生的 Chat/Composer 功能无法直接替代 Claude Code。

前置条件

  1. 前往 Lumina 控制台 获取 API Key
  2. 下载安装 Cursor
  3. Windows 用户 必须先安装 终端准备（见下方）

⚡ Windows 用户：先安装 终端准备（必须） ​

⚠️ 跳过此步会导致 Claude Code 插件无法运行！ 请务必先完成。

国内镜像（推荐，速度快）： 👉 Git-2.47.1-64-bit.exe（npmmirror 镜像）

官方地址（备用）： 👉 https://git-scm.com/downloads/win

下载后运行安装程序，保持所有默认选项，一路 Next 完成安装，然后重启 PowerShell。

Claude Code for Cursor 配置流程（共 4 步） ​

第一步：安装 Claude Code CLI ​

打开终端（PowerShell / Terminal），运行：

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

⚠️ 必须安装原版 @anthropic-ai/claude-code，这是 Anthropic 官方发布的包。

验证安装：

powershell
claude --version

第二步：配置 API Key ​

运行一键配置工具，按提示输入你的 Key：

powershell
npx lumina-api

或手动创建/编辑 C:\Users\你的用户名\.claude\settings.json（macOS/Linux: ~/.claude/settings.json）：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "ANTHROPIC_BASE_URL": "https://us.api.aiflow321.cn",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

配置完成后，在终端运行 claude，确认可以正常对话，再继续下一步。

👉 详细说明请看 Claude Code CLI 完整教程

第三步：在 Cursor 里安装 Claude Code 插件 ​

  1. 打开 Cursor，按 Ctrl+Shift+X 打开扩展商店
  2. 搜索 Claude Code
  3. 找到发布者为 Anthropic 的官方插件，点击 安装
  4. 安装完成后重启 Cursor

第四步：打开插件 settings.json 配置环境变量 ​

⚠️ 这一步是关键！不配置此项插件会无法连接到国内 API。

  1. 重启后，左侧边栏点击 Claude Code 图标
  2. 插件会提示登录，不要登录，点击插件界面右上角的 设置（齿轮）图标，会自动打开 settings.json
  3. 在 settings.json 中加入以下内容（sk- 替换为你的真实 Key）：
json
{
  "claude-code.environmentVariables": [
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-你的Key"
    },
    {
      "name": "ANTHROPIC_API_KEY",
      "value": "sk-你的Key"
    },
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://us.api.aiflow321.cn"
    }
  ]
}
  1. 保存文件（Ctrl+S），然后重启 Cursor
  2. 再次点击侧边栏 Claude Code 图标，即可正常使用 ✅

Cursor 原生 Chat / Composer（可选） ​

这是 Cursor 自带的 AI 功能，与 Claude Code 插件相互独立，按需配置。

  1. Ctrl+Shift+J (Win) / Cmd+Shift+J (Mac) 打开 Cursor Settings
  2. 导航到 Models 选项卡
  3. OpenAI API Key: 填入你的 Key
  4. 打开 Override OpenAI Base URL，填入 https://us.api.aiflow321.cn/v1
  5. 在 Add Model 处添加：claude-opus-4-6、claude-sonnet-4-5、gpt-4o 等
  6. 按 Ctrl+L 呼出 Chat 窗口，底部切换到新模型即可

常见问题与异常处理 (FAQ) ​

错误原因解决方案
插件提示登录 / 无法连接settings.json 未配置或未重启完成第四步配置后重启 Cursor
CLI 安装失败Node.js 未安装或版本过低安装 Node.js 18+
Windows 启动报错未安装 终端准备安装 Git 国内镜像
401 UnauthorizedAPI Key 错误重新获取 API Key
404 Not FoundBase URL 错误检查 ANTHROPIC_BASE_URL 是否为 https://us.api.aiflow321.cn
429 Too Many Requests额度耗尽前往Lumina 控制台检查额度

提示: 如果依然无法解决，请携带完整报错截图联系 Lumina 支持。