Sẽ mở trong thẻ mới
PDL AIAI Worker — trợ lý AI trực 24/7: trả lời khách, xử lý yêu cầu, báo cáo tự động
Thứ 2 – Thứ 7 · 8h–18h0961 330088Zalo
Công cụ AI, Hướng dẫn Claude

Claude Code sửa lỗi website WordPress: quy trình an toàn từ log lỗi đến review diff

Phú DigitalĐăng 14.10.2026Cập nhật 11.10.2026≈ … phút đọc
Cận cảnh màn hình tối hiển thị mã PHP với mảng trả về thông báo lỗi và thành công, chữ màu cam, vàng, xanh

Cập nhật tháng 10/2026. Claude Code cập nhật rất thường xuyên, tên chế độ và phím tắt có thể khác đôi chút. Hãy đối chiếu với tài liệu chính thức dẫn ở cuối bài.

Bài này dành cho ai: người quản trị WordPress, freelancer và đội kỹ thuật nhỏ đang giữ theme con hoặc plugin tự viết, muốn nhờ AI sửa lỗi mà không làm sập website.

Bạn sẽ nắm được gì: quy trình 6 bước từ cài đặt, đọc log lỗi PHP và console, chọn chế độ xin phép, plan mode đến review diff; cách viết CLAUDE.md ngắn; 3 câu lệnh mẫu, lỗi thường gặp và bài tập.

Thời gian đọc: khoảng 12 phút, thực hành thêm 45–60 phút trên bản staging.

Bài Hướng dẫn toàn diện về Claude Code 2026 đã giải thích tư duy agentic. Bài này đi vào một tình huống cụ thể: website WordPress báo lỗi sau khi cập nhật, người viết code ban đầu đã nghỉ. Claude Code đọc lỗi, tìm nguyên nhân, đề xuất bản sửa nhỏ nhất; bạn giữ quyền quyết định ở mọi bước.

Cận cảnh màn hình tối hiển thị mã PHP với mảng trả về thông báo lỗi và thành công, chữ màu cam, vàng, xanh
Lỗi WordPress thường nằm trong vài dòng PHP của theme con hoặc plugin tự viết.

1. Claude Code là gì và khi nào nên dùng cho WordPress

Claude Code là tác tử lập trình của Anthropic, chạy trong Terminal, VS Code, JetBrains hoặc ứng dụng Claude trên máy tính. Khác với dán code vào khung chat, nó đọc cả thư mục dự án, chạy lệnh kiểm tra, sửa nhiều tệp, và hỏi bạn trước việc có rủi ro.

Với WordPress, công cụ này phù hợp nhất khi phần code là của bạn:

Theme con

functions.php, template ghi đè, CSS, JS riêng: nơi hay lỗi nhất sau khi cập nhật theme cha.

Plugin tự viết

Tính phí ship, đồng bộ đơn hàng, thêm trường cho form; thường thiếu tài liệu và test.

Đoạn code chèn thêm

Hook, shortcode, JS chèn footer: nhỏ nhưng dễ xung đột khi plugin khác cập nhật.

Đừng để Claude Code sửa trực tiếp plugin hoặc theme thương mại của bên thứ ba: bản cập nhật sau sẽ ghi đè. Hãy nhờ Claude giải thích nguyên nhân rồi xử lý bằng hook trong theme con. Các lỗi WordPress phổ biến và cách xử lý thủ công có trong bài Tổng hợp một số lỗi website WordPress.

2. Chuẩn bị: gói nào dùng được, staging và git

Claude Code cần tài khoản Claude Pro, Max, Team, Enterprise hoặc tài khoản Console (trả theo API); gói Free không có. Máy cần macOS 13+, Windows 10 1809+, Ubuntu 20.04+ hoặc Debian 10+, RAM từ 4 GB.

Ba thứ cần có trước khi cho AI chạm vào code:

  • Bản staging: bản sao website chạy trên máy bạn hoặc tên miền phụ của hosting. Không để Claude sửa trực tiếp website đang chạy.
  • Git cho thư mục theme con hoặc plugin: git init rồi commit trạng thái hiện tại, để mọi thay đổi hiện rõ trong diff và quay lại được. Xem thêm những lệnh Git hay sử dụng.
  • Bản sao lưu cơ sở dữ liệu: xuất trước khi thử, vì có lỗi nằm ở dữ liệu.

3. Quy trình 6 bước sửa lỗi an toàn

1

Cài Claude Code và mở đúng thư mục

