CN CoreNode DocsClaude API 接入中心
CoreNode Claude Gateway

把客户端接入 CoreNode Claude 服务,一页看懂

这份文档整合了原有 CoreNode 接入说明和新手教程。建议先获取 API Key,再根据所使用的工具选择对应接法,通常几分钟内就能完成首轮联调。

OpenAI Base URLhttps://api.corenode.best/v1
Claude Base URLhttps://api.corenode.best
推荐模型claude-sonnet-4-6
Quick Route

先判断你属于哪种接法

接入失败最常见的原因不是配置本身,而是协议选错。请先区分 OpenAI 兼容、Claude 原生和图形化配置工具三类场景。

最常见

OpenAI 兼容客户端

适用于 Cherry Studio、LobeChat、ChatBox、Cline、Roo Code、Continue、OpenAI SDK 等支持自定义 Base URL 的工具。

  • Base URL:https://api.corenode.best/v1
  • API Key:你的 CoreNode Key
  • 模型名:Claude 系列模型名
Claude 原生

Claude Code / Claude SDK

这类工具会自行请求 /v1/messages,因此 Base URL 只填写根地址,不要手动再拼一层 /v1

  • Base URL:https://api.corenode.best
  • Token:你的 CoreNode Key
  • 常见错误:地址写成带 /v1 的版本
图形切换

CC Switch

适合不想手动修改配置文件,或经常在多个 CLI 工具之间切换的用户。

  • 服务地址:https://api.corenode.best
  • Key:你的 CoreNode Key
  • 支持保存多套配置并快速切换
Preparation

准备工作与下载

如果你是第一次接触 Claude 工具链,按下面的顺序准备环境会更高效。

Windows 常用

Git for Windows

Windows 用户在安装 Claude Code 前,建议先准备 Git 环境。

打开 Git 下载页
推荐

WSL2

如果你会长期使用终端类工具,建议在 Windows 上启用 WSL2,兼容性更好。

打开 WSL 安装文档
编辑器

VS Code

如果你需要插件、补全或图形化编辑体验,VS Code 是最稳妥的起点。

打开 VS Code 官网
图形工具

CC Switch

用于图形化管理 Claude Code、Codex、Gemini CLI 等工具的 API 配置。

打开 CC Switch Releases
入口

CoreNode 控制台

注册、登录、创建 API Key、查看余额和套餐信息都在这里完成。

打开控制台
API Key

获取 API Key

API Key 用来标识“谁在调用、从哪个账号扣费”。即使地址填写正确,Key 错误也会导致请求失败。

  1. 打开 注册页登录页
  2. 进入 令牌 / Token 页面。
  3. 新建一个 Key,或复制已有 Key。
  4. 订阅用户确认 Key 已绑定到正确分组;按量计费用户则选择余额结算分组。
  5. 把文档中的 YOUR_API_KEY 全部替换为你的真实 Key。
OpenAI Compatible

OpenAI 兼容调用

这是兼容范围最广的接法。只要工具支持填写 Base URL 和 API Key,通常都可以走这条链路。

Base URLhttps://api.corenode.best/v1
API KeyYOUR_API_KEY
推荐模型claude-sonnet-4-6

curl 示例

curl https://api.corenode.best/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","messages":[{"role":"user","content":"你好,帮我写一句自我介绍"}],"max_tokens":512}'

Python 示例

from openai import OpenAI
client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.corenode.best/v1")
resp = client.chat.completions.create(model="claude-sonnet-4-6", messages=[{"role":"user","content":"帮我写一个发布公告标题"}], max_tokens=512)
print(resp.choices[0].message.content)
Anthropic Native

Anthropic 原生调用

如果你的工具本身就是按 Claude 协议发请求,例如 Claude Code 或 Claude SDK,请走原生接法。

Base URLhttps://api.corenode.best
鉴权头x-api-key: YOUR_API_KEY
请求路径/v1/messages
curl https://api.corenode.best/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":512,"messages":[{"role":"user","content":"帮我生成一个接口接入清单"}]}'
在 Claude 原生工具中,Base URL 只填写根地址。不要手动写成带 /v1 的版本,否则很容易生成重复路径。
Models

模型怎么选

默认建议先从 Sonnet 开始,它在速度、效果和成本之间最均衡,适合作为首选默认模型。

默认推荐

Claude Sonnet

适合日常编码、文档撰写、办公自动化和大多数智能体流程。

低成本

Claude Haiku

适合轻量生成、高频调用以及对成本更敏感的场景。

高强度

Claude Opus

更适合复杂推理、重型编码和对生成质量要求更高的任务。

实时可用模型和价格以 CoreNode Pricing 页面 为准。
Common Clients

