教程:在 Windows WSL 中为 Codex 接入 DeepSeek V4 Pro


适用环境:已安装 WSL 的 Windows 10/11;拥有 DeepSeek 账号。预计 10 分钟完成。


1. 安装 WSL(如尚未安装)

以管理员身份打开 PowerShell 或 Windows 命令提示符,执行:

wsl --install

重启电脑后,首次启动 WSL 会提示创建 Linux 用户和密码。完成后,你就有了一个完整的 Linux 子系统。详情参阅WSL 安装

2. 安装 x-cmd

在 WSL 终端(非 PowerShell)中执行:

eval "$(curl https://get.x-cmd.com)"

安装脚本会自动配置环境变量。重启终端(或执行 exec bash / exec zsh)后,验证安装:

x --version

若看到版本号,说明安装成功。

3. 安装 Codex 并切换到 v0.80.0

直接使用 x-cmd 的 codex 模块安装指定版本:

x codex use 0.80.0

该命令会自动下载并激活该版本。验证版本:

x codex version

为什么用 0.80.0?
新版 Codex(≥ 0.81.0)移除了对旧 chat 协议的支持,而 DeepSeek 目前的集成依赖该协议。0.80.0 是最后一个完美兼容的版本,所有功能稳定可用。

4. 获取 DeepSeek API Key

  1. 访问 DeepSeek 开放平台 API Keys 并登录。
  2. 点击 “创建 API key”,复制生成的 sk- 开头的密钥。请妥善保管,不要泄露
  3. 如果还没有账号,先注册(提供免费额度)。

5. 配置 Codex 使用 DeepSeek

在 WSL 终端中运行以下命令,会弹出交互式图形界面:

x deepseek init

按界面提示输入你的 API Key,并选择模型(推荐 deepseek-v4-pro)。配置完成后,界面会提示成功。

最后,启用 DeepSeek 作为 Codex 的后端:

x codex ds

如果看到类似 Codex backend switched to DeepSeek 的消息,就表示配置成功。

6. 验证功能

在终端中尝试一次对话,如果返回了 DeepSeek 的正常回复,恭喜!你可以随时用 x codex 命令调用 AI 助手。


常见问题

Q: 运行 x deepseek init 时提示没有图形界面?
A: 确保你在 WSL 的终端(如 Windows Terminal)中运行,而非纯命令行界面。如果仍有问题,可以手动编辑配置文件:~/.config/x/deepseek/config,手动填入 api_keymodel

Q: 怎么切换回其他 Codex 版本?

x codex use 0.81.0    # 切到最新版
x codex use system    # 使用系统默认版本

Q: 如何卸载 x-cmd?

x uninstall

学到了什么?

  • x <module> 统一管理命令行工具,告别繁琐的手动下载和版本切换。
  • DeepSeek 的 API 可以本地配置给 Codex,离线体验与隐私可控。
  • 版本锁定是解决兼容性问题的通用手段——不是最新就是最好。

下一步:你可以用 x codex 做更多事情,比如代码解释、自动补全,甚至用 x codex agent 创建自定义 AI 助手。

有问题?去 x-cmd 社区DeepSeek 官方文档 聊聊。

agent面试题库
agent面试题库
agent面试题库
了解更多