claude-code-setup这个开源设置让你把Codex调教得像Claude Code一样好用，包括配置文件、技能迁移、钩子设置等四大招。
我最近用Codex用得特别多，感觉这家伙挺靠谱。但是说实话，一开始我差点被它气到砸键盘。为啥呢？因为我之前用Claude Code用得太舒服了，各种骚操作都配好了，突然换个工具，感觉就像从自动挡换回手动挡，真心不习惯。
后来我发现，原来Codex也能配得跟Claude Code一样香。
第一招搞懂Codex的说明书文件
说到AI编程助手，最基础的东西就是说明书文件。
啥是说明书文件呢？就是你告诉这个AI助手：“嘿，兄弟，我喜欢这么干活，你得记住这些规矩。”然后AI就会按照你的习惯来工作。
Codex用的说明书文件叫AGENTS.md，这玩意儿跟Claude Code用的CLAUDE.md完全是同一个妈生的。意思就是格式一样，用法一样，你原来怎么配Claude Code的，现在照葫芦画瓢配Codex就行。
这个说明书文件还能放好几个地方。你可以放一个全局的，就是你电脑上所有项目都通用的规矩。也可以在每个项目里单独放一个，专门管这个项目的特殊要求。还能在项目里的子文件夹再放一个，管得更细。
Codex有个特别贴心的命令叫/init。你在项目文件夹里输入这个，它就会自动帮你创建一个AGENTS.md文件，里面还给你写好了模板。这个操作跟Claude Code一模一样，所以老用户完全不用学就会。
如果你想要个更省事的办法：使用GitHub上找个叫claude-code-setup的工具。这个工具能帮你自动创建链接，让你的Claude Code和Codex共用同一套配置文件。这样你改一个地方，两个工具都跟着变，特别适合我们这种懒人。
当然了，你也可以自己手动创建AGENTS.md文件。怎么写呢？就跟写普通的Markdown文档一样。写上你最常用的编程习惯，比如“我喜欢用4个空格缩进”、“函数命名要用驼峰式”、“注释要用中文写清楚”之类的。AI看到这些就会照做。
我自己的说明书文件写了大概二十来条规矩，都是平时踩坑总结出来的。比如我规定AI改代码之前要先问我一下，别自作主张。还有规定它解释代码的时候要用大白话，别整那些专业术语装深沉。这些都是实打实能提高效率的好习惯。
第二招看懂Codex的配置文件
配置文件这玩意儿就像你手机的设置中心。
Codex的配置文件叫config.toml，这个就相当于Claude Code里面的settings.json。他们两个干的事儿一模一样，就是存各种默认设置。
比如说你想让Codex默认用哪个AI模型，要不要开深度思考模式，允不允许它自己执行命令，需不需要开沙盒保护，这些都能在配置文件里设好。设好之后就不用每次重复说了，省时省力。
这个配置文件能放在两个地方。一个是全局的，路径是~/.codex/config.toml，这个管你电脑上所有项目。另一个是项目专属的，放在.codex/config.toml里面，这个只对当前项目生效。如果你两个地方都放了，项目级别的会覆盖全局的，更灵活。
那么问题来了，配置文件怎么写呢？Codex早给咱们想好了。你打开终端，在一个新会话里输入/config命令，它就会自动帮你生成一个模板文件。模板里面各种选项都写着注释，告诉你这个是管啥的，那个是干啥的，你看着改就行。
我推荐你重点配置几个地方。首先是默认模型，选你觉得最好用的那个。其次是权限设置，我一般会让AI在执行危险操作前问我一下，免得它把我代码删了。还有就是超时时间，设长一点，这样处理大项目时不会中途断掉。
沙盒模式这个功能特别值得一说。开了沙盒之后，AI执行的命令都在一个隔离环境里跑，就算它干了坏事也伤不到你的系统。就像把熊孩子关在游戏房里玩，随便他怎么折腾，客厅的电视机是安全的。
钩子功能也可以在配置文件里开启。钩子是啥我后面会详细说，你就理解成“出事儿了要通知我”或者“干完活儿要自动做点啥”就行。配置文件里可以指定钩子脚本放哪儿，什么时候触发，触发后干啥。
MCP也是个好东西，简单说就是个万能接口。有了它，Codex就能跟你电脑上的其他工具聊天了。比如你打开个网页，它就能自动读取网页内容。你用个数据库，它就能帮你查数据。这些都要在配置文件里配好。
第三招搬走你的技能包
技能包这个词听着挺唬人，其实说白了就是“特训手册”。
啥意思呢？就是你给AI做了一套专门的训练，让它学会干某个特定的事儿。比如你写个技能包叫“写周报”，AI学了之后就能自动帮你整理这周干了啥，然后写得漂漂亮亮的。再比如你写个技能包叫“修bug”，AI学了之后就会按你的习惯来找问题、分析原因、改代码。
我在Claude Code里攒了不少这种技能包，有些是从网上下载的，有些是自己写的。一开始我还担心换了Codex之后这些就白瞎了，后来发现完全多虑了。
为啥不用担心呢？因为这两个工具用的都是同一个开放标准，叫Agent Skills。这个标准是个公开的玩法，谁都能用，谁都能改。既然标准一样，那技能包自然就能互相通用。就像USB接口一样，不管是哪个牌子的U盘，插哪个电脑上都能用。
具体怎么搬呢？超级简单。你找到Claude Code的技能包文件夹，一般在~/.claude/skills/里面，每个技能包就是一个文件夹。然后把这个文件夹整个复制到Codex的技能包文件夹，也就是~/.codex/skills/里面，搞定收工。
如果你项目里面也放了技能包，同样操作就行。项目级别的技能包一般在项目根目录的.claude/skills/和.codex/skills/里面，把文件夹复制过去就完事。
嫌麻烦的话，还有个偷懒的办法：用GitHub上有个工具叫sync-claude-skills-to-codex，装好之后跑一下命令，它自动帮你把所有技能包从Claude Code同步到Codex，省得你一个一个复制。
更牛的是，Codex社区还有个专门干这活的技能包，名字就叫claude-to-codex。你直接在Codex里安装这个技能包，然后运行它，它就会自动分析你Claude Code里面有哪些技能包，然后一个一个帮你适配过来。这简直就是智能搬运工啊。
当然了，自己写技能包也不难。你就在技能包文件夹里新建个文件夹，名字就是你的技能包名，里面放个SKILL.md文件，写上你这个技能包是干啥的，怎么用，AI看了就懂了。我第一个自己写的技能包是“代码注释翻译”，让AI把我代码里的英文注释改成中文，五分钟就搞定了。
第四招搞挂钩子自动干活
钩子这个名字起得挺形象，就是“钩住某个时刻，然后干点啥”。
打个比方，你写代码的时候经常犯同一个错误，每次AI改了代码你就想跑一下测试看看对不对。那就可以设个钩子，让AI每次改完代码之后自动运行测试，测试结果直接告诉你。这样你就不用每次都手动敲命令了，多爽。
Codex是最近才加上的钩子功能，所以可能没有Claude Code那么全。Claude Code的钩子框架已经很成熟了，啥都能干。Codex这边更侧重命令行操作，也就是主要钩住命令的执行过程。两者有区别，但不是大问题。
好消息是，大部分Claude Code的钩子都能直接拿来用，或者稍微改两下就能用。为啥呢？因为核心思路是一样的，都是跑个脚本，然后传点数据进去，脚本处理完再返回结果。Codex和Claude Code都支持shell脚本和Python脚本，所以你原来写的脚本基本不用动。
具体怎么迁移呢？首先找到你的Claude Code钩子脚本，一般在.claude/hooks/文件夹里，文件大多是.sh或者.py结尾的。把这些脚本文件复制到Codex的钩子文件夹，也就是~/.codex/hooks/或者.codex/hooks/里面。
复制完之后，你需要改一下配置文件。因为Codex的钩子类型可能跟Claude Code不太一样，比如触发时机、参数格式之类的有点差别。不过你别怕，Codex有个很贴心的功能，你启动之后它会检测到配置文件有问题，然后一步一步问你咋改，你跟着提示走就行，基本是傻瓜式操作。
我自己迁移的时候遇到过一个小坑。Claude Code有个钩子是在用户按Ctrl+C的时候触发，用来清理临时文件。到了Codex这边，这个钩子的名字变了，我一开始不知道，死活不生效。后来Codex启动时给了个提示，说“没找到你配置的钩子类型，要不要改成正确的”，我点了个yes就完事了，特别智能。
钩子能做的事儿可多了。你可以让AI每次启动时自动加载你的常用设置。也可以让AI每次回答完问题后自动保存对话记录。还可以让AI在执行危险命令前弹个窗口问你确定不确定。这些都是钩子的功劳，用好了效率蹭蹭涨。
我电脑里现在挂了七八个钩子。有个钩子在AI改完代码后自动跑lint检查，看看有没有语法错误。有个钩子在AI删文件前自动备份一下，防止删错了找不回来。还有个钩子在AI联网搜索后自动保存搜索结果，方便我事后翻看。这些钩子都是我从Claude Code那边搬过来的，改改配置就能用，省了我大把时间。
再送你个终极套餐
看到这儿你可能会说：“哇，这么多东西要配，好麻烦啊。”
GitHub这个项目叫claude-code-setup，作者是petekp，这哥们把Claude Code和Codex的所有配置都整理到一个仓库里了，包括技能包、命令、智能体、钩子、脚本、配置文件，啥都有。
你直接克隆这个仓库，然后运行里面的setup.sh脚本，它会自动帮你把所有东西链接好。Claude Code的配置放到~/.claude/文件夹，Codex的配置放到~/.codex/文件夹，两个工具共用同一套文件，你改一个地方另一个自动同步。
安装脚本会将此仓库符号链接到以下~/.claude/位置~/.codex/：
~/.claude/ ~/.codex/ |
无论在哪个位置编辑文件，它们都是相同的文件。提交并推送即可跨机器同步。
这个套餐牛在哪儿呢？它是可移植的。你把这个仓库克隆到你的每台电脑上，运行一下脚本，所有配置就都一样了。你再也不用担心换电脑之后回忆不起当初都配了啥。你还可以把这个仓库放到GitHub上，改配置就提交一下，换个电脑就拉下来，跟你写代码一样方便。
这个脚本还特别智能，你运行的时候可以加个--undo参数，它就会把所有链接都删掉，恢复成没装之前的样子。所以你想试就试，不想用了随时撤销，不会留下任何垃圾。
我自己就在用这个套餐，真心爽。家里电脑、公司电脑、笔记本，三台机器跑同样的配置，干活的时候感觉特别顺手。有时候我在公司电脑上改了个技能包，提交到GitHub，回家拉下来就能用，无缝衔接。
Codex技能同步
技能会以符号链接的形式单独添加到目录中~/.codex/skills/（Codex 不支持目录级符号链接）。目录中列出的技能codex-exclude会被跳过——这些是Claude特有的技能，会使 Codex 产生混淆。
说在最后的话
回顾一下四大招：第一招搞定说明书文件AGENTS.md，让AI知道你的习惯。第二招看懂配置文件config.toml，给AI定好规矩。第三招搬走技能包，让AI学会干专业活。第四招搞挂钩子，让AI自动干活。最后还送了你一个懒人套餐，一键配置全部搞定。
按照这几步操作，点击标题使用开源claude-code-setup配置，你的Codex就能配得跟Claude Code一样好用了。我自己就是这么干的，现在两个工具换着用，哪个顺手用哪个，效率比以前高了不止一倍。