TEHUI API / QUICK START
从安装到可用，一次走完
这是一份首次使用指南。按顺序完成环境安装、购买卡密、创建 Key 并一键导入 CC Switch，即可在 Claude Code 或 Codex 中开始使用。
只选择一个客户端配置，不需要同时安装 Claude Code 和 Codex。
0
前置环境检测
先安装 Node.js
Node.js 是 Claude Code 和 Codex 的运行环境。进入 Node.js 下载页，让网站自动识别系统后直接下载即可。
- Windows 下载
.msi安装包。 - macOS 下载
.pkg安装包。 - 安装过程保持默认选项，一直点击下一步即可。
只安装你要使用的 CLI。 Claude Code 与 Codex 的安装命令会在第 5 步根据你的选择显示。
1
2
购买额度
购买卡密
- 在控制台左侧进入 兑换码购买。
- 根据需要选择对应额度的商品（1 / 10 / 50 / 100 元）。
- 完成支付后保存好收到的卡密（兑换码），下一步会用它兑换额度。
3
兑换额度
使用卡密
- 在控制台左侧进入 钱包。
- 在“有兑换码吗？”输入框粘贴上一步购买的卡密。
- 点击 兑换额度，余额到账后即可开始使用。
4
访问凭证
创建 API Key
- 在控制台左侧进入 API 密钥。
- 点击右上角 创建 API 密钥。
- 填写一个容易识别的名称，并选择分组：配置 Codex 选 GPT 分组，配置 Claude Code 选 ccmax 分组，kiro 为逆向渠道按需选择。
- 点击 保存更改，列表中出现新密钥即创建成功。
保护你的 API Key。 不要把 Key 发到群聊、截图或公开仓库。
5
客户端配置
配置 API Key：一键导入 CC Switch
选择一个客户端，在当前页面完成配置。切换选项不会离开当前页面。
安装 Codex
打开终端，运行以下命令安装。安装完成后先启动一次 CLI，让本机生成所需配置目录。
npm install -g @openai/codex@latest
codex看到版本更新提示时： 保持选择
1. Update now，直接按 Enter，让当前安装更新到最新版本。 codex。下载安装 CC Switch
根据你的操作系统，下载对应的 CC Switch 安装包并完成安装。
前往 CC Switch 官网获取最新版本 ↗macOS 提示“安装包已损坏”时： 进入“系统设置 → 隐私与安全性”，在底部选择“仍然允许打开”。
从密钥页一键导入
- 回到控制台的 API 密钥 页面。
- 点击密钥行末尾的 ···，选择 CC Switch。
- 弹窗中应用选择 Codex，确认名称。主模型保持默认（如 gpt-6-astra）即可。
- 点击 打开 CC Switch，在唤起的确认弹窗里核对信息后点击 导入。
点击后没有反应？ 请确认已安装 CC Switch 3.19.0 及以上版本。
启用配置
在 CC Switch 供应商列表中确认刚导入的配置处于「使用中」，然后完全退出并重新打开 codex。
6
完成验证
发起第一条请求
完全退出当前 CLI 后，重新打开终端并运行：
codex- 等待 CLI 进入交互界面。
- 在底部的
>后输入hi，或输入“只回复：连接成功”。 - 按
Enter发送，看到模型回复就代表配置成功。
配置完成。 后续只需要在 CC Switch 中切换已启用的配置，不要手动混用多个本地配置文件。
连接失败、Key 无效、额度不足或模型不可用时，查看 常见问题。