OpenKaya 使用教程 1.1

适用场景：Codex、Claude Code、OpenCode、OpenClaw

店铺地址：https://pay.ldxp.cn/shop/M7RVPOB4

服务站地址：https://api.openkaya.com

联系客服：QQ:981972938

API Base URL：https://api.openkaya.com

API Key：登录后在「API 密钥」页面自行创建，格式通常为 sk-****。请勿公开分享。

零、使用前必读

安全提醒

根据本站服务条款和中国大陆相关监管要求，本站不面向中国大陆地区的个人、组织或设备提供注册、访问、购买或使用服务。若您位于中国大陆地区，请立即停止访问，并不要注册或使用。

服务定位：本站用于合法业务场景下的 API 调用管理、用量统计、密钥管理、计费和相关技术服务；不得用于违法、侵权、欺诈、规避监管、网络中转、代理、VPN 或类似用途。

账号安全：请妥善保管账号密码、API Key 和访问令牌。因泄露、共享、转售、托管或配置不当造成的风险和损失，由用户自行承担。

发票与倍率：当前不支持开具发票；模型分组和倍率以「API 密钥」页面创建或选择分组时展示为准。

售后与公告：售后请联系客服。站内公告会提示分组、倍率或服务调整，以公告和页面实时展示为准。

社群与沟通：如需售后和通知，请联系客服。不要在公开发布 API Key。

一、注册与兑换码使用

1.1 注册或登录账号

访问服务站 https://api.openkaya.com/，点击首页右上角「登录」。

已有账号直接登录；新用户点击「注册」，按页面提示完成人机验证、邮箱验证和账号创建。

1.2 使用兑换码

登录后，在左侧导航栏点击「兑换」。将收到的兑换码粘贴到输入框，确认无误后点击「兑换」。成功后可在仪表盘或余额区域查看到账情况。

二、API 密钥使用

2.1 进入 API 密钥页面

在左侧导航栏点击「API 密钥」。该页面可查看默认 API 端点、创建和管理密钥、选择分组、复制密钥，并查看用量、状态和最后使用时间。

2.2 创建 API 密钥

点击右上角「创建密钥」，填写便于识别的名称（例如 Codex、Claude 或测试）。在「分组」中选择对应模型/套餐，确认倍率和用途后点击「创建」。

2.3 获取接入配置

密钥创建成功后，在密钥列表的操作列点击「使用密钥」。弹窗会按不同客户端展示配置方式，请复制自己的 API Key 和 base_url。Codex App、Codex CLI、VSCode/IDEA Codex 插件使用同一套 Codex 配置思路。

三、Codex App、Codex 插件（VSCode / IDEA）配置

3.1 打开「使用密钥」配置

在「API 密钥」页面找到要使用的密钥。 教程截图

3.2 修改 `config.toml` 和 `auth.json`

Codex 的配置文件在用户目录下的 .codex 文件夹内：

Windows：C:\Users\你的用户名\.codex\
macOS：/Users/你的用户名/.codex/
Linux：~/.codex/

如果找不到 .codex 文件夹，可以先在终端执行一次 codex 你好，Codex 会自动创建默认配置目录。

打开 ~/.codex/config.toml，写入以下配置：

toml

model_provider = "openkaya"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.openkaya]
name = "openkaya"
base_url = "https://api.openkaya.com/v1"

model 可以替换为你实际购买或页面支持的 Codex 模型。

打开 ~/.codex/auth.json，写入以下配置，并把 sk-... 替换成你自己的 API Key：

json

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-..."
}

如果配置文件无误但仍提示无效令牌，优先检查系统环境变量里是否残留旧的 OPENAI_API_KEY 或 OPENAI_BASE_URL。环境变量优先级高于配置文件，清理后需要完全关闭终端或 VS Code 再重新打开。

四、Claude Code / VSCode Claude 插件配置

4.1 打开「使用密钥」配置

在「API 密钥」页面点击「使用密钥」

4.2 修改环境变量与 `settings.json`

第一推荐使用站点里的 CC Switch 一键接入助手生成配置，适合需要经常切换模型的人。

你也可以直接打开一键接入助手，在文档站内生成并复制配置。

如果选择永久配置，需要设置两个环境变量：

ANTHROPIC_AUTH_TOKEN：你的授权令牌，格式通常为 sk-...
ANTHROPIC_BASE_URL：API 服务地址，填写 https://api.openkaya.com

Windows PowerShell 用户可以执行：

powershell

setx ANTHROPIC_BASE_URL "https://api.openkaya.com"
setx ANTHROPIC_AUTH_TOKEN "你的Token"

执行完成后，必须关闭当前 PowerShell、终端或 VS Code，再重新打开才会生效。

macOS 或 Linux 用户可以先检查 Shell：

bash

echo $SHELL

如果使用 Zsh，可以写入 ~/.zshrc：

bash

echo 'export ANTHROPIC_BASE_URL="https://api.openkaya.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的Token"' >> ~/.zshrc
source ~/.zshrc

