ENKE.AI 多客户端接入教程

开始前准备

建议先确认 Node.js、客户端版本和 API Key 分组，再开始配置。不同客户端对“根地址、Base URL、完整接口地址”的要求不同，这是配置出错最多的地方。

地址填写规则

API 直连建议

如果你使用代理软件，建议把 ENKE.AI 域名加入直连规则。这样可以减少代理链路导致的延迟、超时、连接被重置等问题。

Clash / Clash Verge Rev

DOMAIN-SUFFIX,api.enke.ai,DIRECT
DOMAIN-SUFFIX,enke.ai,DIRECT

扩展脚本写法

function main(config, profileName) {
  const directRules = [
    'DOMAIN-SUFFIX,api.enke.ai,DIRECT',
    'DOMAIN-SUFFIX,enke.ai,DIRECT'
  ]
  const rules = Array.isArray(config.rules) ? config.rules : []
  config.rules = [...directRules.filter(rule => !rules.includes(rule)), ...rules]
  return config
}

保存后打开 Connections / 连接列表，让客户端请求 https://api.enke.ai，确认规则命中 DIRECT。

CC Switch 配置 Claude、Codex、Gemini

CC Switch 适合不想手动编辑多个配置文件的用户。安装后在顶部 Tab 切换到目标对象，再添加自定义供应商。

Claude Code 快速开始

Claude Code 是 Anthropic 官方 CLI。建议使用 Claude Code 专用密钥，不要和 Codex、Gemini 或普通聊天客户端混用。

node --version
npm --version

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

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "粘贴你的 Claude Code 专用密钥",
    "ANTHROPIC_BASE_URL": "https://api.enke.ai"
  }
}

claude

node --version
npm --version
npm install -g @anthropic-ai/claude-code
mkdir -p ~/.claude

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "粘贴你的 Claude Code 专用密钥",
    "ANTHROPIC_BASE_URL": "https://api.enke.ai"
  }
}

claude

Codex CLI / App 配置

Codex 使用 OpenAI Responses 兼容协议时，配置根地址即可，实际请求会走 /v1/responses。

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

配置文件位置

model_provider = "enke"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.enke]
name = "ENKE.AI"
base_url = "https://api.enke.ai"
wire_api = "responses"
requires_openai_auth = true

{
  "OPENAI_API_KEY": "粘贴你的 Codex 专用密钥"
}

Gemini CLI 快速开始

Gemini CLI 需要单独的 Gemini 分组密钥。配置后客户端会通过 Gemini 兼容接口请求。

npm install -g @google/gemini-cli
gemini --version

Windows

配置目录：%USERPROFILE%\.gemini\

macOS / Linux

配置目录：~/.gemini/

GOOGLE_GEMINI_BASE_URL=https://api.enke.ai
GEMINI_API_KEY=粘贴你的 Gemini CLI 专用密钥
GEMINI_MODEL=gemini-3-pro-preview

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

保存后完全退出 Gemini CLI，再执行：

gemini

Cursor 配置教程

Cursor 使用 OpenAI 兼容格式接入。不同版本设置入口略有变化，以 Models / API Keys / Override OpenAI Base URL 相关字段为准。

VSCode Codex 插件安装教程

Cline 接入教程

Cline 支持 OpenAI Compatible provider。这里填写的是 Base URL，不是完整的 /chat/completions。

Continue 接入教程

Continue 支持 OpenAI compatible provider。新版 Assistant 配置建议包含 name、version 和 schema。

name: ENKE.AI
version: 1.0.0
schema: v1
models:
  - name: ENKE GPT
    provider: openai
    model: gpt-5.4
    apiBase: https://api.enke.ai/v1
    apiKey: sk-替换为你的ENKE密钥

如果你使用旧版全局配置，只把 models 部分合并到现有文件即可。保存后重载 Continue。

Zed 接入教程

Zed 的 OpenAI Compatible provider 使用 language_models.openai_compatible 配置结构。

{
  "language_models": {
    "openai_compatible": {
      "ENKE.AI": {
        "api_url": "https://api.enke.ai/v1",
        "available_models": [
          {
            "name": "gpt-5.4",
            "display_name": "ENKE GPT-5.4",
            "max_tokens": 128000
          }
        ]
      }
    }
  }
}

API Key 按 Zed 当前版本要求写入环境变量、secret 或界面字段。若版本提供图形化添加 provider，以界面字段为准。

TRAE CN 接入教程

TRAE CN 的自定义模型入口可能随版本变化。如果你的版本提供 OpenAI Compatible 或自定义 Provider，可按以下方式填写。

