Thiết kế UI với Claude Code: Cài đặt Oil UI, Prompt & Review trực quan
Claude Code rất mạnh trong việc đọc cấu trúc repository, chia nhỏ công việc nhiều bước và khởi tạo subagent. Tuy nhiên, nếu thiếu định hướng thiết kế, những prompt như "tạo một landing page hiện đại" vẫn dễ tạo ra dải chuyển màu tím, thẻ lồng nhau và các huy hiệu KPI tự bịa. Cài đặt Oil UI giúp Claude Code có một quy trình thiết kế bài bản: nghiên cứu đúng danh mục sản phẩm, đặt các hướng thị giác khác biệt cạnh nhau để so sánh và kiểm tra trang đã render trên các viewport thực tế.
Điểm chính
Điểm chính 1
Chạy npx skills add oil-oil/oil-ui để cài đặt skill mã nguồn mở miễn phí vào Claude Code mà không khóa dự án vào một thư viện component cố định nào.
Điểm chính 2
Mở đầu prompt bằng sản phẩm, đối tượng người dùng, tác vụ cốt lõi, nội dung thật và viewport mục tiêu (như 1440×900 hoặc 390×844) thay vì các tính từ phong cách mơ hồ.
Điểm chính 3
Với trang mới hoặc làm lại giao diện, hãy yêu cầu Claude Code tạo bảng so sánh HTML đặt cạnh nhau gồm 3 đến 4 hướng thiết kế khác biệt trước khi viết các trạng thái production.
Điểm chính 4
Dùng subagent của Claude Code để chạy blind review trực quan không ngữ cảnh ở mức 100% và 200%, giúp sửa các lỗi giãn cách, độ tương phản và phân cấp trước khi bàn giao.
Giúp khách tham quan xem lịch triển lãm, phòng trưng bày và hiện vật của Ánh sáng & Đồ gốm rồi đặt lịch.

Ánh sáng
& Đồ gốm.
Chạng vạng trên mặt nước
Để ánh chiều phủ kín khung hình. Giữ hiện vật ở gần và tiêu đề serif ở một góc tĩnh lặng.
NHẬT KÝÁNH SÁNG

Nắng trên mặt nước.
Nắng trên đất gốm.
Một triển lãm về đồ vật thường ngày và ánh sáng tự nhiên.
Nhật ký buổi sáng
Mở một tập san triển lãm: lưới báo gom nắng mai, đồ gốm và thông tin tham quan.
Sương sớm.
Ánh sáng êm.

