📖 5 分钟接入 · 2026

KiKi AI 使用教程

选操作系统 → 用 KiKi 助手一键配置(或手写 baseURL + Key)→ 开聊。
覆盖 Cursor / Windsurf / CodeBuddy / MIMO / DeepSeek Harness / ZCode / WorkBuddy / Qoder / Kiro / Codex / Claude Code / KiKi IDE 等,国内直连,按量计费。

🎬 观看操作视频教程

KiKi 助手 · 操作视频

11 章 MG 教程:总览约 10 分钟,其余为各菜单 / 软件配置分集。电脑看横屏,手机看竖屏(可手动切换)。

加载章节…

桌面端默认横屏 · 手机端默认竖屏

API 域名 · 实时连通性

探活端点 /v1/models,每 5 秒自动重测。完整卡密通用模型见 下方列表。

🌐 域名健康检测
—
kikiapi.dexuebao.com 主域名 · 推荐
检测中…
—
🤖 Claude Code · https://kikiapi.dexuebao.com
🎯 Cursor / Windsurf / CodeBuddy / 小米 MIMO · 经 KiKi 助手配置
⚙️ Kiro CLI · https://kikiapi.dexuebao.com
🆕 Codex CLI · https://kikiapi.dexuebao.com
📱 KiKi IDE(Android) · https://kikiapi.dexuebao.com

⏱ 每 5 秒自动重测一次。检测从当前浏览器网络发出,代表你本机对该域名的可达性。

卡密通用模型

任意有效卡密均可调用下列模型 id(与 GET /v1/models 对齐)。 点击芯片即可复制;专属 / 1M 窗口模型需单独开通,不在此列。

📦 当前可用 60 个
实时同步

Claude / Anthropic 19

GPT / OpenAI 15

Grok 3

GLM / 智谱 3

Kimi / Moonshot 3

Qwen / 通义 6

DeepSeek 5

MiniMax 1

Composer 5

没有匹配的模型。

调用示例:curl https://kikiapi.dexuebao.com/v1/models -H "Authorization: Bearer 你的卡密" · 未列出:dexuebao-fable-5、dexuebao-opus-4-8

已复制

🤖 Claude Code 安装教程

桌面 App、终端 CLI、Cursor 扩展侧栏 是三个不同产品,配置通道互不通用。 下方为完整本地图文教程;KiKi 卡密登录桌面客户端可一键写入 CLI 配置。

桌面 App

Claude Code 桌面版

Anthropic 独立桌面程序(claude.com/download)。需开启开发者模式, 配合 CC Switch ≥ v3.15 或 App 内 Gateway 填入 KiKi 网关 + 卡密,不要点 Sign In。

终端 CLI

Claude Code 命令行

npm i -g @anthropic-ai/claude-code 后终端运行 claude。 读 ~/.claude/settings.json + apiKeyHelper,与 Cursor 侧栏扩展不是同一套登录。

KiKi 客户端

一键配置(推荐)

下载 KiKi 桌面客户端 → 卡密登录 → 点 [⚙ 配置], 自动写入 CLI 的 settings.json、Cursor 扩展环境变量与启动脚本,免手改文件。

💡
Cursor 用户注意:终端里 claude 能用,但 Claude Code 扩展侧栏仍弹登录 是 Anthropic 扩展已知限制。 KiKi 客户端提供「用 KiKi 环境启动 Cursor」脚本;最稳方式是在 Cursor 内置终端 输入 claude。

🖥️ Claude Code 桌面版安装及模型配置

以 Windows 为例,macOS 步骤相同 · 独立 App,与终端 claude 命令不是同一套登录

📌
建议先完成上方 终端 CLI 教程 中的 Node.js 与 Git 安装,桌面版部分场景也会用到。

1 下载 Claude Code Desktop

⚠️
Windows 用户若 exe 安装报 Download was intercepted by a network proxy or firewall (HTTP 403),请改用网盘中的 msix 安装包。

2 安装并开启开发者模式

  1. 双击安装包完成安装
  2. 首次打开后请勿点击 Sign In / 登录
  3. 点击左上角 设置(Settings)
  4. 进入 帮助(Help)→ 故障排除(Troubleshooting)
  5. 开启 开发者模式(Developer Mode)

开启后,菜单中会出现「配置第三方推理 / Configure Third-Party Inference」等 Gateway 相关选项。

3 安装 CC Switch(≥ v3.15)

使用国内模型 / 自定义网关时,需配合 CC Switch v3.15.0 及以上 管理 Claude Code Desktop 的 Provider 配置。

  • KiKi 客户端(推荐):登录后点「⬇ CC Switch」下载,再点「⚙ 一键配置」自动写入网关 + 卡密
  • 本站下载:见本页 一键导入 · CC Switch 区块(Windows MSI / 便携版 / macOS DMG)
  • 官方:ccswitch.io · GitHub Releases

4 获取 KiKi API Key(卡密)

桌面版需要 API Key 才能调用模型(原飞书文档以 DeepSeek 为例;接入 KiKi 请用本平台卡密):

  1. 登录 会员中心 → 我的卡密
  2. 复制卡密 AIDE-XXXX-XXXX-XXXX-XXXX,或提取 sk-kiki-... Key
  3. 首次 API 请求会自动激活卡密