Trên macOS, Linux hoặc WSL, chạy lệnh chính thức curl -fsSL https://claude.ai/install.sh | bash; trên Windows PowerShell: irm https://claude.ai/install.ps1 | iex. Mở Terminal mới, gõ claude --version để kiểm tra. Sau đó vào thư mục theme con hoặc plugin (ví dụ wp-content/themes/ten-theme-con), gõ claude và đăng nhập trên trình duyệt.

2

Bật log lỗi PHP trên staging

Trong wp-config.php của staging, đặt WP_DEBUG và WP_DEBUG_LOG là true, WP_DEBUG_DISPLAY là false để lỗi ghi vào wp-content/debug.log. Tái hiện lỗi rồi lấy 50–100 dòng cuối của log. Với lỗi giao diện, mở DevTools của Chrome, tab Console, chép thông báo đỏ kèm tên tệp và số dòng.

3

Chọn chế độ xin phép phù hợp

Nhấn Shift+Tab để đổi chế độ; thanh trạng thái cho biết chế độ đang bật. Từ bản 2.1.283, phiên mới mặc định ở auto mode: một mô hình phân loại tự duyệt thao tác thay bạn. Với website khách hàng, người mới nên chuyển sang Manual (hỏi trước khi sửa tệp, chạy lệnh) hoặc plan, chỉ dùng acceptEdits khi đã tin hướng sửa. Có thể khởi động bằng claude --permission-mode plan.

4

Cho Claude chẩn đoán trong plan mode

Ở plan mode, Claude đọc tệp, tìm kiếm và viết kế hoạch nhưng không sửa mã nguồn cho tới khi bạn duyệt. Dán log kèm bước tái hiện; Claude trả về nguyên nhân dự đoán, tệp cần sửa và các bước. Bạn duyệt, hoặc yêu cầu lập lại kế hoạch. Cũng có thể gõ /plan ở đầu một câu lệnh.

5

Sửa, kiểm tra và review diff

Sau khi duyệt, Claude sửa tệp. Yêu cầu nó chạy php -l để kiểm tra cú pháp, rồi bạn tái hiện lỗi trên staging và xem debug.log. Cuối cùng chạy git diff, đọc từng dòng thay đổi. Nếu sai hướng, gõ /rewind hoặc nhấn Esc hai lần để quay lại; tính năng này không hoàn tác thay đổi do lệnh shell gây ra, nên git vẫn là lưới an toàn chính.

6

Đưa lên website thật theo quy trình của bạn

Commit với mô tả rõ lỗi gì, sửa ở đâu. Sao lưu website thật, đưa đúng các tệp đã đổi lên, xoá cache rồi kiểm tra trên máy tính và điện thoại. Claude Code không cần quyền vào máy chủ thật.

Một người vừa xem điện thoại vừa gõ laptop đang mở trình soạn mã trên bàn tròn cạnh cốc cà phê
Đọc diff trước khi commit là bước không thể bỏ qua, dù bản sửa chỉ có vài dòng.

4. Viết CLAUDE.md ngắn cho dự án WordPress

CLAUDE.md là tệp hướng dẫn Claude đọc đầu mỗi phiên. Gõ /init để Claude tạo bản đầu, rồi rút gọn. Anthropic khuyên giữ mỗi tệp dưới 200 dòng; càng cụ thể, Claude càng làm theo nhất quán. Nếu dự án đã có AGENTS.md cho Codex, Claude Code đọc được tệp đó khi không có CLAUDE.md. Bản đủ dùng cho theme con:

# Theme con cho website bán lẻ
– WordPress 6.x, PHP 8.2, theme cha: [tên theme cha]. KHÔNG sửa thư mục theme cha và wp-content/plugins.
– Chỉ sửa trong thư mục này. Không đổi tên hàm đang được hook ở nơi khác.
– Kiểm tra cú pháp: php -l <tệp>. Log lỗi: ../../debug.log (chỉ đọc).
– Escape mọi dữ liệu in ra (esc_html, esc_attr, esc_url). Form phải kiểm tra nonce.
– Không ghi vào cơ sở dữ liệu, không đọc wp-config.php.
– Mọi thay đổi liên quan thanh toán: chỉ đề xuất, chờ người duyệt.

CLAUDE.md là hướng dẫn, không phải hàng rào. Muốn chặn hẳn một thao tác, thêm luật deny trong .claude/settings.json hoặc qua lệnh /permissions; luật deny có hiệu lực ở mọi chế độ.

5. Ba câu lệnh mẫu

Dán vào Claude Code, sửa phần trong ngoặc vuông cho đúng dự án.

Mẫu 1: Trang trắng sau khi cập nhật theme cha

