手把手:装好 Codex 并接上 DeepSeek(照着做就行)
本文只讲操作,不讲原理。每一步照抄,走完就能用。
想了解原理、配置项含义和完整排错表,请看我的另一个文章《从零安装 Codex CLI 并接入 DeepSeek 模型》。
全程约 10 分钟。系统:Windows。
第 0 步:先准备一个 Key
- 打开 https://platform.deepseek.com/api_keys
- 登录 → 点「创建 API Key」→ 复制(以
sk-开头)
先放一边,第 7 步要用。
第 1 步:下载安装包
打开 https://github.com/openai/codex/releases
往下拉,找到Assets,点这个文件名下载:
codex-x86_64-pc-windows-msvc.exe.zip下载太慢?把浏览器地址换成下面这串(前面加了加速前缀),会快很多:
https://ghfast.top/https://github.com/openai/codex/releases/download/rust-v0.163.0/codex-x86_64-pc-windows-msvc.exe.zip版本号
rust-v0.163.0可能会更新,以 Release 页面上的最新版为准。
第 2 步:解压到固定位置
- 在 C 盘新建文件夹
C:\Codex\bin - 把下载好的 zip 拖进去,右键 →全部解压缩→ 目标选
C:\Codex\bin
解压完,C:\Codex\bin里面能看到这个文件:
codex-x86_64-pc-windows-msvc.exe第 3 步:做一个启动文件
- 打开
C:\Codex文件夹(注意是 bin 的上一级) - 右键 → 新建 → 文本文档
- 把文件名改成
codex.cmd(一定要把.txt换成.cmd) - 右键编辑,粘贴下面两行,保存:
@echo off "C:\Codex\bin\codex-x86_64-pc-windows-msvc.exe" --no-daemon %*第 4 步:让命令随处可用
- 开始菜单搜索PowerShell,打开
- 粘贴下面这行,回车:
$u=[Environment]::GetEnvironmentVariable('Path','User');[Environment]::SetEnvironmentVariable('Path',$u.TrimEnd(';')+';C:\Codex','User')- 关掉这个窗口,重新打开一个新的 PowerShell
第 5 步:验证装好了
在新的 PowerShell 里输入:
codex --version看到codex-cli 0.163.0这样的版本号,安装就成功了。
第 6 步:让 Codex 生成配置文件夹
还是在 PowerShell 里输入:
codex login status显示Not logged in是正常的,这一步的目的只是让它自动生成配置文件夹C:\Users\你的用户名\.codex,第 7 步的脚本需要这个文件夹存在。
第 7 步:一键接入 DeepSeek
在 PowerShell 里粘贴下面这行,回车:
irmhttps://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1|iex接下来按提示操作:
- 让你输 API Key →粘贴第 0 步复制的 Key,回车
- 让你选模型 → 输入
1回车(1 = deepseek-flash,快;想要更强的输2= deepseek-v4-pro)
看到配置完成的提示就 OK 了。它会自动帮你备份旧配置并写好两个配置文件,不用你手动改任何东西。
第 8 步:开始用
进入你的项目文件夹,然后启动:
cd D:\你的项目目录 codex看到启动横幅上写着model: deepseek-flash,就说明成功了。
然后直接说话就行,比如:
帮我看看这个项目是干什么的常用命令
| 想干什么 | 输入 |
|---|---|
| 启动 | codex |
| 直接带任务启动 | codex "帮我重构这个函数" |
| 跑完就退出(非交互) | codex exec "给这个项目加上单元测试" |
| 看版本 | codex --version |
| 出问题自检 | codex doctor |
| 升级 Codex | codex update |
换模型
用记事本打开C:\Users\你的用户名\.codex\config.toml,找到这一行:
model = "deepseek-flash"改成下面的任意一个,保存即可:
model = "deepseek-v4-pro" # 更强,慢一点 model = "deepseek-flash" # 更快,省一点三个可能遇到的问题
1. 输入codex提示"不是内部或外部命令"
关掉命令行窗口,重新开一个再试(PATH 要新窗口才生效)。
2. 启动时报Error: the CLI package does not match...
说明你没用第 3 步的codex.cmd,而是直接跑了 exe。用codex.cmd启动就不会有这个问题。
3. 脚本第 7 步跑不起来 / 想手动配置
看 CSDN 文章《从零安装 Codex CLI 并接入 DeepSeek 模型》第五节,里面有手动写config.toml和models.json的完整内容。
其他系统(两行命令搞定)
macOS:
curl-Lhttps://github.com/openai/codex/releases/latest/download/codex-aarch64-apple-darwin.tar.gz|tarxzsudomvcodex-aarch64-apple-darwin /usr/local/bin/codexLinux:
curl-Lhttps://github.com/openai/codex/releases/latest/download/codex-x86_64-unknown-linux-gnu.tar.gz|tarxzsudomvcodex-x86_64-unknown-linux-gnu /usr/local/bin/codex装完后同样执行第 7 步的一键脚本(macOS/Linux 版):
bash<(curl-fsSLhttps://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh)想改安装位置?把教程里所有的
C:\Codex换成你自己的路径即可,注意第 3 步codex.cmd里的路径也要一起改。