配置项KiKi 填写值
Gateway / Base URLhttps://kikiapi.dexuebao.com(末尾不要 /v1)
API Key卡密 AIDE-... 或 sk-kiki-...
默认模型如 claude-opus-4-8、claude-opus-4-7(以会员中心已开通为准)

5 CC Switch 配置 KiKi(推荐)

  1. 打开 CC Switch → 选择 Claude Code 目标
  2. 点击 添加 Provider / 导入配置
  3. 粘贴本页 一键导入 复制的 JSON,将 apiKey 改为你的真实卡密
  4. baseUrl 保持 https://kikiapi.dexuebao.com
  5. 保存并 切换 / 应用 到该 Provider
  6. 重启 Claude Code Desktop(若已打开)

6 App 内 Gateway 配置(备选)

也可在 Claude Desktop 开发者菜单中手动配置第三方推理 Gateway:

  1. 开发者模式已开启(见步骤 2)
  2. 进入 Configure Third-Party Inference / 第三方推理 Gateway
  3. inferenceProvider 选 gateway
  4. inferenceGatewayBaseUrl 填 https://kikiapi.dexuebao.com
  5. inferenceGatewayApiKey 填 KiKi 卡密
  6. 保存后选择模型开始对话
💡
也可使用 KiKi 桌面客户端「Claude 桌面版」卡片复制网关地址与卡密,按 App 内引导粘贴。

7 验证

  • 桌面 App 主界面能正常发消息、流式回复 = 配置成功
  • 仍弹出官方 Sign In:确认未点登录,且 Gateway / CC Switch 已生效并重启 App
  • 终端 claude 能用但桌面版不行:正常,两者配置通道不同,请分别按本教程与 CLI 教程 配置

📟 Claude Code 安装指南及模型配置(终端 CLI)

Windows / macOS / Linux 通用 · 与桌面 App、Cursor 扩展侧栏配置通道不同

1 系统要求

安装 Claude Code 前,请确认系统满足以下条件:

类别要求
操作系统Windows 10+(64 位)/ macOS 10.15+ / Ubuntu 20.04+、Debian 10+ 或其他兼容 Linux
CPU至少 4 核
内存至少 8GB(推荐 16GB+)
磁盘至少 1GB 可用空间
网络稳定互联网连接

2 安装 Node.js(必需)

Claude Code 依赖 Node.js 18 或更高版本。请安装 LTS 长期支持版:

💡
如何打开终端? Windows:Win + R → 输入 cmd 或 powershell 回车。macOS:Command + 空格 → 搜索 Terminal。

macOS 使用 NVM 安装(可选):

bash
# 下载并安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
\. "$HOME/.nvm/nvm.sh"
nvm install 24
node -v   # 应显示 v24.x
npm -v

3 安装 Git(推荐)

Claude Code 的 Agent 功能会调用 Git。未安装请先到 git-scm.com 下载安装,安装后重启终端。

4 安装 Claude Code CLI

在终端执行(需管理员权限的 Windows 请用「以管理员身份运行」的 PowerShell):

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

验证安装:

bash
claude --version
claude doctor

5 接入 KiKi 网关(二选一)

方式 A — settings.json(推荐)

编辑 ~/.claude/settings.json(Windows:%USERPROFILE%\.claude\settings.json),卡密通过 apiKeyHelper 脚本输出,勿在 env 里同时写 ANTHROPIC_API_KEY:

json
{
  "apiKeyHelper": "C:\\Users\\你的用户名\\.claude\\kiki-api-key.cmd",
  "env": {
    "ANTHROPIC_BASE_URL": "https://kikiapi.dexuebao.com"
  },
  "model": "claude-opus-4-8",
  "theme": "dark",
  "hasCompletedOnboarding": true
}

同目录新建 kiki-api-key.cmd(macOS/Linux 用 .sh 并 chmod +x):

cmd
@echo off
echo AIDE-XXXX-XXXX-XXXX-XXXX

方式 B — 环境变量

PowerShell(Windows 用户级持久化):

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://kikiapi.dexuebao.com", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "AIDE-XXXX-XXXX-XXXX-XXXX", "User")

macOS / Linux(写入 ~/.zshrc 或 ~/.bashrc):

bash
export ANTHROPIC_BASE_URL="https://kikiapi.dexuebao.com"
export ANTHROPIC_API_KEY="AIDE-XXXX-XXXX-XXXX-XXXX"
⚡
下载 KiKi 桌面客户端 并卡密登录后,点 [⚙ 配置] 可自动生成上述文件,无需手改。

6 验证与使用

关闭并重新打开终端后执行:

bash
claude
# 或指定模型
claude --model claude-opus-4-8

可选检查:

bash
claude auth status
⚠️
ANTHROPIC_BASE_URL 填 https://kikiapi.dexuebao.com,不要带 /v1 或 /messages。卡密从 会员中心 复制,形如 AIDE-XXXX-... 或 sk-kiki-...。

🚀 一键导入 · CC Switch

装好 CC Switch ≥ v3.15(桌面版 Claude Code 配国内模型必备),一键写入 baseURL + Key + 模型映射。

