Cách chuyển từ Claude Code sang Codex trong năm 2026: hướng dẫn từng bước

Tài liệu Ailoot: API, khóa và thiết lập.

Vì sao cần công cụ Migration của Codex?#

OpenAI đã thêm tính năng này vào Codex vào đầu tháng 6 năm 2026. Nhật ký thay đổi chính thức mô tả ngắn gọn như sau:

Nói cách khác: khi bạn khởi chạy Codex App lần đầu hoặc từ phần cài đặt của một ứng dụng khách đang chạy, một trình hướng dẫn sẽ khởi động và đọc cấu hình cục bộ của một agent khác. Hiện tại, Claude Code và Claude Cowork được hỗ trợ.

Lý do OpenAI làm điều này rất rõ ràng. Sau khi Sites ra mắt và Codex App được cập nhật vào tháng 5–6 năm 2026, Codex đã có mọi thứ mà Claude Code từng có lợi thế hơn OpenAI: terminal, plugin, phiên làm việc dài và khả năng điều phối. Việc chuyển đổi xóa bỏ rào cản cuối cùng đối với các nhóm đã tích hợp Claude Code vào stack của mình: "settings được hỗ trợ có thể nhập rồi đối chiếu với inventory gốc."

Lý do bạn có thể cần công cụ này thì không rõ ràng bằng. Tôi đã so sánh trực tiếp hai công cụ trong hướng dẫn Codex và Claude Code: Claude vẫn nhỉnh hơn trong các cuộc thảo luận kiến trúc dài và Plan Mode, còn Codex nhanh hơn với các tác vụ tự động và PR song song. Nếu bạn đã quyết định chuyển hẳn, hãy đọc tiếp. Nếu đang cân nhắc kết hợp cả hai, các cách cộng tác có thể phù hợp hơn.

Công cụ Migration tự động chuyển những gì?#

Tôi sẽ lần lượt trình bày các nhóm và giải thích chính xác điều gì xảy ra với từng phần trong ~/.claude.

1. Hướng dẫn và ngữ cảnh. Các tệp CLAUDE.md — tệp toàn cục trong ~/.claude/ và tệp dự án trong các kho mã — được chuyển sang định dạng AGENTS.md. Tệp toàn cục được đặt tại ~/.codex/AGENTS.md; các tệp dự án vẫn ở thư mục gốc kho mã và các thư mục con. Về cơ bản, định dạng AGENTS.md cũng là một loại tệp Markdown chứa quy tắc; khác biệt chủ yếu mang tính hình thức — tên mục và một vài chỉ thị cụ thể. Tôi đã giải thích AGENTS.md là gì và vì sao Codex cần tệp này.

2. Skills. Toàn bộ thư mục ~/.claude/skills/ được quét; từng skill được điều chỉnh theo cấu trúc Codex và đặt trong $HOME/.agents/skills. Skills của dự án từ .claude/skills/ trong kho mã được chuyển sang .agents/skills. Định dạng SKILL.md có frontmatter được chuyển gần như nguyên trạng. Nếu một skill dùng trình kích hoạt riêng của Claude, skill đó sẽ được đánh dấu để xem xét.

3. Máy chủ MCP. Cấu hình .mcp.json (cả toàn cục lẫn cấp dự án) được nhập sang định dạng Codex. Tên máy chủ, lệnh khởi chạy và đường dẫn được giữ nguyên. Những gì không được chuyển là token và biến môi trường. Vì lý do bảo mật, Codex sẽ yêu cầu bạn nhập lại khóa API và mật khẩu để chúng không bị lộ trong quá trình chuyển đổi. Đây là việc chỉ cần làm một lần: mở mục MCP trong Codex App và nhập các token bạn đã lưu trong trình quản lý mật khẩu.

4. Hooks. Đây là nhóm phức tạp. Hooks có logic xác định (chặn rm -rf, cảnh báo về đường dẫn có dạng thông tin xác thực, ghi lại bằng chứng) được chuyển đầy đủ. Hooks có trình kích hoạt không có chức năng tương đương trong Codex (ví dụ: các sự kiện vòng đời riêng của Claude Code) được đánh dấu là "cần xem xét thủ công" và không tự động kích hoạt. Tôi đã giải thích chi tiết hooks hoạt động như thế nào trong Claude Code để làm điểm tham chiếu — Codex có ít loại hơn.

5. Lịch sử phiên. Hoạt động Claude Code trong tối đa 30 ngày gần nhất được nhập để tham khảo. Điều này không có nghĩa là "tiếp tục chính xác từ nơi bạn đã dừng lại", nhưng các cuộc trò chuyện trước đây sẽ hiển thị trong Codex để bạn nhanh chóng nhớ lại ngữ cảnh dự án mà không phải giải thích lại mọi thứ.

Công cụ Migration không phân biệt tệp đang dùng với sản phẩm thử nghiệm — nó chuyển tất cả. Sau khi chuyển đổi, bạn nên tự dọn những thứ đã không dùng trong sáu tháng qua.

Những gì KHÔNG được chuyển, và vì sao?#

