【最新Codex教程】 | 安装、入门和快速使用，适合新手

- - 前言
🕹️【最新Codex教程】 | 安装、入门和快速使用，适合新手
- 🧐一、 Codex 简介
- 🚀二、安装方法
- - 2.1 安装Codex CLI
    - 2.2 安装Codex桌面端（推荐）
- 🎈三、Codex CLI
- 🧑‍💻四、Codex 桌面端
- - 4.1 设置页面（语言、宠物、个性化等）
    - 4.2 布局区域
    - 4.3 工作区管理
    - 4.4 添加插件和技能（重要）
    - 4.5 配置模型，计划模式和追求目标
    - 4.6 权限管理
- ✈️五、账户与订阅
- 💕六、使用技巧
- - 6.1 Codex中一直Reconnecting的解决方案
    - 6.2 常用提示词模板
    - 6.3 使用小窍门
- 总结

前言

目前AI Agent市场可谓是遍地开花，现在最火的就是OpenAI旗下的 Codex 工具了！
老手早就各种Agent手到擒来，玩出花来的都有，而新手却连怎样安装使用都不知道~
本文则带来Codex最新入门教程，以及快速使用方法，绕过复杂冗余的繁琐步骤，针对新手友好的教程。
让感兴趣的小伙伴可以先安装完成、然后快速体验Codex的实用功能，不讲废话直接开始。

🕹️【最新Codex教程】 | 安装、入门和快速使用，适合新手

本文基于 OpenAI 官方文档整理，实际使用以官方页面和账号内提示为准。

🧐一、 Codex 简介

Codex 是 OpenAI 面向软件开发的 coding agent。它可以读取代码、修改文件、运行命令、解释项目结构、修复 bug、生成测试和辅助 code review。

官方文档提到，Codex 可以通过多种方式使用：CLI、IDE、桌面端、移动端。对新手来说，最常用的是 桌面端 和 CLI。

本文主要讲解Codex桌面端的使用方法，也是普通人最容易上手使用的一种方式，比CLI命令行器敲代码的方式要友好的多！

🚀二、安装方法

在开始安装Codex之前需要先安装Node.js，可以简单理解成是一个安装包工具，安装很多工具都推荐先安装这个Node.js。

选择自己电脑的合适版本下载安装即可，node.js安装地址：https://nodejs.org/zh-cn/download

检查Node.js是否已安装：

1node --version
2npm --version
3

2.1 安装Codex CLI

Windows 安装方法

1# 安装命令，需使用管理员模式打开 <终端>
2npm i -g @openai/codex --registry=https://registry.npmmirror.com
3
4# 可升到最新版
5npm i -g @openai/codex@latest
6# 检查安装状态
7codex --version
8

Linux / macOS 安装方法

1npm install -g @openai/codex
2codex --version
3

如果报权限错误，则使用管理员模式安装即可。

2.2 安装Codex桌面端（推荐）

建议安装使用桌面端Codex，相比CLI命令行来说桌面端更容易上手使用。

打开官网下载桌面端即可，根据自己的电脑类型选择不同的下载方式。

下载安装地址如下：https://openai.com/zh-Hans-CN/codex/

Windows用户下载完之后，默认是一个下载器。点击之后还要跳转到微软商店下载，在微软商店安装之后就可以使用了，MAC用户直接下载安装之后即可正常使用。

🧑‍💻如果微软商店无法正常安装，可以参考下面这种安装Codex的方式。

使用 rg-adguard 提取离线包的方式获取安装包，这是豆包姐告诉我的方法，亲测可以正常下载安装。

打开：store.rg-adguard.net

粘贴这个链接：https://apps.microsoft.com/detail/9plm9xgg6vks

选择：Retail → 点对勾

下载 .msixbundle，如果下载不了，可以尝试换个浏览器下载。

使用管理员终端进行安装Codex 主包：
Add-AppxPackage E:\Downloads\OpenAI.Codex_26.527.3686.0_x64__2p2nqsd0c76g0.Msix

安装完之后正常打开使用即可。

选择 Codex 入口

桌面端

CLI

UI图形页面容易上手

命令行窗口操作

🎈三、Codex CLI

安装完Codex首次启动时，会提示登录。

官方文档说明，可以使用 ChatGPT 账号或 API key 进行认证，两种登录方式都可以，选择自己的即可。

CLI的使用方式与其他Agent没有什么区别，首次使用需要设置沙盒环境，其他的功能都是用自然语言描述自己的需求即可，与众多Agent使用方法基本类似。

🧑‍💻四、Codex 桌面端

4.1 设置页面（语言、宠物、个性化等）

设置页面有很多设置，这里介绍一些比较常用的功能，如设置语言、主题、宠物及个性化设置等。

设置语言方法如下：

设置Codex主题如下，有深色和浅色两种设置。

