Codex 相关问题

1. 使用技巧与高效建议

1. 把需求拆成可验证的小任务。
2. 明确文件路径和不允许修改的范围。
3. 长任务先让 Codex 读取项目说明和关键源码。
4. 避免在一次对话里混合无关目标。
5. 构建失败时贴完整错误，不要只贴最后一行。

2. Windows 下使用 Codex

推荐使用 PowerShell，并确保配置文件保存在：

$env:USERPROFILE\.codex

若终端乱码，先检查编码：

[Console]::OutputEncoding.WebName
chcp

如果输出不是 UTF-8，可先在当前终端执行：

chcp 65001
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

3. 常用命令

命令	用途
codex --version	查看版本。
codex	进入交互模式。
codex exec "..."	非交互执行任务。
codex --help	查看帮助。
codex login	登录或配置认证。
codex logout	清理认证。
codex mcp list	查看 MCP。
codex mcp add	添加 MCP。
codex mcp remove	移除 MCP。
codex config	查看配置帮助。
codex exec --help	查看 exec 参数。
codex debug	调试信息。

建议先用 codex --version 确认安装成功，再打开 codex 进入交互模式测试短消息。

4. Windows 乱码修复

chcp 65001
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

如果系统区域设置仍导致乱码，可在 Windows「区域」设置中启用 UTF-8 Beta 选项。修改系统区域设置后需要重新打开终端或重启系统。

5. VSCode Codex 插件设置最新模型

{
  "codex.model": "gpt-5.5",
  "codex.provider": "aivoyz",
  "codex.baseUrl": "https://api.52hertz-palpitate.cn/v1"
}

设置后检查三项：

1. 模型名与 aivoyz 模型广场一致。
2. Base URL 使用 https://api.52hertz-palpitate.cn/v1。
3. 插件使用的 API Key 是当前令牌分组可用的 Key。

6. 全局提示词配置

# Global Instructions

- 回答使用中文。
- 修改前先说明目标文件。
- 不要改动未授权目录。

全局提示词适合放长期规则，不建议放一次性任务需求。一次性需求直接写在当前对话里更清晰。

7. 内置网络搜索开启

[tools]
web_search = true

如果开启后仍无法联网，检查当前运行环境是否禁止网络访问，或项目规则是否要求不访问外网。

8. Connection failed / 401 / 403 排查

错误	检查项
Connection failed	Base URL 是否包含 /v1，代理是否拦截。
401	API Key 是否完整、是否复制了多余空格。
403	账号或令牌是否无权限，分组是否不可用。
model not found	模型是否在模型广场启用，令牌分组是否包含模型。

按下面顺序排查更快：

1. 确认控制台令牌仍有效，额度没有耗尽。
2. 确认 Base URL 是 https://api.52hertz-palpitate.cn/v1。
3. 确认模型名没有写错，且当前分组可用。
4. 确认本机代理、公司网络或防火墙没有拦截 HTTPS 请求。
5. 改用最小测试 prompt，排除上下文过大、文件过多或工具调用造成的失败。