Sau khi cập nhật theme cha lên [phiên bản], trang chủ staging bị trắng, trang quản trị vẫn vào được.
Đây là 60 dòng cuối của debug.log:
[dán log]
Việc cần làm:
1. Tìm trong theme con đoạn code gây lỗi Fatal error trong log, giải thích vì sao bản cập nhật làm nó lỗi.
2. Đề xuất bản sửa nhỏ nhất, giữ nguyên tính năng hiện có.
3. Chưa sửa tệp nào, trình bày kế hoạch trước.
Giới hạn: không sửa theme cha, không thêm plugin.

Mẫu 2: Nút thêm vào giỏ không phản hồi trên điện thoại

Trên điện thoại, bấm nút Thêm vào giỏ ở trang sản phẩm không có gì xảy ra. Trên máy tính vẫn bình thường.
Console của Chrome (giả lập điện thoại) báo:
[dán lỗi console, kèm tên tệp và số dòng]
Hãy tìm đoạn JS liên quan trong assets/js/ của theme con, giải thích nguyên nhân và sửa. Sau đó liệt kê các trang tôi cần thử lại.

Mẫu 3: Rà soát bảo mật plugin nội bộ trước khi bàn giao

Rà soát plugin trong thư mục này trước khi bàn giao cho khách. Chỉ báo cáo, không sửa.
Tập trung vào: form thiếu nonce, dữ liệu đầu vào chưa làm sạch, truy vấn SQL không dùng $wpdb->prepare, dữ liệu in ra chưa escape, endpoint AJAX hoặc REST thiếu kiểm tra quyền.
Trả về bảng: mức độ, tệp, dòng, mô tả, cách sửa đề xuất.

6. Ví dụ minh hoạ: shop mỹ phẩm ở Đà Nẵng

Tình huống giả định: shop mỹ phẩm dùng WooCommerce, theme con do freelancer viết từ 2023. Sau khi cập nhật, trang thanh toán báo lỗi. Người quản trị tạo staging qua công cụ của hosting, commit thư mục theme con vào git, bật debug log và đặt thử một đơn để lấy dòng Fatal error. Ở plan mode với mẫu 1, Claude chỉ ra hàm trong theme con trùng tên với hàm mới của theme cha, đề xuất đổi tên kèm cập nhật lời gọi hook. Duyệt kế hoạch, Claude sửa 2 tệp; người quản trị thử lại, đọc diff rồi đưa đúng 2 tệp lên website thật. Suốt quá trình, Claude Code không có mật khẩu quản trị và không chạm vào máy chủ thật.

Nữ kỹ sư cầm laptop đứng giữa các tủ máy chủ trong phòng dữ liệu ánh đèn xanh
Sửa trên staging, kiểm tra kỹ rồi mới đưa lên máy chủ thật.

7. Lỗi thường gặp và cách khắc phục

Claude không tìm thấy tệp gây lỗi

Thường do mở sai thư mục, hoặc lỗi nằm trong plugin khác. Xem đường dẫn tệp trong log; lỗi ở plugin bên thứ ba thì chỉ nhờ Claude giải thích.

Claude sửa quá tay, đổi cả những chỗ không liên quan

Ghi rõ “chỉ sửa tối thiểu, không định dạng lại tệp” và dùng plan mode để thấy phạm vi trước. Nếu đã lỡ, dùng /rewind hoặc git checkout tệp đó.

Sửa xong trên staging nhưng website thật vẫn lỗi

So sánh phiên bản PHP, plugin, theme cha giữa hai môi trường và xoá cache (plugin cache, CDN). Môi trường khác nhau là nguyên nhân phổ biến nhất.

8. So sánh ngắn với Codex

Bài OpenAI Codex cho đội nhỏ nhấn mạnh giao việc chạy nền trên đám mây và review pull request bằng @codex. Thế mạnh của Claude Code trong tình huống này là làm việc tương tác trên máy bạn: plan mode, chế độ xin phép và /rewind giúp kiểm soát từng bước. Hai công cụ cùng dùng tệp hướng dẫn (CLAUDE.md, AGENTS.md) nên có thể dùng song song; hãy thử cả hai trên cùng một lỗi thật.

9. Bài tập thực hành

  1. Tạo staging, git init thư mục theme con, mở Claude Code, gõ /init và rút gọn CLAUDE.md còn dưới 20 dòng.
  2. Cố ý xoá một dấu chấm phẩy trong functions.php, lấy log, dùng mẫu 1 ở plan mode và so sánh kế hoạch của Claude với nguyên nhân bạn biết.
  3. Chạy mẫu 3 cho một plugin nội bộ. Ghi lại mục nào đúng, mục nào báo nhầm.

