适用于你想继续使用 Claude Code 客户端，但后端实际走 Codex / GPT-5.4 模型的场景。这套配置使用 Anthropic 兼容入口，因此 Base URL 填根地址即可。

直接修改 Claude Code 的 settings.json 即可接入 Oreniva 的 Codex 能力。

1. 访问 https://oreniva.com ，在 API 密钥管理创建一个 Codex 专用 密钥。
2. 打开 Claude Code 的配置文件：Windows 为 %USERPROFILE%\.claude\settings.json，macOS / Linux 为 ~/.claude/settings.json。
3. 将下面的 JSON 合并到你的配置中，并把密钥替换成刚创建的 Codex key。
   Codex2Claude 配置示例 复制

   {
     "env": {
       "ANTHROPIC_API_KEY": "替换为你创建的 Codex key",
       "ANTHROPIC_BASE_URL": "https://api.oreniva.com",
       "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.4-low",
       "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.4-xhigh-fast",
       "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.4-high",
       "ANTHROPIC_MODEL": "gpt-5.4-xhigh",
       "ANTHROPIC_REASONING_MODEL": "gpt-5.4-xhigh",
       "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
       "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
       "DISABLE_ERROR_REPORTING": "1",
       "DISABLE_TELEMETRY": "1",
       "MCP_TIMEOUT": "60000"
     },
     "model": "gpt-5.4-xhigh",
     "skipDangerousModePermissionPrompt": true
   }

4. 保存后完全退出并重启 Claude Code。

Cursor 自定义 API 路由使用 OpenAI /v1/chat/completions 兼容格式。 你可以直接在 Cursor 的 Other 配置里接入 Oreniva。

1. 进入 Cursor Settings → Models，确保你是 Cursor Pro 账号。
2. 打开 OpenAI API Key 开关，粘贴在 Oreniva 后台创建的 key。
3. 打开 Override OpenAI Base URL，填写：https://api.oreniva.com/v1
4. Claude 系列直接在 Cursor 模型列表中选择；GPT 系列需要在 Add model 输入自定义模型名称。

配置图示（按图中位置操作）

VSCode Codex插件安装教程

适合使用 VSCode 图形界面安装 Codex 插件，并通过 API Key 登录的用户。

1. 1

   VSCode 打开后，先选择任意项目文件夹进入工作区。

2. 2

   打开左侧插件扩展界面。

   
3. 3

   搜索 Codex，出现插件后点击安装。

   
4. 4

   安装后侧栏会出现 Codex 入口。

   
5. 5

   安装完成后，配置 Codex 的全局配置文件。

   Windows 路径：%USERPROFILE%\\.codex\\config.toml与%USERPROFILE%\\.codex\\auth.json。安装 Codex 插件和 Codex CLI 后，.codex 位于用户目录下；在 macOS/Linux 中，~/.codex因为以点开头，默认是隐藏文件夹。
   config.toml 复制

   approval_policy = "never"
   sandbox_mode = "danger-full-access"
   model_provider = "Oreniva"
   model = "gpt-5.4"
   model_reasoning_effort = "xhigh"
   plan_mode_reasoning_effort = "xhigh"
   model_reasoning_summary = "detailed"
   network_access = "enabled"
   disable_response_storage = true
   windows_wsl_setup_acknowledged = true
   model_verbosity = "high"
   
   [model_providers.Oreniva]
   name = "Oreniva"
   base_url = "https://api.oreniva.com"
   wire_api = "responses"
   requires_openai_auth = true

   auth.json 复制

   {
     "OPENAI_API_KEY": "粘贴为Codex专用分组密钥key"
   }

6. 6

   如果之前使用官方或其他平台登录过，请先按图退出已有登录。

   
7. 7

   选择 Use API Key 方式登录。

   
8. 8

   输入在https://oreniva.com/keys创建的 Codex 分组 key，然后点击 OK。

   