⚡

CC Switch 一键导入 KiKi 配置

打开 CC Switch → 添加 Provider → 粘贴下方 JSON(把 apiKey 换成会员中心卡密或 sk-kiki-...)。

📋 复制导入配置
🪟 Windows MSI
v3.15.0 · 推荐 · 支持自动更新
⬇ 下载安装包
🪟 Windows 便携版
v3.15.0 · 解压即用 · 不写注册表
⬇ 下载 ZIP
🍎 macOS
v3.15.0 · DMG 安装包
⬇ 下载 DMG
⚠️
CC Switch 为免费开源软件,请只从本站镜像或 ccswitch.io / GitHub Releases 下载, 谨防仿冒站索要付费或账号。Linux 版请前往 GitHub Releases 按发行版选择 deb / AppImage。

支持的客户端

优先用 KiKi 助手 一键配置;亦兼容 OpenAI / Anthropic / EventStream 协议客户端。完整图文见 官网软件端介绍。

🔑

KiKi 助手

卡密登录入口(Win / macOS / Linux)。选模型、查余额,并为各软件一键写入配置与本机网关。

必装入口
🎯

Cursor

主流 AI IDE。助手写入自定义模型与 Ask/Workbench 本地网关,默认 Opus 5.5 High。

助手一键配置
🌊

Windsurf / Devin

Cascade 对话由助手拦截转发,模型与计费统一走 KiKi(非 Cognition Local)。

助手一键配置
🐧

CodeBuddy CN

腾讯 CodeBuddy。助手写入 ~/.codebuddy/models.json,选「KiKi · …」。

OpenAI Compatible
🟠

小米 MIMO

MiMo Code。助手写入 mimocode 配置,在模型列表选「KiKi / …」。

OpenAI Compatible
🧠

DeepSeek Harness

OpenAI 网关。助手配置后在 Harness 模型列表选择 KiKi 系列模型。

新增 · 助手配置
⚡

ZCode

写入 OpenAI Compatible 配置,模型列表选「KiKi / …」即可。

新增 · 助手配置
💼

WorkBuddy

办公编程助手一键指向 KiKi 网关,适合轻量日常编码。

新增 · 助手配置
🟣

Qoder

国际版 IDE。助手写入 Custom 模型并接入 kikiapi;配置后重开,选「KiKi · …」。对话会带上当前工作区路径与打开文件。不支持 Qoder CN。

新增 · 助手配置
🚀

Kiro IDE

桌面 IDE,AWS EventStream;助手自动补全模型列表并配置代理。

助手一键配置
🆕

Codex

OpenAI Codex CLI / 桌面,Responses API + 本机能力令牌。

助手一键配置
🤖

Claude Code CLI / 桌面

终端 claude 与桌面 Gateway / CC Switch,助手写环境变量,免 OAuth。

Anthropic
⚙️

Kiro CLI

命令行 AI,OpenAI 兼容,适合脚本与终端工作流。

OpenAI 兼容
📱

KiKi IDE(Android)

移动端 AI IDE,同一张卡密激活,通勤也能写代码。

移动端
🔌

Cline / Roo Code

VSCode 插件 Agent;按教程配置 Base URL 与卡密即可接入。

Anthropic / OpenAI

按系统配置

点选你的系统标签,按步骤操作。

🪟 Windows
🍎 macOS
🐧 Linux

1 提取 API Key

购买后在 会员中心 → 我的卡密 → 提取 Key。形如 sk-kiki-xxxx,首次请求自动激活。

2 配置速查

用途Base URL协议
Claude Codehttps://kikiapi.dexuebao.comAnthropic Messages
Kiro CLI / Codex CLIhttps://kikiapi.dexuebao.comOpenAI Chat Completions
OpenAI SDKhttps://kikiapi.dexuebao.comOpenAI Chat Completions
KiKi IDE(Android)https://kikiapi.dexuebao.comHBuilderX 打包 · API 兼容
API Keysk-kiki-... 或卡密 AIDE-XXXX-...通用(Claude Code 推荐 settings.json 填卡密)
⚠️
Key 是本平台生成的(sk-kiki-...)或购买卡密(AIDE-...),不是上游原始 Key。Claude Code 可直接在 ~/.claude/settings.json 里填卡密。后端限制可用模型/平台,按量计费。

3 Claude Code(终端 CLI)

完整安装步骤(Node.js、Git、npm 全局安装)见 本地 · Claude Code 命令行安装教程。 桌面 App 配置见 本地 · Claude Code 桌面版教程 (需 CC Switch,可从本页下载 CC Switch)。

方式 A — 环境变量(PowerShell)

PowerShell 中执行:

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://kikiapi.dexuebao.com", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-kiki-your-key-here", "User")
💡
设完重启终端 / VSCode生效。运行 claude 开始对话。

方式 B — settings.json(推荐,可指定默认模型)

编辑 %USERPROFILE%\.claude\settings.json(没有就新建),写入 KiKi 卡密与 baseURL:

json
{
  "apiKeyHelper": "C:\\Users\\你的用户名\\.claude\\kiki-api-key.cmd",
  "env": {
    "ANTHROPIC_BASE_URL": "https://kikiapi.dexuebao.com"
  },
  "model": "claude-opus-4-8",
  "theme": "dark",
  "hasCompletedOnboarding": true
}