VS Code、Cursor、Cherry Studio 这类程序到底该怎么填

大部分人不是被接口难住,而是被软件里的字段名绕晕。先记一句最实用的话:看到 Base URL / OpenAI API Key / Model,通常就走 OpenAI 兼容接法;看到 ANTHROPIC_BASE_URLx-api-key/v1/messages,就走 Claude 原生接法。

不会判断时,先看软件让你填的是不是 OpenAI 地址。如果是,就填 https://api.corenode.best/v1;如果它明确写的是 Claude / Anthropic 地址,就填 https://api.corenode.best。第一次接入建议只做一件事:先让它成功回一句话,再慢慢调模型和体验。
程序 该走哪种接法 你要填的内容 说明
VS Code + Cline / Roo Code / Continue OpenAI 兼容 Base URL:https://api.corenode.best/v1
API Key:YOUR_API_KEY
Model:claude-sonnet-4-6
如果插件让你先选供应商,优先选择 OpenAI、OpenAI Compatible 或 Custom OpenAI。
VS Code + Claude Code 插件 Claude 原生 Base URL:https://api.corenode.best
Token / API Key:YOUR_API_KEY
这类插件会自己请求 /v1/messages,不要再手动多写一个 /v1
Cherry Studio OpenAI 兼容 接口地址:https://api.corenode.best/v1
API Key:YOUR_API_KEY
默认模型:claude-sonnet-4-6
本质上和配置自定义 OpenAI 提供商一样,填完三项基本就能用。
Cursor(自带 API Key 模式) OpenAI 兼容 OpenAI API Key:YOUR_API_KEY
如果版本里有 Base URL / Override OpenAI Base URL,再填:https://api.corenode.best/v1
模型:claude-sonnet-4-6
适合你自己带 Key 的聊天模型场景。自动补全、Tab、部分 Agent 能力不一定都走这条自定义链路,所以这行更适合“先把聊天模型接通”。
ChatBox / LobeChat / NextChat OpenAI 兼容 OpenAI API Host / Endpoint:https://api.corenode.best/v1
API Key:YOUR_API_KEY
模型:Claude 模型名
凡是支持自定义 OpenAI 地址的软件,通常都按这一行填写。
Open WebUI(自建) OpenAI 兼容 Base URL:https://api.corenode.best/v1
API Key:YOUR_API_KEY
模型:claude-sonnet-4-6
更推荐管理员在后台统一配连接。若走 Direct Connections,要先让管理员开启,再处理好跨域和连接权限。
第一步

先复制正确地址

普通桌面客户端和大多数 VS Code AI 插件,优先复制 https://api.corenode.best/v1。只有明确写 Claude / Anthropic 的工具,才改用根地址。

第二步

先用 Sonnet 跑通

第一次接入建议先填 claude-sonnet-4-6。它最均衡,排错也最省时间,等链路通了再换成其他模型。

第三步

报错只查 4 项

地址、Key、模型名、协议类型。大部分接入失败都集中在这四项,先不要急着怀疑软件本身。

像 Cursor 这类 IDE,如果你用的是它自带的官方账号模式或内置高级能力,不一定会完全走你手动填写的自定义接口。所以文档里写的这套参数,主要用于“自带 API Key 的模型调用”这一层。
Claude Code

Claude Code 安装配置

安装完成后,只需把请求地址和鉴权信息指向 CoreNode,就可以直接使用。

irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.sh | bash
export ANTHROPIC_BASE_URL="https://api.corenode.best"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_API_KEY="YOUR_API_KEY"
$env:ANTHROPIC_BASE_URL = "https://api.corenode.best"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_API_KEY = "YOUR_API_KEY"
VS Code

VS Code 插件怎么区分、怎么填

VS Code 最容易配错的地方,不是值填错,而是插件类型认错。你先判断自己装的是 Claude Code 插件,还是 Cline / Roo Code / Continue 这类走 OpenAI 兼容协议的插件,再照对应方法填就行。

如果你装的是 Claude Code 插件

这类插件通常会继承环境变量或 ~/.claude/settings.json。核心思路只有两步:把 Base URL 指向 CoreNode 根地址,再把 Key 写进去。

  • ANTHROPIC_BASE_URLhttps://api.corenode.best
  • ANTHROPIC_AUTH_TOKENANTHROPIC_API_KEY 都填你的 CoreNode Key
  • 不要手动补 /v1

如果你装的是 Cline / Roo Code / Continue

把它当成“支持自定义 OpenAI 接口的插件”来配即可。一般进入插件设置后,选 OpenAI 或自定义 OpenAI 提供商,然后填下面三项。

  • Base URL:https://api.corenode.best/v1
  • API Key:你的 CoreNode Key
  • 模型:先用 claude-sonnet-4-6 跑通
