应用配置
Codex 配置
在 OpenAI Codex CLI 中使用 smai.ai
简介
Codex 是 OpenAI 推出的代码生成 CLI 工具，支持在终端中进行代码相关的 AI 辅助。
一键配置
推荐
登录 smai.ai，进入「平台接入」页面，点击 Codex CLI 卡片即可自动完成配置。
轻松一键配置
推荐使用开源工具 CC Switch 进行图形化配置管理。
CC Switch 是一个用于图形化管理 Claude Code、Codex、Gemini CLI 多配置文件的工具，可以帮助用户在不同的配置文件之间快速切换，无需手动编辑配置文件。
安装 CC Switch
打开 CC Switch 下载页面，滑到页面底部下载对应系统的安装包：
| 系统 | 下载文件 |
|---|---|
| Windows | CC-Switch-Setup.msi |
| macOS | CC-Switch-macOS.zip |
| Debian/Ubuntu | CC.Switch_x.x.x_amd64.deb |
| Arch Linux | 使用 yay cc-switch 命令安装 |
| 其他 Linux | CC.Switch_x.x.x_amd64.AppImage |
如果安装遇到问题，可以联系客服进行辅助安装。
打开 CC Switch
安装完成后打开 CC Switch 应用。
配置 Codex
点击「Codex」选项卡，依次配置以下内容：
auth.json：
{
"OPENAI_API_KEY": "sk-xxxxxxxx"
}config.toml：
model_provider = "smai"
model = "gpt-5.2-codex"
model_reasoning_effort = "xhigh"
disable_response_storage = true
sandbox_mode = "workspace-write"
windows_wsl_setup_acknowledged = true
[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
web_search_request = true
unified_exec = false # 会造成 Windows 不停弹窗，不要开
streamable_shell = false
rmcp_client = true
# approve_all = true # 谨慎开，但想偷懒的开，但也要承担被删库的风险
[tools]
web_search = true
view_image = true
[model_providers.smai]
name = "smai"
base_url = "https://api.smai.ai/v1"
wire_api = "responses"
env_key = "keysmai"
requires_openai_auth = true重要
务必将 sk-xxxxxxxx 替换为您自己的 smai.ai 密钥。
点击保存即可完成配置。
多 Key 管理
如果您有多个 API Key：
- 点击右上角的「添加服务商」
- 参考以上方式输入您的 Key，点击保存
- 点击「切换此 Key」后重启终端即可使用
手动配置步骤
安装 Codex CLI
npm install -g @openai/codex配置环境变量
设置 API 端点和密钥：
export OPENAI_API_KEY="sk-your-api-key"
export OPENAI_BASE_URL="https://api.smai.ai/v1"端点格式
Codex 使用 OpenAI API 格式，需要包含 /v1 后缀。
推荐模型
| 用途 | 推荐模型 |
|---|---|
| 代码生成 | gpt-4.1 |
| 代码补全 | gpt-4o |
| 快速任务 | gpt-4o-mini |