想用 Codex（OpenAI 最新的 AI 编程助手）却不知道怎么装、怎么配？尤其是在国内环境下，可能还会遇到网络问题、登录问题、API 配置问题……
别慌，这篇文章手把手教你从零开始安装配置 Codex CLI，让你也能在终端里用 AI 写代码。
💡 如果你还在找一个稳定、省心的 API 中转平台来跑 Codex、Claude Code、Gemini CLI 这类工具，推荐你看看 weelinking平台——统一接入、Key 分组管理、用量可视化、服务监控一应俱全，专门为开发者和 AI 工具场景设计。
📑 目录导航
- 1. Codex 是什么？
- 2. 安装前准备
- 3. 安装 Codex CLI
- 4. 登录与配置
- 5. 常用命令速查
- 6. 常见问题排查
- 7. 为什么推荐配合 weelinking 使用？
1. Codex 是什么？
Codex 是 OpenAI 专门为代码开发设计的 AI 工具，基于最新的模型，主打：
| ✅ 代码理解更准 | 查找 Bug、理解上下文的准确率更高 |
| ✅ 多种使用方式 | 网页版、IDE 扩展、CLI 终端都能用 |
| ✅ 开发者友好 | 直接在命令行里对话、生成代码、分析项目 |
简单来说，Codex 就是你的 AI 编程搭档，能帮你写代码、改 Bug、重构项目。
2. 安装前准备
2.1 系统要求
| 📦 Node.js | 版本 ≥ 22（必须） |
| 🔑 账户 | 有效的 OpenAI API Key 或 ChatGPT Plus/Pro 账户 |
2.2 安装 Node.js
🪟 Windows 系统
node –v
npm –v
🍎 macOS 系统
# 使用 Homebrew 安装
brew install node
# 或者直接从 nodejs.org 下载安装
# 验证安装
node -v
npm -v
🐧 Linux 系统
# 推荐使用 nvm 安装（版本管理更方便）
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
# 验证安装
node -v
npm -v
3. 安装 Codex CLI
打开终端，执行以下命令全局安装：
# 方法一：npm 全局安装
npm install -g @openai/codex
# 方法二：国内用户使用镜像加速（推荐）
npm install -g @openai/codex –registry=https://registry.npmmirror.com
# 方法三：macOS 用户可用 Homebrew
brew install codex
✅ 安装完成后验证：
codex –version
# 示例输出：0.42.0
4. 登录与配置
4.1 首次登录
直接在终端输入：
codex
首次运行会自动打开浏览器，选择 Sign in with ChatGPT 登录授权。授权成功后，凭证会自动保存到 ~/.codex/token 文件。
4.2 使用 API Key 方式（⭐ 推荐配合 weelinking）
如果你用的是 weelinking 平台或其他 API 中转服务，可以直接配置环境变量：
🪟 Windows PowerShell
# 当前会话有效
$env:OPENAI_API_KEY = "你的API密钥"
$env:OPENAI_BASE_URL = "https://api.weelinking.com/v1"
# 永久生效（用户级）
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的API密钥", "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://api.weelinking.com/v1", "User")
🍎🐧 macOS / Linux
# 添加到 shell 配置文件（zsh 用户）
echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.weelinking.com/v1"' >> ~/.zshrc
source ~/.zshrc
# bash 用户改成 ~/.bashrc
4.3 设置中文回复
默认 Codex 会用英文回复，想要中文回复可以这样配置：
# 创建配置目录和文件
mkdir -p ~/.codex
echo "Always respond in Chinese-simplified" > ~/.codex/AGENTS.md
5. 常用命令速查
📋 命令一览表
| 🚀 快速生成代码 | codex "写一个下载文件的Python脚本" | 一句话生成可运行代码 |
| 💬 交互模式 | codex | 进入多轮对话模式 |
| 🖼️ 分析错误截图 | codex -i error.png "分析并修复" | 支持图片输入 |
| 🔧 项目级重构 | codex "给这个项目加上日志功能" | 自动分析项目结构 |
| ⚡ 自动化执行 | codex exec "跑通项目测试" | 自动安装依赖并执行 |
💻 交互模式示例
# 启动交互模式
codex
# 输入你的需求
>> 写一个 Python 爬虫脚本，爬取豆瓣电影 Top250
# Codex 会生成代码…
# 继续追问
>> 给这个脚本加上异常处理和进度条
6. 常见问题排查
❌ 问题一：登录失败 / 回调超时
解决方案：
- 检查网络代理是否开启了全局模式（TUN Mode）
- 重新执行 codex 命令进行授权
❌ 问题二：命令未找到 codex: command not found
解决方案： 检查 npm 全局路径是否在 PATH 中：
npm config get prefix
# 把输出的路径加到 PATH 环境变量
❌ 问题三：npm 安装缓慢
解决方案： 使用国内镜像源：
npm install -g @openai/codex –registry=https://registry.npmmirror.com
❌ 问题四：API 调用失败
解决方案：
- 检查 OPENAI_API_KEY 是否正确设置
- 如果用中转平台，确认 OPENAI_BASE_URL 配置正确
- 在 weelinking 平台的「服务监控」页面查看服务状态
7. 为什么推荐配合 weelinking 使用？
🚫 直接用官方 API 可能会遇到：
| 🚫 网络不稳定 | 请求超时、连接失败 |
| 🚫 Key 管理混乱 | 多项目/多人协作容易出问题 |
| 🚫 用量看不清 | 月底才发现烧了很多钱 |
✅ weelinking平台 专门解决这些痛点：
| ✅ 稳定中转 | 国内访问更顺畅 |
| ✅ 秘钥分组 | 多 Key 管理，权限隔离 |
| ✅ 用量可视化 | 余额、调用、消耗一目了然 |
| ✅ 服务监控 | 实时查看 Codex 专用服务状态 |
| ✅ 兼容 OpenAI SDK | 改个 BASE_URL 就能用 |
🎯 最后
Codex 是目前最强大的 AI 编程工具之一，配合好用的中转平台，能让你的开发体验更上一层楼。
🚀 weelinking平台｜开发者的 AI 工具好搭档
| ✅ 统一接入 | 一个入口聚合主流大模型，省去来回折腾 |
| 🔑 秘钥分组 | 多 Key、多分组，权限与模型选择更可控 |
| 📊 用量清晰 | 余额/调用/消耗/性能指标一屏可见 |
| 🛰️ 实时监控 | 服务大盘可观测，稳定性心里有数 |
| 🧰 开发者友好 | 覆盖 Claude Code / Codex / Gemini CLI 等工具场景 |
👉 立即上车（注册/体验）： weelinking平台 跟着新手教程走，5 分钟搞定配置，开始愉快地用 Codex 写代码吧！
💬 互动交流
有问题？欢迎在评论区留言交流！ 无论是安装遇到坑、使用有疑问，还是有更好的玩法想分享，都可以一起聊聊~
如果这篇教程对你有帮助，点个赞👍、加个关注🌟 支持一下，后续会持续更新更多 AI 工具的实用教程！
感谢支持，祝你用 Codex 写代码越来越顺手！ 🚀