简单判断法:设置页里如果出现 OpenAI API BaseOpenAI CompatibleEndpoint 这类字样,就按 OpenAI 兼容填;如果出现 AnthropicClaudeANTHROPIC_BASE_URL,就按 Claude 原生填。

Claude Code 插件 settings.json 示例

{
  "claude-code.env": {
    "ANTHROPIC_BASE_URL": "https://api.corenode.best",
    "ANTHROPIC_API_KEY": "YOUR_API_KEY"
  },
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.corenode.best" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "YOUR_API_KEY" },
    { "name": "ANTHROPIC_API_KEY", "value": "YOUR_API_KEY" }
  ]
}
Desktop Clients

Cherry Studio、ChatBox、LobeChat、Open WebUI 这类程序怎么接

这类程序虽然名字不同,但本质上都在让你填写“接口地址、API Key、模型名”。只要它支持自定义 OpenAI 地址,基本都能按同一套参数接入,区别只在设置入口名字不一样。

接口地址 / Base URLhttps://api.corenode.best/v1
API KeyYOUR_API_KEY
建议先填的模型claude-sonnet-4-6
Cherry Studio

新建一个自定义 OpenAI 提供商

如果界面里没有直接叫 CoreNode 的选项,就自己新增一个 OpenAI 兼容供应商,然后把上面的三项填进去即可。

  • 接口地址写到 /v1
  • 模型名直接填 Claude 模型名
  • 保存后先发一句最简单的测试问题
ChatBox / LobeChat

找到 OpenAI 设置页

这类程序一般会把字段写成 OpenAI API Key、OpenAI API Host、OpenAI Endpoint。名字不完全一样,但填法一样。

  • Host / Endpoint 填 https://api.corenode.best/v1
  • API Key 填你的 CoreNode Key
  • 模型填 claude-sonnet-4-6 或其他已开通模型
Open WebUI

优先让管理员统一配连接

如果你是团队或自建环境,更推荐管理员在后台把 CoreNode 配成 OpenAI 连接,这样所有用户都能直接选模型,不用每个人自己填一遍。

  • 后台连接地址填 https://api.corenode.best/v1
  • 如果是 Direct Connections,要先开启权限
  • 遇到跨域报错时优先检查部署层和连接方式
排错

第一次失败时先别乱改

先只核对三件事:地址是不是带了 /v1、Key 有没有空格、模型名是不是从 Pricing 页面完整复制的。

  • 401 多半是 Key 问题
  • 模型不存在多半是模型名写错
  • 无响应再检查本地代理和网络
CC Switch

CC Switch 配置

适合不想手动编辑配置文件,或者经常在多个 CLI 之间切换的用户。

brew tap farion1231/ccswitch
brew install --cask cc-switch
新建一个 Custom Provider,Base URL 填 https://api.corenode.best,API Key 填你的 CoreNode Key,保存后启用即可。
OpenClaw

OpenClaw 配置

OpenClaw 适合把 Claude 能力接入聊天机器人、平台助手或其他多入口场景。

curl -fsSL https://openclaw.ai/install.sh | bash
iwr -useb https://openclaw.ai/install.ps1 | iex
{
  "providers": {
    "corenode": {
      "baseUrl": "https://api.corenode.best/v1",
      "auth": "api-key",
      "apiKey": "YOUR_API_KEY",
      "api": "anthropic-messages"
    }
  }
}
OpenCode

OpenCode 配置

建议使用 Anthropic provider,不要误配成 OpenAI provider,以免协议不匹配。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.corenode.best/v1",
        "apiKey": "YOUR_API_KEY"
      }
    }
  },
  "model": "anthropic/claude-sonnet-4-6",
  "small_model": "anthropic/claude-haiku-4-5"
}
One Click

一键写入 Claude 的 settings.json

下面两段脚本会把 Base URL 和鉴权信息写入 ~/.claude/settings.json,适合希望快速完成本地配置的用户。

Windows PowerShell 脚本

$CoreNodeKey = Read-Host "请输入你的 CoreNode API Key"
$ClaudeDir = Join-Path $HOME ".claude"
$SettingsPath = Join-Path $ClaudeDir "settings.json"

New-Item -ItemType Directory -Force -Path $ClaudeDir | Out-Null

if (Test-Path $SettingsPath) {
  try { $Settings = Get-Content -Raw -Path $SettingsPath | ConvertFrom-Json }
  catch { Copy-Item $SettingsPath "$SettingsPath.bak" -Force; $Settings = [pscustomobject]@{} }
} else { $Settings = [pscustomobject]@{} }