设置宠物方法如下，默认有几种内置宠物，也可以自己创建或者去一些网站下载自己想要的宠物形象！

查看使用情况和计费，在次数可以查看剩余5小时额度和每周额度。

Codex个性化设置，此处与ClaudeCode的CLAUDE.md功能一致，很建议按自己的风格修改一下内容。

这里也给大家推荐一份github上面16万⭐的AI规范：andrej-karpathy-skills

1# CLAUDE.md
2
3Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed.
4
5**Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment.
6
7## 1. Think Before Coding
8
9**Don't assume. Don't hide confusion. Surface tradeoffs.**
10
11Before implementing:
12- State your assumptions explicitly. If uncertain, ask.
13- If multiple interpretations exist, present them - don't pick silently.
14- If a simpler approach exists, say so. Push back when warranted.
15- If something is unclear, stop. Name what's confusing. Ask.
16
17## 2. Simplicity First
18
19**Minimum code that solves the problem. Nothing speculative.**
20
21- No features beyond what was asked.
22- No abstractions for single-use code.
23- No "flexibility" or "configurability" that wasn't requested.
24- No error handling for impossible scenarios.
25- If you write 200 lines and it could be 50, rewrite it.
26
27Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify.
28
29## 3. Surgical Changes
30
31**Touch only what you must. Clean up only your own mess.**
32
33When editing existing code:
34- Don't "improve" adjacent code, comments, or formatting.
35- Don't refactor things that aren't broken.
36- Match existing style, even if you'd do it differently.
37- If you notice unrelated dead code, mention it - don't delete it.
38
39When your changes create orphans:
40- Remove imports/variables/functions that YOUR changes made unused.
41- Don't remove pre-existing dead code unless asked.
42
43The test: Every changed line should trace directly to the user's request.
44
45## 4. Goal-Driven Execution
46
47**Define success criteria. Loop until verified.**
48
49Transform tasks into verifiable goals:
50- "Add validation" → "Write tests for invalid inputs, then make them pass"
51- "Fix the bug" → "Write a test that reproduces it, then make it pass"
52- "Refactor X" → "Ensure tests pass before and after"
53
54For multi-step tasks, state a brief plan:
55
561. [Step] → verify: [check]
572. [Step] → verify: [check]
583. [Step] → verify: [check]
59
60Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification.
61
62## 5. 用户偏好
63
64默认全部使用中文回复，英文特殊词语或关键词除外。
65

其他的设置可以按需挨个打开看下，调整为更适合自己的使用习惯即可。

4.2 布局区域

本文着重来介绍Codex桌面版的使用，页面采用三栏布局。

左侧多功能区可以创建新对话、搜索对话内容、添加插件和技能、自动化(添加定时任务)及Codex移动版(使用手机控制Codex)

中间则是跟网页端类似的功能，正常对话进行问答，右侧则是针对本次会话的任务区域，进行侧边聊天和修改审查等。

4.3 工作区管理

在使用Codex可以使用工作区来区分不同的任务需求，可以新建空白项目，或者使用现有文件夹。

不同的工作内容可以分成多个工作区，这样可以有效管理不同的任务需求。

4.4 添加插件和技能（重要）

可以给Codex添加各种插件和技能，比如很火的HyperFarmes by HeyGen(构建视频)、Remotion(动画)等。

也可以根据自己的需求创建插件和技能，插件和技能使用逻辑与ClaudeCode无太大差异。

插件和技能这里是目前Codex大火的原因之一，有很多非常好用的插件可以一键安装使用。

4.5 配置模型，计划模式和追求目标

Codex可以隐藏两侧边栏，只专注于对话。

右下方可以切换当前使用的模型，左下方则可以使用添加的插件和设置 计划模式、追求目标(goal)模式。

计划模式开启后，可以跟Codex描述一个需求。Codex不会立马执行这个需求，而是会根据这个需求去写一份执行计划，计划写完之后供我们查阅，如果觉得没问题之后再让Codex按这个计划实施即可，计划有问题则可以继续修改。

这样做的好处是需求先告诉AI，让AI充分理解并指定计划之后再真正的做事，可以有效避免AI没能理解我们的需求，或者没有计划步骤的一股脑瞎干活~

追求目标则是给Codex一个大目标，它自己拆步骤、自动做完。
Codex 会自动：分析项目结构，改文件、装依赖，跑测试、修复报错，最后输出结果报告。

4.6 权限管理

codex 是依靠沙箱进行文件管理的，codex 将整个项目文件夹视为一个沙箱进行操作。

共有三种权限可以选择：默认权限、自动审查、完全访问权限。新手建议自动审查即可。

✈️五、账户与订阅

前面讲了Codex常用的两种方式：CLI和桌面端，下面简单提一下账户的几种使用方法。