同目录新建 kiki-api-key.cmd(路径与上面 apiKeyHelper 一致):

cmd
@echo off
echo AIDE-XXXX-XXXX-XXXX-XXXX
💡
说明:AIDE-XXXX... 写在 kiki-api-key.cmd 里(不要同时在 env 里填 ANTHROPIC_API_KEY,会 Auth conflict)。 model 可改为 claude-opus-4-8、claude-opus-4-7 等。 或登录 KiKi 客户端 后点 [⚙ 配置] 自动生成。 改完重启终端,运行 claude 验证。

4 Kiro CLI

🅰️
标准用户(独立装 kiro-cli)按下面 ① 改一个文件。已装 KiKi 桌面客户端的跳过本步,点下方折叠卡 [🅱️ KiKi 一键接入],不用手改任何文件。

Kiro CLI 的 Key 写在 auth.json 文件里,不靠环境变量,自成一派。Kiro 命名空间里没有 config.toml 这个文件——别照着 Codex CLI 的模板抄,只能改 auth.json 一个文件。

⚠️
KiKi 不是通用 OpenAI 中转站——别抄网上的"配 OPENAI_BASE_URL 环境变量 / auth.json 加 baseUrl 字段"那套。那套是给 api.openai.com 这类纯 OpenAI 兼容协议中转用的,KiKi 后端走 AWS Smithy SDK / EventStream 协议,Kiro CLI 这边的 auth.json 解析器根本不读 baseUrl / OPENAI_BASE_URL 这俩字段,写了也会被静默忽略,反而会让人误以为配好了。KiKi 的接入入口只能是 ① 改 auth.json 写 Key(标准用户)或 🅱️ 折叠卡的字节级 patch kiro-cli.exe(KiKi 客户端用户),二选一。

① auth.json — 写入 Key(5 步)

  1. 备份(如有):copy %USERPROFILE%\.kiro\auth.json %USERPROFILE%\.kiro\auth.json.bak
  2. 新建 / 覆盖 %USERPROFILE%\.kiro\auth.json,内容见下方代码块(把 sk-kiki-your-key-here 替换成你 KiKi 卡密对应的真实 Key,从 购买页 / 客户端 复制)
  3. 关掉所有正在跑的 kiro-cli 进程 + 所有终端窗口(auth.json 是 kiro-cli 启动时一次性读,热改不会生效,必须重启进程)
  4. 重开 PowerShell / 终端,跑 kiro-cli --version 验证客户端已装
  5. 跑 kiro-cli login——按提示走 Builder ID 浏览器授权(不是 OpenAI 那个 codex login,走的是 AWS IAM Identity Center 流程),授权码回贴到终端即登录成功

编辑 %USERPROFILE%\.kiro\auth.json(没有就新建):

json
{
  "OPENAI_API_KEY": "sk-kiki-your-key-here"
}
✅
验证是否生效:登录成功后终端跑 kiro-cli chat "你好",能看到流式回复 = 配置成功。如果报 Authentication failed → 99% 是 Key 复制错位(多了空格 / 少了前缀 / 大小写错),重新核对粘贴;如果报 ProtocolMismatch → 说明你走了别家 OpenAI 中转站的 baseUrl 思路,删 auth.json 里的 baseUrl 字段 + 删 OPENAI_BASE_URL 环境变量,KiKi 不需要这两项。
🅱️ 装了 KiKi 桌面客户端?点这里免改文件一键接入(推荐)▾

KiKi 客户端不写 ~/.kiro/ 下任何文件,而是对 kiro-cli.exe 做字节级 patch(同长度替换硬编码的 q.us-east-1.amazonaws.com → www.kiki-cli.dexuebao.com),原版自动备份为 .kiki-original,可一键还原。

  1. 下载并登录 KiKi 桌面客户端(Windows / macOS / Linux 三端)
  2. KiKi 主界面 → [🔧 Patch kiro-cli] → 等几秒提示 ✅ 已 patch 3 处 chat endpoint
  3. 终端跑 kiro-cli login(Builder ID 授权)→ 回 KiKi 客户端点 [🔗 Builder ID 绑定] → 完事
  4. 终端 kiro-cli chat 验证;想卸载 KiKi 时点 [🔙 还原原版] 即可
🔒
patch 过程只改字符串字面量,不改 PE 结构 / 不影响签名校验(kiro-cli 本身就不验签);卸载 KiKi 后点 [🔙 还原原版] 100% 还原。
💡
Kiro CLI 与 Codex CLI 的区别:前者 Key 在 auth.json。Codex 新版只走 Responses API,卡密写在 ~/.codex/config.toml 的 X-Card-Key,base_url 要带 /v1,wire_api = "responses"。域名 kikiapi.dexuebao.com 国内直连,不需要代理。

5 Codex CLI(OpenAI 官方)

Codex 新版只走 Responses API。卡密写在 config.toml 的 X-Card-Key,不需要 OPENAI_API_KEY,也不需要代理。

① config.toml — 配置 baseURL 和模型

先安装:

powershell
npm i -g @openai/codex

