终端里装个AI编程助手，比你想的简单——Codex CLI 安装与配置全记录

本文基于 2026年8月最新版本，实测 Windows 11 + Node.js v22，三种安装方式全覆盖

最近 OpenAI 把 Codex CLI 开源了（Apache-2.0 协议），可以在终端里跑一个 AI 编程助手。你告诉它你想干啥，它帮你写代码、改代码、甚至帮你跑命令。关键是它支持 DeepSeek、OpenAI 等多种模型，不是非得用 OpenAI 的付费 API。

我花了一下午从零折腾到跑起来，中间踩了几个坑，写下来给想试试的人省点时间。

一、三种安装方式，选你喜欢的

方式一：微软商店（最简单，推荐新手）

打开 Microsoft Store，搜索 "Codex"，点击安装。装完直接用，不用配任何环境。

安装地址：https://apps.microsoft.com/detail/9plm9xgg6vks

方式二：winget 命令行（适合喜欢命令行的）

打开 PowerShell，一行搞定：

winget install Codex -s msstore

验证安装：

codex --version

方式三：npm 安装（最灵活，适合开发者）

如果你习惯用 npm 管理工具，可以全局安装：

npm install -g @openai/codex

验证安装：

codex --version

我装的时候是 v0.80.0。能正常输出版本号就说明装好了。

⚠️ 踩坑记录： 装完输入 codex 提示找不到命令？这是因为 npm 全局包的路径没加到系统 PATH 里。解决办法：

npm root -g

把输出的路径（比如 C:\Users\你的用户名\AppData\Roaming\npm）加到系统环境变量 PATH 里就行。

二、配置 API Key（核心步骤）

Codex CLI 本身不收费，但调用 AI 模型需要 API Key。我用的是 DeepSeek，因为国内访问稳定、价格也便宜。

去 platform.deepseek.com/api_keys 注册账号，创建一个 API Key，复制下来保存好。

如果你用 OpenAI，就去 platform.openai.com/api-keys 搞。

配置方式 A：环境变量（简单，临时）

PowerShell 里临时设置：

$env:OPENAI_API_KEY="sk-你的密钥"

CMD 里：

set OPENAI_API_KEY=sk-你的密钥

重启终端后失效，只适合临时测试。

配置方式 B：系统环境变量（推荐，永久）

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」

2. 在「用户变量」里点「新建」

3. 变量名：OPENAI_API_KEY

4. 变量值：粘贴你刚才复制的 API Key

5. 确定保存，重启终端生效

配置方式 C：配置文件（最灵活）

Codex 支持从 ~/.codex/config.toml 读取配置。创建这个文件：

mkdir -p $HOME/.codex
notepad $HOME/.codex/config.toml

写入配置：

model = "gpt-4o"
model_provider = "openai"

[model_providers.openai]
name = "OpenAI"
base_url = "https://api.openai.com/v1"
env_key = "OPENAI_API_KEY"

如果用 DeepSeek 中转，把 base_url 换成你的 API 地址：

[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com/v1"
env_key = "DEEPSEEK_API_KEY"

这样每次启动 Codex 都会自动加载配置，不用手动设置环境变量。

三、启动 Codex CLI

在终端里直接输入：

codex

第一次启动会：

1. 自动检测环境

2. 加载 API Key

3. 进入交互式命令行界面

看到命令行提示符就说明跑起来了。

你可以试试跟它说：

"帮我写一个 Python 脚本，读取当前目录下所有 CSV 文件并合并成一个"

它就会开始干活，写代码、解释、甚至帮你保存文件。

四、常用命令

进到交互界面后，这几个命令最常用：

如果遇到问题，先跑 /doctor 看看，大部分问题它都能自己诊断出来。

五、Windows 启动脚本（偷懒专用）

每次开终端都要输 codex 有点麻烦，我写了个启动脚本 codex-start.bat，双击就能跑：

@echo off
setlocal enabledelayedexpansion

REM 从 .env 加载 API Key
if defined OPENAI_API_KEY goto :launch
if exist "%~dp0.env" (
    for /f "usebackq eol=# tokens=1,* delims==" %%A in (`findstr /b /i "OPENAI_API_KEY=" "%~dp0.env"`) do (
        set "OPENAI_API_KEY=%%B"
    )
)
if not defined OPENAI_API_KEY (
    echo [WARN] OPENAI_API_KEY 未设置，Codex 可能无法认证
)

:launch
cd /d "%~dp0"
codex
endlocal

把这个 .bat 文件和 .env 放在同一个目录下，双击它就自动加载 API Key 然后启动 Codex CLI，省事。

⚠️ 踩坑： Windows 可能会弹出安全提示，说这个脚本要运行什么的。选择「仍要运行」就行，第一次放行后后面就不会再弹了。

六、切换模型

Codex CLI 支持多种模型，你可以根据自己的需求切换：

/model gpt-4o        # 切换回 OpenAI GPT-4o
/model deepseek-v4   # 切换到 DeepSeek V4

我目前用 DeepSeek 感觉挺稳的，速度和价格都合适。如果你用 OpenAI 的 GPT-4o 或者 Claude，效果会更好但成本也更高，看自己需求。

七、卸载

哪天不想用了，卸载也简单：

npm uninstall -g @openai/codex

如果想清理干净，再把环境变量 OPENAI_API_KEY 删掉，.env 文件删掉就行。

八、总结

装下来其实不复杂，主要就三步：

1. 安装：微软商店一键装，或者 npm install -g @openai/codex

2. 配 API Key：环境变量或配置文件都行

3. 启动：终端里跑 codex 就开始用了

踩坑基本也就两个：npm 全局包路径没加到 PATH 里、API Key 没配对。上面都写了解决办法。

装完之后，你就有个能在终端里直接对话的 AI 编程助手了。写脚本、改代码、查问题，都能在终端里搞定，不用来回切浏览器。

如果你也装了，欢迎来交流使用体验。

参考链接：

• 官方 GitHub：https://github.com/openai/codex

• 官方文档：https://developers.openai.com/codex

• DeepSeek 平台：https://platform.deepseek.com

• OpenAI 平台：https://platform.openai.com