Tôi sẽ lần lượt trình bày từng nhóm theo góc nhìn "cần làm gì sau khi chuyển đổi".

Token MCP và khóa API. Đây là phần dễ đoán nhất. Sau khi quét, Codex sẽ hiển thị danh sách mọi máy chủ MCP tìm thấy trong Claude. Codex sẽ yêu cầu khóa và token cho từng máy chủ. Cách dễ nhất là chuẩn bị trình quản lý mật khẩu và nhập thông tin cho tất cả máy chủ trong một lần. Sau đó, MCP hoạt động giống nhau trong Codex và Claude Code. Hãy đối chiếu lệnh và tham số kết nối của máy chủ MCP bạn chọn với tài liệu của máy chủ đó.

Lệnh slash /name. Trong Claude Code, bạn đã quen gọi một skill bằng /skill-name. Trong Codex, cách gọi chuẩn khác đi: $skill-name. Coi các lệnh /name là bằng chứng skill đã được tải là lỗi chuyển đổi phổ biến.

Sau khi chuyển đổi, hãy thử một vài skills quan trọng bằng $skill-name trong Codex. Nếu chúng hoạt động, việc chuyển đổi thực sự thành công. Đừng tin vào ô đánh dấu "skills migrated" trong trình hướng dẫn — hãy xác minh bằng cách gọi chúng.

Hooks không có chức năng tương đương trong Codex. Nếu bạn có hook cho các sự kiện cụ thể của Claude Code — chẳng hạn hook tại pre-tool-use cho một tổ hợp công cụ cụ thể — trình kích hoạt đó có thể không tồn tại trong Codex. Công cụ Migration sẽ đánh dấu và để chúng ở trạng thái không hoạt động. Bạn sẽ phải quyết định viết lại cho tương đương với Codex, bỏ chúng đi hay giữ chúng trong Claude Code (nếu chạy song song). Một quy tắc hay: chỉ chuyển các hooks có tính xác định; mọi thứ khác là lý do để không nhân bản toàn bộ bộ máy sang công cụ mới.

Quy trình nhóm dựa trên subagents. Tôi đã giải thích subagents trong Claude Code là gì và cách dùng nested subagents. Trong Codex, subagents được tổ chức thông qua profiles và roles (xem bên dưới). Nếu Claude của bạn có một pipeline phức tạp gồm nhiều subagents nối tiếp nhau, bạn sẽ phải viết lại dựa trên khái niệm profile của Codex. Công cụ Migration đánh dấu các thiết lập như vậy là "cần thiết kế lại kiến trúc".

Các tệp CLAUDE.md lớn, đặc thù cho Claude. Nếu một tệp đã dài 2,000–3,000 dòng với các mục cho từng dự án, Codex có thể chấp nhận, nhưng đó là một cách làm không tốt. AGENTS.md được thiết kế để gọn và phân tán: quy tắc toàn cục trong ~/.codex/AGENTS.md, quy tắc riêng của dự án ở thư mục gốc kho mã và các ghi đè hẹp trong thư mục con. Sau khi chuyển đổi, đừng để CLAUDE.md thành một "tệp hướng dẫn khổng lồ"; hãy chia nó theo từng cấp. Tôi đã giải thích cách cấu hình CLAUDE.md đúng cách; cách làm tương tự cũng áp dụng cho AGENTS.md.

Từng bước: 4 thao tác trong Codex App#

Dưới đây là danh sách kiểm tra cụ thể.

1. Bước 1: Cập nhật Codex App lên phiên bản 26.608 trở lên

   Công cụ Migration xuất hiện trong phiên bản 26.608 (phát hành ngày 9 tháng 6 năm 2026). Trên macOS, mở Codex App và kiểm tra bản cập nhật. Làm tương tự trên Windows. Nếu chạy Codex CLI, hãy đảm bảo ứng dụng tương thích với App hiện tại. Nếu không có phiên bản mới nhất, "Import other agent setup" sẽ không xuất hiện trong Settings.

2. Bước 2: Bắt đầu nhập từ Settings

   Trong Codex App, mở Settings và tìm "Import other agent setup." Nếu vừa cài Codex App, trình hướng dẫn sẽ đề xuất chuyển đổi trong quá trình thiết lập ban đầu. Sau khi bắt đầu, trình hướng dẫn quét hệ thống tệp: ~/.claude/ và các kho mã có CLAUDE.md hoặc .claude/. Quá trình quét mất từ 30 giây đến vài phút, tùy số lượng tệp.

3. Bước 3: Xác nhận kế hoạch chuyển đổi

   Sau khi quét, Codex sẽ hiển thị danh mục: tìm thấy bao nhiêu skills, bao nhiêu máy chủ MCP, bao nhiêu tệp CLAUDE.md, những hooks nào đủ điều kiện chuyển đổi và có thể nhập lịch sử phiên trong bao nhiêu ngày. Bạn có thể bỏ chọn bất kỳ nhóm nào không muốn chuyển. Theo mặc định, mọi thứ Codex cho là an toàn để nhập đều được chọn.

