OpenBiliPortal

在 IDE 中使用 AIone

概述

AIone 支持两类接入方式：

  • OpenAI 兼容格式：适用于 Cursor、Cline、Continue 以及大多数支持自定义 OpenAI Base URL 的 IDE / 插件
  • Anthropic 原生格式：适用于 Claude Code、Anthropic SDK 和直接调用 Messages API 的工具

本文介绍在主流 IDE 和编程工具中配置 AIone 的方法。

Cursor 配置

Cursor 是最流行的 AI 代码编辑器之一。

配置步骤

  1. 打开 Cursor → Settings → Models
  2. 找到 OpenAI API Key 配置项
  3. 填入以下信息：
    • API Key: sk-nex-your-key-here
    • Base URL: https://api.openbili.com/v1
  4. 所有模型都必须使用简写名称（见下方表格），不要使用 gpt-、claude-、gemini- 开头的原始模型名
  5. 通过模型列表底部的 Add Models 手动添加简写模型名

Cursor 模型简写对照表

Cursor 会自动拦截 gpt-、claude-、gemini- 开头的模型名，强制走 Cursor 自己的通道，绕过您配置的 API 地址。因此在 Cursor 中必须使用以下简写：

GPT 系列

简写 实际模型
o5.4 GPT-5.4
o5 GPT-5
o5.1 GPT-5.1
o5.2 GPT-5.2
o4.1 GPT-4.1
o4o GPT-4o

Claude 系列

简写 实际模型
opus-4-6 Claude Opus 4.6
sonnet-4-6 Claude Sonnet 4.6
haiku-4-5 Claude Haiku 4.5

Gemini 系列

简写 实际模型
flash-2.5 Gemini 2.5 Flash
pro-2.5 Gemini 2.5 Pro
flash-3 Gemini 3 Flash
pro-3 Gemini 3 Pro
pro-3.1 Gemini 3.1 Pro

注意事项

  • Cursor 可能需要在 Override OpenAI Base URL 中设置
  • 请务必关闭 Cursor 中的 “Anthropic API Key” 和 “Google API Key” 开关。 如果这些开关打开，Cursor 会将对应模型的请求直接发送到官方 API，绕过 AIone，导致 Key 验证失败（401 错误）。所有模型都应通过上方的 OpenAI API Key 配置项接入
  • 不要使用 Cursor 内置的模型条目，请通过 Add Models 手动添加上表中的简写名称
  • GPT 模型在 Cursor Agent 模式下的深度推理（Thinking）功能暂不支持。如需 Agent + Thinking，建议使用 opus-4-6 或 sonnet-4-6
  • 如果模型列表里没有对应条目，直接手动填写简写名即可

Cline（VS Code 插件）配置

Cline 是 VS Code 中强大的 AI 编程助手。

安装

  1. 打开 VS Code → 扩展商店（Ctrl+Shift+X / Cmd+Shift+X）
  2. 搜索 Cline 并安装
  3. 安装完成后，左侧栏出现 Cline 图标

配置

  1. 点击 Cline 图标 → 设置（齿轮图标）
  2. API Provider 选择 OpenAI Compatible
  3. 填写：
    • Base URL: https://api.openbili.com/v1
    • API Key: sk-nex-your-key-here
    • Model ID: claude-sonnet-4-6（或其他正常模型 ID）

Claude Code 配置

Claude Code 是 Anthropic 官方的 CLI 工具。

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.openbili.com"
export ANTHROPIC_AUTH_TOKEN="sk-nex-your-key-here"

如果你希望长期生效，也可以把这两个变量写进 shell 配置文件。

注意：变量名是 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY。 ANTHROPIC_API_KEY 是 Anthropic Python/TypeScript SDK 使用的变量名，Claude Code CLI 使用的是 ANTHROPIC_AUTH_TOKEN。如果用错变量名，会导致 401 Invalid API key 错误。

Windows（推荐永久配置）

推荐直接使用 Windows 的”用户环境变量”方式配置，一次设置，后续可长期生效。

  1. 打开开始菜单，搜索 环境变量
  2. 选择 编辑账户的环境变量
  3. 在”用户变量”里点击 新建
  4. 新建以下两个变量：
    • ANTHROPIC_BASE_URL = https://api.openbili.com
    • ANTHROPIC_AUTH_TOKEN = sk-nex-your-key-here
  5. 保存后，关闭已经打开的 CMD、PowerShell、VS Code 终端窗口，再重新打开

