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 系列模型名
这份文档整合了原有 CoreNode 接入说明和新手教程。建议先获取 API Key,再根据所使用的工具选择对应接法,通常几分钟内就能完成首轮联调。
https://api.corenode.best/v1https://api.corenode.bestclaude-sonnet-4-6接入失败最常见的原因不是配置本身,而是协议选错。请先区分 OpenAI 兼容、Claude 原生和图形化配置工具三类场景。
适用于 Cherry Studio、LobeChat、ChatBox、Cline、Roo Code、Continue、OpenAI SDK 等支持自定义 Base URL 的工具。
https://api.corenode.best/v1这类工具会自行请求 /v1/messages,因此 Base URL 只填写根地址,不要手动再拼一层 /v1。
https://api.corenode.best/v1 的版本适合不想手动修改配置文件,或经常在多个 CLI 工具之间切换的用户。
https://api.corenode.best如果你是第一次接触 Claude 工具链,按下面的顺序准备环境会更高效。
Claude Code、OpenClaw、OpenCode 等工具都依赖 Node.js 运行环境。
打开 Node.js 下载页Windows 用户在安装 Claude Code 前,建议先准备 Git 环境。
打开 Git 下载页如果你会长期使用终端类工具,建议在 Windows 上启用 WSL2,兼容性更好。
打开 WSL 安装文档如果你需要插件、补全或图形化编辑体验,VS Code 是最稳妥的起点。
打开 VS Code 官网用于图形化管理 Claude Code、Codex、Gemini CLI 等工具的 API 配置。
打开 CC Switch Releases注册、登录、创建 API Key、查看余额和套餐信息都在这里完成。
打开控制台API Key 用来标识“谁在调用、从哪个账号扣费”。即使地址填写正确,Key 错误也会导致请求失败。
YOUR_API_KEY 全部替换为你的真实 Key。这是兼容范围最广的接法。只要工具支持填写 Base URL 和 API Key,通常都可以走这条链路。
https://api.corenode.best/v1YOUR_API_KEYclaude-sonnet-4-6curl 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}'
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)
如果你的工具本身就是按 Claude 协议发请求,例如 Claude Code 或 Claude SDK,请走原生接法。
https://api.corenode.bestx-api-key: YOUR_API_KEY/v1/messagescurl 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":"帮我生成一个接口接入清单"}]}'
/v1 的版本,否则很容易生成重复路径。默认建议先从 Sonnet 开始,它在速度、效果和成本之间最均衡,适合作为首选默认模型。
适合日常编码、文档撰写、办公自动化和大多数智能体流程。
适合轻量生成、高频调用以及对成本更敏感的场景。
更适合复杂推理、重型编码和对生成质量要求更高的任务。
大部分人不是被接口难住,而是被软件里的字段名绕晕。先记一句最实用的话:看到 Base URL / OpenAI API Key / Model,通常就走 OpenAI 兼容接法;看到 ANTHROPIC_BASE_URL、x-api-key 或 /v1/messages,就走 Claude 原生接法。
https://api.corenode.best/v1;如果它明确写的是 Claude / Anthropic 地址,就填 https://api.corenode.best。第一次接入建议只做一件事:先让它成功回一句话,再慢慢调模型和体验。| 程序 | 该走哪种接法 | 你要填的内容 | 说明 |
|---|---|---|---|
| VS Code + Cline / Roo Code / Continue | OpenAI 兼容 | Base URL:https://api.corenode.best/v1API Key: YOUR_API_KEYModel: claude-sonnet-4-6 |
如果插件让你先选供应商,优先选择 OpenAI、OpenAI Compatible 或 Custom OpenAI。 |
| VS Code + Claude Code 插件 | Claude 原生 | Base URL:https://api.corenode.bestToken / API Key: YOUR_API_KEY |
这类插件会自己请求 /v1/messages,不要再手动多写一个 /v1。 |
| Cherry Studio | OpenAI 兼容 | 接口地址:https://api.corenode.best/v1API 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/v1API Key: YOUR_API_KEY模型:Claude 模型名 |
凡是支持自定义 OpenAI 地址的软件,通常都按这一行填写。 |
| Open WebUI(自建) | OpenAI 兼容 | Base URL:https://api.corenode.best/v1API Key: YOUR_API_KEY模型: claude-sonnet-4-6 |
更推荐管理员在后台统一配连接。若走 Direct Connections,要先让管理员开启,再处理好跨域和连接权限。 |
普通桌面客户端和大多数 VS Code AI 插件,优先复制 https://api.corenode.best/v1。只有明确写 Claude / Anthropic 的工具,才改用根地址。
第一次接入建议先填 claude-sonnet-4-6。它最均衡,排错也最省时间,等链路通了再换成其他模型。
地址、Key、模型名、协议类型。大部分接入失败都集中在这四项,先不要急着怀疑软件本身。
安装完成后,只需把请求地址和鉴权信息指向 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 最容易配错的地方,不是值填错,而是插件类型认错。你先判断自己装的是 Claude Code 插件,还是 Cline / Roo Code / Continue 这类走 OpenAI 兼容协议的插件,再照对应方法填就行。
这类插件通常会继承环境变量或 ~/.claude/settings.json。核心思路只有两步:把 Base URL 指向 CoreNode 根地址,再把 Key 写进去。
ANTHROPIC_BASE_URL 填 https://api.corenode.bestANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 都填你的 CoreNode Key/v1把它当成“支持自定义 OpenAI 接口的插件”来配即可。一般进入插件设置后,选 OpenAI 或自定义 OpenAI 提供商,然后填下面三项。
https://api.corenode.best/v1claude-sonnet-4-6 跑通OpenAI API Base、OpenAI Compatible、Endpoint 这类字样,就按 OpenAI 兼容填;如果出现 Anthropic、Claude、ANTHROPIC_BASE_URL,就按 Claude 原生填。{
"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" }
]
}
这类程序虽然名字不同,但本质上都在让你填写“接口地址、API Key、模型名”。只要它支持自定义 OpenAI 地址,基本都能按同一套参数接入,区别只在设置入口名字不一样。
https://api.corenode.best/v1YOUR_API_KEYclaude-sonnet-4-6如果界面里没有直接叫 CoreNode 的选项,就自己新增一个 OpenAI 兼容供应商,然后把上面的三项填进去即可。
/v1这类程序一般会把字段写成 OpenAI API Key、OpenAI API Host、OpenAI Endpoint。名字不完全一样,但填法一样。
https://api.corenode.best/v1claude-sonnet-4-6 或其他已开通模型如果你是团队或自建环境,更推荐管理员在后台把 CoreNode 配成 OpenAI 连接,这样所有用户都能直接选模型,不用每个人自己填一遍。
https://api.corenode.best/v1先只核对三件事:地址是不是带了 /v1、Key 有没有空格、模型名是不是从 Pricing 页面完整复制的。
适合不想手动编辑配置文件,或者经常在多个 CLI 之间切换的用户。
brew tap farion1231/ccswitch
brew install --cask cc-switch
https://api.corenode.best,API Key 填你的 CoreNode Key,保存后启用即可。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"
}
}
}
建议使用 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"
}
下面两段脚本会把 Base URL 和鉴权信息写入 ~/.claude/settings.json,适合希望快速完成本地配置的用户。
$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"
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
接入阶段建议优先把链路跑通,再优化成本。默认先用 Sonnet,需要更低成本时切到 Haiku,复杂任务再考虑 Opus。
对重复输入内容,Prompt Caching 可以显著降低费用。对方教程里提到缓存命中的输入 Token 可大幅降价,这类思路同样适用于 CoreNode 的高重复调用场景。
参考 Feishu 教程整理的经验值,普通开发者日常编码通常优先用 Sonnet;复杂任务再切 Opus,更容易把成本控制在稳定范围内。
大多数问题都集中在地址、API Key、模型名和协议这四项设置上。
OpenAI 兼容客户端填写 https://api.corenode.best/v1。这类字段通常会显示为 Base URL、OpenAI Endpoint 或 API Host。
因为它会自行请求 /v1/messages。如果你再手动补一层 /v1,就容易形成重复路径。
重新复制控制台中的 Key,检查首尾是否存在空格,并确认该 Key 所属分组正确。
先去 Pricing 页面 查看当前可用模型名,再完整复制,不要手动拼写。
优先运行上面的 curl 示例。只要能正常返回内容,就说明请求链路已经打通。
通常是安装目录没有进入 PATH。终端类工具优先检查 ~/.local/bin 或 npm 全局 bin 目录是否已经加入环境变量;Windows 还要确认已重新打开终端。
这类问题通常是网络不可达、代理缺失或上游临时过载。先用 curl -I 测试目标地址可达性,再区分是本地网络问题还是上游暂时拥堵。
优先压缩或清空上下文,避免历史消息无限累积。对于长任务,拆成多个较短会话通常比在单一会话里持续堆上下文更稳。
支持成本统计的 CLI 通常会提供内置命令,例如 Claude Code 可以使用 /cost。如果你在平台侧做统一对账,也建议结合控制台用量页面一起看。
先确认全局安装目录是否已经加入 PATH,再运行 openclaw doctor、openclaw gateway logs 和 openclaw gateway restart 逐项排查。