1. 引言
AIone API
  • 引言
    • 快速开始
    • 认证方式
    • 错误码说明
    • 定价说明
    • 联系我们
    • 服务质量保障
    • 完整请求案例
    • 关于缓存与成本优化
    • 模型质量监控与保障
    • 关于模型真实性验证
    • 在IDE中使用AIone
    • 网络与连接说明
    • 模型命名与兼容规则
    • Gemini 图片生成
  • 聊天(Chat)
    • 基础文本对话
      POST
    • 流式响应
      POST
  • 模型(Models)
    • 获取模型列表
      GET
    • List Models
      GET
  • API Key 管理
    • List Keys
      GET
    • Create Key
      POST
    • Get Key
      GET
    • Update Key
      PUT
    • Delete Key
      DELETE
    • Rotate Key
      PUT
    • Disable Key
      PUT
    • Enable Key
      PUT
  • 用量统计
    • Query Usage
    • Get Dashboard
  • 账单
    • Get Current Plan
    • Get Billing Account
    • List Invoices
  • 数据模型
    • HTTPValidationError
    • DashboardResponse
    • KeyCreateRequest
    • KeyListResponse
    • PlanDetailResponse
    • ModelListResponse
    • KeyResponse
    • InvoiceListResponse
    • KeyRotateResponse
    • BillingAccountResponse
    • UsageRow
    • KeyUpdateRequest
    • ValidationError
    • TechDashboardData
    • ModelInfo
    • BusinessDashboardData
    • DailyTrend
    • TeamCostItem
    • ModelDistribution
  1. 引言

在IDE中使用AIone

在 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.nexara.net/v1
4.
如果使用 GPT / Gemini,直接选择或填写正常模型 ID,例如 gpt-5.4、gpt-5.2、gemini-3.1-pro。
5.
如果在 Cursor 中使用 Claude,请填写 Cursor 这边可识别的短模型名,例如:
opus-4-6
sonnet-4-6
haiku-4-5

注意事项#

Cursor 可能需要在 Override OpenAI Base URL 中设置
这个“短模型名”规则只针对 Cursor 中的 Claude 模型
在 Cursor 里使用 Claude 时,不要填写带 claude- 前缀或带日期的完整模型名,优先填写 opus-4-6、sonnet-4-6、haiku-4-5 这类短名
GPT / Gemini 在 Cursor 中仍然使用正常模型 ID,不需要改成短名
如果模型列表里没有对应 Claude 条目,直接手动填写模型名即可

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.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 配置文件。

Windows(推荐永久配置)#

推荐直接使用 Windows 的“用户环境变量”方式配置,一次设置,后续可长期生效。
1.
打开开始菜单,搜索 环境变量
2.
选择 编辑账户的环境变量
3.
在“用户变量”里点击 新建
4.
新建以下两个变量:
ANTHROPIC_BASE_URL = https://api.nexara.net
ANTHROPIC_API_KEY = sk-nex-your-key-here
5.
保存后,关闭已经打开的 CMD、PowerShell、VS Code 终端窗口,再重新打开
你可以在新的命令行窗口中验证是否生效:
echo %ANTHROPIC_BASE_URL%
如果你使用 PowerShell,也可以执行:
$env:ANTHROPIC_BASE_URL
显示 https://api.nexara.net 就说明配置成功。

启动 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,因此只需要填写根地址即可。
如果你改过环境变量但 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.nexara.net/v1",
      "apiKey": "sk-nex-your-key-here"
    }
  ]
}

通用配置原则#

请先判断客户端走的是哪种协议:
场景Base URLProvider / Type
OpenAI 兼容客户端https://api.nexara.net/v1OpenAI / OpenAI Compatible
Anthropic 原生客户端https://api.nexara.netAnthropic
所有场景都使用 AIone API Key,即 sk-nex- 开头的密钥。

模型名怎么判断#

如果你只是想尽快知道“这个客户端该填什么模型名”,先记住这 3 条:
实时权威列表请以 GET https://api.nexara.net/v1/models 和 模型列表 为准
只有 Cursor 里的 Claude 需要优先使用短模型名
其他客户端一律优先使用标准模型 ID
完整规则、完整模型表,以及 Cursor Claude 短模型名对照,请查看:
模型命名与兼容规则

常见问题#

连接失败 / 超时#

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 也支持
修改于 2026-04-02 07:33:25
上一页
关于模型真实性验证
下一页
网络与连接说明
Built with