Khung cửa sương mờ
Đặt bức tranh vào một khung cửa giấy mở rộng để gốm men ngọc và mặt nước nhạt có khoảng thở.
Vì sao Claude Code cần một Skill thiết kế chuyên biệt
Khi bạn yêu cầu Claude Code làm một "giao diện SaaS sạch sẽ, hiện đại" mà không có phương pháp đi kèm, model sẽ rơi về giá trị trung bình thống kê từ dữ liệu huấn luyện: một tiêu đề căn giữa kèm nhãn pill phía trên, ba thẻ rộng bằng nhau ở dưới, cùng biểu đồ sparkline trang trí hoặc bộ đếm "+24%" ở góc. Mã nguồn biên dịch bình thường, nhưng giao diện trông giống hệt mọi bản demo AI khác.
Oil UI thay đổi trình tự làm việc đó. Thay vì nhảy thẳng từ prompt sang mã HTML/CSS cuối cùng, Claude Code sẽ nghiên cứu điều gì giúp danh mục sản phẩm dễ hiểu, đưa các hướng thị giác khác biệt lên cùng một bảng so sánh và kiểm tra kết quả render trên trình duyệt thật trước khi chốt hoàn thành.
| Giai đoạn | Prompt một lần trong Claude Code | Quy trình Claude Code + Oil UI |
|---|---|---|
| Điểm xuất phát | Mặc định rơi về lưới thẻ SaaS rập khuôn và bảng màu an toàn | Bắt đầu từ danh mục sản phẩm, tác vụ người dùng và nội dung thật |
| Chọn hướng thiết kế | Chỉ ra một phương án; lệch ý phải prompt lại từ đầu | Tích hợp trang so sánh đặt cạnh nhau ở 1440px hoặc 390px |
| Dữ liệu & nội dung | Thường tự bịa phần trăm và nhãn lấp chỗ | Xây dựng phân cấp quanh trường dữ liệu chuyên ngành thật và lược bỏ chi tiết thừa |
| Kiểm tra chất lượng | Dừng lại ngay khi mã biên dịch xong | Khởi tạo subagent blind review để soi toàn trang và ảnh cắt phóng đại 200% |
Thiết lập trong ba bước
Bạn có thể cài Oil UI ở mức toàn cục cho tài khoản người dùng hoặc cài cục bộ trong repository để cả nhóm dùng chung một quy trình.
Chạy trình cài đặt skill và chọn Claude Code
Chạy lệnh bên dưới trong terminal và làm theo hướng dẫn tương tác để chọn Claude Code cùng phạm vi cài đặt mong muốn.
npx skills add oil-oil/oil-uiĐảm bảo trình duyệt cục bộ có thể render và chụp trang
Việc review trực quan cần ảnh chụp màn hình thật chứ không đoán qua mã nguồn. Hãy chắc chắn Playwright hoặc công cụ tự động hóa trình duyệt trên máy mở được dev server ở kích thước 1440×900 (desktop) và 390×844 (di động).
Nâng cấp lên Oil UI Pro khi cần trọn bộ quy trình
Nếu bạn đã mua Oil UI Pro, hãy cài đặt qua CLI. Khi đã cài Pro, bạn không cần giữ thêm bản mã nguồn mở song song.
npx github:oil-oil/oil-cli install oil-ui-pro
Cách viết UI Prompt giàu tín hiệu cho Claude Code
Hãy xem các tác phẩm dựng bằng Claude trong thư viện — như Margins (trình đọc sách máy tính bảng bởi Claude Opus 5.5), Echo (trợ lý giọng nói bởi Claude Opus 5.5), Pickup (ứng dụng gọi xe bởi Claude Sonnet 5.5) và Pinch Checkout (module thanh toán bởi Claude Sonnet 5.5). Mỗi prompt đều nêu rõ người dùng là ai, tương tác nào giữ vai trò trung tâm và những trạng thái nào bắt buộc phải chạy được.
- Nêu rõ người dùng và tác vụ bằng ngôn ngữ trực diện
- Thay vì yêu cầu một "ứng dụng di chuyển mượt mà", hãy chỉ rõ "luồng gọi xe 390×844 gồm xác nhận ghim điểm đón, theo dõi tài xế đang tới trực tiếp và đổi điểm đến giữa chuyến".
- Chỉ tên tương tác trọng tâm
- Cho Claude Code biết điều khiển hoặc chuyển đổi nào quan trọng nhất: tính lại giá trực tiếp khi áp mã giảm giá, ngăn ghi chú trong trình đọc bài dài hay phản hồi dạng sóng âm ở trợ lý giọng nói.
- Xác định viewport và các trạng thái cụ thể
- Liệt kê đúng kích thước viewport và ba hoặc bốn trạng thái bạn muốn render để agent kiểm tra từng trạng thái trên trình duyệt thật.
Dùng Oil UI để thiết kế giao diện cho [loại sản phẩm, ví dụ: module thanh toán cho hiệu sách độc lập].
- Đối tượng & tác vụ chính: [ví dụ: độc giả xem lại giỏ hàng, chuyển đổi giữa nhận tại cửa hàng và giao tận nơi, áp dụng mã giảm giá và hoàn tất thanh toán]
- Tương tác trọng tâm & trạng thái: Tập trung vào [tương tác chính]. Bao phủ [Trạng thái 1: biểu mẫu mặc định], [Trạng thái 2: tính lại phí giao hàng và giảm giá trực tiếp], và [Trạng thái 3: báo lỗi kiểm tra thẻ tại chỗ và khôi phục].
- Ràng buộc: Giữ nguyên tech stack hiện tại. Nhắm tới 1440×900 trên desktop và responsive xuống chiều rộng 390px.
Hãy đề xuất các hướng thiết kế khác biệt trước để chúng tôi so sánh trước khi tinh chỉnh hướng đã chọn.Thay phần trong ngoặc vuông bằng thông tin thực tế của dự án và dán vào Claude Code.
Chạy Blind Review bằng Subagent trên ảnh chụp thực tế
Một agent vừa viết xong 600 dòng CSS hiếm khi tự nhận ra hai nhãn chữ đang đè lên nhau hay chữ phụ bị thiếu tương phản. Oil UI giải quyết điều này bằng cách để agent chính chụp ảnh màn hình trang đang chạy và chuyển cho một subagent Claude Code hoàn toàn mới, không biết gì về quá trình triển khai.
Subagent đánh giá sẽ kiểm tra ảnh toàn trang ở mức 100%, ảnh cắt 200% tại các cụm điều khiển dày đặc và ảnh làm mờ khối bố cục nhằm lộ ra các bố cục nặng đầu hoặc đơn điệu. Agent chính sẽ sửa các lỗi được báo cáo trước khi bàn giao kết quả cho bạn.
Ví dụ thực tế & prompt trong thư viện
Xem bộ sưu tập →Khi nào nên chuyển từ bản miễn phí sang Oil UI Pro
Skill miễn phí đưa một trang hoàn toàn mới từ khung trống đến một thiết kế sắc nét. Hãy nâng cấp lên Oil UI Pro ($19.99 mua một lần) khi bạn dùng Claude Code để cải tạo ứng dụng production sẵn có, xây dựng workspace desktop mật độ cao hoặc chạy tùy chọn tinh chỉnh sâu blind review tối đa 3 vòng kèm kiểm thử tác vụ đếm lượt bấm.
Khám phá Oil UI Pro →npx github:oil-oil/oil-cli install oil-ui-proCâu hỏi thường gặp
Oil UI có khóa Claude Code vào React, Tailwind hay thư viện UI cụ thể nào không?
Không. Oil UI cung cấp phương pháp thiết kế, tư duy bố cục và các bước kiểm tra trực quan. Claude Code vẫn viết mã và giao diện theo đúng stack hiện có của bạn, dù là Next.js, Vue, Svelte, HTML/CSS thuần hay design system nội bộ.
Claude Opus và Claude Sonnet khác nhau thế nào khi dùng Oil UI?
Opus thường đưa ra quyết định chắc tay hơn về tỷ lệ chữ, nhịp trang và phân cấp biên tập trên toàn trang. Sonnet nhanh hơn và rất hợp để làm các module tập trung, hoàn thiện trạng thái và mở rộng một hướng thiết kế đã chốt.
Tôi có thể đưa cho Claude Code một ảnh chụp tham chiếu để bám theo hoặc biến tấu không?
Có. Hãy truyền đường dẫn ảnh và nói rõ bạn muốn tái tạo sát từng pixel (pixel-diff) hay chỉ mượn tinh thần typography và khoảng thở cho nội dung sản phẩm của mình. Oil UI có quy trình riêng cho cả hai cách.
Làm sao biết Claude Code đang thực sự áp dụng Oil UI?
Hãy đưa cụm "Use Oil UI" (hoặc "Dùng Oil UI") vào prompt. Thay vì đổ ngay mã mẫu chưa chỉnh trang, Claude Code sẽ định khung tác vụ người dùng, đề xuất các hướng thị giác khác biệt hoặc mở bảng so sánh, rồi kiểm tra ảnh chụp màn hình trước khi kết thúc.



