116
论坛 1.0.0 初始管理员账号
116
当前还没有回复，欢迎成为第一个参与讨论的人。
原文来源：腾讯云开发者社区
原文主题：Codex 安装、使用与 API Key 配置全流程
Codex 是 OpenAI 推出的 AI 编程 Agent（智能体），可以理解为一个能真正"进入项目干活"的 AI 程序员。与普通聊天式 AI（如 ChatGPT）只充当"代码顾问"不同，Codex 具备以下核心能力：
OpenAI 官方对 Codex CLI 的定义是：它可以在你选择的目录中读取、修改并运行代码。
| 使用方式 | 适合人群 | 说明 |
|---|---|---|
| Codex CLI（命令行） | 开发者、站长 | 在终端进入项目目录直接运行 codex |
| Codex App（桌面客户端） | 不喜欢命令行的用户 | 支持 worktree、自动化和 Git 功能 |
| IDE 插件 | VS Code / Cursor / Windsurf 用户 | 融入日常写代码流程 |
💡 新手建议：从 Codex CLI 开始上手，安装简单、反馈直观。
brew install gitgit --versionnode --version 和 npm --versionbash# 推荐方式
npm install -g @openai/codex
# macOS / Linux 权限不足时
sudo npm install -g @openai/codex
⚠️ Windows 用户建议以管理员身份运行终端。
bashcodex --version
如果安装后 codex 命令无法识别，尝试以下方案：
| 方案 | 操作 |
|---|---|
| ① 刷新终端 | 关闭并重新打开终端窗口 |
| ② 直接调用 | 使用 npx codex 临时启动 |
| ③ 检查路径 | npm bin -g 确认全局路径已加入环境变量 |
| ④ 重装 Node | 保持默认路径重新安装 Node.js |
Codex 的配置存放在用户主目录下的 .codex 文件夹中：
| 系统 | 路径 |
|---|---|
| Windows | C:\Users\你的用户名\.codex\ |
| macOS / Linux | ~/.codex/ |
text.codex/ ├── config.toml # 主配置文件（接口地址、模型、参数） └── auth.json # 鉴权文件（API Key）
config.tomltomlmodel = "gpt-5" # 默认调用的模型名称
model_provider = "uiuiapi" # 模型服务商标识
base_url = "https://your-api-endpoint.com/v1" # API 接口地址
[model_settings]
reasoning_effort = "xhigh" # 推理强度：xhigh 适合复杂分析
verbosity = "high" # 输出详细程度：high 解释更清楚
web_search = true # 开启联网搜索
use_responses_api = true # 使用 Responses API 模式
[auth]
api_key_file = "auth.json" # 指定鉴权文件
关键参数说明：
| 参数 | 说明 |
|---|---|
reasoning_effort = "xhigh" |
适合代码分析、重构、Bug 排查等复杂任务 |
verbosity = "high" |
新手推荐，输出解释更详细 |
web_search = true |
适合查文档、查报错、版本兼容问题 |
use_responses_api = true |
适配新版 OpenAI 接口兼容模式 |
auth.jsonjson{
"api_key": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
⚠️ 安全提醒：
- Windows 用户务必确认文件后缀是
.json，不是.json.txt- 在文件资源管理器中开启"显示文件扩展名"以避免错误
bash# 进入项目目录
cd /path/to/your/project
# 启动交互模式
codex
text第一步：让 Codex 分析项目（不要直接改代码） → "请分析一下这个项目的整体结构和主要功能" 第二步：确认理解正确后，让它制定方案 → "我想添加 XX 功能，请先给出方案" 第三步：确认方案后，再让它修改代码 → "按方案实施，开始修改" 第四步：每次修改前先 Git 备份 → git commit -m "backup before codex changes"
git commit 备份git reset --hard 回滚| 维度 | 关键结论 |
|---|---|
| Codex 定位 | 不是"代码顾问"，而是"能进项目干活的 AI 程序员" |
| 安装核心 | 先装 Git + Node.js，再用 npm 全局安装 |
| 配置核心 | .codex/config.toml + .codex/auth.json 两个文件 |
| 使用原则 | 先分析 → 再方案 → 确认后修改，不要一上来就大改 |
| 最佳实践 | Codex + API 聚合平台 = 高效的 AI 编程工作流 |
| 安全底线 | 每次修改前 Git 备份，善用回滚 |
📌 一句话总结：Codex 是 OpenAI 面向真实软件开发场景推出的 AI 编程助手，配合合理的 API 配置和安全使用习惯，可以极大提升代码阅读、Bug 排查、功能开发和项目重构的效率。
