玄德
返回首页登录控制台
玄德 API 快速接入

3 分钟完成
Codex 接入

安装 Codex 与 CC Switch，创建玄德 API 密钥后一键导入。无需手动填写接口地址，也无需修改配置文件。

开始配置 →下载 Codex下载 CC Switch夸克网盘

本教程以 Windows 为例 · 已安装工具的用户可直接从第 2 步开始

01安装工具02创建密钥03选择分组04一键导入05启动测试
01

安装两个工具

Codex 负责实际的 AI 编程工作，CC Switch 负责保存并切换玄德 API 配置。

  • 安装 Codex 官方版本
  • 安装 CC Switch 最新版本
  • 安装完成后启动一次 CC Switch
如果电脑提示找不到 npm，请先安装 Node.js LTS，再执行安装命令。
准备工具
CCodexOpenAI 官方编码代理
↔CC Switch统一管理本地配置
npm install -g @openai/codex
codex --version
02

创建 API 密钥

登录玄德 API 后进入“API 密钥”，点击“创建密钥”。名称可填写当前电脑或用途，方便以后管理。

  • 密钥名称：例如“我的电脑”
  • 额度限制：没有特殊需要可保持默认
  • 密钥只用于自己设备，不要转发他人
前往 API 密钥 →
玄德 API 控制台 · API 密钥
创建密钥×
我的电脑
请选择分组 ⌄
不限制
03

选择使用分组

创建密钥时选择购买对应的服务分组。当前 Codex 接入选择 GPT-pro-0.22x。

  • 分组决定可用模型与计费倍率
  • 0.22x 表示按标准费用的 22% 扣费
  • 创建后仍可在密钥列表修改分组
选择分组
GPT-pro-0.22x ⌃
GPT-pro-0.22x0.22x 倍率稳定优先 · Codex 推荐
其他可用分组按页面显示根据实际需求选择
04

点击“一键导入”

在刚创建的密钥右侧点击“导入到 CCS”。浏览器询问是否打开 CC Switch 时，选择允许。

  • 接口地址自动写入
  • API 密钥自动写入
  • 无需复制或编辑配置文件
点击没有反应时，请确认 CC Switch 已安装并至少启动过一次。
API 密钥列表
名称API 密钥分组操作
我的电脑sk-••••••a2b0.22x⇧ 导入到 CCS➜
05

启用并开始使用

在 CC Switch 中确认玄德 API 配置已启用，然后重新打开终端并启动 Codex。

  • CC Switch 中选择玄德 API
  • 点击启用或应用配置
  • 重新打开终端运行 codex
能够收到正常回复，即表示域名、密钥和模型链路全部配置成功。
CC Switch · Codex
玄德 APIhttps://xuande.chat/v1
PS> codex
› 请回复“接入成功”
接入成功
✓ 现在可以开始使用
帮助

遇到问题？

先检查下面三项，通常一分钟内即可恢复。

点击“导入到 CCS”没有反应

请先启动一次 CC Switch，再回到浏览器重新点击。浏览器弹出“是否允许打开 CC Switch”时选择允许。

Codex 启动后仍然无法调用

确认 CC Switch 中玄德 API 已启用，然后完全关闭并重新打开终端。如果仍失败，请检查账户余额与密钥状态。

需要手动配置时填什么？

Base URL 使用 https://xuande.chat/v1，API Key 使用玄德 API 密钥页面创建的密钥。请勿把密钥发送给他人。