4. Bước 4: Chờ hoàn tất và nhập token

   Quá trình nhập mất 1–5 phút. Khi hoàn tất, Codex sẽ mở một cửa sổ tiếp theo: "đây là những gì tôi không thể tự động chuyển; hãy kiểm tra thủ công." Thông thường đó là danh sách máy chủ MCP cần token. Mở trình quản lý mật khẩu và nhập khóa vào biểu mẫu Codex. Sau đó, phần chính của quá trình chuyển đổi đã hoàn tất.

Tiếp theo, xác minh kết quả. Mở một dự án bạn thường làm bằng Claude Code và kiểm tra:

• cat ~/.codex/AGENTS.md — các quy tắc toàn cục của bạn đã ở đó chưa?
• Chạy một skill bất kỳ: $skill-name. Skill đó sẽ được tải.
• Mở .mcp.json trong dự án và kiểm tra các máy chủ cần thiết đang chạy.
• Bắt đầu một cuộc trò chuyện phản ánh cách bạn thường làm việc. Codex sẽ cho biết những hooks được nhập nào không thể sử dụng; đó là các mục inventory cụ thể cần thủ công; không có phần còn lại cố định được xác lập.

Hooks và subagents: các chức năng tương đương trong Codex và những gì cần viết lại#

Hooks. Trong Claude Code, bạn có thể gắn lệnh shell vào từng sự kiện vòng đời (pre-tool-use, post-tool-use, on-error, on-context-load, v.v.). Codex có ít loại sự kiện hơn: có thể kiểm tra trước khi thực thi, ghi lại bằng chứng và chặn lệnh nguy hiểm. Nếu bạn có hook pre-tool-use lọc theo một tổ hợp cụ thể, trong Codex bạn sẽ phải đưa nó vào một bước kiểm tra trước khi thực thi tổng quát hoặc bỏ nó đi. Tôi đã giải thích chi tiết kiến trúc hooks của Claude Code; nếu dùng rộng, liệt kê từng trigger và tác dụng cần, tìm bản tương đương được hỗ trợ và xác minh trước bật.

Subagents. Trong Claude Code, subagent là một ngữ cảnh riêng với system prompt riêng, được khởi chạy thông qua /command hoặc từ cuộc trò chuyện chính. Codex có khái niệm tương tự trong profiles: bạn có thể xác định profile với một bộ skills, quyền hạn và chính sách phê duyệt cụ thể. Profiles giải quyết gần như cùng một vấn đề — cô lập ngữ cảnh cho một nhóm tác vụ cụ thể — nhưng thông qua cài đặt thay vì gọi agent rõ ràng.

Điều này có nghĩa là trong thực tế:

• Nếu bạn có subagent "security-reviewer" với prompt riêng, hãy tạo profile security-review trong Codex với các quyền cần thiết và mức reasoning effort cao hơn.
• Nếu bạn có subagent "feature-developer", đó đơn giản là profile làm việc mặc định; không cần làm gì đặc biệt.
• Nếu bạn dùng nested subagents, cách đó không hoạt động tương đương từng phần trong Codex; hãy thiết kế lại bằng một chuỗi profiles hoặc skills được gọi rõ ràng.

Công cụ Migration sẽ cố tạo profiles bằng tên subagents của bạn và đánh dấu những trình kích hoạt không được chuyển. Công việc tùy số role, trigger, quyền và dependency; thử từng pipeline cần trước coi đã di chuyển.

Khi nào nên chuyển hẳn và khi nào nên giữ cả hai công cụ#

Bộ lọc quyết định đơn giản:

Chuyển hẳn sang Codex hợp lý nếu:

• Bạn chủ yếu thực hiện PR tự động và các tác vụ song song.
• Quy trình GitHub của bạn được tích hợp sâu và Codex Cloud Agent xử lý 80% công việc.
• Bạn không dành nhiều thời gian cho thảo luận kiến trúc và Plan Mode.
• Bạn muốn trả phí cho một công cụ thay vì hai.

Giữ Claude Code và Codex cùng nhau nếu:

• Bạn thường xuyên dùng Plan Mode cho các quyết định kiến trúc dài hạn.
• Bạn cần làm việc song song: Codex chạy trên đám mây với một tác vụ trong khi Claude Code giữ ngữ cảnh cho tác vụ khác.
• Bạn thực hiện nhiều thủ thuật nhất thời và dự án nhỏ, nơi Plan Mode là quá mức cần thiết.
• Bạn có pipeline subagents phức tạp không thể viết lại trong một buổi tối.

Cá nhân tôi dùng cả hai: Claude Code giữ cuộc trò chuyện dài, còn Codex xử lý các việc như "sửa N lỗi song song" hoặc "review một PR". Tôi giải thích thêm về cách này trong hướng dẫn làm việc cùng Claude Code và Codex.

Điều chính tôi muốn nói về việc chuyển đổi là: công cụ Migration xóa bỏ rào cản kỹ thuật để chuyển, nhưng không trả lời câu hỏi liệu ngay từ đầu bạn có cần chuyển hay không. Trước hết hãy quyết định bạn làm loại công việc nào. Sau đó chọn công cụ.

Nếu cần truy cập các mạng nơ-ron thông qua Ailoot, hãy xem Ailoot.