KHaiXAPIAPI 配置手册

KHaiXAPI AI API 配置手册

面向支持自定义 API 地址的 AI 应用与客户端，提供 Base URL、API Key、模型名称及常见配置方式。

更新日期：

API 地址和 API Key 获取

进入后台左侧菜单栏的 API 密钥页面，创建或查看用于配置 Codex 的 API Key。

API 密钥页面里需要记录两项信息：

  • API 地址：页面里的 API 端点。
  • API Key：sk- 开头的一段密钥。

API 地址示例：

TEXT
https://api.khaix.net

以上就是 API 地址和 API Key 的获取方式。

GPT-5.6 模型与模式说明

目前支持 GPT-5.6 的三个正式模型：

  • gpt-5.6-sol：旗舰能力模型，适合复杂任务；gpt-5.6 别名会路由到该模型。
  • gpt-5.6-terra：兼顾能力、速度与成本。
  • gpt-5.6-luna：适合高并发和批量任务。

推荐默认使用 gpt-5.6-sol。

  • Max：GPT-5.6 的最高推理强度。在 Codex 配置中使用 model_reasoning_effort = "max"。
  • Ultra：Codex 客户端的并行协作模式，不是独立模型 ID；请在支持 Ultra 的 Codex 客户端中选择，不要把 ultra 写进 model 字段。

常见问题清单

问题1：遇见断流超时错误代码 （Codex CLI 以及 VS Code Codex 插件表现一样）

stream disconnected before completion:error sending request for url

