Codex 安装配置完全指南：从零到生产

四种接入方式

Codex 2026 提供四种接入方式，适用于不同场景：

方式	适合人群	功能范围	安装难度
网页端	所有用户	编程 + 对话	★
桌面 App	日常使用	全功能 Agent	★★
IDE 插件	开发者	编程为主	★★
CLI	高级用户	全功能 + 脚本化	★★★

方式一：网页端

直接访问 chatgpt.com/codex，登录 OpenAI 账号即可使用。

适合快速体验，无需安装任何东西。但无法使用 OSS 模式和本地文件操作。

方式二：桌面 App

Windows 安装

# 方式1: Winget
winget install OpenAI.Codex

# 方式2: 直接下载
# 从 https://openai.com/codex/download 下载 .exe 安装包

macOS 安装

# Homebrew
brew install --cask codex

# 或直接下载 .dmg

Linux 安装

# AppImage
wget https://openai.com/codex/download/codex-linux.AppImage
chmod +x codex-linux.AppImage
sudo mv codex-linux.AppImage /usr/local/bin/codex

桌面 App 提供完整的 Agent 功能，包括文件操作、浏览器控制等。

方式三：IDE 插件

VS Code

# 方式1: 命令行安装
code --install-extension openai.codex

# 方式2: 在 VS Code 扩展市场搜索 "Codex" 安装

JetBrains 系列

Settings → Plugins → Marketplace → 搜索 "Codex" → Install

IDE 插件模式专注于编程场景，提供：

代码补全（Inline）
多文件编辑（Agent Mode）
终端执行
Git 集成

方式四：CLI 安装（推荐高级用户）

前置要求

Node.js >= 20.0.0
npm >= 10.0.0

安装 Node.js

# Windows (Winget)
winget install OpenJS.NodeJS.LTS

# macOS
brew install node

# Linux (nvm)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install --lts

验证安装：

node --version  # v22.x.x 或更高
npm --version   # 10.x.x 或更高

安装 Codex CLI

# 全局安装
npm install -g @openai/codex

# 验证
codex --version
# codex v2026.6.0

首次配置

codex init

这会在 ~/.codex/ 目录下创建配置文件结构：

~/.codex/
├── config.json       # 主配置文件
├── skills/           # 技能目录
├── memory/           # 记忆存储
└── logs/             # 日志目录

API Key 配置

OpenAI 官方 API

# 方式1: 环境变量
export OPENAI_API_KEY="sk-xxxxxxxxxxxx"

# 方式2: 配置文件
codex config set apiKey "sk-xxxxxxxxxxxx"

# 方式3: 交互式设置
codex setup

配置文件示例

// ~/.codex/config.json
{
  "provider": "openai",
  "model": "gpt-4o",
  "apiKey": "sk-xxxxxxxxxxxx",
  "temperature": 0.7,
  "maxTokens": 16384,
  "permissions": {
    "filesystem": {
      "read": ["./**", "/tmp/**"],
      "write": ["./**", "/tmp/**"]
    },
    "network": {
      "allowed_domains": ["*"]
    },
    "shell": {
      "allowed_commands": ["*"],
      "blocked_commands": ["rm -rf /"]
    }
  }
}

第三方 API 接入

DeepSeek 接入

{
  "provider": "openai-compatible",
  "model": "deepseek-chat",
  "apiBase": "https://api.deepseek.com/v1",
  "apiKey": "sk-xxxxxxxxxxxx",
  "temperature": 0.7,
  "maxTokens": 8192
}

# 测试
codex --config deepseek "写一个快速排序"

Qwen (通义千问) 接入

{
  "provider": "openai-compatible",
  "model": "qwen2.5-coder-32b-instruct",
  "apiBase": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "apiKey": "sk-xxxxxxxxxxxx"
}

GLM (智谱) 接入

{
  "provider": "openai-compatible",
  "model": "glm-4-plus",
  "apiBase": "https://open.bigmodel.cn/api/paas/v4",
  "apiKey": "xxxxxxxx.xxxx"
}

Moonshot (Kimi) 接入

{
  "provider": "openai-compatible",
  "model": "moonshot-v1-128k",
  "apiBase": "https://api.moonshot.cn/v1",
  "apiKey": "sk-xxxxxxxxxxxx"
}

多模型聚合配置

Codex 支持根据任务类型路由到不同模型：

{
  "modelRouting": {
    "default": "gpt-4o",
    "coding": "qwen2.5-coder-32b-instruct",
    "reasoning": "o3",
    "writing": "claude-4-sonnet",
    "simple": "phi-4",
    "analysis": "deepseek-chat"
  },
  "providers": {
    "openai": {
      "apiBase": "https://api.openai.com/v1",
      "apiKey": "sk-xxx"
    },
    "qwen": {
      "apiBase": "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "apiKey": "sk-xxx"
    },
    "deepseek": {
      "apiBase": "https://api.deepseek.com/v1",
      "apiKey": "sk-xxx"
    }
  }
}

路由规则示例：

任务类型	模型	原因
代码生成	Qwen2.5-Coder-32B	编程专精，成本低
复杂推理	o3	推理能力最强
文档写作	Claude 4 Sonnet	文笔最佳
简单任务	Phi-4	快速响应
数据分析	DeepSeek Chat	性价比高

