快速开始 · Codex CLI
Codex CLI 接入指南
把 Codex CLI 接到 wyapi,并完成可用性验证。
📌 准备工作
开始前请确认这几项:
- 你已经在 wyapi 控制台 创建了一枚 API Key
- 你的机器已安装较新的 Node.js(≥18)
- 知道当前分组可用的模型名,如
gpt-5.4
1️⃣ 安装 Codex CLI
全局安装:
# Windows
npm install -g @openai/codex@latest
# macOS / Linux
sudo npm install -g @openai/codex@latest
验证安装:
codex --version
💡 提示权限不足? 说明 npm 全局安装目录没有加入 PATH。先运行
npm root -g 查看路径,再补到系统环境变量里。2️⃣ 创建 API Key 并确认接入地址
登录 wyapi 控制台后,进入 API Keys 页面。你需要:
- 在控制台创建一枚新的 API Key
- 确认接入地址 — wyapi 的 API 地址为:
https://www.wwyai.cc/v1
⚠️ API Key 等同于你的调用凭证,请不要提交到代码仓库、公开群聊或截图里。
3️⃣ 推荐方式:站内生成的配置
wyapi 的 API Keys 页面已经内置了 Codex 配置生成功能。
4️⃣ 手动配置方式
如果你不想通过站内弹窗复制,也可以手动创建配置文件。
a) 创建配置目录
rm -rf ~/.codex && mkdir -p ~/.codex
b) 创建 config.toml
model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://www.wwyai.cc/v1"
wire_api = "responses"
requires_openai_auth = true
c) 配置环境变量
export OPENAI_API_KEY="***"
5️⃣ 启动使用
进入任意项目目录,运行:
codex
6️⃣ 验证是否接入成功
- ✅ Codex CLI 能正常启动
- ✅ 确认
base_url是https://www.wwyai.cc/v1 - ✅ API Key 仍然有效
- ✅ 能正常发消息并收到回复
❓ 常见问题
明明填了地址,还是连不上
优先检查你填的基础地址是不是 https://www.wwyai.cc/v1。
Codex 能启动,但发消息时报模型不存在
检查模型名是否与分组一致。