Skip to main content

​
安装与更新

安装完成后需要打开一个新的终端窗口再运行 codex。使用官方安装脚本或 Homebrew 安装的，重新运行一次安装命令即可。使用 npm 安装的，确认 npm 全局目录已加入 PATH：
  • 官方安装脚本：重新运行安装命令即可更新到最新版
  • Homebrew：brew upgrade --cask codex
  • npm：npm i -g @openai/codex@latest --registry=https://registry.npmmirror.com
  1. 官方安装脚本需要访问 chatgpt.com，无法访问时改用 npm 国内镜像
  2. npm 方式需要 Node.js 18 或更高版本，参考 Node.js 环境配置

​
配置问题

  • macOS/Linux：~/.codex/
  • Windows：C:\Users\你的用户名\.codex\（在 WSL 中使用时为 WSL 内的 ~/.codex/）
需要 config.toml 和 auth.json 两个文件。
Windows 下用记事本新建文件时，注意文件名不要变成 config.toml.txt。
要。Codex 使用 OpenAI 格式，请求地址必须以 /v1 结尾，且只写一次：
报错中出现 /v1/v1/responses，说明 /v1 写了两次。
auth.json 中填写完整的 API Key，不是环境变量名：
  • model_provider、model 等顶层配置必须写在 [model_providers.jiji] 这一行之前，写在后面会被当作 jiji 的子配置
  • model_provider 的值必须和 [model_providers.xxx] 中的名称完全一致
  • 服务商配置只在用户目录的 ~/.codex/config.toml 中生效，写在项目目录 .codex/config.toml 中会被忽略
  • 修改后需要退出并重新启动 Codex
在 config.toml 开头加入：
可选值："live"（实时联网搜索）、"cached"（默认，使用缓存索引）、"disabled"（关闭搜索）。
在 ~/.codex/ 目录下新建 AGENTS.md，写入你的提示词，重启 Codex 后生效。

​
模型使用

  • 修改配置文件：修改 config.toml 中 model 的值，保存后重启 Codex
  • 启动时指定：codex -m gpt-6.1-sol -c model_reasoning_effort="high"
  • 会话中切换：在对话界面输入 /model
可用的模型 ID 以 模型广场 为准。

​
错误排查

检查环境变量冲突系统中已有的 OPENAI_API_KEY、OPENAI_BASE_URL 环境变量可能覆盖配置文件。
如有输出，macOS/Linux 从 ~/.zshrc 或 ~/.bashrc 中删除对应的 export 行；Windows 运行 setx OPENAI_API_KEY "" 和 setx OPENAI_BASE_URL "" 清除。然后重新打开终端。检查配置文件
  • auth.json 中的 API Key 是否完整、没有多余空格
  • Key 所在分组是否包含当前使用的模型
model 填写的模型 ID 不在 Key 所在分组中。到 模型广场 核对准确的模型 ID 和可用分组。
  1. 检查本机网络是否通畅
  2. 关闭代理工具后重试
  3. 只在 VS Code 扩展中出错时，先在命令行中测试，再重启 VS Code
  1. 按 Win + R，输入 intl.cpl 回车
  2. 切换到「管理」选项卡，点击「更改系统区域设置」
  3. 勾选「Beta 版: 使用 Unicode UTF-8 提供全球语言支持」
  4. 确定后重启电脑

​
仍未解决？

提交工单

以上方法都无法解决时，请提交工单联系我们