Codex 安装与配置完全指南:多平台安装到 DeepSeek 接入

Codex 多平台安装教程(macOS/Windows/Linux),接入 DeepSeek 等国内模型的完整实操指南。
Codex 安装与配置完全指南:多平台安装到 DeepSeek 接入



macOS 安装教程

系统要求

操作系统:macOS 12 (Monterey) 或更高版本

处理器:Apple Silicon (M1/M2/M3/M4) 或 Intel

内存:至少 4GB RAM

磁盘空间:至少 500MB 可用空间

网络:需要互联网连接

其他:可选 Node.js 22+(用于 npm 安装)

第一步:安装 Codex CLI

macOS 提供三种安装方式,任选其一:

方式一:官方脚本安装(推荐)

curl -fsSL https://chatgpt.com/codex/install.sh | sh

🌏 如果国内访问较慢,可以使用镜像源:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

方式二:通过 npm 安装

npm install -g @openai/codex

🌏 使用国内 npm 镜像:

npm config set registry https://registry.npmmirror.com && npm install -g @openai/codex

方式三:通过 Homebrew 安装

brew install --cask codex

第二步:验证安装

安装完成后,运行以下命令验证:

codex --version

如果看到版本号输出(如 codex 1.0.0),说明安装成功。

第三步:运行诊断

Codex CLI 内置了诊断工具,可以帮助排查问题:

codex diagnose

该命令会检查:
- 网络连接状态
- API Key 是否有效
- 配置文件是否正确
- 系统环境是否兼容

第四步:登录账号(可选)

如果你有 OpenAI 账号,可以登录以使用官方功能:

codex login

按照提示在浏览器中完成授权即可。


🔧 接入 DeepSeek 大模型

DeepSeek 是一款性价比极高的大语言模型,我们可以将 Codex CLI 配置为使用 DeepSeek 作为后端模型。

获取 API Key

  1. 访问 DeepSeek 开放平台
  2. 注册并登录账号
  3. 进入「API Keys」页面
  4. 点击「创建 API Key」
  5. 复制生成的 Key(仅显示一次,请妥善保存)

创建配置目录

mkdir -p ~/.codex

编辑配置文件

cat > ~/.codex/config.toml << 'EOF'
# ===== DeepSeek 模型配置 =====
model = "deepseek-chat"
model_provider = "deepseek"
model_reasoning_effort = "high"
approval_policy = "never"
sandbox_mode = "danger-full-access"

