Lumina API

Appearance

VS Code 插件接入教程 ​

VS Code 是目前最主流的代码编辑器，通过安装 Claude Code 官方插件可以获得完整的 AI 编程能力。

前置条件

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

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

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

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

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

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

Claude Code for VS Code 配置流程（共 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 完整教程

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

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

第四步：打开插件 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），然后重启 VS Code
  2. 再次点击侧边栏 Claude Code 图标，即可正常使用 ✅

其他可选插件 ​

以下插件无需依赖 Claude Code CLI，直接配置 API Key 即可使用。

Roo Code ​

扩展商店搜索 Roo Code 安装。

  • API Provider: Anthropic
  • API Key: 你的 Key（分组选 cc5 或 cc7）
  • Use custom base URL: https://us.api.aiflow321.cn

⚠️ 关闭「将 Anthropic API 密钥作为 Anthropic 标头传递」和「启用 1M 上下文」

👉 Roo Code 完整教程

Cline ​

扩展商店搜索 Cline 安装。

  • API Provider: OpenAI Compatible
  • Base URL: https://us.api.aiflow321.cn/v1
  • API Key: 你的 Key
  • Model ID: claude-sonnet-4-5

👉 Cline 完整教程

Continue ​

扩展商店搜索 Continue 安装，编辑 ~/.continue/config.json，apiBase 填 https://us.api.aiflow321.cn/v1。

👉 Continue.dev 完整教程

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

错误原因解决方案
插件提示登录 / 无法连接settings.json 未配置或未重启完成第四步配置后重启 VS Code
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 支持。