Codex 是什么

一句话：它是一个住在“黑色窗口”里的 AI 同事，能直接看你电脑上的文件、按你说的话把它们改好。这一页先讲清楚它能帮你做什么、动手前要准备什么 —— 只需要读，暂时不用动手。

它和网页上的聊天 AI 差在哪

你大概用过网页版的聊天 AI：把内容贴进去，它把结果吐出来，你再复制回自己的文件里。搬运工作全是你自己做，30 份 Word 就得来回贴 30 次。

Codex 不一样的地方只有一条，但这一条改变了很多事：它能直接读你电脑上的文件，也能直接把改动写回去。你只要说一句“把这个文件夹里所有 Word 的甲方都换成公司全称”，它自己打开、自己改、自己存。你负责说，它负责动手。

为什么它到处写着“编程助手”

因为它是按“给程序员用”来定位的，介绍里全是代码词。但它真正的本事是“能读文件、能写文件、能听懂人话”，所以处理 Word、Excel、PPT、PDF 一样顺手。你完全不需要会写代码。

下面都是同事们已经在用的真实场景。右边一列是你可以照着说的话 —— 大白话就行，没有“咒语”要背，说得越具体它做得越准。

你想干的事	你可以直接这么跟它说
批量改文件名	把这个文件夹里所有 IMG 开头的照片，按拍摄时间改名成“2026-01-15_001”这种格式
清洗 Excel	把这张表里的重复行删掉，日期统一成 2026-01-15 的写法，再按“部门”这列分组求和
合并 / 拆分 PDF	把这 10 份 PDF 按文件名顺序合成一份；或者：把这份 100 页的 PDF 按章节拆成单独文件
批量改 Word	把所有文档里的“甲方”替换成公司全称，字体字号保持不变，批注和修订别弄丢
生成 PPT	照这份大纲做一份 10 页的 PPT，每页一个标题加三条要点
对比两个文件夹	看看 A 文件夹和 B 文件夹里哪些文件不一样，列个清单给我
让它自己定时干活	写个小脚本，每周一把这个文件夹打包成 zip，名字带上日期

Office 文件要多装一步

处理 Word / Excel / PPT / PDF 需要四个小插件（叫 Skill），工作文件夹里已经带好。Windows 上用一键脚本装的，脚本会替你装好，不用管；Mac 和自己一步步装的，需要手动复制一次，做法见文档处理技能那一页。

命令行、终端、Git Bash、PowerShell —— 这几个词说的都是同一类东西：一个用打字代替鼠标点击的界面。你平时是双击图标，它是打一行字回车，区别就这么大。

你不需要记任何命令。这份手册里要敲的东西都给了可以整行复制的完整形式，选中、复制、粘贴、回车，四步走完。

打错了也不会弄坏电脑。最常见的后果是它回你一行看不懂的英文，重新粘一遍就好。真正会动到你文件的操作，下面那条提醒里说清楚了。

装完之后，启动它只要打一个词：

codex

或者一上来就把问题带上：

codex "帮我看看这个文件夹里都有什么"

回车之后进入的是一个能打字聊天的界面，用起来和微信差不多。它默认在你打开窗口时所在的文件夹里干活，想整理哪个文件夹就在哪儿启动。

它是真的会改文件的

公司发的配置里，默认给了它完整的文件读写权限，并且不再每一步都弹窗问你“可以吗”，这样它才能一口气把活干完。代价是它下手实在，所以养成两个习惯：① 重要文件先复制一份，让它改副本；② 只在自己的工作文件夹里启动，别跑到不认识的目录去。

你的电脑是 Windows 10 / 11（64 位），或者 macOS

这两类系统都支持。怎么查见下面的标签页，一分钟就能确认。太老的系统（比如 Windows 7）装不上，找 IT 换台电脑更省事。
电脑能正常上网

安装过程要从网上把 Codex 本体下载下来，所以必须能联网。如果上网要走代理、或者装东西常被安全软件拦，先跟 IT 打声招呼。
你手上有公司发的“codex 教学”工作文件夹

里面是一键脚本和几个安装包，省得你上网到处找。没收到就找发你资料的同事要一份，不要自己上网搜同名文件下载。

右键点“此电脑”（在桌面上，或者打开文件资源管理器后在左边那栏）→ 选“属性”。在弹出的页面里找“系统类型”那行，写着“64 位操作系统”就没问题。

点左上角的苹果图标 → “关于本机”。能正常打开这个窗口的 Mac 基本都能装，芯片是 Apple 芯片还是 Intel 都行。

打开发给你的那个文件夹（一般在桌面上，名字类似“codex 教学”），对照下表看看齐不齐。齐了就能去下一页开装。

文件	是什么	用来做什么
`install.bat` Windows 专用	一键安装脚本	最省事的路：右键“以管理员身份运行”，粘贴一次密钥，剩下的它全包了
`.msi` 结尾的那个包	Node.js 安装包	Codex 跑起来要的底层环境，可以理解成“车要烧的油”
`.exe` 结尾、名字带 Git 的包	Git 安装包	顺带装一个能打字的黑色窗口（Git Bash），用来启动 Codex
`config.toml`	Codex 的设置文件	告诉它用哪个模型、连到哪个地址、能不能直接动文件
`auth.json`	密钥模板	里面只有一行密钥。一键脚本会拿你输入的那串生成最终版
`skill/` 文件夹	四个文档处理插件	docx / xlsx / pptx / pdf，装上之后它才会处理 Office 文件

缺文件就去要，别上网搜

网上有不少同名但被改过的安装包，装上之后出的问题很难查。少了哪个，直接找发你资料的同事再要一份。

两点补充

密钥不在文件夹里，需要单独找管理员要，形如 sk-xxxxxxxx，装的时候会让你粘一次。另外还有一个不用敲命令、点鼠标就能用的桌面图形版，需要就找管理员要 —— 本站不提供安装包下载。

Mac 同事看这里

一键脚本是 Windows 专用的（.bat 只有 Windows 认），Mac 上跑不了。请按安装那页的 macOS 步骤走，同样是复制粘贴。

一共六页，按顺序写的，从头读一遍约二十分钟。

页	讲什么	什么时候看
1 · 介绍与准备	就是你现在这页	已经看完了
2 · 安装	一键脚本和手动安装两条路，Windows 和 Mac 都有	下一步就看它
3 · 配置文件	`config.toml` 和 `auth.json` 一行一行讲清楚	想换模型、想让它答得更快时再回来
4 · 日常使用	斜杠命令、快捷键、怎么把话说清楚让它一次做对	装完就看，最实用的一页
5 · 文档处理技能	让它真正能改 Word / Excel / PPT / PDF	要拿它办公之前
6 · 出错了怎么办	按症状查：装不上、连不上、跑一半断了	卡住的时候

最省事的读法：先照「安装」那页装好，直接跳到「日常使用」开始干活。中间的「配置文件」不影响使用，想调整时再回头看。

卡住了先自查一下

Codex 自带一个“体检”命令，装完之后哪里不对，它自己就能告诉你个大概：

codex doctor

跑完再翻出错了怎么办那页，通常几分钟就能解决。