ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

Codex安装纯教程

Codex安装纯教程

手把手:装好 Codex 并接上 DeepSeek(照着做就行)

本文只讲操作,不讲原理。每一步照抄,走完就能用。
想了解原理、配置项含义和完整排错表,请看我的另一个文章《从零安装 Codex CLI 并接入 DeepSeek 模型》。

全程约 10 分钟。系统:Windows。


第 0 步:先准备一个 Key

  1. 打开 https://platform.deepseek.com/api_keys
  2. 登录 → 点「创建 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 步:解压到固定位置

  1. 在 C 盘新建文件夹C:\Codex\bin
  2. 把下载好的 zip 拖进去,右键 →全部解压缩→ 目标选C:\Codex\bin

解压完,C:\Codex\bin里面能看到这个文件:

codex-x86_64-pc-windows-msvc.exe

第 3 步:做一个启动文件

  1. 打开C:\Codex文件夹(注意是 bin 的上一级)
  2. 右键 → 新建 → 文本文档
  3. 把文件名改成codex.cmd(一定要把.txt换成.cmd)
  4. 右键编辑,粘贴下面两行,保存:
@echo off "C:\Codex\bin\codex-x86_64-pc-windows-msvc.exe" --no-daemon %*

第 4 步:让命令随处可用

  1. 开始菜单搜索PowerShell,打开
  2. 粘贴下面这行,回车:
$u=[Environment]::GetEnvironmentVariable('Path','User');[Environment]::SetEnvironmentVariable('Path',$u.TrimEnd(';')+';C:\Codex','User')
  1. 关掉这个窗口,重新打开一个新的 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

接下来按提示操作:

  1. 让你输 API Key →粘贴第 0 步复制的 Key,回车
  2. 让你选模型 → 输入1回车(1 = deepseek-flash,快;想要更强的输2= deepseek-v4-pro)

看到配置完成的提示就 OK 了。它会自动帮你备份旧配置并写好两个配置文件,不用你手动改任何东西。


第 8 步:开始用

进入你的项目文件夹,然后启动:

cd D:\你的项目目录 codex

看到启动横幅上写着model: deepseek-flash,就说明成功了。

然后直接说话就行,比如:

帮我看看这个项目是干什么的

常用命令

想干什么输入
启动codex
直接带任务启动codex "帮我重构这个函数"
跑完就退出(非交互)codex exec "给这个项目加上单元测试"
看版本codex --version
出问题自检codex doctor
升级 Codexcodex 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/codex

Linux:

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里的路径也要一起改。

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进