9. 9

   点击 Continue 完成登录。

   
10. 10

    登录成功后即可开始对话，底部可以切换模型与推理强度。

    

适合不想手动改配置文件的同学，按步骤填入即可。

1. 安装后，在应用顶部 Tab 切换到你的目标配置对象（Claude、Codex、Gemini），然后添加自定义配置。
2. 按下方参数填入并保存。

OpenCode 与 Codex 的配置是两套独立步骤，请按下方内容单独配置。

1. 安装 OpenCode CLI 并登录。
2. 登录时选择 Other，并设置 Oreniva 供应商。
3. 编辑配置文件，替换为你的 API Key 与 baseURL。

npm install -g opencode-ai
opencode auth login

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "oreniva": {
      "npm": "@ai-sdk/openai",
      "name": "Oreniva",
      "options": {
        "baseURL": "https://api.oreniva.com",
        "apiKey": "替换为你的key"
      },
      "models": {
        "gpt-5.4": {
          "attachment": true,
          "reasoning": true,
          "modalities": {
            "input": [
              "text",
              "image"
            ],
            "output": [
              "text"
            ]
          },
          "limit": {
            "context": 1000000,
            "output": 128000
          },
          "variants": {
            "xhigh": {
              "reasoningEffort": "xhigh",
              "textVerbosity": "low",
              "reasoningSummary": "auto"
            },
            "high": {
              "reasoningEffort": "high",
              "textVerbosity": "low",
              "reasoningSummary": "auto"
            },
            "medium": {
              "reasoningEffort": "medium",
              "textVerbosity": "low",
              "reasoningSummary": "auto"
            },
            "low": {
              "reasoningEffort": "low",
              "textVerbosity": "low",
              "reasoningSummary": "auto"
            }
          }
        }
      }
    }
  }
}

Ctrl + T

OpenClaw 可通过 OpenAI Responses 兼容方式接入 Oreniva。

1. 安装 OpenClaw：

npm i -g openclaw

2. 运行初始化命令：

clawdbot onboard

模型供应商配置请选择跳过（Model/auth provider - Skip for now），其他配置可按需随意填写。

3. 运行以下命令启动 Web 面板：

openclaw dashboard

4. Codex 配置：在面板的 Config 中修改 Raw JSON 配置，重点对应models字段和agents.defaults.model字段。以下为参考配置（请替换apiKey）：

