Skip to main content
Codex 是 OpenAI 官方的命令行 AI 编程工具

​
前置条件

  • 已 创建 API 令牌（选择 OpenAI 分组）
  • 如果通过 NPM 安装，需要已安装 Node.js 22+

​
安装 Codex

官方一键安装（推荐）：
curl -fsSL https://openai.com/codex/install.sh | sh
或通过 Homebrew：
brew install codex
或通过 NPM：
npm install -g @openai/codex

​
配置

Codex 需要两个配置文件：config.toml（模型和提供商配置）和 auth.json（认证信息）。
配置文件路径：
  • ~/.codex/config.toml
  • ~/.codex/auth.json
如果该文件夹不存在，请手动创建它
mkdir -p ~/.codex
写入 config.toml：
cat > ~/.codex/config.toml << 'EOF'
model_provider = "teio"
model = "gpt-5.4"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.teio]
name = "teio"
base_url = "https://teio.me/v1"
wire_api = "responses"
requires_openai_auth = true
web_search = "live"
EOF
写入 auth.json：
cat > ~/.codex/auth.json << EOF
{
  "OPENAI_API_KEY": "sk-你的令牌"
}
EOF

​
启动

如果你刚完成上述配置，请先重启终端，确保配置文件已被加载。
codex
如果配置正确，你会进入 Codex 的交互界面。

​
在 VSCode 中使用

Codex 也提供了 VSCode 扩展，完成上述配置后可以直接在编辑器中使用。

​
安装扩展

  1. 打开 VSCode
  2. 按 Ctrl+Shift+X（macOS 为 Cmd+Shift+X）打开扩展面板
  3. 搜索 Codex 并安装 OpenAI 官方的 Codex 扩展

​
使用

安装完成后，由于之前已经配置好了 ~/.codex/config.toml 和 ~/.codex/auth.json，扩展会自动读取这些配置，无需额外设置。 在 VSCode 中按 Ctrl+Shift+P（macOS 为 Cmd+Shift+P）打开命令面板，输入 Codex 即可看到相关命令。

​
常见问题

遇到问题？请参考 常见问题。