选择你的系统和经验等级，我们只给你看需要的步骤。
# 检查 Node.js 版本（应该 >= 22） node -v # 检查 Codex 版本 codex --version # 试试看！ codex "用 Python 写一个九九乘法表"
# 启动 Codex 交互模式 codex # 一次性提问 codex "解释这段代码是做什么的" # 在指定目录运行 codex "修复这个 bug" --cwd ~/my-project # 切换模型（临时） codex --model deepseek-chat
我们收集了用户最常遇到的问题，也许能帮到你
这是因为 npm 默认的官方源在国内访问慢。解决方法：
# 切换到国内镜像 npm config set registry https://registry.npmmirror.com # 清缓存重试 npm cache clean --force npm install -g @openai/codex
这说明 npm 全局安装路径不在你的 PATH 环境变量里。
# 查看 npm 全局路径 npm prefix -g # 把它加到 PATH echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc source ~/.bashrc # 或者用 npx 临时运行，无需全局安装 npx @openai/codex
升级 Node.js 到 22 或更高版本：
# 如果用的是 nvm nvm install 22 nvm use 22 nvm alias default 22 # 否则，从国内镜像重新安装 # 访问 https://npmmirror.com/mirrors/node/ 下载最新版
检查以下几项：
# 查看当前配置 cat ~/.codex/config.toml # 查看环境变量 echo $DEEPSEEK_API_KEY # 测试 API 是否可用（DeepSeek 为例） curl https://api.deepseek.com/v1/models \ -H "Authorization: Bearer $DEEPSEEK_API_KEY"
几个常见原因：
# 检查 WSL 状态 wsl --status # 查看已安装的发行版 wsl --list --verbose # 如果 WSL 版本是 1，升级到 2 wsl --set-default-version 2
本地模型速度主要取决于你的显卡。优化建议：
ollama pull qwen2.5:7b（约 4.5GB）ollama ps 查看方式一：命令行临时切换
codex --provider deepseek --model deepseek-chat codex --provider ollama --model qwen2.5:7b
方式二：修改默认配置
编辑 ~/.codex/config.toml，修改 model 和 model_provider 两行即可。