再编辑 %USERPROFILE%\.codex\config.toml(base_url 带 /v1,wire_api = "responses",卡密写在 X-Card-Key):

toml
model_provider = "kiki"
model = "claude-sonnet-5"

[model_providers.kiki]
name = "KiKi"
base_url = "https://kikiapi.dexuebao.com/v1"
wire_api = "responses"

[model_providers.kiki.http_headers]
X-Card-Key = "AIDE-你的卡密"

② 生效

💡
保存后新开一个终端再运行 codex。不要设置 OPENAI_BASE_URL,否则可能盖掉上面的 KiKi 网关。域名国内可直连。

6 OpenAI SDK

powershell
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-kiki-your-key-here", "User")
[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://kikiapi.dexuebao.com", "User")

或 Python 代码:

python
from openai import OpenAI

client = OpenAI(
    api_key="sk-kiki-your-key-here",
    base_url="https://kikiapi.dexuebao.com",
)

resp = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "用 Python 写个快速排序"}],
)
print(resp.choices[0].message.content)

7 KiKi IDE(Android 安卓手机版)

📱 下载 KiKi IDE APK · 安装后启动 App → 我的 → 激活码 → 输入 sk-kiki-your-key-here → 自动校验 → 激活成功即可在手机上写代码。

📱
KiKi IDE 是 HBuilderX 打包的 Android 原生 App(APK),跟桌面 Kiro IDE 完全是两个产品,Key 通用、API 兼容。手机端支持 AI 对话、代码生成、文件管理,移动办公场景。

1 提取 API Key

购买后到 会员中心 → 我的卡密 → 提取 Key。形如 sk-kiki-xxxx。

2 Claude Code(终端 CLI)

详细步骤见 本地 · 命令行安装教程 · 桌面版教程

方式 A — 环境变量

追加到 ~/.zshrc(bash 用户改 ~/.bash_profile):

bash
export ANTHROPIC_BASE_URL="https://kikiapi.dexuebao.com"
export ANTHROPIC_API_KEY="sk-kiki-your-key-here"

source ~/.zshrc 立即生效。

方式 B — settings.json(推荐,可指定默认模型)

编辑 ~/.claude/settings.json:

json
{
  "apiKeyHelper": "/Users/你的用户名/.claude/kiki-api-key.sh",
  "env": {
    "ANTHROPIC_BASE_URL": "https://kikiapi.dexuebao.com"
  },
  "model": "claude-opus-4-8",
  "theme": "dark",
  "hasCompletedOnboarding": true
}

同目录新建 kiki-api-key.sh 并赋予执行权限:

bash
#!/bin/bash
echo "AIDE-XXXX-XXXX-XXXX-XXXX"
bash
chmod +x ~/.claude/kiki-api-key.sh
💡
AIDE-XXXX... 写在 kiki-api-key.sh 里,勿与 env.ANTHROPIC_API_KEY 同时设置。卡密见会员中心;model 可按需改为 claude-opus-4-8 等。

3 Kiro CLI

🅰️
标准用户(独立装 kiro-cli)按下面 ① 改一个文件。已装 KiKi 桌面客户端的跳过本步,点下方折叠卡 [🅱️ KiKi 一键接入],不用手改任何文件。

Kiro CLI 的 Key 写在 auth.json 文件里,不靠环境变量,自成一派。

⚠️
KiKi 不是通用 OpenAI 中转站——别抄网上的"配 OPENAI_BASE_URL 环境变量 / auth.json 加 baseUrl 字段"那套。那套是给 api.openai.com 这类纯 OpenAI 兼容协议中转用的,KiKi 后端走 AWS Smithy SDK / EventStream 协议,Kiro CLI 这边的 auth.json 解析器根本不读 baseUrl / OPENAI_BASE_URL 这俩字段,写了也会被静默忽略,反而会让人误以为配好了。KiKi 的接入入口只能是 ① 改 auth.json 写 Key(标准用户)或 🅱️ 折叠卡的字节级 patch kiro-cli(KiKi 客户端用户),二选一。

① auth.json — 写入 Key(5 步)

  1. 备份(如有):cp ~/.kiro/auth.json ~/.kiro/auth.json.bak
  2. 新建 / 覆盖 ~/.kiro/auth.json,内容见下方代码块(把 sk-kiki-your-key-here 替换成你 KiKi 卡密对应的真实 Key,从 购买页 / 客户端 复制)
  3. 关掉所有正在跑的 kiro-cli 进程 + 所有终端窗口(auth.json 是 kiro-cli 启动时一次性读,热改不会生效,必须重启进程)
  4. 重开终端,跑 kiro-cli --version 验证客户端已装
  5. 跑 kiro-cli login——按提示走 Builder ID 浏览器授权(不是 OpenAI 那个 codex login,走的是 AWS IAM Identity Center 流程),授权码回贴到终端即登录成功

创建 ~/.kiro/auth.json:

