想用 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 系统

1. 访问 nodejs.org 下载 LTS 版本（.msi 安装包）
2. 双击运行安装程序，一路 Next 即可
3. 安装完成后打开 PowerShell 验证：

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 写代码越来越顺手！ 🚀

---