AI精品店

Appearance

快速开始 ​

本页给你一条最短路径：只要配置成功能正常进入 codex 对话界面，就算接入完成。更细的解释与进阶玩法在后续页面展开。

【推荐配置方式】

如果你想用 CC-Switch 一键完成本页的“写入配置文件”等步骤，直接看：CC-Switch 一键配置。

0. 先拿到 API Key ​

  1. 打开 https://codexzh.com 注册并登录。
  2. 在控制台完成激活（激活码兑换或直接订阅）。
  3. 激活成功后，控制台会分配一串以 sk- 开头的专属密钥（API Key）。

不会激活？看：激活服务

1. 安装 Codex CLI ​

CodexZH 的教程要求：

  • Windows 10+ / macOS 10.15+ / Linux（如 Ubuntu 20.04+）
  • Node.js 22+，npm 10+

安装 Codex CLI：

bash
npm install -g @openai/codex
codex --version

2. 创建配置目录 ​

  • Windows：%USERPROFILE%\.codex
  • macOS / Linux：~/.codex

3. 写入配置文件 ​

在 .codex 目录中创建两个文件：

  • config.toml
  • auth.json

3.1 config.toml（最小可用） ​

将以下内容保存到 ~/.codex/config.toml（Windows 对应目录同名文件）：

toml
model_provider = "codexzh"
model = "gpt-5.2"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.codexzh]
name = "codexzh"
base_url = "https://api.codexzh.com/v1"
wire_api = "responses"
requires_openai_auth = true
web_search = "live"

3.2 auth.json（填入你的 sk- 密钥） ​

在同目录创建 auth.json：

json
{
  "OPENAI_API_KEY": "sk-替换成你控制台里的真实密钥"
}

4. 启动测试 ​

进入任意项目目录，运行：

bash
codex

如果能进入对话界面并正常回复，就说明接入成功。

遇到 401、路径找不到、流式中断等问题，直接看：问题解决