返回文档首页 快速开始 桌面版教程

macOS / Linux CLI 教程

适合 macOS 和 Linux 用户,推荐直接用终端方式接入。

1. 安装 Codex CLI

npm install -g @openai/codex

macOS 也可以用:

brew install codex

安装完成后执行:

codex --help

2. 设置 Token

export YUNCE_API_KEY="sk-在这里填你的完整Token"
以你后台实际复制出来的完整令牌为准。
不要自己手动加删 sk-
echo 'export YUNCE_API_KEY="sk-在这里填你的完整Token"' >> ~/.bashrc
source ~/.bashrc

如果你用的是 zsh:

echo 'export YUNCE_API_KEY="sk-在这里填你的完整Token"' >> ~/.zshrc
source ~/.zshrc

3. 保存配置文件

路径是:

~/.codex/config.toml

把这个示例配置保存进去:

https://yunce.cloud/docs/codex/yunce-codex-config.example.toml

4. 第一次运行

官方 CLI 首次进入产品时,通常仍会要求你用 ChatGPT 账号或 OpenAI API key 先完成登录。
真正模型请求仍然按你本机 yunce provider 配置走中转站。
codex -p yunce_gpt54

第一次输入:

reply exactly ok

5. 推荐模型

默认主模型: gpt-5.4
快速/省一点: gpt-5.4-mini
代码能力优先备选: gpt-5.3-codex
旧兼容轻量档: gpt-5-codex-mini