Codex 相关问题
Codex 使用前先做
- 在项目根目录放置清晰的
AGENTS.md或工作指南。 - 为常见任务准备可复用命令：测试、lint、格式化、构建。
- 使用小步提交和明确的验证命令。
- 为复杂代码库配置必要 MCP，但避免给工具过大权限。
- Skills 可从 skills.sh 获取。
- Codex 工作流可参考 oh-my-codex。
Windows 下使用 Codex
安装 Git、Node.js、Python/uv，并确认终端编码为 UTF-8。必要时使用 WSL，但要注意 Windows 路径与 WSL 路径的配置文件不是同一份。
Codex 常用命令
codex：启动交互。codex --help：查看参数。- 在会话中使用明确的测试命令和文件路径，减少误操作。
Codex App 需要单独配置吗？
先按 Codex 配置 写好 .codex/config.toml 和 .codex/auth.json，再安装并打开 Codex App。新建会话后，Codex App 会读取本机 Codex 配置发起请求。
VSCode Codex 插件中设置最新模型
打开 VSCode Codex 插件设置，填入与 config.toml 一致的 provider、Base URL 和模型 ID。
AveMujicaAPI provider
toml
model_provider = "avemujicaapi"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
[model_providers.avemujicaapi]
name = "AveMujicaAPI"
base_url = "https://api.avemujica.moe/v1"
requires_openai_auth = true
stream_idle_timeout_ms = 600000
wire_api = "responses"开启内置网络搜索
toml
[features]
web_search_request = true只在确实需要外部资料时开启，并遵守所在组织的网络和数据政策。
容器或 CLI 沙盒中的网络连接问题
- 确认容器能访问
https://api.avemujica.moe/v1。 - 检查代理变量、DNS、证书和防火墙。
- 如果工具运行在沙盒中，确认网络权限已开启。
Connection failed
常见原因：Base URL 域名错误、路径缺少 /v1、代理不可用、服务临时故障。
401 Unauthorized
排查：
bash
echo "$OPENAI_API_KEY"
echo "$OPENAI_BASE_URL"确认 auth.json 和环境变量没有冲突。必要时清空旧变量后重启终端。
403 Forbidden
排查原因：
- 当前计划不包含目标模型。
- API Key 权限不足或余额不足。
- 触发限流。
- 账号被风控或地区限制。
处理：换用控制台展示的模型、检查账单或联系支持。