Skip to content

Codex 常见问题

本页面解答使用 Codex CLI 时的常见问题。

安装问题

Q: 提示 Node.js 版本过低怎么办?

A: Codex 需要 Node.js 18 或更高版本。

解决方案:

  1. 访问 nodejs.org 下载最新 LTS 版本
  2. 安装后验证:node --version
  3. 重新安装 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 ~/.bashrc

Q: 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: 检查:

  1. auth.json 格式是否正确(是 JSON 格式)
  2. API Key 是否完整(包括 sk- 前缀)
  3. 文件名是否正确(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: 检查:

  1. API Key 是否完整复制
  2. 在 MYY 中转站确认令牌启用
  3. auth.json 格式是否正确:
json
{
  "OPENAI_API_KEY": "sk-你的MYY令牌"
}

提示

这里的 sk- 开头的令牌是从 MYY 中转站获取的,不是 OpenAI 官方的 Key

Q: 响应很慢或超时?

A:

  1. 检查网络连接到 https://us.myy9.com
  2. 尝试切换模型:
bash
codex --model gpt-3.5-turbo "你的问题"
  1. 查看配置文件中的模型设置

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:

  1. 确认已全局安装:npm list -g @openai/codex
  2. 检查 PATH:npm config get prefix
  3. 重新安装:npm install -g @openai/codex

Q: Windows 下使用遇到问题?

A: 配置文件中已经默认包含 Windows 支持:

toml
windows_wsl_setup_acknowledged = true

如果仍有问题:

  1. 确认配置文件路径:%USERPROFILE%\.codex\config.toml
  2. 检查配置文件是否包含上述设置
  3. 重启终端/PowerShell
  4. 查看详细日志:codex --debug "你的问题"

Q: 如何退出交互模式?

A:

  • 输入 exitquit
  • Ctrl + D
  • Ctrl + C

功能问题

Q: Codex 可以执行命令吗?

A: 可以!Codex 支持:

  • 文件读写
  • 命令执行
  • Git 操作
  • 运行测试
  • 安装依赖

前提是在沙箱模式允许的范围内。

Q: 如何让 Codex 创建项目?

A: 直接描述需求:

bash
codex "创建一个 Next.js 14 + TypeScript + Tailwind 的项目"

Codex 会自动:

  1. 创建目录结构
  2. 生成配置文件
  3. 安装依赖
  4. 创建基础代码

Q: Codex 和 GitHub Copilot 有什么区别?

A:

特性Codex CLIGitHub Copilot
类型命令行工具IDE 插件
交互方式对话式自动补全
范围整个项目当前文件
命令执行✅ 可以❌ 不可以
费用按量计费订阅制

Q: 如何控制 Codex 的权限?

A:config.toml 中设置 sandbox_mode

  • "safe" - 安全模式,只能读文件
  • "danger-full-access" - 完全访问,可执行命令

费用问题

Q: Codex 会很贵吗?

A: 费用取决于:

  1. 使用频率
  2. 选择的模型
  3. 输入输出长度

节省建议:

  • 简单任务用 gpt-3.5-turbo
  • 复杂任务用 gpt-4
  • 限制上下文范围

Q: 如何查看使用量?

A:

  1. 登录 MYY 中转站
  2. 进入"日志管理"
  3. 筛选 Codex 对应的令牌
  4. 查看详细统计

Q: 为什么消耗的 Token 比预期多?

A: 可能原因:

  1. Codex 会包含项目上下文
  2. 多文件操作消耗更多
  3. 对话历史累积

优化方法:

  • 指定具体文件而非整个项目
  • 定期退出交互模式
  • 使用更便宜的模型处理简单任务

故障排查

Q: 如何查看详细错误信息?

A:

bash
# 启用调试模式
codex --debug "你的问题"

# 或查看日志
# Windows: %USERPROFILE%\.codex\logs
# macOS/Linux: ~/.codex/logs

Q: 网络连接失败?

A:

  1. 测试连接:
bash
curl https://us.myy9.com/v1/models \
  -H "Authorization: Bearer sk-你的key"
  1. 检查防火墙设置
  2. 尝试使用代理(如需要)

Q: 配置文件语法错误?

A:

  1. 检查 TOML 格式:使用在线 TOML 验证器
  2. 检查 JSON 格式:使用在线 JSON 验证器
  3. 对比文档中的示例

更多问题

MYY中转站 - 让 AI 工具更易用