如果使用 Bash，可以写入 ~/.bash_profile 或 ~/.bashrc：

bash

echo 'export ANTHROPIC_BASE_URL="https://api.openkaya.com"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的Token"' >> ~/.bash_profile
source ~/.bash_profile

验证配置：

bash

echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

配置完成后，在新的终端窗口进入项目目录并运行：

bash

claude 你是什么大模型

需要切换模型时，可以在 Claude Code 中输入 /model，例如 /model claude-sonnet-4-6。

五、OpenCode 配置

5.1 打开「使用密钥」配置

在「API 密钥」页面点击「使用密钥」

5.2 修改 `opencode.json`

OpenCode 使用 opencode.json 配置，不使用 Claude 的 %USERPROFILE%\.claude\settings.json。请复制弹窗中生成的 JSON，保存到 OpenCode 实际读取的配置文件中。

配置重点：baseURL 填 https://api.openkaya.com，apiKey 填你自己的 API 密钥；OpenAI、Claude、Gemini 或 Antigravity 分组需与密钥分组匹配。

六、OpenClaw 配置

6.1 腾讯云配置

步骤 1：登录腾讯云，进入你的龙虾服务器，点击「应用管理」，找到「模型」。下拉选择「自定义模型」，选择「JSON 输入」，填入步骤 2 的 JSON。

步骤 2：填入下方 JSON 后，点击「添加并应用」。其中 api_key 请替换为你在服务站创建的 API 密钥。也可以使用一键接入助手选择 OpenClaw 后自动生成。

json

{
  "provider": "openai",
  "base_url": "https://api.openkaya.com/v1",
  "api": "openai-completions",
  "api_key": "填写你的 API 密钥（sk-****）",
  "model": {
    "id": "gpt-5.4",
    "name": "GPT-5.4"
  }
}

6.2 本地配置

按 Win + R 输入 %USERPROFILE%\.openclaw 并回车，参考下方配置修改 openclaw.json。若文件不存在，先新建文本文件，再改名为 openclaw.json。

json

{
  "baseUrl": "https://api.openkaya.com",
  "api": "openai-responses",
  "apiKey": "填写你的 API 密钥（sk-****）"
}

七、常见问题与排查

优先自查配置：Codex 的 base_url 是否为 https://api.openkaya.com/v1，Claude/OpenCode/OpenClaw 的 base_url 或 baseURL 是否为 https://api.openkaya.com，API Key 是否完整，客户端文件路径和 JSON/TOML 格式是否正确。

如果出现 503，多数情况下代表上游、渠道或服务临时不可用，可稍后重试或查看站内公告/渠道状态。

如果不是 503，通常优先检查本地配置。建议把使用场景（例如 Codex、Claude Code、OpenCode）、报错信息、base_url 和已脱敏的 Key 片段整理清楚。

不要把完整 API Key 公开发到群里或截图里；如需售后，请只提供必要信息，并对敏感字段做脱敏。

可先使用 AI 工具辅助排查配置文件格式和路径问题，能更快定位常见错误。

客服工作量较大，回复可能延迟。清晰描述场景、报错和已尝试步骤，可以显著提高处理效率。

OpenKaya 使用教程 1.1 ​

零、使用前必读 ​

一、注册与兑换码使用 ​

1.1 注册或登录账号 ​

1.2 使用兑换码 ​

二、API 密钥使用 ​

2.1 进入 API 密钥页面 ​

2.2 创建 API 密钥 ​

2.3 获取接入配置 ​

三、Codex App、Codex 插件（VSCode / IDEA）配置 ​

3.1 打开「使用密钥」配置 ​

3.2 修改 config.toml 和 auth.json ​

四、Claude Code / VSCode Claude 插件配置 ​

4.1 打开「使用密钥」配置 ​

4.2 修改环境变量与 settings.json ​

五、OpenCode 配置 ​

5.1 打开「使用密钥」配置 ​

5.2 修改 opencode.json ​

六、OpenClaw 配置 ​

6.1 腾讯云配置 ​

6.2 本地配置 ​

七、常见问题与排查 ​

OpenKaya 使用教程 1.1

零、使用前必读

一、注册与兑换码使用

1.1 注册或登录账号

1.2 使用兑换码

二、API 密钥使用

2.1 进入 API 密钥页面

2.2 创建 API 密钥

2.3 获取接入配置

三、Codex App、Codex 插件（VSCode / IDEA）配置

3.1 打开「使用密钥」配置

3.2 修改 `config.toml` 和 `auth.json`

四、Claude Code / VSCode Claude 插件配置

4.1 打开「使用密钥」配置

4.2 修改环境变量与 `settings.json`

五、OpenCode 配置

5.1 打开「使用密钥」配置

5.2 修改 `opencode.json`

六、OpenClaw 配置

6.1 腾讯云配置

6.2 本地配置

七、常见问题与排查