ZeoAPIZeoAPI API 文档与接入指南
faq

Codex 常见问题

常用命令

命令说明
/model选择当前使用的模型
/review让 Codex 审查当前工作区变更
/resume从历史会话列表中选择并继续一个之前的交互会话
/new在当前 CLI 会话中开启新对话
/compact总结对话内容以释放上下文
/undo撤销 Codex 的上一次操作
/status查看会话配置和 token 使用情况
/exit退出 Codex CLI

高效使用技巧

  1. 任务划分:不要提交过于笼统的任务,对任务进行拆分,Codex 的特点是「严谨有序,指哪打哪」
  2. 掌控之内:在开始任务前进行评估,确保任务拆分足够细致,不要让 AI 脱离掌控
  3. 避免压缩:多数场景下任务只需要 60% 上下文即可解决,超过则需要重新拆分任务

Connection failed 问题

如果遇到连接失败错误:

  1. 检查本机网络是否通畅
  2. 检查是否使用了网络代理工具,如有问题请关闭
  3. 在终端运行 codex 命令尝试判断是否是 VSCode Codex 插件问题
  4. 如仍有问题,带上报错截图咨询客服

401 报错问题

如果遇到 401 Unauthorized 错误:

  1. 检查 auth.json 中的 API Key 配置是否正确
  2. 检查 config.toml 中的请求地址是否正确
  3. 确保没有设置 OPENAI_API_KEY 环境变量

403 报错问题

如果遇到 403 Forbidden 错误:

  1. 使用 Ctrl+C 打断对话
  2. 重新发起对话进行尝试
  3. 如果重试 3 次以上无效,带上报错截图咨询客服

Windows 乱码问题

  1. 按下 Win + R,输入 intl.cpl 后回车
  2. 点击「管理」→「更改系统区域设置」
  3. 勾选「使用 Unicode UTF-8 提供全球语言支持」
  4. 重启电脑后使用 Codex

配置全局提示词

  1. 创建或编辑 AGENTS.md 文件
  2. 写入提示词内容并保存
  3. 重启 Codex 或 VSCode,提示词即生效