if (-not ($Settings.PSObject.Properties.Name -contains "env")) {
  $Settings | Add-Member -MemberType NoteProperty -Name env -Value ([pscustomobject]@{})
}

$Settings.env | Add-Member -MemberType NoteProperty -Name ANTHROPIC_BASE_URL -Value "https://api.corenode.best" -Force
$Settings.env | Add-Member -MemberType NoteProperty -Name ANTHROPIC_AUTH_TOKEN -Value $CoreNodeKey -Force
$Settings.env | Add-Member -MemberType NoteProperty -Name ANTHROPIC_API_KEY -Value $CoreNodeKey -Force

$Settings | ConvertTo-Json -Depth 20 | Set-Content -Path $SettingsPath -Encoding UTF8
Write-Host "已写入 $SettingsPath"

macOS / Linux 脚本

read -r -p "请输入你的 CoreNode API Key: " CORENODE_API_KEY
export CORENODE_API_KEY
mkdir -p "$HOME/.claude"

python3 - <<'PY'
import json, os
from pathlib import Path
path = Path.home() / ".claude" / "settings.json"
key = os.environ["CORENODE_API_KEY"].strip()
settings = {}
if path.exists():
    try: settings = json.loads(path.read_text(encoding="utf-8"))
    except Exception: path.rename(path.with_suffix(".json.bak"))
env = settings.setdefault("env", {})
env["ANTHROPIC_BASE_URL"] = "https://api.corenode.best"
env["ANTHROPIC_AUTH_TOKEN"] = key
env["ANTHROPIC_API_KEY"] = key
path.write_text(json.dumps(settings, ensure_ascii=False, indent=2) + "\\n", encoding="utf-8")
print(f"已写入 {path}")
PY
Pricing

计费说明

接入阶段建议优先把链路跑通,再优化成本。默认先用 Sonnet,需要更低成本时切到 Haiku,复杂任务再考虑 Opus。

Prompt Caching

对重复输入内容,Prompt Caching 可以显著降低费用。对方教程里提到缓存命中的输入 Token 可大幅降价,这类思路同样适用于 CoreNode 的高重复调用场景。

日常成本预期

参考 Feishu 教程整理的经验值,普通开发者日常编码通常优先用 Sonnet;复杂任务再切 Opus,更容易把成本控制在稳定范围内。

省钱建议

  • 日常编码优先用 Sonnet,复杂架构或高难推理再切到更高档模型。
  • 切换任务时主动清理上下文,避免无关历史继续消耗 Token。
  • 对于支持成本统计的 CLI,定期查看会话费用,尽早发现异常增长。
  • 高重复提示词、系统提示或长模板优先设计成可缓存结构。
实时价格、模型名和套餐说明以 Pricing 页面 为准。
FAQ

常见问题

大多数问题都集中在地址、API Key、模型名和协议这四项设置上。

普通客户端到底该填哪个地址?

OpenAI 兼容客户端填写 https://api.corenode.best/v1。这类字段通常会显示为 Base URL、OpenAI Endpoint 或 API Host。

Claude Code 为什么不能手动再加 /v1?

因为它会自行请求 /v1/messages。如果你再手动补一层 /v1,就容易形成重复路径。

返回 401 怎么办?

重新复制控制台中的 Key,检查首尾是否存在空格,并确认该 Key 所属分组正确。

提示模型不存在怎么办?

先去 Pricing 页面 查看当前可用模型名,再完整复制,不要手动拼写。

怎么确认接口真的通了?

优先运行上面的 curl 示例。只要能正常返回内容,就说明请求链路已经打通。

安装后提示 command not found 或命令找不到怎么办?

通常是安装目录没有进入 PATH。终端类工具优先检查 ~/.local/bin 或 npm 全局 bin 目录是否已经加入环境变量;Windows 还要确认已重新打开终端。

报错 Connection timeout、ECONNREFUSED 或 503 怎么办?

这类问题通常是网络不可达、代理缺失或上游临时过载。先用 curl -I 测试目标地址可达性,再区分是本地网络问题还是上游暂时拥堵。

Claude Code 或 Codex 会话太长,速度变慢怎么办?

优先压缩或清空上下文,避免历史消息无限累积。对于长任务,拆成多个较短会话通常比在单一会话里持续堆上下文更稳。

如何查看当前会话花了多少钱?

支持成本统计的 CLI 通常会提供内置命令,例如 Claude Code 可以使用 /cost。如果你在平台侧做统一对账,也建议结合控制台用量页面一起看。

OpenClaw 命令找不到或启动失败怎么办?

先确认全局安装目录是否已经加入 PATH,再运行 openclaw doctoropenclaw gateway logsopenclaw gateway restart 逐项排查。