你可以在新的命令行窗口中验证是否生效：

echo %ANTHROPIC_BASE_URL%

如果你使用 PowerShell，也可以执行：

$env:ANTHROPIC_BASE_URL

显示 https://api.openbili.com 就说明配置成功。

禁用实验性 Beta 特性（重要）

Claude Code 默认会携带一些实验性 anthropic-beta 请求头。部分 Beta 特性与 AWS Bedrock 上游不兼容，可能触发 ValidationException 错误（Claude 官方已知 bug，详见 Claude Code LLM Gateway 文档）。

建议所有用户额外设置以下环境变量：

macOS / Linux：

export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

Windows：按上文同样的方式新增一个用户环境变量：

  • CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = 1

设置后请关闭并重新打开终端窗口使其生效。

启动 Claude Code

claude

如果 Claude Code 首次检测到自定义 API Key，按提示选择使用当前环境变量里的 Key 即可。

你也可以改为在 ~/.claude/config.json 中配置，但环境变量方式更直接，也更适合 Windows 用户。

注意

Claude Code 使用 Anthropic Messages API 格式（非 OpenAI 格式），因此 Base URL 请使用 https://api.openbili.com，不要手动追加 /v1。

Claude Code / Anthropic SDK 会继续按协议请求 /v1/messages，因此只需要填写根地址即可。

  • 变量名必须是 ANTHROPIC_AUTH_TOKEN，写成 ANTHROPIC_API_KEY 会导致 401 错误
  • 如果你改过环境变量但 Claude Code 仍然读取旧值，通常是因为终端窗口没有重开
  • 如果你想切回官方 API，删除这两个环境变量后重新打开终端，再执行 claude login

Continue（VS Code 插件）配置

  1. 安装 Continue 插件
  2. 打开配置文件 ~/.continue/config.json
  3. 添加 AIone 作为 provider：
{
  "models": [
    {
      "title": "AIone Claude Sonnet",
      "provider": "openai",
      "model": "claude-sonnet-4-6",
      "apiBase": "https://api.openbili.com/v1",
      "apiKey": "sk-nex-your-key-here"
    }
  ]
}

通用配置原则

请先判断客户端走的是哪种协议：

场景 Base URL Provider / Type
OpenAI 兼容客户端 https://api.openbili.com/v1 OpenAI / OpenAI Compatible
Anthropic 原生客户端 https://api.openbili.com Anthropic

所有场景都使用 AIone API Key，即 sk-nex- 开头的密钥。

模型名怎么判断

如果你只是想尽快知道“这个客户端该填什么模型名”，先记住这 3 条：

  • 实时权威列表请以 GET https://api.openbili.com/v1/models 和 模型列表 为准
  • 只有 Cursor 里的 Claude 需要优先使用短模型名
  • 其他客户端一律优先使用标准模型 ID

完整规则、完整模型表，以及 Cursor Claude 短模型名对照，请查看：

常见问题

Claude Code 报 401 Invalid API key

最常见的原因是环境变量名写错了：

工具 正确的变量名
Claude Code CLI ANTHROPIC_AUTH_TOKEN
Anthropic Python/TS SDK ANTHROPIC_API_KEY

如果你用了 ANTHROPIC_API_KEY，Claude Code 不会读取它，请改为 ANTHROPIC_AUTH_TOKEN。

连接失败 / 超时

  • OpenAI 兼容客户端请检查 Base URL 是否为 https://api.openbili.com/v1
  • Claude Code / Anthropic SDK 请检查 Base URL 是否为 https://api.openbili.com
  • 确认 API Key 是否有效
  • 检查网络是否能访问 api.openbili.com

模型不存在

  • 确认模型 ID 拼写正确
  • 在 模型列表 中确认模型名称
  • 如果是 Cursor 里的 Claude，请优先使用短模型名，例如 opus-4-6、sonnet-4-6、haiku-4-5
  • 其他客户端，以及 GPT / Gemini，直接使用正常模型 ID，例如 claude-sonnet-4-6、gpt-5.4、gpt-5.2、gemini-3.1-pro
  • 更完整的模型名对照请查看：模型命名与兼容规则

响应格式异常

  • 确保 Provider 类型选择了 OpenAI Compatible（而非 Anthropic 原生格式）
  • Claude Code 例外：它使用 Anthropic 格式，AIone 也支持