json
{
  "OPENAI_API_KEY": "sk-kiki-your-key-here"
}
✅
验证是否生效:登录成功后终端跑 kiro-cli chat "你好",能看到流式回复 = 配置成功。如果报 Authentication failed → 99% 是 Key 复制错位(多了空格 / 少了前缀 / 大小写错),重新核对粘贴;如果报 ProtocolMismatch → 说明你走了别家 OpenAI 中转站的 baseUrl 思路,删 auth.json 里的 baseUrl 字段 + 删 OPENAI_BASE_URL 环境变量,KiKi 不需要这两项。
🅱️ 装了 KiKi 桌面客户端?点这里免改文件一键接入(推荐)▾

KiKi 客户端不写 ~/.kiro/ 下任何文件,而是对 kiro-cli 二进制做字节级 patch(同长度替换硬编码的 q.us-east-1.amazonaws.com → www.kiki-cli.dexuebao.com),原版自动备份为 kiro-cli.kiki-original,可一键还原。

  1. 下载并登录 KiKi 桌面客户端(macOS 走 app.dist/app.app 或 .dmg)
  2. 首次打开可能提示 [无法验证开发者] → 系统设置 → 隐私与安全性 → 仍要打开
  3. KiKi 主界面 → [🔧 Patch kiro-cli] → 等几秒提示 ✅ 已 patch 3 处 chat endpoint
  4. 终端 kiro-cli login(Builder ID)→ 回 KiKi 客户端点 [🔗 Builder ID 绑定] → 完事
  5. 终端 kiro-cli chat 验证;卸载 KiKi 时点 [🔙 还原原版] 即可
💡
为什么 KiKi 用 patch 二进制而不是改 config 文件?KiKi 后端走 AWS Smithy SDK / EventStream 协议,纯 OpenAI 兼容协议的 kiro-cli chat 走的是另一条接口,返回 ProtocolMismatch。唯一稳定通道是 patch kiro-cli 二进制的硬编码 endpoint(q.us-east-1.amazonaws.com → www.kiki-cli.dexuebao.com),这是 KiKi 后端专门为 AWS-EventStream 协议设计的入口。
🔒
macOS 上首次 patch 需要 KiKi 客户端拿到 kiro-cli 二进制的写权限(chmod u+w,KiKi 会自动处理),不会触发 Gatekeeper / 签名失效(kiro-cli 本身不验签)。
💡
Kiro CLI 与 Codex CLI 的区别:前者 Key 在 auth.json。Codex 新版只走 Responses API,卡密写在 ~/.codex/config.toml 的 X-Card-Key,base_url 要带 /v1,wire_api = "responses"。域名 kikiapi.dexuebao.com 国内直连,不需要代理。

4 Codex CLI

Codex 新版只走 Responses API。卡密写在 config.toml 的 X-Card-Key,不需要 OPENAI_API_KEY,也不需要代理。

① config.toml — 配置 baseURL 和模型

先安装:

bash
npm i -g @openai/codex

再创建 ~/.codex/config.toml(base_url 带 /v1,wire_api = "responses",卡密写在 X-Card-Key):

toml
model_provider = "kiki"
model = "claude-sonnet-5"

[model_providers.kiki]
name = "KiKi"
base_url = "https://kikiapi.dexuebao.com/v1"
wire_api = "responses"

[model_providers.kiki.http_headers]
X-Card-Key = "AIDE-你的卡密"

② 生效

💡
保存后新开一个终端再运行 codex。不要设置 OPENAI_BASE_URL。域名国内可直连。

5 OpenAI SDK

bash
export OPENAI_API_KEY="sk-kiki-your-key-here"
export OPENAI_BASE_URL="https://kikiapi.dexuebao.com"

6 KiKi IDE(Android 安卓手机版)

📱 下载 KiKi IDE APK · 安卓手机直接装 APK → 启动 → 我的 → 激活码 → 输入 sk-kiki-your-key-here → 激活成功。Key 跟 macOS 上的 Claude Code 通用。

📱
KiKi IDE 是 HBuilderX 打包的 Android 原生 App,跟桌面 IDE 完全是两个产品。桌面 macOS 用户继续用 Claude Code / Kiro CLI 就行,KiKi IDE 主要是给手机用户用。

1 提取 API Key

购买后到 会员中心 → 我的卡密 → 提取 Key。

2 Claude Code(终端 CLI)

详细步骤见 本地 · 命令行安装教程 · 桌面版教程

方式 A — 环境变量

追加到 ~/.bashrc 或 ~/.zshrc:

bash
export ANTHROPIC_BASE_URL="https://kikiapi.dexuebao.com"
export ANTHROPIC_API_KEY="sk-kiki-your-key-here"

source ~/.bashrc 立即生效。

方式 B — settings.json(推荐,可指定默认模型)

编辑 ~/.claude/settings.json:

json
{
  "apiKeyHelper": "/home/你的用户名/.claude/kiki-api-key.sh",
  "env": {
    "ANTHROPIC_BASE_URL": "https://kikiapi.dexuebao.com"
  },
  "model": "claude-opus-4-8",
  "theme": "dark",
  "hasCompletedOnboarding": true
}

同目录新建 kiki-api-key.sh 并赋予执行权限:

bash
#!/bin/bash
echo "AIDE-XXXX-XXXX-XXXX-XXXX"
bash
chmod +x ~/.claude/kiki-api-key.sh
💡
AIDE-XXXX... 写在 kiki-api-key.sh 里,勿与 env.ANTHROPIC_API_KEY 同时设置。卡密见会员中心;model 可按需改为 claude-opus-4-8 等。