第一种是官方直连，需要使用魔法去官网注册OpenAI的GPT账号，然后正常购买订阅套餐，在Codex中登录使用就可以了。直连也有几种方式，比如使用Google Play购买套餐，或者苹果土区购买礼品卡等，目前都可正常使用。
第二种则是使用一些AI中转站，目前市面上随便一搜都是各种中转站。优点是国内网络即可正常访问，缺点则是信息不安全，全凭中转站良心操作。

价格与订阅方案

目前GPT提供了多种订阅方案，可根据自己的需求购买。
值得注意的是目前GPT网页端跟Codex中的额度计算是分开的，所以哪怕Codex额度用光了，也可以继续在网页端使用GPT进行对话和生成图片的功能。

套餐/价格	定位	特性
Plus($20/月)	轻量编码需求	每周适合做几个中等规模的编码会话，可在 Web、CLI、IDE 中使用 Codex，以及获得最新模型和扩展使用额度
Pro($100/月)	全职开发者	包含 Plus 的所有内容，5倍Plus使用限额、优先请求处理、更高性能的云任务等能力。
Pro($200/月)	全职开发者	包含 Plus 的所有内容，20倍Plus使用限额、优先请求处理、更高性能的云任务等能力。

💕六、使用技巧

6.1 Codex中一直Reconnecting的解决方案

问题描述：
发起请求后，长时间没有正式输出，中间不断显示 Reconnecting… 1/5、2/5、…、5/5，之后才进入正常回复，或者提示回退到 HTTPS 传输。

这是因为客户端优先尝试 WebSocket 通道，如果跑不通尝试5次之后才会使用HTTPS。

解决方法：
在用户名/.codex/ 文件目录下新增一个.env文件，文件内容如下，换成自己的代理端口即可。

1HTTP_PROXY=http://127.0.0.1:代理端口号
2HTTPS_PROXY=http://127.0.0.1:代理端口号
3

或者把代理开TUN模式也可以解决这个问题。

6.2 常用提示词模板

项目理解

1请阅读当前项目，输出：
21. 项目技术栈；
32. 启动命令；
43. 测试命令；
54. 主要目录说明；
65. 新手应该先看哪些文件。
7不要修改文件。
8

修复 bug

1问题：[粘贴错误现象或报错信息]
2复现步骤：[写清楚如何触发]
3要求：
41. 先定位原因；
52. 只做必要修改；
63. 不重构无关代码；
74. 修改后运行相关测试；
85. 用中文总结。
9

Code Review

1请 review 当前 git diff。
2重点关注：
31. 潜在 bug；
42. 边界情况；
53. 安全风险；
64. 缺少的测试；
75. 是否有无关修改。
8

6.3 使用小窍门

任务越小，结果越稳定。先从单个 bug、单个组件、单个测试文件开始。
先让 Codex 分析，再让它修改。可以明确写“先不要改代码”。
给成功标准。例如“运行 npm test 通过”比“修好它”更清楚。
合并前一定看 diff。尤其是依赖、配置、权限、数据库迁移相关改动。
可以在项目中维护 AGENTS.md，写清团队规范，例如回复语言、测试要求、禁止无关重构等。

总结

本文介绍了Codex的常用两种安装方法，尽量用简介的文本去介绍，防止看起来一团乱码无从下手。
着重介绍了Codex桌面端的常见使用方法，对比命令行的模式，桌面端是非常友好的使用方式了。
文章内容主要面对新手，想快速上手使用Codex时参考使用，更多深度使用方法后续还会继续介绍的！

🎬 博客主页：https://xiaoy.blog.csdn.net

🎥 本文由 呆呆敲代码的小Y 原创 🙉

🎄 学习专栏推荐：Unity系统学习专栏

🌲 游戏制作专栏推荐：游戏制作

🌲Unity实战100例专栏推荐：Unity 实战100例教程

🏅 欢迎点赞 👍 收藏 ⭐留言 📝 如有错误敬请指正！

📆 未来很长，值得我们全力奔赴更美好的生活✨

------------------❤️分割线❤️-------------------------

资料白嫖，技术互助

学习路线指引（点击解锁）	知识定位	人群定位
🧡 Unity系统学习专栏	入门级	本专栏从Unity入门开始学习，快速达到Unity的入门水平
💛 Unity实战类项目	进阶级	计划制作Unity的 100个实战案例！助你进入Unity世界，争取做最全的Unity原创博客大全。
❤️ 游戏制作专栏	难度偏高	分享学习一些Unity成品的游戏Demo和其他语言的小游戏！
💚 游戏爱好者万人社区	互助/吹水	数万人游戏爱好者社区，聊天互助，白嫖奖品
💙 Unity100个实用技能	Unity查漏补缺	针对一些Unity中经常用到的一些小知识和技能进行学习介绍，核心目的就是让我们能够快速学习Unity的知识以达到查漏补缺

《【最新Codex教程】 | 安装、入门和快速使用，适合新手》是转载文章，点击查看原文。