(https://api.khaix.net/responses)

解决方案：重新切换网络环境，并检查代理是否稳定。这类问题可能是被 CF 拦截，也可能是网络代理自动切换 IP 后导致连接丢失。

服务器在国外，并且走 CF 加速线路；稳定的网络环境会更快，国内也可以访问使用。

问题2：遇见 429 重试错误代码 （Codex CLI 以及 VS Code Codex 插件表现一样）

■ exceeded retry limit, last status: 429 Too Many Requests, request id: u4139nevc6s

典型的是当前可用额度已经用完，需要进行额度重置。

解决方案：

本站采用 1:1 重置方式。完成额度重置后，重新发起请求即可继续使用；如果仍然返回 429，请重新打开终端或 IDE 后再试。

一、Codex CLI 配置使用教程

本节使用官方配置文件方式：先安装 Codex CLI，再在用户目录创建或覆盖 .codex/config.toml 与 .codex/auth.json。

1.1 Windows 安装 Codex CLI

1. 安装 Windows Terminal

  • Windows 里面使用 Codex CLI 建议使用 Windows Terminal 替代 cmd 启动 Codex CLI。
  • Windows Terminal 在使用和多开窗口上更加舒适和方便。
  • Windows Terminal 下载地址为：https://github.com/microsoft/terminal/releases/tag/v1.23.20211.0 如果打不开，可以更换网络环境后再试。

2. 安装 Node.js 配置环境

（如果已安装过可以跳过） 检查是否安装命令：node -v

  • 安装 Node.js 需要 Node 20+ 以上版本，下载软件包进行安装：https://nodejs.org/en/download 一路点下一步，到图片的位置注意勾选即可。
  • 安装好了之后，在终端输入 node -v 验证是否安装成功；如果安装成功会显示版本号。

特殊情况说明：

  • 如果没有安装 Node.js，或者之前安装过但环境配置有问题，可能会出现下面图片中的报错。
  • 需要重新下载再安装一次！重新打开终端就行。
  • 如果在终端启动 Codex 时出现禁止运行脚本的报错：
  • codex：无法加载文件C:\Users\Adminis因为在此系统上禁止运行脚本。
  • 解决办法：请在终端运行以下命令来更改执行策略然后重新打开新终端：
  • Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 安装 Codex CLI

  • 在终端输入命令 npm i -g @openai/codex 进行安装。
  • 如果遇到安装失败或下载失败，通常是网络环境问题，可以尝试使用国内镜像源下载。
  • 在终端输入：npm config set registry https://registry.npmmirror.com 指定镜像源然后再到终端执行
  • npm i -g @openai/codex进行下载
  • 验证安装：codex --version 显示有版本号就代表安装成功了

4. 启动 Codex CLI

  • 终端输入：codex 启动。
  • 如果你明确需要自动执行命令，可以手动使用 codex --yolo，但不要在不信任的项目目录中使用。

1.2 Windows 官方配置文件方式

如果你已经安装了 Codex CLI，可以直接按下面的官方配置文件方式配置；如果没安装，请先参考上面的安装步骤。

先编辑下配置文件（如果没有就新建，存在的话就覆盖）

  • Windows 的配置目录在 C:\users\你的用户名\.codex\
  • 在该目录下创建或者覆盖配置文件 config.toml 和 auth.json。如果目录下已经有这两个文件，就直接替换以下内容。

config.toml 直接粘贴或者覆盖为以下配置

TOML
model = "gpt-5.6-sol"
model_reasoning_effort = "max"
model_provider = "openai"
openai_base_url = "https://api.khaix.net/v1"
web_search = "cached"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true

auth.json 直接粘贴或者覆盖为以下配置

JSON
{
  "OPENAI_API_KEY": "这里填入在后台生成的 sk- 开头密钥"
}

auth.json 里包含你的 API 密钥，不要上传到公开仓库，也不要把完整内容发给别人。

然后打开就能自动登录 Codex CLI 了

2.1 Mac / Linux 安装 Codex CLI

1. Node.js 环境配置

使用 Mac 的终端进行安装和配置启动。

需要安装 Node 20+ 以上版本，下载软件包进行安装：https://nodejs.org/en/download 一路点下一步就行安装好了之后，在终端输入验证安装：

BASH
node --version

验证安装查看是否安装成功，如果安装成功会显示版本号

2. 安装 Codex CLI

  • 在终端输入命令 npm i -g @openai/codex 进行安装。
  • 如果遇到安装失败或下载失败，通常是网络环境问题，可以尝试使用国内镜像源下载。
  • 在终端输入：npm config set registry https://registry.npmmirror.com 指定镜像源然后再到终端执行
  • npm i -g @openai/codex进行下载
  • 验证安装：codex --version 显示有版本号就代表安装成功了

3. 启动 Codex CLI

  • 终端输入：codex 启动。
  • 如果你明确需要自动执行命令，可以手动使用 codex --yolo，但不要在不信任的项目目录中使用。

2.2 Mac / Linux 官方配置文件方式

如果你已经安装了 Codex CLI，可以直接按下面的官方配置文件方式配置；如果没安装，请先参考上面的安装步骤。

先编辑下配置文件（如果没有就新建，存在的话就覆盖）

  • Mac/Linux 的在 ~/.codex/config.toml
  • 在 ~/.codex/ 目录下创建或者覆盖配置文件 config.toml 和 auth.json。如果目录下已经有这两个文件，就直接替换以下内容。

config.toml 直接粘贴或者覆盖为以下配置

TOML
model = "gpt-5.6-sol"
model_reasoning_effort = "max"
model_provider = "openai"
openai_base_url = "https://api.khaix.net/v1"
web_search = "cached"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true

auth.json 直接粘贴或者覆盖为以下配置

JSON
{
  "OPENAI_API_KEY": "这里填入在后台生成的 sk- 开头密钥"
}

auth.json 里包含你的 API 密钥，不要上传到公开仓库，也不要把完整内容发给别人。

然后打开就能自动登录 Codex CLI 了

3.1 WSL2 / SSH 远程服务器配置教程

  1. Node.js 环境配置，或者选择其他方式安装 Node 环境都可以。

服务器终端输入：

TEXT
curl https://get.volta.sh | bash
  • 服务器安装volta环境成功后切记要新建一个终端窗口输入：
TEXT
volta install node@20
  • 安装 Codex CLI，在服务端终端输入：
TEXT
volta install @openai/codex
  • 创建 Codex 官方配置目录：
TEXT
mkdir -p ~/.codex
  • 在 ~/.codex/config.toml 中写入前面 Codex CLI 配置里的 config.toml 内容。
  • 在 ~/.codex/auth.json 中写入前面 Codex CLI 配置里的 auth.json 内容，并把 OPENAI_API_KEY 替换成你自己的 sk- 开头密钥。
  • 启动 Codex CLI
  • 终端输入：codex 启动。
  • 如果你明确需要自动执行命令，可以手动使用 codex --yolo，但不要在不信任的项目目录中使用。

注意事项

  • 目前推荐使用 GPT-5.6 系列，默认模型为 gpt-5.6-sol
  • GPT-5.6 还提供 gpt-5.6-terra 和 gpt-5.6-luna，可按任务需求切换
  • 推理强度设置为 max；Ultra 是 Codex 客户端模式，不是模型名
  • 大家慢慢体验，祝大家工作愉快~
  • 如果不小心切换到旧模型了，重新把配置文件里的模型名改回 gpt-5.6-sol
  • 修改远程用户目录下的 ~/.codex/config.toml 文件后，重启终端即可

二、VS Code / Cursor / Trae Codex 插件配置教程

1.1 常见报错

  • 报错：配置后发现 401 提示密钥不正确，一般是没有替换或创建 config.toml 和 auth.json。
  • 如果没有正确创建这两个文件，Codex 可能继续请求官方默认地址，而不是 api.khaix.net，也可能是没有重启 IDE 重新加载配置文件。
  • 请再次按照教程创建或者替换 config.toml 和 auth.json 这两个文件，然后重启 IDE 即可。
  • 请务必仔细检查。
  • 如果遇见报错，请一定要截图并翻译错误信息，先确认具体原因。

1.2 配置方案

  • 先编辑下配置文件（如果没有就新建，存在的话就覆盖）
  • Mac/Linux 的在 ~/.codex/ 的目录下
  • 创建或者覆盖配置文件 config.toml 和 auth.json。如果目录下已经有这两个文件，就直接替换以下内容。
  • 如果没有 ~/.codex 这个目录，可以使用终端命令 mkdir -p ~/.codex 创建配置目录。
  • Windows 的在 C:\users\你的用户名\.codex\ 的目录下
  • 创建或者覆盖配置文件 config.toml 和 auth.json 如果目录下已经有 config.toml 文件和 auth.json 文件就直接替换以下内容
  • 注意：若之前使用官方或其他平台登录过，请先退出账号登录。再进行配置！
  • config.toml 直接粘贴或者覆盖为以下配置
TOML
model = "gpt-5.6-sol"
model_reasoning_effort = "max"
model_provider = "openai"
openai_base_url = "https://api.khaix.net/v1"
web_search = "cached"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true
  • auth.json 直接粘贴或者覆盖为以下配置
JSON
{
  "OPENAI_API_KEY": "这里填入在后台生成的 sk- 开头密钥"
}

auth.json 里包含你的 API 密钥，不要上传到公开仓库，也不要把完整内容发给别人。

然后打开 VS Code、Cursor、Trae 里的 Codex 插件就能够自动登录了。

Visual Studio Code 插件安装教程

  • 适合通过 VS Code 图形界面安装 Codex 插件的用户。
  • 打开 VS Code 后先选择任意项目文件夹进入工作区。不然会提示弹窗要求你打开项目文件夹！
  • 打开左侧插件扩展界面进入扩展面板。
  1. 搜索 Codex，出现如图所示结果后点击安装。
  • 安装完成后侧栏会出现 Codex 入口。
  • 注意：若之前使用官方或其他平台登录过，请先按图退出登录，再进行重新配置！
  • 配置好后点击插件会出现当前界面，点击 Continue 完成登录流程。
  • 如果 GPT-5.6 没有在下拉列表展示，可以在自定义模型中填写 gpt-5.6-sol、gpt-5.6-terra 或 gpt-5.6-luna。
  • Max 是推理强度；Ultra 是 Codex 客户端模式，是否显示取决于当前客户端版本。
  • 或者在后台调用记录可以看到实际的请求模型

三、Codex App 桌面客户端配置方式

如果你不想安装 Codex CLI，只需要使用 Codex App 桌面客户端，可以参考此方法。

如果之前你登录过自己的账号，请先在 Codex App 里面退出当前账号，然后再进行重新配置。

警告：之前登录过自己的 GPT 账号时，更换 API 后可能看不到原来的历史对话，因为这类历史记录保存在 GPT 账号空间里，不在本地。

更换 API 登录之后，后续历史对话记录会保存在本地。

第一步：创建配置文件

  • Mac/Linux 的在 你的用户名 目录下创建 .codex 文件夹。如果文件夹已经存在，建议先删掉里面的 auth.json config.toml 再重新创建，避免旧配置干扰。
  • 也可以使用终端命令 mkdir -p ~/.codex 创建配置目录。
  • 接下来在 .codex 文件夹里创建两个文件：
  • auth.json - 存放你的 API 密钥：
JSON
{
  "OPENAI_API_KEY": "这里填入在后台生成的 sk- 开头密钥"
}
  • config.toml - 配置服务提供商：
TOML
model = "gpt-5.6-sol"
model_reasoning_effort = "max"
model_provider = "openai"
openai_base_url = "https://api.khaix.net/v1"
web_search = "cached"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true

注意事项：

  • 配置文件一般都在用户目录下的 .codex 文件夹内；如果找不到 .codex 文件夹，可以手动创建该文件夹，并创建 config.toml 和 auth.json。
  • 注意：若之前使用官方或其他平台登录过，请先按图退出登录，再进行配置！
  • 如果手动创建不了 .codex 文件夹，请参考第一节 Codex CLI 配置使用教程 中的官方配置文件方式，确认目录路径和文件名是否正确。

auth.json 里包含你的 API 密钥，不要上传到公开仓库，也不要把完整内容发给别人。

然后重新打开 Codex App 就能够自动登录使用了

第二步：常见报错

  • 报错：配置后发现 401 提示密钥不正确，一般是没有替换或创建 config.toml 和 auth.json。
  • 如果没有正确创建这两个文件，Codex 可能继续请求官方默认地址，而不是 api.khaix.net，也可能是没有重启应用重新加载配置文件。
  • 请再次按照教程创建或者替换 config.toml 和 auth.json 这两个文件，然后重启应用即可。
  • 请务必仔细检查。
  • 如果遇见报错，请一定要截图并翻译错误信息，先确认具体原因。

四、OpenCode 配置使用教程

安装

OpenCode 按照官方文档安装即可，官网有很详细教程

配置模型

安装完成后，编辑配置文件，在 ~/.config/opencode/opencode.json，添加模型提供商

JSON
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "api": {
      "npm": "@ai-sdk/openai",
      "name": "api",
      "options": {
        "baseURL": "https://api.khaix.net/v1"
      },
      "models": {
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol",
          "thinking": true,
          "modalities": {
            "input": [
              "text",
              "image",
              "pdf"
            ],
            "output": [
              "text"
            ]
          },
          "options": {
            "store": false,
            "reasoningEffort": "max",
            "textVerbosity": "high",
            "reasoningSummary": "auto",
            "include": [
              "reasoning.encrypted_content"
            ]
          }
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra",
          "thinking": true,
          "options": {
            "store": false,
            "reasoningEffort": "max",
            "reasoningSummary": "auto",
            "include": [
              "reasoning.encrypted_content"
            ]
          }
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna",
          "thinking": true,
          "options": {
            "store": false,
            "reasoningEffort": "max",
            "reasoningSummary": "auto",
            "include": [
              "reasoning.encrypted_content"
            ]
          }
        }
      }
    }
  }
}

