快速开始（一键脚本）
通过一键脚本，自动检测 Node.js 与 Codex CLI 环境，并引导你完成 API Key 配置。脚本会写入 ~/.codex 配置文件，复制命令中不包含你的密钥，密钥会在运行后交互式输入。
适用范围
一键脚本支持 macOS、Windows（PowerShell）与 Linux 系统。如果你的系统未安装 Node.js，脚本会引导你先完成安装。
macOS / Linux
在终端中执行以下命令，按提示输入你的 API Key：
bash
bash <(curl -fsSL https://yuncezn.com/install/codex.sh)脚本执行流程：
- 检测系统是否已安装 Node.js（≥ 18），未安装时引导安装
- 检测是否已安装 Codex CLI，未安装时自动通过 npm 全局安装
- 提示输入你的 云策 API Key
- 将配置写入
~/.codex/config.toml与~/.codex/auth.json - 提示重启已打开的 Codex CLI 以使配置生效
Windows (PowerShell)
在 PowerShell（推荐 PowerShell 7+）中执行以下命令：
powershell
irm https://yuncezn.com/install/codex.ps1 | iex脚本执行流程与 macOS / Linux 版本一致：检测环境 → 引导安装 → 输入 API Key → 写入 ~/.codex → 提示重启。
PowerShell 执行策略
若提示无法加载脚本，请先以管理员身份执行：
powershell
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned然后重新运行安装命令。
验证配置
配置完成后，可通过以下命令验证连通性：
bash
# 查看 Codex CLI 版本
codex --version
# 启动 Codex 并执行只读任务测试
cd your-project-folder
codex建议第一次使用时，先跑一个只读任务验证接入是否正常：
请只读分析当前项目结构，列出主要目录和入口文件，不要修改任何文件。配置文件位置
一键脚本写入的配置文件位于：
| 文件 | 路径 | 用途 |
|---|---|---|
| 配置文件 | ~/.codex/config.toml | 模型提供商、API 端点配置 |
| 认证文件 | ~/.codex/auth.json | API Key 凭证存储 |
跨平台路径
- macOS / Linux：
~即用户主目录，如/Users/yourname - Windows：
~对应C:\Users\你的用户名\.codex
配置示例
写入 ~/.codex/config.toml 的内容形如：
toml
model_provider = "apikeyfun"
[model_providers.apikeyfun]
name = "apikeyfun"
base_url = "https://yuncezn.com/v1"
wire_api = "responses"
requires_openai_auth = true写入 ~/.codex/auth.json 的内容形如：
json
{
"OPENAI_API_KEY": "sk-替换成你的云策密钥"
}