Codex 新手入门：安装、建项目文件夹、装技能和插件

这篇写给完全没用过 Codex 的人。Codex 更新很快，个别菜单名称可能和你看到的略有不同，遇到对不上的地方，以官方文档为准。

一、Codex 是什么？

简单说：Codex 是 OpenAI 做的 AI 编程助手。你用中文告诉它「帮我做一个询盘报价表」「把这个网站首页改成蓝色」，它会自己读文件、改文件、跑命令，你只需要检查结果。

对做外贸的人，它能帮你：

• 搭建和修改独立站、做小工具
• 批量处理表格、整理客户资料、写脚本
• 把重复的事（比如批量生成产品描述）做成一键流程

它有两种用法，新手建议用第一种：

用法	特点
Codex 桌面应用	有图形界面，点点鼠标就能用，最适合新手
Codex 命令行（CLI）	在终端里输入命令使用，熟悉之后更灵活

二、准备工作

1. 一个 ChatGPT 账号（Plus / Pro 等付费计划可以直接使用 Codex，具体额度看官方说明）。
2. 一台电脑（Windows 或 Mac 都可以）。
3. 命令行版需要先装 Node.js（去 nodejs.org 下载 LTS 版本，一路下一步即可）。

三、安装并登录

方式一：桌面应用（推荐）

1. 打开 OpenAI 官网的 Codex 页面，下载对应系统的应用并安装。
2. 打开后选择 Sign in with ChatGPT，在浏览器里登录你的账号。
3. 登录成功就可以用了。

方式二：命令行

打开终端（Windows 用 PowerShell，Mac 用「终端」），输入：

npm install -g @openai/codex

装完后，输入下面的命令启动：

codex

第一次启动会让你选择登录方式，选 Sign in with ChatGPT，浏览器里确认即可。

四、建一个自己的项目文件夹

Codex 是在一个文件夹里工作的。它只能看到、修改你打开的那个文件夹，所以第一步是给每件事建一个独立文件夹。

1. 新建文件夹

在电脑上随便找个位置，新建一个文件夹，名字用英文或拼音，不要有空格，比如：

D:\work\my-b2b-site

建议一个项目一个文件夹：独立站一个，报价工具一个，客户资料整理一个，互不干扰。

2. 用 Codex 打开它

• 桌面应用：点「打开文件夹 / Open project」，选中刚才的文件夹。
• 命令行：先进入文件夹，再启动：

cd D:\work\my-b2b-site
codex

3. 说出你的第一个需求

直接用中文写，越具体越好。比如：

我是做户外家具出口的。请在这个文件夹里建一个简单的英文公司介绍网页，
包含公司介绍、3 个产品、联系方式，风格简洁专业，做好后告诉我怎么在浏览器里打开。

Codex 会先说它打算怎么做，再动手。不确定的操作它会问你是否同意，看不懂就别点同意，先问它「这一步是干什么的」。

4. 给文件夹写一份「规则说明」：AGENTS.md

在项目文件夹里放一个叫 AGENTS.md 的文本文件，Codex 每次打开这个文件夹都会先读它。里面写你希望它长期遵守的规则，比如：

# 项目说明
这是一个出口户外家具的英文独立站。

# 规则
- 所有对外的文字用英文，我和你沟通用中文。
- 改文件前先告诉我你要改什么。
- 不要删除任何图片文件。
- 产品价格以 FOB 美元为准。

这份文件就像给新员工的入职手册，写得越清楚，它越少犯错。不会写也没关系，直接对 Codex 说「帮我为这个项目生成一份 AGENTS.md」。

五、安装 Skill（技能）

Skill 是什么？

Skill 就是一份写好的操作手册，教 Codex 怎么稳定地完成某一类任务。比如「写 SEO 文章的标准流程」「做询盘回复」。装上之后，你说一句话，它就会按这份手册做，效果比每次重新解释稳定得多。

一个 Skill 本质上是一个文件夹，里面有一个 SKILL.md：

my-skill/
└── SKILL.md

SKILL.md 开头写名字和用途，后面写步骤：

---
name: inquiry-reply
description: 用于回复海外客户的询盘邮件，语气专业友好
---

1. 先判断客户的需求类型（询价 / 样品 / 合作）
2. 回复里必须包含：感谢、直接回答问题、下一步动作
3. 英文邮件控制在 150 词以内

怎么装？

方法一（最省事）：直接让 Codex 帮你装。

请帮我安装一个 Skill，名字叫 inquiry-reply，作用是……（写出你的需求）

方法二（手动）：把整个 Skill 文件夹复制到 Codex 的技能目录。

• 只给当前项目用：放在项目文件夹里的技能目录
• 所有项目都能用：放在用户目录下的 .codex 文件夹的 skills 里（Windows 一般是 C:\Users\你的用户名\.codex\skills）

装完后重新打开 Codex，输入 /skills（或在对话里直接说出 Skill 名字）就能看到并使用它。

提示：不同版本的技能目录位置可能有调整，拿不准时，直接问 Codex「我的 Skill 应该放在哪个目录」，它会告诉你当前版本的位置。

六、安装插件和外部工具（MCP）

Codex 默认只能处理你电脑上的文件。想让它连接外部服务（查网页、读 Google 文档、操作邮箱、看设计稿），就需要接入「插件 / MCP 工具」。

图形界面（推荐）

在桌面应用的设置里找到 插件 / Plugins 或 MCP 页面，从列表中选需要的，点连接，按提示登录授权即可。

命令行

用 codex mcp add 添加，比如添加一个官方文档查询工具：

codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp

也可以直接编辑配置文件 ~/.codex/config.toml（Windows 在 C:\Users\你的用户名\.codex\config.toml）。

安全提醒

• 只装来源可信的插件和 Skill。 它们能让 Codex 访问你的文件和账号，来路不明的不要装。
• 连接邮箱、网盘这类敏感服务时，授权范围能小就小。
• 涉及发邮件、发消息、删除文件的动作，保持「每次询问我」，不要全自动放行。

七、新手常用的 5 个习惯

1. 一次只说一件事。 把大需求拆成小步骤，做完一步看一步。
2. 先让它列计划。 在需求前加一句「先告诉我你的方案，我同意后再动手」。
3. 改之前备份。 重要文件夹先复制一份，或者让 Codex 用 Git 做版本记录，改坏了能回退。
4. 报错就把错误原文发给它。 复制粘贴整段报错，说「帮我解决」，大多数问题它能自己修。
5. 不懂就问。 「这是什么意思」「为什么要这样做」，它会用大白话解释。

八、一页纸速查

我想……	怎么做
开始一个新项目	新建文件夹 → 用 Codex 打开
让它长期记住规则	项目里写 AGENTS.md
让它按固定流程干活	装对应的 Skill
让它连外部服务	装插件 / 添加 MCP
做错了想撤回	提前备份，或用 Git 回退
看不懂它在干嘛	直接问「这一步是干什么的」

下一步

先别想太大，今天就做一件小事：新建一个文件夹，让 Codex 帮你做一个公司英文介绍页。跑通一次，你就入门了。后面再逐步加 AGENTS.md、Skill 和插件，一点点把它变成你的外贸助手。

有卡住的地方，欢迎到会员群里提问。