3 Kiro CLI

🅰️
标准用户(独立装 kiro-cli)按下面 ① 改一个文件。已装 KiKi 桌面客户端的跳过本步,点下方折叠卡 [🅱️ KiKi 一键接入],不用手改任何文件。

Kiro CLI 的 Key 写在 auth.json 文件里,不靠环境变量,自成一派。

⚠️
KiKi 不是通用 OpenAI 中转站——别抄网上的"配 OPENAI_BASE_URL 环境变量 / auth.json 加 baseUrl 字段"那套。那套是给 api.openai.com 这类纯 OpenAI 兼容协议中转用的,KiKi 后端走 AWS Smithy SDK / EventStream 协议,Kiro CLI 这边的 auth.json 解析器根本不读 baseUrl / OPENAI_BASE_URL 这俩字段,写了也会被静默忽略,反而会让人误以为配好了。KiKi 的接入入口只能是 ① 改 auth.json 写 Key(标准用户)或 🅱️ 折叠卡的字节级 patch kiro-cli(KiKi 客户端用户),二选一。

① auth.json — 写入 Key(5 步)

  1. 备份(如有):cp ~/.kiro/auth.json ~/.kiro/auth.json.bak
  2. 新建 / 覆盖 ~/.kiro/auth.json,内容见下方代码块(把 sk-kiki-your-key-here 替换成你 KiKi 卡密对应的真实 Key,从 购买页 / 客户端 复制)
  3. 关掉所有正在跑的 kiro-cli 进程 + 所有终端窗口(auth.json 是 kiro-cli 启动时一次性读,热改不会生效,必须重启进程)
  4. 重开终端,跑 kiro-cli --version 验证客户端已装
  5. 跑 kiro-cli login——按提示走 Builder ID 浏览器授权(不是 OpenAI 那个 codex login,走的是 AWS IAM Identity Center 流程),授权码回贴到终端即登录成功

创建 ~/.kiro/auth.json(权限 600):

bash
mkdir -p ~/.kiro && cat > ~/.kiro/auth.json <<'EOF'
{
  "OPENAI_API_KEY": "sk-kiki-your-key-here"
}
EOF
chmod 600 ~/.kiro/auth.json
✅
验证是否生效:登录成功后终端跑 kiro-cli chat "你好",能看到流式回复 = 配置成功。如果报 Authentication failed → 99% 是 Key 复制错位(多了空格 / 少了前缀 / 大小写错),重新核对粘贴;如果报 ProtocolMismatch → 说明你走了别家 OpenAI 中转站的 baseUrl 思路,删 auth.json 里的 baseUrl 字段 + 删 OPENAI_BASE_URL 环境变量,KiKi 不需要这两项。
🅱️ 装了 KiKi 桌面客户端?点这里免改文件一键接入(推荐)▾

KiKi 客户端不写 ~/.kiro/ 下任何文件,而是对 kiro-cli 二进制做字节级 patch(同长度替换硬编码的 q.us-east-1.amazonaws.com → www.kiki-cli.dexuebao.com),原版自动备份为 kiro-cli.kiki-original,可一键还原。

  1. 下载并登录 KiKi 桌面客户端(Linux 走 AppImage 或 .deb)
  2. AppImage 首次运行需要 chmod +x KiKi-*.AppImage + FUSE
  3. KiKi 主界面 → [🔧 Patch kiro-cli] → 等几秒提示 ✅ 已 patch 3 处 chat endpoint
  4. 终端 kiro-cli login(Builder ID)→ 回 KiKi 客户端点 [🔗 Builder ID 绑定] → 完事
  5. 终端 kiro-cli chat 验证;卸载 KiKi 时点 [🔙 还原原版] 即可
💡
为什么 KiKi 用 patch 二进制而不是改 config 文件?KiKi 后端走 AWS Smithy SDK / EventStream 协议,纯 OpenAI 兼容协议的 kiro-cli chat 走的是另一条接口,返回 ProtocolMismatch。唯一稳定通道是 patch kiro-cli 二进制的硬编码 endpoint(q.us-east-1.amazonaws.com → www.kiki-cli.dexuebao.com),这是 KiKi 后端专门为 AWS-EventStream 协议设计的入口。
🔒
Linux 上 patch 需要 root(KiKi 客户端会调 pkexec 弹授权框),不会改 /usr/bin/ 之外的任何东西;卸载 KiKi 后点 [🔙 还原原版] 100% 还原。
💡
Kiro CLI 与 Codex CLI 的区别:前者 Key 在 auth.json。Codex 新版只走 Responses API,卡密写在 ~/.codex/config.toml 的 X-Card-Key,base_url 要带 /v1,wire_api = "responses"。域名 kikiapi.dexuebao.com 国内直连,不需要代理。

4 Codex CLI

Codex 新版只走 Responses API。卡密写在 config.toml 的 X-Card-Key,不需要 OPENAI_API_KEY,也不需要代理。

① config.toml — 配置 baseURL 和模型

先安装:

bash
npm i -g @openai/codex

再创建 ~/.codex/config.toml(base_url 带 /v1,wire_api = "responses",卡密写在 X-Card-Key):

