Skip to Content
常见问题Codex 相关

Codex 相关

下面整理了通过 AI66 使用 Codex 时的常见问题。还没完成安装与配置，请先看环境检查和 Codex 配置教程。

1. Codex 有哪些常用斜杠命令？

在 Codex 对话输入框中输入 / 可以查看命令。下表按 Codex CLI 0.162.1 核对；直接输入对应命令即可使用。

命令用途
/model选择模型，调整推理强度。
/permissions设置允许 Codex 执行哪些操作。
/review审查当前改动，帮助发现问题。
/new开启一段新对话。
/resume继续之前保存的会话。
/init在当前目录生成项目说明文件 AGENTS.md。
/compact压缩当前对话，释放上下文空间。
/diff查看 Git 改动差异，包括未跟踪文件。
/mention把需要参考的文件加入上下文。
/status查看当前会话的配置与用量。
/mcp列出可用的 MCP 工具。
/quit退出 Codex。

2. 怎样更高效地使用 Codex？

  • 说清目标和完成标准。 例如：「修复登录按钮点击后无反应的问题，只修改登录页，完成后说明原因并验证按钮能正常跳转。」比「修一下」更容易得到符合预期的结果。
  • 提供相关材料。 用 /mention 加入涉及的文件，贴出完整报错和复现步骤，避免一次塞入大量无关内容。
  • 按任务管理对话。 同一任务尽量在原对话中继续；对话太长时用 /compact；切换到无关任务时用 /new，需要接着旧任务做时用 /resume。
  • 把长期规则写进 AGENTS.md。 在项目目录运行 /init 后，检查并补充项目的运行方式、修改范围和验证要求。所有项目通用的偏好可以放在下文的全局提示词文件中。

3. Windows 终端中文乱码怎么办？

可以按以下步骤启用系统 UTF-8 支持：

  1. 按 Win + R 打开「运行」，输入 intl.cpl，按回车。
  2. 在打开的窗口中切换到「管理」。
  3. 点击「更改系统区域设置」。
  4. 勾选「Beta 版：使用 Unicode UTF-8 提供全球语言支持」，点击「确定」。
  5. 保存正在处理的文件，重启电脑，再打开终端和 Codex 检查中文显示。

4. 如何配置全局提示词？

把希望 Codex 在各个项目中遵守的通用要求写入全局 AGENTS.md 文件：

系统文件位置打开方式
Windows%userprofile%\.codex\AGENTS.md在文件资源管理器地址栏输入 %userprofile%\.codex，用记事本打开或新建 AGENTS.md。
macOS~/.codex/AGENTS.md在访达中按 Command + Shift + G，输入 ~/.codex，使用「文本编辑」打开或新建 AGENTS.md，先选择「格式 → 制作纯文本」，再编辑并保存。

如果 .codex 目录不存在，先按环境检查安装并运行一次 Codex。新建文件时确保名称是 AGENTS.md，没有额外的 .txt 后缀；已有内容时，在原文基础上补充即可。

例如可以写入：

默认使用简体中文回复。
修改前先阅读相关文件，保持改动范围最小。
完成后说明修改内容和验证结果。

保存后退出并重新启动 Codex，让修改生效。

5. 通过 AI66 能使用 Codex 内置联网搜索吗？

通过 AI66 使用时，Codex 内置联网搜索目前不可用。 即使在 config.toml 中设置 web_search = "live"，通过 AI66 使用时也不会获得联网搜索工具。

需要网页信息时，请先在浏览器中打开网页，再把所需正文复制到对话里，并说明希望 Codex 根据哪些内容完成什么任务。

6. 容器或代理 TUN 模式下遇到网络问题怎么办？

如果使用了代理或 TUN 模式，请在代理客户端的网络或 TUN 设置中找到 MTU，将其设为 1500，保存并应用设置后重新连接，再回到 Codex 重试。不同客户端的设置入口可能不同。

如果 Codex 运行在容器中，也要检查容器是否能使用配置的网络或代理；主机浏览器能联网，并不代表容器内的连接正常。仍然失败时，继续按下一题检查连接地址。

7. 出现 Connection failed 怎么办？

报错示例：

Connection failed: error sending request for url (https://api.ai66.app/v1/responses)

这类报错表示请求未能正常发送，按以下顺序检查：

  1. 检查电脑是否能正常联网；使用代理或 TUN 模式时，先检查上一题的设置。
  2. 打开 ~/.codex/config.toml（Windows 对应 %userprofile%\.codex\config.toml），对照配置教程检查 AI66 供应商的 base_url，应为 https://api.ai66.app/v1。
  3. 不要把报错中的完整请求地址填成 base_url；配置值末尾不需要添加 /responses，Codex 会在请求时补上。
  4. 保存配置后重启 Codex，再发送一句「请只回复 OK」测试。仍然失败时，记录报错和发生时间，联系客服。

8. 出现 401 Unauthorized 怎么办？

报错示例：

exceeded retry limit, last status: 401 Unauthorized

这表示身份验证未通过，优先核对 API Key 和请求地址：

  1. 打开 ~/.codex/auth.json（Windows 对应 %userprofile%\.codex\auth.json），确认 OPENAI_API_KEY 的值是从 AI66「API 密钥」页面复制的完整 Key，没有保留示例占位文字或多余空格。
  2. 打开同一目录中的 config.toml，确认使用的是 AI66 供应商，其 base_url 为 https://api.ai66.app/v1。
  3. 登录 AI66 ，确认对应 API 密钥仍然有效；如果已删除或停用，使用有效的 API 密钥更新配置。创建与复制密钥的步骤见快速开始。
  4. 保存后退出并重新启动 Codex，再试一次。如果仍然报错，对照配置教程逐项核对两个文件。

排查时不要把完整 API Key 发到公开对话或截图中。

9. Windows 提示「在此系统上禁止运行脚本」怎么办？

安装 Node.js 后，npm 和 codex 在 Windows 上会生成 .ps1 脚本；PowerShell 默认的执行策略是 Restricted，会拒绝运行这些脚本，报错类似：

无法加载文件 …\npm.ps1，因为在此系统上禁止运行脚本。

解决方法：在 PowerShell 中运行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned，询问是否更改时输入 Y 并按回车，再重新执行刚才的命令；或者改用「命令提示符」(cmd) 执行相同命令。

10. 提示余额不足或额度用完怎么办？

请在 https://ai66.app  在线充值。登录后进入控制台左侧「钱包」页面，检查账户余额并按页面提示完成充值；确认余额到账后，再回到 Codex 重试。具体操作可查看快速开始。

最后更新于
FAQ 总览