这里的 reasoningEffort: "max" 对应 Max 推理强度；Ultra 不是 OpenCode 的模型 ID。

配置密钥

方式一：使用命令行（推荐）

BASH
# 登录或更新某个供应商的 Key
opencode auth login

# 查看当前已配置的所有供应商和 Key 状态
opencode auth list

# 删除指定供应商的 Key
opencode auth logout <供应商名称>

方式二：手动编辑配置文件

在 ~/.local/share/opencode/auth.json 中添加对应供应商的 API Key

注意：auth.json 中的供应商名称必须与 opencode.json 中的供应商名称完全一致。

TEXT
{
  "api": {
    "type": "api",
    "key": "你的 API 密钥"
  }
}

小技巧：在 OpenCode 中按 Ctrl + T 可切换不同的推理强度（variants）。

五、Cherry 配置使用教程

Cherry 的官网下载地址：https://www.cherry-ai.com/

Cherry 的手机版本分安卓和苹果系统，下载地址是：https://github.com/CherryHQ/cherry-studio-app/releases 安装方式和电脑端类似，按页面说明选择对应版本即可。

六、IDEA 里面使用第三方插件 Kilo Code 配置教程

七、小龙虾 OpenClaw 安装指南

1.1 官方配置文件方式

安装过程中可以先不管模型配置，安装完成后，直接去编辑配置文件 ~/.openclaw/openclaw.json