toml
model_provider = "kiki"
model = "claude-sonnet-5"

[model_providers.kiki]
name = "KiKi"
base_url = "https://kikiapi.dexuebao.com/v1"
wire_api = "responses"

[model_providers.kiki.http_headers]
X-Card-Key = "AIDE-你的卡密"

② 生效

💡
保存后新开一个终端再运行 codex。不要设置 OPENAI_BASE_URL。域名国内可直连。

5 OpenAI SDK

bash
export OPENAI_API_KEY="sk-kiki-your-key-here"
export OPENAI_BASE_URL="https://kikiapi.dexuebao.com"
💡
systemd 服务用 Environment=;Docker 用 -e;K8s 用 Secret + envFrom。

6 KiKi IDE(Android 安卓手机版)

📱 下载 KiKi IDE APK · Linux 桌面用 Claude Code / Kiro CLI 即可。如果想在安卓手机/平板上写代码:

bash
# 手机端
# 1. 用电脑下载 APK 后通过 USB / 网盘传到手机
# 2. 或在手机浏览器直接打开 https://kiki.dexuebao.com/mobile 下载
# 3. 允许"未知来源安装" → 安装 APK
# 4. 启动 → 我的 → 激活码 → 粘贴 sk-kiki-your-key-here → 激活

Key 跟 Linux 上的 Claude Code / Kiro CLI 完全通用,同一个 Key 桌面和手机都能用。

📱
KiKi IDE 是 HBuilderX 打包的 Android 原生 App(APK 格式),跟桌面 Kiro IDE(VSCode Fork)完全是两个产品。Linux 桌面用户继续用 Claude Code 就行,KiKi IDE 是给手机/平板用户准备的。

常见问题

90% 的坑都在这。

Q1:API Key 提示 "Invalid" / "Unauthorized"?

① 复制时无多余空格;② BASE_URL 末尾没有 /v1 或 /messages;③ 会员中心看 Key 是否已激活(首次请求自动激活)。

Q2:Claude Code 报 "Connection refused" / "SSL: CERTIFICATE_VERIFY_FAILED"?

前者 ANTHROPIC_BASE_URL 没设对(应设为 https://kikiapi.dexuebao.com,不要带 /v1)。后者 Windows 下 pip install --upgrade certifi。

Q3:Kiro CLI 提示 "No api key found"?

检查 ~/.kiro/auth.json 路径(Linux/macOS)或 %USERPROFILE%\.kiro\auth.json(Windows),文件权限 chmod 600。

Q4:Codex CLI 报 "401" / 找不到 base_url?

新版 Codex 只认 Responses API。base_url 写成 https://kikiapi.dexuebao.com/v1,wire_api = "responses",卡密放在 [model_providers.kiki.http_headers] 的 X-Card-Key。不要再设 wire_api = "chat",也不需要 OPENAI_API_KEY。这个域名国内可直连。

Q5:KiKi IDE(Android)激活失败/网络超时?

国内访问 https://kikiapi.dexuebao.com 偶发卡顿,多半是 DNS 污染或移动网络问题。解决方案:①切到 Wi-Fi/4G/5G 不同网络;②到 /mobile 页面 重新下载最新 APK(已内置 DNS 优选);③实在不行用卡密登录桌面 Claude Code / Kiro CLI,Key 通用。

Q6:可以多台机器同 Key 吗?

可以。卡密按"同时在线设备数"计费(默认 3 台),会员中心"设备管理"可调整上限。

Q7:为什么 OpenAI 协议返回了 Claude 模型?

平台允许 OpenAI 兼容入口映射 claude-* 模型(OpenAI SDK 调 Claude)。不需要时请求 header 加 X-Skip-Cross-Mapping: 1。

Q8:终端 claude 能用,Cursor / 桌面版还要登录?

正常。终端 CLI、Cursor Claude Code 扩展侧栏、Anthropic 桌面 App 是三个产品,配置通道不同。 CLI 读 ~/.claude/settings.json(见本页 CLI 本地教程); 桌面版需开发者模式 + CC Switch Gateway(见 桌面版本地教程); Cursor 侧栏推荐在内置终端运行 claude,或用 KiKi 客户端「启动 Cursor」脚本。

Q9:CC Switch 供应商卡片显示「查询失败」?

多数是供应商里 API Key 被清空(CC Switch 保存时可能抹掉 env 里的卡密),或网关尚未部署 /user/balance。 解决:① KiKi 客户端点「⚙ CC Switch」重新写入;② 或在 CC Switch 手动把 API Key 填回 AIDE-... 卡密; ③ 确认余额接口可用:curl -H "Authorization: Bearer 卡密" https://kikiapi.dexuebao.com/user/balance 返回 200。

Q10:卡密能调哪些模型?列表会不会过期?

本页 卡密通用模型 与网关 GET /v1/models 对齐,任意有效卡密都可调用这些 id。 专属模型(如 dexuebao-fable-5 / 1M 窗口)需单独开通,不会出现在默认列表。 上新或下架后此页约 5 分钟内同步。

Q11:怎么联系客服?

客服微信 kikiaide,官网页脚有二维码,用微信扫一扫添加即可。