← 全部教程

Codex CLI

OpenAI 官方命令行智能体。

Codex 走 OpenAI 兼容 API，所以不止能连 api.openai.com。可以直接用 OpenAI 密钥，也可以在配置文件里声明自定义渠道。

官方文档 ↗

配置步骤

1. 1

   安装 CLI

   需要 Node.js 18 及以上，会装上全局命令 codex。

   bash复制

   npm install -g @openai/codex

2. 2

   方式 A：用 OpenAI 密钥

   填入从 OpenAI 平台拿到的密钥。Windows 用 setx 后重开终端。

   bash / zsh复制

   export OPENAI_API_KEY="your-api-key"

   PowerShell复制

   setx OPENAI_API_KEY "your-api-key"

3. 3

   方式 B：添加自定义渠道

   在配置文件里声明一个 OpenAI 兼容端点。env_key 指定存放密钥的环境变量名；多数第三方端点用 wire_api = chat。

   ~/.codex/config.toml复制

   model = "your-model-name"
   model_provider = "custom"
   
   [model_providers.custom]
   name = "Custom"
   base_url = "https://api.example.com/v1"
   env_key = "OPENAI_API_KEY"
   wire_api = "chat"

4. 4

   清除已保存的 ChatGPT 登录

   仅当你之前用 ChatGPT 登录过才需要，这一步会强制 Codex 改用你自己的密钥。

   bash复制

   codex logout

5. 5

   开始使用

   在项目目录里运行，然后开始下达指令。

   bash复制

   codex