10. Thuật ngữ cần biết

  • Permission mode (chế độ xin phép): thiết lập quyết định Claude Code được tự làm gì mà không hỏi bạn. Nguồn: Choose a permission mode.
  • Plan mode: chế độ Claude chỉ nghiên cứu và đề xuất kế hoạch, không sửa mã nguồn cho tới khi bạn duyệt. Nguồn: Analyze before you edit with plan mode.
  • Checkpoint: ảnh chụp trạng thái tệp trước mỗi câu lệnh, cho phép quay lại bằng /rewind; không thay thế git. Nguồn: Checkpointing.
  • WP_DEBUG_LOG: hằng số trong wp-config.php ghi lỗi PHP vào tệp debug.log thay vì hiện ra trang. Nguồn: Debugging in WordPress.

11. Tìm hiểu thêm

12. Câu hỏi thường gặp

Có nên cho Claude Code kết nối thẳng vào hosting để sửa nhanh hơn?

Không nên. Sửa trên staging có git, kiểm tra kỹ rồi tự đưa lên: chậm hơn vài phút nhưng an toàn hơn nhiều.

Gói Pro có đủ để sửa lỗi hằng tuần không?

Tuỳ khối lượng. Hạn mức của Claude và Claude Code tính chung, theo phiên 5 giờ và theo tuần; thường xuyên chạm hạn mức thì cân nhắc gói Max. Xem trang hỗ trợ chính thức.

Đọc tiếp

PDL Digital đào tạo và triển khai AI cho đội kỹ thuật doanh nghiệp, từ thiết lập Claude Code, viết CLAUDE.md đến quy trình staging và review an toàn. Xem trang đào tạo để chọn khoá phù hợp.

AI lập trình, Claude Code, sửa lỗi website, WordPress
Tác giả
Phú Digital
Đội ngũ PDL Digital — triển khai website, giải pháp AI và digital marketing cho doanh nghiệp.
Tư vấn 1:1

Bạn đang có bài toán số cần gỡ?

Website · AI · Quảng cáo · 360VR — chuyên gia PDL phản hồi trong giờ làm việc (T2–T7, 8h–18h).
Xem giải pháp
<script src="https://cdn.jsdelivr.net/npm/page-flip/dist/js/page-flip.browser.js"></script>

<div id="container-flipbook" style="display:flex; justify-content:center;">
    <div id="my-flipbook">
       <div class="page"> <img src="https://pdl.vn/wp-content/uploads/2025/05/AI-Google-Search.jpg" /> </div>
       <div class="page"> <img src="https://pdl.vn/wp-content/uploads/2025/05/wearable-tech-advertising.jpg" /> </div>
       <div class="page"> <img src="https://pdl.vn/wp-content/uploads/2025/05/multimodal-embeddings-digital-marketing.jpg" /> </div>
    </div>
</div>
#my-flipbook {
    box-shadow: 0 0 20px rgba(0,0,0,0.2);
    margin: 20px auto;
    background-color: #f0f0f0;
}

.page {
    background-color: white;
    overflow: hidden;
}

.page img {
    width: 100%;
    height: 100%;
    object-fit: cover; /* Giúp ảnh vừa vặn trang sách */
}
// Đảm bảo thư viện đã sẵn sàng
function initFlipbook() {
    const el = document.getElementById("my-flipbook");
    if (!el || !window.St) return; // Nếu chưa thấy thư viện St thì thoát

    const pageFlip = new St.PageFlip(el, {
        width: 550,
        height: 733,
        size: "stretch",
        minWidth: 315,
        maxWidth: 1000,
        minHeight: 420,
        maxHeight: 1350,
        showCover: true,
        maxShadowOpacity: 0.5,
    });

    pageFlip.loadFromHTML(document.querySelectorAll(".page"));
}

// Chạy khởi tạo
if (document.readyState === 'complete') {
    initFlipbook();
} else {
    window.addEventListener('load', initFlipbook);
}
PDL · Tư vấn 1:1

Nhận tư vấn
miễn phí

Để lại thông tin, chuyên viên PDL sẽ liên hệ để hiểu nhu cầu và đề xuất giải pháp phù hợp ngân sách của bạn.

  • Phân tích nhanh hiện trạng website, quảng cáo, kênh bán hàng
  • Đề xuất lộ trình & báo giá minh bạch, rõ từng hạng mục
  • Không ràng buộc: nghe tư vấn xong mới quyết định
Giờ làm việc T2–T7 · 08:00–18:00
☎0961 330 088💬Chat Zalo

Chỉ mất khoảng 30 giây

Bạn cần tư vấn về

🔒 Thông tin được bảo mật, chỉ dùng để PDL liên hệ tư vấn.