ChatGPT Codex官网
首页 Codex使用教程正文

从安装到实战：手把手教你用Codex AI代理操作电脑

codex编辑2026-04-22 09:50:3741

Codex不再是那个只会补全代码的“小助手”，它已经成长为能看懂你的屏幕、操作你的软件、连接90多种开发工具的数字同事。本文将带你从零开始，将它配置成你的专属开发伙伴。

开篇摘要：2026年4月，OpenAI Codex完成了一次里程碑式的进化，从“代码生成器”蜕变为真正的“环境操作代理”。它现在可以直接在你的电脑后台运行，查看屏幕、操作鼠标键盘、通过SSH连接服务器，并集成了从Jira到GitLab的90多个开发工具。本教程将彻底解析如何安装、配置并高效利用这个“数字员工”，重塑你的开发工作流。

一、 认识全新的Codex：它远不止是“高级ChatGPT”

你可能听说过Codex，但很多人对它存在误解。现在的OpenAI Codex与2021年驱动GitHub Copilot的模型已完全不同，它是一个完整的、能自主行动的软件工程智能体（Coding Agent）。

简单说，它不再只是“聊天并给出代码建议”，而是能真正“读懂项目、修改文件、运行测试、提交补丁”的AI程序员。

Codex的四大使用入口，你该如何选择？

根据你的使用场景，Codex提供了四种主要方式，其特点和推荐场景如下：

  1. Codex CLI（命令行工具）：本地运行，功能最全、最灵活。适合追求极致效率、喜欢在终端工作的开发者。它是本次“后台操作”能力的核心载体之一。

  2. Codex IDE 扩展（VS Code / Cursor）：在编辑器内无缝集成。优势是能直接预览代码差异（Diff），边聊边改，适合日常编码任务。

  3. Codex Web（云端版）：通过 chatgpt.com/codex 访问。每个任务在独立的云端沙箱中运行，适合需要长时间计算或大规模重构的异步任务。

  4. Codex 桌面应用：本次升级的主角。它实现了多代理并行、后台电脑操作（Computer Use）和庞大的插件生态，是向“数字团队”演进的核心。

本教程将聚焦于功能最强大的CLI和桌面应用环境，因为它们是解锁“操作电脑”能力的关键。

640 (3).webp

二、 实战准备：环境搭建与核心配置

在让Codex“接管”你的电脑之前，必须打好地基。别急，我们一步步来。

第一步：满足基础环境要求
请确保你的系统符合以下条件，这是稳定运行的前提：

  • 操作系统：macOS 12+， Ubuntu 20.04+/Debian 10+，或 Windows 11（强烈建议使用WSL2以获得最佳体验）。

  • Node.js：版本需要 v22 或更高（一些早期教程提到的v18已不适用）。

  • Git：虽然不是强制，但强烈推荐安装。Codex与Git深度集成，所有修改都可追溯，这是最重要的安全网。

第二步：安装Codex CLI核心组件
打开你的终端（Windows用户请使用WSL2终端或Git Bash），执行以下命令进行全局安装：

npm install -g @openai/codex


安装完成后，用以下命令验证是否成功：

codex --version


如果正确显示版本号（例如 @openai/codex, 0.79.0），说明核心安装成功。

第三步：关键配置——连接AI模型（以第三方API为例）
Codex的强大能力需要后端模型驱动。除了使用OpenAI官方账户登录，更灵活的方式是配置第三方API（如教程中提到的神马中转、LinoAPI等）。所有配置都存放在用户目录下的 .codex 文件夹中。

  1. 创建配置文件：

    • Windows：路径为 C:\Users\你的用户名\.codex\

    • macOS/Linux：路径为 ~/.codex/
      如果该文件夹不存在，请手动创建。然后在其中创建两个文件：auth.json 和 config.toml。

  2. 编辑 auth.json：在此文件中填入你的API密钥。

    {   "OPENAI_API_KEY": "sk-xxx...你的真实密钥" }


  3. 编辑 config.toml：这是控制模型和行为的核心。以下是一个连接第三方服务的配置示例：

    # 指定模型提供商，必须与下面的段名一致 model_provider = "your_provider_name" # 指定使用的模型，如最新的 gpt-5.3-codex 或 gpt-5.4[3](@ref)[7](@ref) model = "gpt-5.3-codex" # 将推理努力程度设为“high”，以获得最深度的思考和分析[2](@ref)[8](@ref) model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" # 定义模型提供商详情 [model_providers.your_provider_name] name = "your_provider_name" # 替换为你的第三方API网关地址 base_url = "https://api.example.com/v1" wire_api = "responses"


    ⚠️ 重要：修改配置后，必须完全重启终端，新的配置才会生效。

三、 解锁核心能力：像人类一样操作数字世界

配置完成后，你便拥有了一个基础版的Codex。但要让其发挥“操作电脑”的威力，你需要了解并主动使用它的高级模式和功能。