其中模型配置部分 models 直接使用这个，其中 sk-xxxx 替换成你的密钥

JSON
"models": {
      "providers": {
        "api": {
          "baseUrl": "https://api.khaix.net/v1",
          "apiKey": "你的密钥sk-xxxx",
          "auth": "api-key",
          "api": "openai-responses",
          "authHeader": true,
          "models": [
            {
              "id": "gpt-5.6-sol",
              "name": "GPT-5.6 Sol",
              "reasoning": true,
              "input": [
                "text",
                "image"
              ]
            },
            {
              "id": "gpt-5.6-terra",
              "name": "GPT-5.6 Terra",
              "reasoning": true,
              "input": [
                "text",
                "image"
              ]
            },
            {
              "id": "gpt-5.6-luna",
              "name": "GPT-5.6 Luna",
              "reasoning": true,
              "input": [
                "text",
                "image"
              ]
            }
          ],
          "headers": {
            "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) OpenClaw/2026.2.14",
            "Accept": "application/json"
          }
        }
      }
    },
    "agents": {
      "defaults": {
        "model": {
          "primary": "api/gpt-5.6-sol"
        },
        "models": {
          "api/gpt-5.6-sol": {
            "alias": "GPT 5.6 Sol"
          },
          "api/gpt-5.6-terra": {
            "alias": "GPT 5.6 Terra"
          },
          "api/gpt-5.6-luna": {
            "alias": "GPT 5.6 Luna"
          }
        },
        "workspace": "/root/.openclaw/workspace",
        "compaction": {
          "mode": "safeguard"
        },
        "maxConcurrent": 4,
        "subagents": {
          "maxConcurrent": 8
        }
      }
    }

