New-API 中转接入文档

1. 准备工作

2. 创建 API 令牌

1. 打开并登录 https://newapi.jaycue.dpdns.org。
2. 进入「控制台」→「令牌」。
3. 点击「添加令牌」，按需设置额度、模型限制、过期时间等。
4. 创建后复制令牌，填写到客户端时通常写成 sk-你的令牌。

3. 通用填写规则

4. Cherry Studio 安装与接入

安装方式

• Windows / macOS：到 Cherry Studio 官网或 GitHub Releases 下载对应安装包。
• Linux：下载 AppImage / deb / rpm 等对应发行版安装包（以 Cherry Studio 发布页为准）。
• 如果已有旧版本，建议先升级到新版；新版通常已内置 NewAPI 类型。

New-API 配置

1. 打开 Cherry Studio，进入「设置」或「模型服务 / Providers」。
2. 选择 NewAPI；如果没有该选项，就新增 OpenAI Compatible 提供商。
3. API 地址填写 https://newapi.jaycue.dpdns.org；如版本要求 API Base URL，填写 https://newapi.jaycue.dpdns.org/v1。
4. API Key 填写 New-API 令牌。
5. 添加模型 gpt-5.4、gpt-image-2。

5. Chatbox 安装与接入

安装方式

• Windows / macOS：到 Chatbox 官网或 GitHub Releases 下载桌面安装包。
• Linux：下载 AppImage / deb 等安装包，或使用网页版。
• 移动端：如有需要，从对应应用商店安装官方版本。

New-API 配置

6. Codex CLI 安装与接入

安装方式

• 官方 GitHub：https://github.com/openai/codex
• 官方入门说明：OpenAI Codex CLI Getting Started
• 先安装 Node.js LTS（Windows / macOS / Linux 都建议使用 LTS 版本），再执行 npm 全局安装。

npm install -g @openai/codex
codex --version

配置 New-API

临时环境变量方式：

# macOS / Linux / WSL
export OPENAI_API_KEY="sk-你的令牌"
export OPENAI_BASE_URL="https://newapi.jaycue.dpdns.org/v1"

# Windows PowerShell
$env:OPENAI_API_KEY="sk-你的令牌"
$env:OPENAI_BASE_URL="https://newapi.jaycue.dpdns.org/v1"

如使用配置文件：macOS / Linux 路径通常为 ~/.codex/config.toml，Windows 通常为 C:\Users\你的用户名\.codex\config.toml。

7. Claude Code / CC 安装与接入

安装方式

• 官方文档：Claude Code Setup
• npm 包：@anthropic-ai/claude-code
• Windows 可用官方 PowerShell 安装脚本，也可使用 npm。

npm install -g @anthropic-ai/claude-code
claude --version

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

接入 New-API

Claude Code 本身以 Claude 生态为主；如果你使用 CC Switch、代理工具或支持 OpenAI Compatible 的桥接方式，就按下面填写 New-API：

8. VS Code / CC Switch

VS Code 通用说明

• Windows / macOS / Linux：从 VS Code 官网下载安装。
• 打开 VS Code 插件市场，安装你使用的 Codex / OpenAI Compatible 相关插件。
• 如果插件只需要 OpenAI Compatible 参数，通常填写 https://newapi.jaycue.dpdns.org/v1 和 New-API 令牌。

9. Hermes Agent 安装与接入

Hermes Agent 支持自定义 OpenAI 兼容端点。接入 New-API 时，Base URL 填 https://newapi.jaycue.dpdns.org/v1，API Key 填 New-API 令牌。

Windows PowerShell 安装

在 Windows PowerShell 中运行：

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

macOS / Linux / WSL2 / Termux 安装

在终端中运行官方安装脚本：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装完成后，重新加载 shell 配置并启动：

source ~/.bashrc 2>/dev/null || true
source ~/.zshrc 2>/dev/null || true
hermes --help

New-API 配置

10. OpenClaw 安装与接入

安装方式

• Windows / macOS / Linux：从 OpenClaw 官方发布页或项目主页下载对应系统安装包。
• 如果已有旧版“龙虾”客户端，建议升级到新版 OpenClaw 后再配置。
• 安装后打开设置页，进入模型服务 / Providers / API 配置。

New-API 配置

在 OpenClaw 中新增 OpenAI Compatible / Custom OpenAI 服务，然后填写：

11. 其他 OpenAI 兼容客户端安装与接入

安装方式

• OpenClaw / Open WebUI：可使用官方网页、安装包、Docker 或项目文档提供的部署方式。
• 沉浸式翻译、AI as Workspace、OpenCat 等：从浏览器插件市场、应用商店或官方网站安装。
• 安装后只要支持 OpenAI Compatible / 自定义 OpenAI，就可以接入 New-API。

New-API 配置

12. 常见问题

Q1：提示 401 / invalid api key 怎么办？

• 确认 Key 是否以 sk- 开头。
• 确认没有多复制空格或换行。
• 回到 New-API「令牌」页面确认令牌未禁用、未删除。

Q2：提示 model not found 怎么办？

把客户端中的模型名改成 New-API 可用模型名，注意大小写、横线和点号要完全一致。

Q3：请求地址到底要不要带 /v1？

字段名是 Base URL / API Base URL 时，通常填 https://newapi.jaycue.dpdns.org/v1；字段名是 API Host / Server 时可先填 https://newapi.jaycue.dpdns.org。