# ===== 自定义模型提供者 =====
[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com"
env_key = "DEEPSEEK_API_KEY"
env_key_instructions = "从 https://platform.deepseek.com/api_keys 获取 API Key"
wire_api = "responses"
EOF

设置环境变量

Zsh 用户(macOS 默认 Shell):

echo 'export DEEPSEEK_API_KEY="***"' >> ~/.zshrc && source ~/.zshrc

Bash 用户:

echo 'export DEEPSEEK_API_KEY="***"' >> ~/.bash_profile && source ~/.bash_profile

⚠️ 请将 *** 替换为你实际的 DeepSeek API Key。

验证配置

codex --version

然后尝试运行 Codex:

codex "Hello, write a Python hello world program"

如果正常返回结果,说明 DeepSeek 接入成功!

高级配置

切换不同模型:

# 使用 DeepSeek Coder(代码专用)
model = "deepseek-coder"

# 使用 DeepSeek Chat(通用对话)
model = "deepseek-chat"

# 使用 DeepSeek Reasoner(推理增强)
model = "deepseek-reasoner"

使用 Ollama 本地部署 DeepSeek:

[model_providers.deepseek]
name = "DeepSeek (Ollama)"
base_url = "http://localhost:11434/v1"
env_key = "DEEPSEEK_API_KEY"
wire_api = "responses"

Profile 模式:

Codex 支持使用 Profile 区分不同配置:

codex --profile deepseek-coder "优化这段代码"
codex --profile deepseek-chat "解释这个概念"

🔑 常用环境变量

环境变量 说明 示例
DeepSeek API 密钥 DEEPSEEK_API_KEY sk-xxxx
OpenAI API 密钥 OPENAI_API_KEY sk-xxxx
指定默认模型 CODEX_MODEL deepseek-chat
审批策略 CODEX_APPROVAL_POLICY never / auto
沙箱模式 CODEX_SANDBOX_MODE danger-full-access
HTTP 代理地址 HTTP_PROXY http://127.0.0.1:7890
HTTPS 代理地址 HTTPS_PROXY http://127.0.0.1:7890

🔧 对接飞书

通过 cc-connect 工具,可以将 Codex CLI 与飞书机器人对接。

安装 cc-connect

npm install -g cc-connect

快速配置

cc-connect feishu setup --project my-project

手动配置

创建配置文件 ~/.codex/cc-connect.toml

[feishu]
app_id = "cli_xxxxxxxxxxxxxxxx"
app_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
encrypt_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
verification_token = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

[feishu.bot]
name = "Codex Assistant"
description = "AI 编程助手"

飞书应用配置步骤

  1. 登录 飞书开放平台
  2. 创建企业自建应用
  3. 在「权限管理」中开启以下权限:
  4. im:message:receive_v1(接收消息)
  5. im:message:send_v1(发送消息)
  6. im:chat:readonly(读取群信息)
  7. 在「事件订阅」中添加消息接收事件
  8. 将 App ID 和 App Secret 填入配置文件
  9. 发布应用并添加到目标群聊

❓ 常见问题

Q: codex 命令找不到?

A: 请确认安装路径已添加到 PATH 环境变量:

# 查看 codex 安装位置
which codex

# 如果未找到,尝试手动添加路径
export PATH="$HOME/.local/bin:$PATH"

如果通过 npm 安装,可能需要:

export PATH="$(npm bin -g):$PATH"

Q: DeepSeek 连接失败?

A: 请检查以下几项:

  1. API Key 是否正确设置:echo $DEEPSEEK_API_KEY
  2. 网络是否能访问 api.deepseek.comcurl -I https://api.deepseek.com
  3. 配置文件格式是否正确:cat ~/.codex/config.toml
  4. 是否需要设置代理

Q: 如何更新到最新版?

A: 根据安装方式选择对应的更新命令:

# 官方脚本安装的
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# npm 安装的
npm update -g @openai/codex

# Homebrew 安装的
brew upgrade --cask codex

Q: 如何查看当前配置?

A: 使用以下命令查看:

# 查看完整配置
cat ~/.codex/config.toml

# 查看当前使用的模型
codex config get model

# 查看所有配置项
codex config list

Q: 为什么选择 DeepSeek 而不是 OpenAI?

对比项 DeepSeek OpenAI (GPT-4)
价格 ¥1/百万 Tokens (输入) $30/百万 Tokens (输入)
中文能力 ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐
代码能力 ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐⭐
推理能力 ⭐⭐⭐⭐ ⭐⭐⭐⭐⭐
国内访问 ✅ 直连 ❌ 需要代理
上下文长度 128K 128K
开源 ✅ 部分开源 ❌ 闭源

对于国内开发者来说,DeepSeek 无需代理、价格低廉、中文友好,是极佳的选择。


📚 常用管理命令速查

说明 命令
查看版本号 codex --version
查看帮助信息 codex --help
登录 OpenAI 账号 codex login
退出登录 codex logout
运行诊断 codex diagnose
查看配置项 codex config get <key>
设置配置项 codex config set <key> <value>
列出所有配置 codex config list
运行 Codex codex "你的指令"

🔗 相关资源

Windows 安装教程

系统要求

操作系统:Windows 10 (64位) 或更高版本

处理器:x64 架构 CPU

内存:至少 4GB RAM

磁盘空间:至少 500MB 可用空间

网络:需要互联网连接

其他:PowerShell 5.1+ 或 PowerShell 7+;可选 Node.js 22+

第一步:安装 Codex CLI

⚠️ Windows 用户请以管理员身份运行 PowerShell

右键点击「开始」菜单 → 选择「Windows Terminal (管理员)」或「PowerShell (管理员)」

方式一:官方脚本安装(推荐)

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

🌏 如果国内访问较慢,可以使用镜像源:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

方式二:通过 npm 安装

npm install -g @openai/codex

🌏 使用国内 npm 镜像:

npm config set registry https://registry.npmmirror.com && npm install -g @openai/codex

💡 如果尚未安装 Node.js,请先从 nodejs.org 下载并安装 LTS 版本。

第二步:验证安装

安装完成后,重新打开一个 PowerShell 窗口,然后运行:

codex --version

如果看到版本号输出(如 codex 1.0.0),说明安装成功。

第三步:运行诊断

Codex CLI 内置了诊断工具,可以帮助排查问题:

codex diagnose

该命令会检查:
- 网络连接状态
- API Key 是否有效
- 配置文件是否正确
- 系统环境是否兼容

第四步:登录账号(可选)

如果你有 OpenAI 账号,可以登录以使用官方功能:

codex login

按照提示在浏览器中完成授权即可。


🔧 接入 DeepSeek 大模型

DeepSeek 是一款性价比极高的大语言模型,我们可以将 Codex CLI 配置为使用 DeepSeek 作为后端模型。

获取 API Key

  1. 访问 DeepSeek 开放平台
  2. 注册并登录账号
  3. 进入「API Keys」页面
  4. 点击「创建 API Key」
  5. 复制生成的 Key(仅显示一次,请妥善保存)

创建配置目录

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"

编辑配置文件

@"
# ===== DeepSeek 模型配置 =====
model = "deepseek-chat"
model_provider = "deepseek"
model_reasoning_effort = "high"
approval_policy = "never"
sandbox_mode = "danger-full-access"

# ===== 自定义模型提供者 =====
[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com"
env_key = "DEEPSEEK_API_KEY"
env_key_instructions = "从 https://platform.deepseek.com/api_keys 获取 API Key"
wire_api = "responses"
"@ | Out-File -FilePath "$env:USERPROFILE\.codex\config.toml" -Encoding utf8

设置环境变量

设置永久环境变量(用户级别):

[Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY", "***", "User")

设置当前会话环境变量(立即生效):

$env:DEEPSEEK_API_KEY="***"

⚠️ 请将 *** 替换为你实际的 DeepSeek API Key。
设置永久环境变量后,需要重新打开 PowerShell 窗口才能生效。

验证配置

codex --version

然后尝试运行 Codex:

codex "Hello, write a Python hello world program"

如果正常返回结果,说明 DeepSeek 接入成功!

高级配置

切换不同模型:

编辑 ~/.codex/config.toml 中的 model 字段:

# 使用 DeepSeek Coder(代码专用)
model = "deepseek-coder"

# 使用 DeepSeek Chat(通用对话)
model = "deepseek-chat"

# 使用 DeepSeek Reasoner(推理增强)
model = "deepseek-reasoner"

使用 Ollama 本地部署 DeepSeek:

[model_providers.deepseek]
name = "DeepSeek (Ollama)"
base_url = "http://localhost:11434/v1"
env_key = "DEEPSEEK_API_KEY"
wire_api = "responses"

Profile 模式:

Codex 支持使用 Profile 区分不同配置:

codex --profile deepseek-coder "优化这段代码"
codex --profile deepseek-chat "解释这个概念"

🔑 常用环境变量

环境变量 说明 示例
DeepSeek API 密钥 DEEPSEEK_API_KEY sk-xxxx
OpenAI API 密钥 OPENAI_API_KEY sk-xxxx
指定默认模型 CODEX_MODEL deepseek-chat
审批策略 CODEX_APPROVAL_POLICY never / auto
沙箱模式 CODEX_SANDBOX_MODE danger-full-access
HTTP 代理地址 HTTP_PROXY http://127.0.0.1:7890
HTTPS 代理地址 HTTPS_PROXY http://127.0.0.1:7890

🔧 对接飞书

通过 cc-connect 工具,可以将 Codex CLI 与飞书机器人对接。

安装 cc-connect

npm install -g cc-connect

快速配置

cc-connect feishu setup --project my-project

手动配置

创建配置文件 ~/.codex/cc-connect.toml

[feishu]
app_id = "cli_xxxxxxxxxxxxxxxx"
app_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
encrypt_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
verification_token = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

[feishu.bot]
name = "Codex Assistant"
description = "AI 编程助手"

Windows 下可以通过以下命令快速创建:

@"
[feishu]
app_id = "cli_xxxxxxxxxxxxxxxx"
app_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
encrypt_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
verification_token = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

[feishu.bot]
name = "Codex Assistant"
description = "AI 编程助手"
"@ | Out-File -FilePath "$env:USERPROFILE\.codex\cc-connect.toml" -Encoding utf8

飞书应用配置步骤

  1. 登录 飞书开放平台
  2. 创建企业自建应用
  3. 在「权限管理」中开启以下权限:
  4. im:message:receive_v1(接收消息)
  5. im:message:send_v1(发送消息)
  6. im:chat:readonly(读取群信息)
  7. 在「事件订阅」中添加消息接收事件
  8. 将 App ID 和 App Secret 填入配置文件
  9. 发布应用并添加到目标群聊

❓ 常见问题

Q: codex 命令找不到?

A: 请确认安装路径已添加到 PATH 环境变量:

# 查看 codex 安装位置
Get-Command codex -ErrorAction SilentlyContinue

# 如果未找到,尝试手动添加路径
$env:PATH += ";$env:APPDATA\npm"

你也可以在「系统属性 → 环境变量」中手动将 %APPDATA%\npm 添加到 PATH。

Q: DeepSeek 连接失败?

A: 请检查以下几项:

  1. API Key 是否正确设置:echo $env:DEEPSEEK_API_KEY
  2. 网络是否能访问 api.deepseek.comTest-NetConnection api.deepseek.com
  3. 配置文件格式是否正确:Get-Content $env:USERPROFILE\.codex\config.toml
  4. 是否需要设置代理

Q: 如何更新到最新版?

A: 重新运行安装命令即可:

# 官方脚本安装的
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

# npm 安装的
npm update -g @openai/codex

Q: 如何查看当前配置?

A: 使用以下命令查看:

# 查看完整配置
Get-Content $env:USERPROFILE\.codex\config.toml

# 查看当前使用的模型
codex config get model

# 查看所有配置项
codex config list

Q: 为什么选择 DeepSeek 而不是 OpenAI?

对比项 DeepSeek OpenAI (GPT-4)
价格 ¥1/百万 Tokens (输入) $30/百万 Tokens (输入)
中文能力 ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐
代码能力 ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐⭐
推理能力 ⭐⭐⭐⭐ ⭐⭐⭐⭐⭐
国内访问 ✅ 直连 ❌ 需要代理
上下文长度 128K 128K
开源 ✅ 部分开源 ❌ 闭源

对于国内开发者来说,DeepSeek 无需代理、价格低廉、中文友好,是极佳的选择。


📚 常用管理命令速查

说明 命令
查看版本号 codex --version
查看帮助信息 codex --help
登录 OpenAI 账号 codex login
退出登录 codex logout
运行诊断 codex diagnose
查看配置项 codex config get <key>
设置配置项 codex config set <key> <value>
列出所有配置 codex config list
运行 Codex codex "你的指令"

🔗 相关资源

Linux 安装教程

系统要求

操作系统:Ubuntu 20.04+、Debian 11+、CentOS 8+、Fedora 36+ 或其他主流发行版

处理器:x64 架构 CPU

内存:至少 4GB RAM

磁盘空间:至少 500MB 可用空间

网络:需要互联网连接

其他:可选 Node.js 22+(用于 npm 安装)

第一步:安装 Codex CLI

方式一:官方脚本安装(推荐)

curl -fsSL https://chatgpt.com/codex/install.sh | sh

🌏 如果国内访问较慢,可以使用镜像源:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

方式二:通过 npm 安装

npm install -g @openai/codex

🌏 使用国内 npm 镜像:

npm config set registry https://registry.npmmirror.com && npm install -g @openai/codex

💡 如果尚未安装 Node.js,可以使用以下命令安装(以 Ubuntu 为例):

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

第二步:验证安装

安装完成后,运行以下命令验证:

codex --version

如果看到版本号输出(如 codex 1.0.0),说明安装成功。

💡 如果提示命令找不到,请检查安装路径是否在 PATH 中:

export PATH="$HOME/.local/bin:$PATH"

第三步:运行诊断

Codex CLI 内置了诊断工具,可以帮助排查问题:

codex diagnose

该命令会检查:
- 网络连接状态
- API Key 是否有效
- 配置文件是否正确
- 系统环境是否兼容

第四步:登录账号(可选)

如果你有 OpenAI 账号,可以登录以使用官方功能:

codex login

按照提示在浏览器中完成授权即可。


🔧 接入 DeepSeek 大模型

DeepSeek 是一款性价比极高的大语言模型,我们可以将 Codex CLI 配置为使用 DeepSeek 作为后端模型。

获取 API Key

  1. 访问 DeepSeek 开放平台
  2. 注册并登录账号
  3. 进入「API Keys」页面
  4. 点击「创建 API Key」
  5. 复制生成的 Key(仅显示一次,请妥善保存)

创建配置目录

mkdir -p ~/.codex

编辑配置文件

cat > ~/.codex/config.toml << 'EOF'
# ===== DeepSeek 模型配置 =====
model = "deepseek-chat"
model_provider = "deepseek"
model_reasoning_effort = "high"
approval_policy = "never"
sandbox_mode = "danger-full-access"

# ===== 自定义模型提供者 =====
[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com"
env_key = "DEEPSEEK_API_KEY"
env_key_instructions = "从 https://platform.deepseek.com/api_keys 获取 API Key"
wire_api = "responses"
EOF

设置环境变量

echo 'export DEEPSEEK_API_KEY="***"' >> ~/.bashrc && source ~/.bashrc

⚠️ 请将 *** 替换为你实际的 DeepSeek API Key。

验证配置

codex --version

然后尝试运行 Codex:

codex "Hello, write a Python hello world program"

如果正常返回结果,说明 DeepSeek 接入成功!

高级配置

切换不同模型:

编辑 ~/.codex/config.toml 中的 model 字段:

# 使用 DeepSeek Coder(代码专用)
model = "deepseek-coder"

# 使用 DeepSeek Chat(通用对话)
model = "deepseek-chat"

# 使用 DeepSeek Reasoner(推理增强)
model = "deepseek-reasoner"

使用 Ollama 本地部署 DeepSeek:

[model_providers.deepseek]
name = "DeepSeek (Ollama)"
base_url = "http://localhost:11434/v1"
env_key = "DEEPSEEK_API_KEY"
wire_api = "responses"

Profile 模式:

Codex 支持使用 Profile 区分不同配置:

codex --profile deepseek-coder "优化这段代码"
codex --profile deepseek-chat "解释这个概念"

🔑 常用环境变量

环境变量 说明 示例
DeepSeek API 密钥 DEEPSEEK_API_KEY sk-xxxx
OpenAI API 密钥 OPENAI_API_KEY sk-xxxx
指定默认模型 CODEX_MODEL deepseek-chat
审批策略 CODEX_APPROVAL_POLICY never / auto
沙箱模式 CODEX_SANDBOX_MODE danger-full-access
HTTP 代理地址 HTTP_PROXY http://127.0.0.1:7890
HTTPS 代理地址 HTTPS_PROXY http://127.0.0.1:7890

🔧 对接飞书

通过 cc-connect 工具,可以将 Codex CLI 与飞书机器人对接。

安装 cc-connect

npm install -g cc-connect

快速配置

cc-connect feishu setup --project my-project

手动配置

创建配置文件 ~/.codex/cc-connect.toml

[feishu]
app_id = "cli_xxxxxxxxxxxxxxxx"
app_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
encrypt_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
verification_token = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

[feishu.bot]
name = "Codex Assistant"
description = "AI 编程助手"

飞书应用配置步骤

  1. 登录 飞书开放平台
  2. 创建企业自建应用
  3. 在「权限管理」中开启以下权限:
  4. im:message:receive_v1(接收消息)
  5. im:message:send_v1(发送消息)
  6. im:chat:readonly(读取群信息)
  7. 在「事件订阅」中添加消息接收事件
  8. 将 App ID 和 App Secret 填入配置文件
  9. 发布应用并添加到目标群聊

❓ 常见问题

Q: codex 命令找不到?

A: 请确认安装路径已添加到 PATH 环境变量:

# 查看 codex 安装位置
which codex

# 如果未找到,尝试手动添加路径
export PATH="$HOME/.local/bin:$PATH"

如果通过 npm 安装,可能需要:

export PATH="$(npm bin -g):$PATH"

Q: DeepSeek 连接失败?

A: 请检查以下几项:

  1. API Key 是否正确设置:echo $DEEPSEEK_API_KEY
  2. 网络是否能访问 api.deepseek.comcurl -I https://api.deepseek.com
  3. 配置文件格式是否正确:cat ~/.codex/config.toml
  4. 是否需要设置代理

Q: 如何更新到最新版?

A: 根据安装方式选择对应的更新命令:

# 官方脚本安装的
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# npm 安装的
npm update -g @openai/codex

Q: 如何查看当前配置?

A: 使用以下命令查看:

# 查看完整配置
cat ~/.codex/config.toml

# 查看当前使用的模型
codex config get model

# 查看所有配置项
codex config list

Q: 为什么选择 DeepSeek 而不是 OpenAI?

对比项 DeepSeek OpenAI (GPT-4)
价格 ¥1/百万 Tokens (输入) $30/百万 Tokens (输入)
中文能力 ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐
代码能力 ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐⭐
推理能力 ⭐⭐⭐⭐ ⭐⭐⭐⭐⭐
国内访问 ✅ 直连 ❌ 需要代理
上下文长度 128K 128K
开源 ✅ 部分开源 ❌ 闭源

对于国内开发者来说,DeepSeek 无需代理、价格低廉、中文友好,是极佳的选择。


📚 常用管理命令速查

说明 命令
查看版本号 codex --version
查看帮助信息 codex --help
登录 OpenAI 账号 codex login
退出登录 codex logout
运行诊断 codex diagnose
查看配置项 codex config get <key>
设置配置项 codex config set <key> <value>
列出所有配置 codex config list
运行 Codex codex "你的指令"

🔗 相关资源

#Codex #安装 #教程 #DeepSeek #飞书

评论 (0)

0 / 1000