Codex (GPT) 使用教程

OpenAI 推出的编程 AI 工具，任务完成细致，适合通用编程和代码生成场景

什么是 Codex?

Codex CLI 是 OpenAI 官方推出的命令行编程助手，基于 GPT-5 系列模型，在代码生成、调试和重构方面表现出色。

✨

任务完成细致

OpenAI 出品，对需求理解精准，生成的代码质量高且符合最佳实践

🔧

通用编程能力强

支持 Python、JavaScript、TypeScript、Go、Rust 等主流编程语言

⚡

OpenAI 兼容接口

使用标准 OpenAI API 格式，可无缝对接 XiDao Api 中转服务

前置条件

依赖	最低版本	检查命令
Node.js	18.0+	`node -v`
Git	2.23+	`git -v`

💡

提示如未安装 Node.js，请参考 Claude Code 教程中的安装步骤。

安装 Codex

bash

npm install -g @openai/codex

验证安装：

bash

codex --version

配置 API

Codex 使用 OpenAI 兼容接口，配置方式如下：

macOS / Linux

bash

export OPENAI_API_KEY="sk-你的API_KEY"
export OPENAI_BASE_URL="https://api.xidao.online/v1"

Windows (PowerShell)

powershell

$env:OPENAI_API_KEY = "sk-你的API_KEY"
$env:OPENAI_BASE_URL = "https://api.xidao.online/v1"

⚠️

重要 Windows 的 $env: 方式为临时配置，关闭终端后失效。URL 末尾需要加 /v1

持久化配置（推荐）

将环境变量写入 shell 配置文件（~/.zshrc、~/.bashrc 或 PowerShell Profile）即可持久化。

使用方法

启动交互模式

bash

codex

非交互模式（一次性执行）

bash

codex "帮我写一个快速排序算法"

# 带上下文
codex "解释这个项目的架构" --full-auto

管道输入

bash

cat main.py | codex "找出这段代码的问题并修复"

使用技巧

🎯

明确需求描述

详细描述你的需求，包括期望的编程语言、框架、功能点等，能获得更精准的结果

📝

分步执行复杂任务

对于大型功能，建议拆分为多个小步骤逐步完成，便于审查和控制质量

🔄

迭代优化

首次生成后可以要求调整和优化，如"改用异步方式"、"添加错误处理"等

✅

提示 Codex 与 Claude Code 可以配合使用：用 Codex 进行代码生成，用 Claude Code 进行代码审查和重构。

←

Claude Code 教程

Gemini CLI 教程

→