{
  "models": {
    "mode": "merge",
    "providers": {
      "oreniva": {
        "baseUrl": "https://api.oreniva.com/v1",
        "apiKey": "替换为你的key",
        "auth": "api-key",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.4",
            "name": "Oreniva (gpt-5.4)",
            "reasoning": true,
            "input": [
              "text",
              "image"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "thinkingDefault": "high",
      "model": {
        "primary": "Oreniva/gpt-5.4"
      }
    }
  }
}

{
  "models": {
    "providers": {
      "oreniva-cc": {
        "baseUrl": "https://api.oreniva.com/v1",
        "apiKey": "你的key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4-5-20250929",
            "name": "Claude 4.5 Sonnet",
            "contextWindow": 200000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "oreniva-cc/claude-sonnet-4-5-20250929"
      }
    }
  }
}

5. 点击Save按钮和Update按钮，等待配置 Update 完成后，回到首页 chat 对话即可。

Cherry Studio 接入教程

这里只提供 Codex（Openai-Response）接入方式。

ChatBox 接入教程

按照以下步骤配置即可完成 ChatBox 的 Oreniva 接入。

1. 下载 ChatBox 客户端。
2. 打开【设置】-【添加】，名称填写 Oreniva（可自定义），API 模式选择 OpenAI Responses API 兼容。
3. API 密钥：粘贴在 https://oreniva.com/keys 创建的密钥 key。
4. API 主机填写：https://api.oreniva.com。
5. API 路径不需要填写，留空。
6. 开启【改善网络兼容性】选项。
7. 新建模型：模型 ID 填写 gpt-5.4，其余保持默认；也可按需开启视觉、推理、工具使用等选项。
8. 点击保存模型。
9. 点击检查按钮，确认配置成功。

Droid CLI 配置教程

Droid CLI 读取~/.factory/config.json，可在其中添加 custom_models 指向本服务端点。

{
  "custom_models": [
    {
      "model_display_name": "GPT-5.4 [oreniva]",
      "model": "gpt-5.4",
      "base_url": "https://api.oreniva.com",
      "api_key": "替换为你的key",
      "provider": "openai",
      "max_tokens": 16384,
      "extra_args": {
        "reasoning": {
          "effort": "high"
        }
      }
    }
  ]
}

Cline 接入教程

Cline 官方支持 OpenAI Compatible 提供商。你只需要填入 Base URL、API Key 和模型 ID，即可直接接入 Oreniva。

1. 打开 Cline 设置页，在 API Provider 中选择 OpenAI Compatible。
2. Base URL 填写为https://api.oreniva.com/v1。
3. API Key 粘贴你在后台创建的 API 密钥。
4. Model ID 输入gpt-5.4，或替换为你想使用的 Oreniva 模型名。
5. 保存后新建会话即可开始使用；若模型列表未自动出现，可手动输入模型 ID。

Continue 接入教程

Continue 官方支持 OpenAI 兼容提供商。最常见的接入方式是在 config.yaml 中为 OpenAI provider 增加 apiBase。

1. 打开 Continue 配置文件。
2. 在 models 数组内新增一个 OpenAI provider 模型。
3. 将 apiBase 指向https://api.oreniva.com/v1，并填入你的 API Key。
4. 模型名建议先用gpt-5.4，保存后重载 Continue。

name: Oreniva
version: 1.0.0
schema: v1

models:
  - name: Oreniva GPT-5.4
    provider: openai
    model: gpt-5.4
    apiBase: https://api.oreniva.com/v1
    apiKey: sk-替换为你的key

Zed 接入教程

Zed 官方支持通过 openai_compatible provider 添加自定义模型。你可以通过 UI 添加，也可以直接修改设置文件。

1. 在 Zed 中执行 agent: open settings。
2. 在 LLM Providers 区域点击 Add Provider。
3. 或者直接编辑设置文件，新增 openai_compatible provider。

{
  "language_models": {
    "openai_compatible": {
      "Oreniva": {
        "api_url": "https://api.oreniva.com/v1",
        "api_key": "sk-替换为你的key",
        "available_models": [
          {
            "name": "gpt-5.4",
            "display_name": "Oreniva GPT-5.4",
            "max_tokens": 128000,
            "max_completion_tokens": 16384
          }
        ]
      }
    }
  }
}

TRAE CN 接入教程

如果你当前使用的 TRAE CN 版本提供自定义模型或 OpenAI Compatible provider 入口，可以按下面的方式接入 Oreniva。

1. 打开 TRAE CN 设置，找到模型、Provider 或自定义模型相关页面。
2. 选择 OpenAI 兼容或自定义 provider 类型。
3. Base URL 填写https://api.oreniva.com/v1。
4. API Key 填入你的 Oreniva 密钥。
5. 模型 ID 先填写gpt-5.4，保存后重新打开模型选择器确认是否生效。

Open WebUI 接入教程

Open WebUI 官方支持连接任何 OpenAI-compatible provider。你可以在管理员后台添加一个新的 OpenAI 连接，把 Oreniva 当作外部模型服务接入。

1. 打开 Open WebUI，进入 Admin Settings → Connections → OpenAI。
2. 点击 Add Connection。
3. URL 填写https://api.oreniva.com/v1，API Key 填写你的密钥。
4. 如果自动校验没有拉到模型列表，在 Model IDs (Filter) 手动加入gpt-5.4。
5. 点击 Save，回到聊天页选择模型即可。

TypingMind 接入教程

TypingMind 支持添加自定义模型，同时也支持给 OpenAI Chat Endpoint 配置自定义代理地址。接入 Oreniva 时，最稳妥的方式是新建一个自定义 OpenAI 模型并把请求指向完整的聊天端点。

1. 打开左侧 Models 页面，点击 Add Custom Models。
2. 新建一个 OpenAI 兼容模型，模型名填Oreniva GPT-5.4，实际 model ID 填gpt-5.4。
3. 在 OpenAI provider 的 Proxy / Custom Endpoint 位置，把聊天接口改为https://api.oreniva.com/v1/chat/completions。
4. API Key 填入你的 Oreniva 密钥并保存。

LibreChat 接入教程

LibreChat 官方支持通过 librechat.yaml 添加 OpenAI API-compatible custom endpoint。最常见的做法是在 endpoints.custom 下新增一个 Oreniva provider。

1. 确认你的 LibreChat 实例已经启用 librechat.yaml 挂载。
2. 在 endpoints.custom 下新增一个 Oreniva 配置。
3. 将 API Key 放进 .env，再重启 LibreChat。

version: 1.3.5
cache: true
endpoints:
  custom:
    - name: "Oreniva"
      apiKey: "${ORENIVA_KEY}"
      baseURL: "https://api.oreniva.com/v1"
      models:
        default: ["gpt-5.4"]
        fetch: true
      titleConvo: true
      titleModel: "gpt-5.4"
      modelDisplayLabel: "Oreniva"

ORENIVA_KEY=sk-替换为你的key

NextChat 接入教程

NextChat 在自托管场景下支持通过环境变量覆盖 OpenAI 的请求地址和模型列表。接入 Oreniva 时，最常用的是设置 BASE_URL 与 CUSTOM_MODELS。

1. 打开 NextChat 部署环境变量，或你自己的 .env.local。
2. 将 OpenAI Key 改成你的 Oreniva API Key。
3. 把 Base URL 指向https://api.oreniva.com/v1。
4. 在自定义模型列表中加入gpt-5.4，重启应用后即可在聊天页选择。

OPENAI_API_KEY=sk-替换为你的key
BASE_URL=https://api.oreniva.com/v1
CUSTOM_MODELS=gpt-5.4

LobeChat 接入教程

LobeChat 在自托管场景下支持通过环境变量覆盖 OpenAI provider 的代理地址和模型列表。接入 Oreniva 时，最常见的是设置 OPENAI_PROXY_URL 与 OPENAI_MODEL_LIST。

1. 找到 LobeChat 的部署环境变量文件。
2. 设置 OpenAI API Key 为你的 Oreniva Key。
3. 设置代理地址为https://api.oreniva.com/v1。
4. 在模型列表加入gpt-5.4，重启 LobeChat。

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

AnythingLLM 接入教程

AnythingLLM 官方提供 OpenAI (generic) provider，适合接入任意 OpenAI-compatible 服务。Oreniva 场景下直接填 Base URL、API Key 和模型名即可。

1. 打开 AnythingLLM 管理后台，进入 LLM Provider 设置。
2. Provider 类型选择 OpenAI (generic)。
3. Base URL 填写https://api.oreniva.com/v1，API Key 填入你的 key。
4. 模型 ID 输入gpt-5.4，保存即可。

BoltAI 接入教程

BoltAI 官方支持 OpenAI-compatible Server。和 TypingMind 类似，它更适合填写完整的聊天接口 endpoint。

1. 打开 BoltAI 设置，进入 AI Providers 或自定义服务器设置。
2. 新建一个 OpenAI-compatible Server。
3. Endpoint 填写https://api.oreniva.com/v1/chat/completions。
4. API Key 填入你的 Oreniva key。
5. 模型名填写gpt-5.4，保存后即可开始对话。