NexusFlow
NexusFlow API Gateway · 客户使用手册

把一个 API Key 接入 Claude Code、Codex、Gemini 与常见 AI 客户端

NexusFlow 提供 OpenAI / Anthropic 兼容入口、统一额度管理和多模型路由。本文档面向客户，重点说明如何创建密钥、设置直连、配置常见开发工具，并快速验证是否可用。

统一入口默认 API 地址：https://api.artderm777.com
按分组授权Claude Code、Codex、通用 OpenAI 客户端可使用不同分组，便于计费和限流。
适合国内访问推荐将 API 域名加入代理软件直连规则，减少延迟与流式中断。

国内直连与 Clash 配置

如果你在国内网络环境中使用代理软件，建议把 NexusFlow API 域名设置为直连。API 流式输出对网络链路比较敏感，直连通常更稳定。

推荐规则
在 Clash Verge / Clash Meta / Mihomo 等客户端的规则列表前置加入下面一条规则。
Clash Rule 
DOMAIN-SUFFIX,api.artderm777.com,DIRECT

Clash Verge Rev v1.7+ 推荐操作

打开 Profiles / 订阅列表，右键当前正在使用的订阅。
选择“编辑规则”，进入规则编辑界面。
选择“前置规则 / prepend”，添加 DOMAIN-SUFFIX,api.artderm777.com,DIRECT。
保存并重新应用订阅，然后访问控制台或运行客户端测试。
不要直接在扩展配置里整段覆盖 rules:，否则可能导致原订阅规则丢失。优先使用“编辑规则 / 前置规则”。

创建 API Key

登录 NexusFlow 控制台后，进入“令牌管理”创建密钥。不同工具建议使用不同令牌，便于排查、限额和回收。

进入 控制台 → 令牌管理，点击“创建令牌”。
填写名称，例如 claude-code-main、codex-work 或 chatbox-personal。
选择合适分组。Claude Code 使用 Claude 兼容分组；Codex / ChatBox / Cherry Studio 通常使用 OpenAI 兼容分组。
设置额度。团队内部测试可设较高额度；给外部客户建议设置明确上限。
复制生成的 sk-... 密钥并妥善保存。出于安全考虑，离开页面后通常无法再次完整查看。

Claude Code 配置

Claude Code 是 Anthropic 官方开发 CLI。使用 NexusFlow 时，需要把 Auth Token 和 Base URL 指向我们的中转入口。

WindowsmacOSLinux

1. 安装 Node.js 与 Claude Code

PowerShell / Terminal 
node --version
npm --version
npm install -g @anthropic-ai/claude-code
claude --version

2. 写入 Claude Code 配置

Windows 配置文件位置：%USERPROFILE%\.claude\settings.json

settings.json 
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换为你的 NexusFlow Claude Code 分组密钥",
    "ANTHROPIC_BASE_URL": "https://api.artderm777.com"
  }
}

3. 启动

进入项目目录并启动 
cd your-project-folder
claude

Codex CLI 配置

Codex CLI 走 OpenAI 兼容接口。建议单独创建 Codex 分组密钥，避免和 Claude Code 混用。

1. 安装

PowerShell / Terminal 
npm install -g @openai/codex@latest
codex --version

2. 配置环境变量

临时环境变量示例 
set OPENAI_API_KEY=替换为你的 NexusFlow Codex 分组密钥
set OPENAI_BASE_URL=https://api.artderm777.com/v1
codex
如果客户端要求填写 Base URL，请优先使用 https://api.artderm777.com/v1；如果是 Claude 兼容工具，则通常使用不带 /v1 的根地址。

Gemini CLI 配置

如管理员已在 NexusFlow 中配置 Gemini 兼容模型，你可以通过 OpenAI 兼容模式调用。模型名称以控制台“模型广场”或管理员提供列表为准。

OpenAI 兼容配置思路 
OPENAI_API_KEY=替换为你的 NexusFlow 密钥
OPENAI_BASE_URL=https://api.artderm777.com/v1
MODEL=管理员提供的 Gemini 兼容模型名

Cursor / VSCode 插件

Cursor
在 Models 或 OpenAI Compatible Provider 中填写 API Key 与 Base URL：
https://api.artderm777.com/v1
VSCode Codex 插件
插件如果支持 OpenAI Compatible，同样填写 NexusFlow 密钥和 /v1 地址。

模型名必须与 NexusFlow 控制台中开放给你的模型名一致。若提示模型不存在，先检查令牌分组是否允许该模型。

OpenCode / OpenClaw

这类终端开发工具通常支持 OpenAI Compatible。配置重点只有三个：API Key、Base URL、Model。

通用配置模板 
provider: openai-compatible
apiKey: 替换为你的 NexusFlow 密钥
baseURL: https://api.artderm777.com/v1
model: 选择控制台可用模型

Cherry Studio / ChatBox

桌面聊天客户端建议创建“通用聊天”分组密钥，避免占用开发工具额度。

新增服务商，类型选择 OpenAI 或 OpenAI Compatible。
API 地址填写 https://api.artderm777.com/v1。
API Key 填写 NexusFlow 令牌。
点击“获取模型”或手动填入管理员开放的模型名。
发送一句测试消息，确认能正常返回。

模型、分组与额度说明

模型名以控制台实际展示为准。不同分组可见模型可能不同。
额度页面可显示人民币额度，但系统内部通常按美元基准计价后换算展示。
流式输出开发工具建议开启 stream。若中途断流，优先检查代理、网络和直连规则。
密钥安全不要把 API Key 发到公开聊天、GitHub、截图或录屏中。如泄露请立即删除重建。

常见问题

1. Base URL 到底要不要带 /v1？

OpenAI 兼容客户端一般填写 https://api.artderm777.com/v1。Claude Code / Anthropic 兼容配置一般填写 https://api.artderm777.com。

2. 提示 invalid token 怎么办？

检查密钥是否复制完整、令牌是否被删除、额度是否耗尽，以及当前客户端是否把 Bearer Token 传到了正确位置。

3. 提示 model not found 怎么办？

检查模型名称是否拼写正确，令牌分组是否允许访问该模型。必要时联系管理员开通对应模型。

4. 国内访问慢或流式断开怎么办？

先按本文“国内直连”章节添加直连规则，再重新测试。若仍异常，把客户端报错、模型名、请求时间发给管理员排查。

© NexusFlow · AI Gateway Documentation · api.artderm777.com