Appearance
Codex 常见问题
本页面解答使用 Codex CLI 时的常见问题。
安装问题
Q: 提示 Node.js 版本过低怎么办?
A: Codex 需要 Node.js 18 或更高版本。
解决方案:
- 访问 nodejs.org 下载最新 LTS 版本
- 安装后验证:
node --version - 重新安装 Codex
Q: npm install 提示权限错误?
A: 使用 sudo(不推荐)或配置 npm 用户目录:
bash
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrcQ: Windows 如何以管理员身份安装?
A: 右键点击 PowerShell,选择"以管理员身份运行",然后安装:
powershell
npm install -g @openai/codex配置问题
Q: 配置文件在哪里?
A:
- Windows:
C:\Users\你的用户名\.codex\ - macOS/Linux:
~/.codex/
需要两个文件:
config.toml- 主配置auth.json- API Key
Q: TOML 格式不熟悉怎么办?
A: TOML 格式很简单:
toml
# 这是注释
key = "value"
number = 123
boolean = true
[section]
nested_key = "nested_value"复制文档中的示例即可,注意:
- 字符串用引号
- 布尔值不用引号(true/false)
Q: API Key 配置后不生效?
A: 检查:
auth.json格式是否正确(是 JSON 格式)- API Key 是否完整(包括
sk-前缀) - 文件名是否正确(
auth.json,不是auth.txt)
Q: Base URL 配置错误?
A: 正确配置应该是:
toml
model_provider = "myy"
model = "gpt-5.2-codex"
[model_providers.myy]
name = "myy"
base_url = "https://us.myy9.com/v1"
wire_api = "responses"
requires_openai_auth = true注意:
- URL 末尾有
/v1 model_provider要设为"myy"wire_api设为"responses"
使用问题
Q: 提示 API Key 无效?
A: 检查:
- API Key 是否完整复制
- 在 MYY 中转站确认令牌启用
auth.json格式是否正确:
json
{
"OPENAI_API_KEY": "sk-你的MYY令牌"
}提示
这里的 sk- 开头的令牌是从 MYY 中转站获取的,不是 OpenAI 官方的 Key
Q: 响应很慢或超时?
A:
- 检查网络连接到
https://us.myy9.com - 尝试切换模型:
bash
codex --model gpt-3.5-turbo "你的问题"- 查看配置文件中的模型设置
Q: 如何指定使用的模型?
A:
方式 1:命令行参数
bash
codex --model gpt-4 "你的问题"
codex --model claude-3-5-sonnet-20241022 "你的问题"方式 2:修改 config.toml
toml
model = "gpt-4"Q: 命令未找到 (codex: command not found)?
A:
- 确认已全局安装:
npm list -g @openai/codex - 检查 PATH:
npm config get prefix - 重新安装:
npm install -g @openai/codex
Q: Windows 下使用遇到问题?
A: 配置文件中已经默认包含 Windows 支持:
toml
windows_wsl_setup_acknowledged = true如果仍有问题:
- 确认配置文件路径:
%USERPROFILE%\.codex\config.toml - 检查配置文件是否包含上述设置
- 重启终端/PowerShell
- 查看详细日志:
codex --debug "你的问题"
Q: 如何退出交互模式?
A:
- 输入
exit或quit - 按
Ctrl + D - 按
Ctrl + C
功能问题
Q: Codex 可以执行命令吗?
A: 可以!Codex 支持:
- 文件读写
- 命令执行
- Git 操作
- 运行测试
- 安装依赖
前提是在沙箱模式允许的范围内。
Q: 如何让 Codex 创建项目?
A: 直接描述需求:
bash
codex "创建一个 Next.js 14 + TypeScript + Tailwind 的项目"Codex 会自动:
- 创建目录结构
- 生成配置文件
- 安装依赖
- 创建基础代码
Q: Codex 和 GitHub Copilot 有什么区别?
A:
| 特性 | Codex CLI | GitHub Copilot |
|---|---|---|
| 类型 | 命令行工具 | IDE 插件 |
| 交互方式 | 对话式 | 自动补全 |
| 范围 | 整个项目 | 当前文件 |
| 命令执行 | ✅ 可以 | ❌ 不可以 |
| 费用 | 按量计费 | 订阅制 |
Q: 如何控制 Codex 的权限?
A: 在 config.toml 中设置 sandbox_mode:
"safe"- 安全模式,只能读文件"danger-full-access"- 完全访问,可执行命令
费用问题
Q: Codex 会很贵吗?
A: 费用取决于:
- 使用频率
- 选择的模型
- 输入输出长度
节省建议:
- 简单任务用
gpt-3.5-turbo - 复杂任务用
gpt-4 - 限制上下文范围
Q: 如何查看使用量?
A:
- 登录 MYY 中转站
- 进入"日志管理"
- 筛选 Codex 对应的令牌
- 查看详细统计
Q: 为什么消耗的 Token 比预期多?
A: 可能原因:
- Codex 会包含项目上下文
- 多文件操作消耗更多
- 对话历史累积
优化方法:
- 指定具体文件而非整个项目
- 定期退出交互模式
- 使用更便宜的模型处理简单任务
故障排查
Q: 如何查看详细错误信息?
A:
bash
# 启用调试模式
codex --debug "你的问题"
# 或查看日志
# Windows: %USERPROFILE%\.codex\logs
# macOS/Linux: ~/.codex/logsQ: 网络连接失败?
A:
- 测试连接:
bash
curl https://us.myy9.com/v1/models \
-H "Authorization: Bearer sk-你的key"- 检查防火墙设置
- 尝试使用代理(如需要)
Q: 配置文件语法错误?
A:
- 检查 TOML 格式:使用在线 TOML 验证器
- 检查 JSON 格式:使用在线 JSON 验证器
- 对比文档中的示例