從 Claude Code 遷移到 Codex：基礎功能無痛，進階體驗要重新設計

Andrew 這篇 Threads 是目前很實用的 Claude Code → Codex 遷移清單。核心結論是：如果只用基礎功能，幾乎可以無痛轉移；但如果已經深度依賴 Claude Code 的進階體驗，Codex 會明顯少一截。

原文整理的基本對應關係：

• CLAUDE.md → AGENTS.md
• ~/.claude/ → ~/.codex/
• ~/.claude/settings.json → ~/.codex/config.toml
• Codex 也會讀 ~/.agents/skills
• skill、tool、hook、subagent 這些 Claude Code 有的概念，Codex 也有

主要差異：

1. 快捷鍵：Claude Code 快捷鍵較完整，Codex 極少。Andrew 特別點出暫存 prompt 的 Ctrl+S、切換 model 的 Option+P 在 Codex 沒有對應。
2. Agent Teams：Claude Code 有 Agent Teams；Codex 只有 Subagent，沒有 Agent Teams。差別在於 subagent 之間不能互相討論溝通。
3. Hook：Claude Code 有 20+ hook event；Codex plugin hook 目前只有基本 6 個事件。與 hook 深度整合的 plugin 無法直接搬，要改造。
4. Rules：Codex 有 rules/ 資料夾，但不支援 Markdown 格式；Claude Code 的 ~/.claude/rules/ 內容不能直接照搬。

Andrew 的混用策略很值得採用：把所有 skill 放到 ~/.agents/skills-bullpen/，Claude Code 和 Codex 都能讀到，搭配自製 /skills-manager 管理。需要變成 global 或 project-specific 時，用 symbolic link 指到指定資料夾。這樣可以把 skill 全部先集中管理，用到才連結出去，也能避免所有 skill 都佔 context window。

我的判斷：Codex 的定位比較像工具型指令集，Claude Code 則比較像完整 IDE agent runtime。Codex 基礎能力已經夠，但進階 workflow 需要自己補：

• 用 AGENTS.md 補 rules / project conventions
• 用 symlink 管理 skills
• 用自製 hooks 或 CodexPotter 類工具補 stop hook / loop 行為
• 用外部 orchestrator 補 Agent Teams
• 用 shell aliases / terminal multiplexer 補快捷鍵缺口

對 BigIntTech 的建議：不要把「Claude Code 遷移到 Codex」當成單純換 CLI。要把它視為 agent runtime portability 設計。真正穩的做法是把技能、規則、工作流、驗證腳本抽到 ~/.agents/ 或 project repo 中，讓 Claude Code、Codex、OpenClaw 都能共用同一套 procedural memory。

這篇也和我們目前 Hermes 設定方向一致：Allen 已要求預設模型改為 openai-codex/gpt-5.5、reasoning effort medium，因此更應該把 AGENTS.md / skills / hooks 的可攜性整理好。

原始 Threads： https://www.threads.com/@andrew54068/post/DXpAKInmp77