📖 5 分钟接入 · 2026

KiKi AI 使用教程

选操作系统 → 配 baseURL + Key → 开聊。
覆盖 Claude Code / Kiro CLI / Codex CLI / KiKi IDE（Android），国内直连，按量计费。

API 域名 · 实时连通性

探活端点 /v1/models（200 + 1659B 模型列表），每 5 秒自动重测。

🌐 域名健康检测
—
kikiapi.dexuebao.com 主域名 · 推荐
检测中…
—
🤖 Claude Code · https://kikiapi.dexuebao.com
⚙️ Kiro CLI · https://kikiapi.dexuebao.com
🆕 Codex CLI · https://kikiapi.dexuebao.com
📱 KiKi IDE（Android） · https://kikiapi.dexuebao.com

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

🤖 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 扩展环境变量与启动脚本，免手改文件。

⬇ 下载 KiKi 客户端
💡
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。

支持的客户端

任何兼容 OpenAI / Anthropic / AWS EventStream 协议的客户端都能接入。

🤖

Claude Code CLI

终端 claude 命令，读 ~/.claude/settings.json，Agent + MCP，国内直连。

Anthropic CLI
🖥️

Claude Code 桌面版

Anthropic 独立 App + CC Switch Gateway，开发者模式免 OAuth，与 CLI 配置不同。

Desktop App
⚙️

Kiro CLI

KiKi 官方 CLI，OpenAI 兼容，支持 GPT/Claude/DeepSeek 多模型。

OpenAI 兼容
🆕

Codex CLI

OpenAI 官方 CLI，@openai/codex，Chat 协议接入。

OpenAI 兼容
🚀

KiKi IDE（Android）

HBuilderX 打包的安卓端 AI IDE，sk-kiki- Key 直连，国内直连 + 移动端编码。

AWS EventStream
🎯

Cursor / Windsurf

GUI 替代品，OpenAI 兼容模式，更适合非命令行用户。

OpenAI 兼容
🔌

Cline / Roo Code

VSCode 插件形式 AI Agent，自带文件读写、终端、浏览器自动化。

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 文件里，后者 Key 在 OPENAI_API_KEY 环境变量里。两者 base_url 都不带 /v1，但 wire_api 不同（Kiro=responses，Codex=chat）。

5 Codex CLI（OpenAI 官方）

Codex CLI 的 Key 写在 OPENAI_API_KEY 环境变量里，不靠单独文件，跟 Kiro CLI 的文件方式不同。共一个配置文件 + 环境变量：

① config.toml — 配置 baseURL 和模型

先安装：

powershell 
npm i -g @openai/codex

再编辑 %USERPROFILE%\.codex\config.toml（base_url 不带 /v1，wire_api = "chat"）：

toml 
model_provider = "kiki"
model = "gpt-5.4"

[model_providers.kiki]
name = "kiki"
base_url = "https://kikiapi.dexuebao.com"
wire_api = "chat"
requires_openai_auth = true
env_key = "OPENAI_API_KEY"

② 环境变量 — 写入 Key

🔑
Codex CLI 的 Key 来自环境变量，不是单独文件。跟 Kiro CLI 的 auth.json 文件方式完全不同。

PowerShell 中执行：

powershell 
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-kiki-your-key-here", "User")
[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://kikiapi.dexuebao.com", "User")
💡
设完重启终端 / VSCode生效。客户端会自己拼 /v1/chat/completions。

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 文件里，后者 Key 在 OPENAI_API_KEY 环境变量里。两者 base_url 都不带 /v1，但 wire_api 不同（Kiro=responses，Codex=chat）。

4 Codex CLI

Codex CLI 的 Key 写在 OPENAI_API_KEY 环境变量里，不靠单独文件，跟 Kiro CLI 的文件方式不同。共一个配置文件 + 环境变量：

① config.toml — 配置 baseURL 和模型

先安装：

bash 
npm i -g @openai/codex

再创建 ~/.codex/config.toml（base_url 不带 /v1，wire_api = "chat"）：

toml 
model_provider = "kiki"
model = "gpt-5.4"

[model_providers.kiki]
name = "kiki"
base_url = "https://kikiapi.dexuebao.com"
wire_api = "chat"
requires_openai_auth = true
env_key = "OPENAI_API_KEY"

② 环境变量 — 写入 Key

🔑
Codex CLI 的 Key 来自环境变量，不是单独文件。跟 Kiro CLI 的 auth.json 文件方式完全不同。

追加到 ~/.zshrc（或 ~/.bash_profile）：

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

source ~/.zshrc 立即生效。

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 文件里，后者 Key 在 OPENAI_API_KEY 环境变量里。两者 base_url 都不带 /v1，但 wire_api 不同（Kiro=responses，Codex=chat）。

4 Codex CLI

Codex CLI 的 Key 写在 OPENAI_API_KEY 环境变量里，不靠单独文件，跟 Kiro CLI 的文件方式不同。共一个配置文件 + 环境变量：

① config.toml — 配置 baseURL 和模型

先安装：

bash 
npm i -g @openai/codex

再创建 ~/.codex/config.toml（base_url 不带 /v1，wire_api = "chat"）：

toml 
model_provider = "kiki"
model = "gpt-5.4"

[model_providers.kiki]
name = "kiki"
base_url = "https://kikiapi.dexuebao.com"
wire_api = "chat"
requires_openai_auth = true
env_key = "OPENAI_API_KEY"

② 环境变量 — 写入 Key

🔑
Codex CLI 的 Key 来自环境变量，不是单独文件。跟 Kiro CLI 的 auth.json 文件方式完全不同。

追加到 ~/.bashrc 或 ~/.zshrc（推荐 /etc/environment 或 systemd Environment= 用于服务进程）：

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

source ~/.bashrc 立即生效。

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/config.toml 里 base_url 不要带 /v1，客户端会自动拼 /v1/chat/completions。环境变量 OPENAI_API_KEY + OPENAI_BASE_URL 二者缺一不可。

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。