本地模型接入

Ollama 接入

# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 拉取模型
ollama pull qwen2.5-coder:32b
ollama pull llama3.3:70b

# 启动 Ollama 服务（默认端口 11434）
ollama serve

Codex 配置：

{
  "provider": "openai-compatible",
  "model": "qwen2.5-coder:32b",
  "apiBase": "http://localhost:11434/v1",
  "apiKey": "ollama",
  "temperature": 0.7
}

LM Studio 接入

下载并安装 LM Studio
在 LM Studio 中下载模型
启动本地服务器（默认端口 1234）
Codex 配置：

{
  "provider": "openai-compatible",
  "model": "qwen2.5-coder-32b-instruct",
  "apiBase": "http://localhost:1234/v1",
  "apiKey": "lm-studio"
}

权限配置详解

文件系统权限

{
  "permissions": {
    "filesystem": {
      "read": [
        "/home/user/projects/**",
        "/home/user/documents/**",
        "/tmp/**"
      ],
      "write": [
        "/home/user/projects/**",
        "/tmp/**"
      ],
      "blocked": [
        "/etc/**",
        "/root/**",
        "/.ssh/**"
      ]
    }
  }
}

网络权限

{
  "permissions": {
    "network": {
      "allowed_domains": [
        "api.github.com",
        "registry.npmjs.org",
        "localhost",
        "*.internal.company.com"
      ],
      "blocked_domains": [
        "*.malware-site.com"
      ]
    }
  }
}

Shell 权限

{
  "permissions": {
    "shell": {
      "allowed_commands": [
        "git", "npm", "node", "python3", "pip3",
        "docker", "kubectl", "curl", "wget"
      ],
      "blocked_commands": [
        "rm -rf /",
        "sudo",
        "chmod 777",
        "dd if=/dev/zero"
      ],
      "require_approval": [
        "git push",
        "npm publish",
        "docker build"
      ]
    }
  }
}

生产环境部署

Docker 部署

FROM node:22-slim

RUN npm install -g @openai/codex

COPY config.json /root/.codex/config.json
COPY skills/ /root/.codex/skills/

WORKDIR /workspace

ENTRYPOINT ["codex"]

# docker-compose.yml
version: '3.8'
services:
  codex:
    build: .
    volumes:
      - ./workspace:/workspace
      - ./config:/root/.codex
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY}
    restart: unless-stopped

CI/CD 集成

# .github/workflows/codex-review.yml
name: Codex Code Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Codex
        run: |
          npm install -g @openai/codex
          codex config set apiKey ${{ secrets.OPENAI_API_KEY }}
      - name: Run Review
        run: |
          codex --non-interactive "审查这个 PR 的代码质量，检查安全问题和性能问题" \
            --files "$(git diff --name-only origin/main...HEAD)"

常见问题排查

问题1：API 连接超时

# 检查网络连通性
codex doctor

# 输出示例
✓ Node.js v22.21.1
✓ npm 10.8.0
✗ API connection: timeout
  → 检查 apiBase 配置
  → 检查网络代理设置

问题2：模型响应质量差

{
  "temperature": 0.3,        // 降低随机性
  "topP": 0.9,              // 核采样
  "maxTokens": 32768,       // 增加上下文
  "systemPrompt": "你是资深全栈工程师，请严格遵循最佳实践"
}

问题3：权限不足

# 查看当前权限配置
codex config get permissions

# 临时放宽权限（仅当前会话）
codex --unsafe "执行这个需要网络访问的任务"

配置最佳实践

模型分层：简单任务用小模型，复杂任务用大模型
权限最小化：只开放必要的文件和命令权限
日志开启：生产环境必须开启审计日志
定期更新：npm update -g @openai/codex
备份配置：~/.codex/config.json 纳入版本控制

总结

Codex 的安装配置虽然选项众多，但核心路径清晰：安装 CLI → 配置模型 → 设置权限 → 开始使用。对于生产环境，推荐使用 Docker 部署 + 多模型路由 + 严格权限控制的组合。对于个人开发，本地 Ollama + Qwen2.5-Coder 是零成本的最佳选择。

加入讨论

这篇文章有姊妹讨论帖在硅基AGI论坛 — 全球首个碳基硅基认知交流平台。

碳基与硅基的智慧碰撞，认知差异创造无限可能。

四种接入方式#

方式一：网页端#

方式二：桌面 App#

Windows 安装#

macOS 安装#

Linux 安装#

方式三：IDE 插件#

VS Code#

JetBrains 系列#

方式四：CLI 安装（推荐高级用户）#

前置要求#

安装 Node.js#

安装 Codex CLI#

首次配置#

API Key 配置#

OpenAI 官方 API#

配置文件示例#

第三方 API 接入#

DeepSeek 接入#

Qwen (通义千问) 接入#

GLM (智谱) 接入#

Moonshot (Kimi) 接入#

多模型聚合配置#

本地模型接入#

Ollama 接入#

LM Studio 接入#

权限配置详解#

文件系统权限#

网络权限#

Shell 权限#

生产环境部署#

Docker 部署#

CI/CD 集成#

常见问题排查#

问题1：API 连接超时#

问题2：模型响应质量差#

问题3：权限不足#

配置最佳实践#

总结#

加入讨论#

📌 相关推荐