安装、配置和使用指南 - 支持国内直连 API

OpenAI Codex CLI 完整教程#

📖 内容涵盖：

本文详细说明如何安装和配置 OpenAI Codex CLI，结合 SurgeAI 聚合 API，可在国内直接使用，无需配置代理。支持 Windows/Linux/Mac 多平台，并可配置 VS Code 等第三方 IDE。

1. Codex CLI 介绍和系统要求#

什么是 OpenAI Codex？#

系统要求#

2. Codex CLI 安装教程#

安装步骤（以 Ubuntu 为例）#

🎉 恭喜！Codex CLI 安装完成！

macOS 安装方法#

Windows (WSL) 安装方法#

3. Codex CLI 配置教程#

配置 API Key#

推荐：使用 SurgeAI 聚合 API（国内直连）

访问 https://surgeai.zhuoxiang.vip 获取 API Key

✅ 国内直连，无需代理

✅ 支持多种 OpenAI 模型

✅ 价格实惠，按需付费

配置 config.toml#

配置说明：

model：要使用的模型名称（如 gpt-4、gpt-3.5-turbo 等）

model_provider：模型提供商配置

base_url：API 基础地址（使用 SurgeAI 聚合 API）

env_key：环境变量名称

wire_api：API 类型（chat 或 completions）

# 高级配置示例

model = "gpt-5-codex"
model_provider = "openai-response"
temperature = 0.7
max_tokens = 2000

[model_providers.openai-chat-completions]
name = "OpenAI using Chat Completions"
base_url = "https://surgeai.zhuoxiang.vip/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

[ui]
theme = "dark"  # 或 "light"
show_token_count = true

4. IDE 集成配置#

VS Code 集成#

其他 IDE 支持#

5. Codex CLI 快速入门#

初始化项目#

常用命令示例#

常用交互命令#

使用场景示例#

6. 故障排除和常见问题#

常见问题解决方案#

问题： 遇到权限错误 "EACCES: permission denied"

解决方案：

问题： Node.js 版本过低

解决方案：

问题： 无法连接到 API

解决方案：

确认 API Key 配置正确

检查 base_url 配置是否正确

使用 SurgeAI 确保国内直连

验证网络连接：curl https://surgeai.zhuoxiang.vip/v1/models

问题： "Invalid API Key" 错误

解决方案：

验证配置#

调试模式#

7. 高级使用技巧#

1. 自定义提示模板#

2. 批量处理#

3. Git 集成#

4. 配置别名#

8. 最佳实践建议#

9. 资源链接#

官方资源#

第三方资源#

总结#

通过本指南，您已成功：

✅ 了解 OpenAI Codex CLI 的基本概念和功能

✅ 在 Linux/macOS/Windows 系统上安装 Codex CLI

✅ 配置 SurgeAI 聚合 API（国内直连）

✅ 掌握基本使用方法和常用命令

✅ 了解 IDE 集成方法

✅ 学习故障排除和问题解决

✅ 掌握高级使用技巧和最佳实践

🚀 您现在可以开始享受 Codex CLI 带来的高效编码体验了！

需要帮助？#