在IDE中使用AIone

概述

AIone 支持两类接入方式：

OpenAI 兼容格式：适用于 Cursor、Cline、Continue 以及大多数支持自定义 OpenAI Base URL 的 IDE / 插件

Anthropic 原生格式：适用于 Claude Code、Anthropic SDK 和直接调用 Messages API 的工具

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

Cursor 配置

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

配置步骤

打开 Cursor → Settings → Models

找到 OpenAI API Key 配置项

填入以下信息：

API Key: sk-nex-your-key-here

Base URL: https://api.nexara.net/v1

所有模型都必须使用简写名称（见下方表格），不要使用 gpt-、claude-、gemini- 开头的原始模型名

通过模型列表底部的 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 编程助手。

安装

打开 VS Code → 扩展商店（Ctrl+Shift+X / Cmd+Shift+X）

搜索 Cline 并安装

安装完成后，左侧栏出现 Cline 图标

配置

点击 Cline 图标 → 设置（齿轮图标）

API Provider 选择 OpenAI Compatible

填写：

Base URL: https://api.nexara.net/v1

API Key: sk-nex-your-key-here

Model ID: claude-sonnet-4-6（或其他正常模型 ID）

Claude Code 配置

Claude Code 是 Anthropic 官方的 CLI 工具。

macOS / Linux

如果你希望长期生效，也可以把这两个变量写进 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 的”用户环境变量”方式配置，一次设置，后续可长期生效。

打开开始菜单，搜索 环境变量

选择 编辑账户的环境变量

在”用户变量”里点击新建

新建以下两个变量：

ANTHROPIC_BASE_URL = https://api.nexara.net

ANTHROPIC_AUTH_TOKEN = sk-nex-your-key-here

保存后，关闭已经打开的 CMD、PowerShell、VS Code 终端窗口，再重新打开

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

echo %ANTHROPIC_BASE_URL%

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

$env:ANTHROPIC_BASE_URL

显示 https://api.nexara.net 就说明配置成功。

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

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

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

macOS / Linux：

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

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = 1

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

启动 Claude Code

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

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

注意

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

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

变量名必须是 ANTHROPIC_AUTH_TOKEN，写成 ANTHROPIC_API_KEY 会导致 401 错误

如果你改过环境变量但 Claude Code 仍然读取旧值，通常是因为终端窗口没有重开

如果你想切回官方 API，删除这两个环境变量后重新打开终端，再执行 claude login

Continue（VS Code 插件）配置

安装 Continue 插件

打开配置文件 ~/.continue/config.json

添加 AIone 作为 provider：

{
  "models": [
    {
      "title": "AIone Claude Sonnet",
      "provider": "openai",
      "model": "claude-sonnet-4-6",
      "apiBase": "https://api.nexara.net/v1",
      "apiKey": "sk-nex-your-key-here"
    }
  ]
}

通用配置原则

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

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

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

模型名怎么判断

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

实时权威列表请以 GET https://api.nexara.net/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.nexara.net/v1

Claude Code / Anthropic SDK 请检查 Base URL 是否为 https://api.nexara.net

确认 API Key 是否有效

检查网络是否能访问 api.nexara.net

模型不存在

确认模型 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 也支持

在IDE中使用AIone

概述#

Cursor 配置#

配置步骤#

Cursor 模型简写对照表#

注意事项#

Cline（VS Code 插件）配置#

安装#

配置#

Claude Code 配置#

macOS / Linux#

Windows（推荐永久配置）#

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

启动 Claude Code#

注意#

Continue（VS Code 插件）配置#

通用配置原则#

模型名怎么判断#

常见问题#

Claude Code 报 401 Invalid API key#

连接失败 / 超时#

模型不存在#

响应格式异常#

概述