启元Hub启元Hub
首页API 服务模型 & 定价接入文档
控制台登录开始接入

启元Hub

社区私有算力与统一 API 网关,为超级个体和小团队提供本地可控的模型接入能力。

产品

  • API 服务
  • 模型定价
  • 接入文档
  • 控制台

合规

  • 用户协议
  • 隐私政策
  • API 使用条款

账号

  • 开始接入
  • 登录

社区算力平台 · 数据不出园区

© 2026 启元Hub. All rights reserved.

快速开始

  • 30 秒快速验证
  • Node.js 环境安装
  • Claude Code 配置
  • Gemini CLI 配置
  • Codex (OpenAI) 配置

进阶玩法

  • OpenClaw 部署教程
  • Hermes 部署教程
  • OpenCode 配置教程
  • ChatBox 接入教程

其他

  • 常见问题
Docs/快速开始/Codex (OpenAI) 配置

Codex (OpenAI) 配置

配置 OpenAI Codex / OpenAI CLI 类工具,通过启元Hub 统一调用模型。

01

准备工作

  • Node.js 18+ 已安装
  • 启元Hub 控制台已创建 API Key
  • 本地已安装目标 Codex / OpenAI CLI 工具
02

配置 OpenAI 兼容环境变量

1. macOS / Linux

export OPENAI_API_KEY="sk-opc-your-api-key"
export OPENAI_BASE_URL="https://api.qiyuanapi.cc/v1"

# 部分工具读取 AZURE_OPENAI_* 或自定义变量,请对照工具文档

2. Windows PowerShell

$env:OPENAI_API_KEY="sk-opc-your-api-key"
$env:OPENAI_BASE_URL="https://api.qiyuanapi.cc/v1"

3. 写入配置文件(持久化)

# ~/.zshrc 或 ~/.bashrc
export OPENAI_API_KEY="sk-opc-your-api-key"
export OPENAI_BASE_URL="https://api.qiyuanapi.cc/v1"
03

Node.js SDK 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: process.env.OPENAI_BASE_URL,
});

const completion = await client.chat.completions.create({
  model: "deepseek-v4",
  messages: [{ role: "user", content: "用 Python 写一个快速排序" }],
});

console.log(completion.choices[0].message.content);
04

Python SDK 示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-opc-your-api-key",
    base_url="https://api.qiyuanapi.cc/v1",
)

response = client.chat.completions.create(
    model="deepseek-v4",
    messages=[{"role": "user", "content": "你好"}],
)

print(response.choices[0].message.content)
05

常见问题

  • 若工具仍请求 api.openai.com,检查是否有硬编码 Base URL
  • quota_exceeded 表示余额不足,请前往控制台钱包充值
  • model_not_allowed 表示当前账户无权访问该模型

本页目录

  • 准备工作
  • 配置 OpenAI 兼容环境变量
  • Node.js SDK 示例
  • Python SDK 示例
  • 常见问题