1. 后台电脑操作（Background Computer Use）
这是本次升级的质变核心。Codex可以通过视觉感知（截图）和模拟输入来与你的操作系统交互。

  • 如何启用：这通常是Codex桌面应用的内置能力，或通过特定的启动参数和插件激活。在CLI中，结合 --search 等参数可以增强其环境感知能力。

  • 它能做什么：

    • 前端开发闭环：直接打开浏览器，查看页面效果，修改CSS，刷新验证，无需你在中间手动复制粘贴。

    • 操作无API的GUI应用：处理那些没有开放接口的遗留系统或桌面软件。

  • 安全边界：此功能仍处于“alpha”阶段，OpenAI强调需要在旁监督。所有敏感操作都应在沙箱（sandbox）环境中运行，这是保障系统安全的关键机制。

2. 90+插件生态：打造你的数字团队
Codex集成了海量工具，从一个“单体助手”变成了“团队协调者”。

  • 涵盖范围：从项目管理（Jira）、代码托管（GitLab）、CI/CD（CircleCI）、部署（Render）到数据库（Neon）等。

  • 实战工作流示例：你可以命令Codex：“修复登录页面的性能问题。”它会自动执行：查看Jira工单 → 拉取代码分析 → 修改并提交PR → 触发CI测试 → 部署到预发环境 → 生成报告通知团队。你从执行者变成了指挥官。

3. 内置浏览器与图像生成

  • 内置浏览器：允许你在Codex内直接打开网页进行标注和指令下达，极大提升了前端和测试任务的精度。

  • 图像生成（gpt-image-1.5）：Codex可以调用模型生成和迭代图像。这意味着你可以在一个流程内完成“产品概念图 → UI设计 → 前端代码”的完整原型开发。

4. 三种批准模式：控制你的“数字员工”
根据你的信任程度，Codex提供不同级别的自主权，这是控制风险的核心开关：

  • 建议模式（suggest）：默认模式，最安全。Codex只提供修改建议，任何文件写入和命令执行都需要你手动批准。

  • 自动编辑模式（auto-edit）：Codex可以自动读写文件，但在执行命令前仍需你批准。在版本控制（Git）环境下工作时推荐此模式。

  • 全自动模式（full-auto）：最高效也最危险。Codex完全自主运行。务必仅在Git仓库中且你准备充分时使用，以便随时回滚。

四、 高阶技巧与实战心法

喂养项目专属知识：AGENTS.md
这是让Codex从“通用助手”变为“项目专家”的秘诀。在项目根目录创建 AGENTS.md 文件，它会成为Codex的长期记忆和行动准则。

# AGENTS.md ## 项目规范 - 代码风格：遵循ESLint + Prettier规则。 - 组件命名：使用PascalCase。 - 提交信息：采用Conventional Commits格式。 ## 常用命令 - 启动：`npm run dev` - 测试：`npm test`


你也可以在 ~/.codex/ 下创建全局的 AGENTS.md 来定义个人偏好。

“满血”启动命令与别名设置
想要一次性解锁Codex最强状态？可以使用这条组合命令：

codex -m gpt-5.3-codex -c model_reasoning_effort="high" --search --dangerously-bypass-approvals-and-sandbox


为了避免每次输入长命令，你可以在Shell配置文件（如 ~/.zshrc 或 ~/.bashrc）中设置别名（alias）：

alias codex_full='codex -m gpt-5.3-codex -c model_reasoning_effort="high" --search'


保存后执行 source ~/.zshrc，之后只需输入 codex_full 即可满血启动。

给新手的实战工作流建议

  1. 从“只读”开始：先用 codex “请总结这个项目的目录结构和主要模块，先不要修改文件。” 让它熟悉环境。

  2. 小范围试水：分配明确、可审查的小任务，如 codex “只修改 src/components/Button.tsx 中的颜色变量。”

  3. 加入验证环节：codex “修复utils.js中的那个TypeError，修复后运行相关的单元测试并告诉我结果。”

  4. 逐步放开权限：从 suggest 模式开始，随着信任建立，逐步尝试 auto-edit，最后在安全环境下谨慎使用 full-auto。

最后的忠告
OpenAI写道：“Codex can now operate your computer alongside you.” 这个 alongside（并肩） 是关键。AI代理的到来，不是取代开发者，而是将我们的角色从“码农”提升为“架构师”和“指挥官”。

适应新时代的关键，在于培养任务分解与委托的能力，以及快速评估AI产出质量的判断力。这场由Codex引领的变革，其学习曲线将决定未来五年开发者的竞争力分层。现在，就从安装和配置开始，迈出与你的“数字同事”并肩作战的第一步吧。


本文链接：https://www.chatgpt-codex.com/Ai/19.html

Codex AI代理Codex AI

相关文章

网友评论