如何设置小龙虾里面的 GPT-5.6 Max 推理强度：

全局默认改成 max 在 agents.defaults 里加一行（和 maxConcurrent 同级）：

TEXT
"agents": {
  "defaults": {
    "workspace": "/root/.openclaw/workspace",
    "compaction": { "mode": "safeguard" },
    "maxConcurrent": 4,
    "subagents": { "maxConcurrent": 8 },

    "thinkingDefault": "max",

    "model": { "primary": "api/gpt-5.6-sol" }
  }
}

改完后重启 OpenClaw gateway/主进程生效。

八、使用 Claude Code 接入 Codex

如果想使用 Claude Code CLI 接入 Codex，需要借助协议转换工具。

项目地址：https://github.com/lich0821/ccNexus/releases 下载适合自己的系统版本

使用说明：https://mp.weixin.qq.com/s/ohtkyIMd5YC7So1q-gE0og

该项目配置示例已更新为使用 gpt-5.6-sol。若工具版本较旧，请先更新工具后再使用。

下载后打开进行配置：

配置 Claude Code

在 Claude Code 设置中：

  • API Base URL: http://localhost:3000
  • API Key: 随便填写（会被代理替换）

然后点启动器里面的项目里面的启动

九、GPT 模型代码中调用

若要在代码中使用，例如 HTTP 请求或者官方的 SDK，那么：

  • 请求地址：https://api.khaix.net/v1/responses
  • 请求方法：POST
  • 请求头
  • Content-Type：application/json
  • Authorization：Bearer sk-xxxx
  • 请求体格式需要注意一下，其中 input 需要使用数组方式，下面给出一个最小可用 demo（以及其他可选参数，这里没有列举出来，可以自己抓包调试一下）
  • Max 推理强度通过 reasoning.effort: "max" 设置；Ultra 是 Codex 客户端模式，不是 Responses API 参数。
JSON
{
  "model": "gpt-5.6-sol",
  "reasoning": {
    "effort": "max"
  },
  "input": [
    {
      "type": "message",
      "role": "developer",
      "content": [
        {
          "type": "input_text",
          "text": "123"
        }
      ]
    },
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "456"
        }
      ]
    }
  ]
}