Codex2Claude 场景

这个场景适合“继续使用 Claude Code 客户端，但后端模型走 Codex / GPT 系列”的用户。是否可用取决于你的账号分组是否支持对应协议和模型。

{
  "env": {
    "ANTHROPIC_API_KEY": "替换为对应专用密钥",
    "ANTHROPIC_BASE_URL": "https://api.enke.ai",
    "ANTHROPIC_MODEL": "gpt-5.4-high",
    "ANTHROPIC_REASONING_MODEL": "gpt-5.4-high"
  }
}

保存后完全退出 Claude Code，再重新启动。若报模型不存在或协议不匹配，请回到控制台确认密钥分组。

OpenCode 配置教程

OpenCode 与 Codex 类工具通常支持自定义 provider。不同版本配置文件位置可能不同，核心字段如下。

{
  "provider": {
    "enke": {
      "name": "ENKE.AI",
      "baseURL": "https://api.enke.ai",
      "apiKey": "sk-替换为你的key"
    }
  },
  "model": "enke/gpt-5.4"
}

如果 OpenCode 当前版本要求 OpenAI Compatible Base URL，则改填 https://api.enke.ai/v1。首次接入建议先使用基础模型，不要同时打开太多高级选项。

OpenClaw 配置教程

OpenClaw 可按 OpenAI Responses 或 Anthropic Messages 两类方式接入。建议优先使用 OpenAI 兼容配置。

{
  "providers": {
    "enke": {
      "baseUrl": "https://api.enke.ai/v1",
      "apiKey": "sk-替换为你的key",
      "models": [
        {
          "name": "gpt-5.4",
          "displayName": "ENKE GPT-5.4"
        }
      ]
    }
  },
  "primary": "enke/gpt-5.4"
}

{
  "providers": {
    "enke-claude": {
      "baseUrl": "https://api.enke.ai/v1",
      "apiKey": "sk-替换为你的key",
      "models": [
        {
          "name": "claude-sonnet-4-5",
          "displayName": "Claude Sonnet"
        }
      ]
    }
  }
}

Droid CLI 配置教程

Droid CLI 通常读取 ~/.factory/config.json 或相近配置文件。若你的版本支持 custom models，可按下面思路添加。

{
  "custom_models": [
    {
      "model": "gpt-5.4",
      "model_display_name": "ENKE GPT-5.4",
      "provider": "openai-compatible",
      "base_url": "https://api.enke.ai",
      "api_key": "sk-替换为你的key"
    }
  ]
}

如果已有旧 provider 配置，建议先备份再修改。保存后重启 Droid CLI。

桌面客户端

通用填写步骤

自部署客户端

Open WebUI

LibreChat

custom:
  - name: "ENKE.AI"
    apiKey: "${ENKE_API_KEY}"
    baseURL: "https://api.enke.ai/v1"
    models:
      default:
        - "gpt-5.4"
    titleConvo: true
    titleModel: "gpt-5.4"

LobeChat

OPENAI_API_KEY=sk-替换为你的key
OPENAI_PROXY_URL=https://api.enke.ai/v1
OPENAI_MODEL_LIST=gpt-5.4

NextChat

OPENAI_API_KEY=sk-替换为你的key
BASE_URL=https://api.enke.ai

多数 NextChat 版本会基于根地址拼接 OpenAI API 路径。如果你的版本文档明确要求 OpenAI API Base URL，再改为 https://api.enke.ai/v1。

AnythingLLM

常见问题

401 或 API_KEY_REQUIRED

说明请求已经到达 API 服务，但没有携带有效密钥。检查 API Key 是否完整、字段是否填对、密钥分组是否支持当前模型。

404 page not found

通常是把 Base URL 和完整 endpoint 混用了。OpenAI Compatible Base URL 通常是 https://api.enke.ai/v1，完整聊天接口才是 https://api.enke.ai/v1/chat/completions。

浏览器打开 /v1 没有内容

这是正常的。/v1 是 API Base URL，不是文档页面。请用客户端或 curl 携带 API Key 请求具体端点。

模型列表为空

部分客户端不会自动拉取模型列表，需要手动输入模型 ID。请以 ENKE.AI 控制台显示的可用模型为准。

速度慢或超时

先把 api.enke.ai 加入代理软件直连规则，再检查 DNS、代理连接列表和本机防火墙。

多个客户端共用一个 Key 是否可以

可以但不推荐。建议按客户端或用途分开创建密钥，便于限额、日志排查和泄露后快速停用。