Viết và gỡ lỗi Python nhanh hơn 3 lần với Claude Code

Mở terminal của bạn, dùng cd để vào thư mục dự án Python, rồi chạy claude. Vậy là xong. Claude Code sẽ tự động nhận diện dự án Python của bạn bằng cách đọc pyproject.toml, setup.py, requirements.txt, hoặc Pipfile. Nó hiểu cấu trúc dự án, các dependency, và cách tổ chức package của bạn ngay từ lệnh đầu tiên.

Tạo một file CLAUDE.md ở thư mục gốc của dự án với các lệnh đặc trưng cho Python: công cụ chạy kiểm thử (pytest, python -m pytest), linter (ruff check, flake8), công cụ định dạng (ruff format, black), và công cụ kiểm tra kiểu dữ liệu (mypy, pyright). Điều này giúp Claude Code có khả năng tự xác minh công việc của mình sau mỗi lần thay đổi.

Nếu team của bạn sử dụng các mẫu cụ thể, như docstring theo kiểu Google, import tuyệt đối, hoặc một cấu trúc thư mục riêng cho kiểm thử, hãy thêm những quy ước đó vào CLAUDE.md. Claude Code đọc file này trước mỗi lần tương tác, nên nó tạo ra code phù hợp với phong cách của dự án bạn ngay từ đầu. Điều này giúp loại bỏ việc phải sửa đi sửa lại các lựa chọn về phong cách sau khi đã viết xong.

Claude Code hiểu hệ thống kiểu dữ liệu dần (gradual typing) của Python. Nó có thể thêm type hint vào các codebase chưa có kiểu dữ liệu, sửa lỗi mypy và pyright, và sử dụng các mẫu kiểu dữ liệu nâng cao như TypeVar, Protocol, ParamSpec, và Generic khi phù hợp. Nó biết khi nào nên dùng str | None thay vì Optional[str] tùy theo phiên bản Python mà bạn đang hướng tới.

Claude Code tạo ra các docstring phù hợp với phong cách của dự án bạn, theo định dạng Google, NumPy, hoặc Sphinx. Nó đọc phần triển khai của hàm, hiểu các tham số, kiểu dữ liệu trả về, và các trường hợp biên, rồi viết tài liệu thực sự mô tả hàm đó làm gì, không phải là văn bản mẫu chung chung. Nó có thể thêm docstring cho toàn bộ một module chỉ trong một lần.

Claude Code tuân theo thiết lập virtual environment của bạn, bất kể bạn dùng venv, poetry, pipenv, conda, hay uv. Nó đọc các file dependency của bạn để biết package nào có sẵn và ở phiên bản nào, nên nó sẽ không bao giờ gợi ý dùng một thư viện mà bạn chưa cài, hoặc viết code dựa trên một API đã thay đổi ở phiên bản mới hơn.

Mô tả endpoint mà bạn cần, ví dụ "Tạo một endpoint POST /api/users nhận tên và email, xác thực định dạng email, lưu vào database, và trả về người dùng đã tạo với trạng thái 201", và Claude Code sẽ viết route, model Pydantic (hoặc serializer của Django), câu truy vấn database, và phần xử lý lỗi. Nó đọc code hiện có của bạn để làm theo đúng mẫu: nếu các endpoint khác của bạn dùng dependency injection, endpoint mới cũng sẽ như vậy.

Claude Code có thể dựng khung một API CRUD hoàn chỉnh chỉ từ mô tả một data model. Nó tạo ra model, route, schema xác thực, migration database (dùng Alembic hoặc Django), và các file kiểm thử. Mỗi file được tạo ra đều theo đúng cấu trúc dự án của bạn, nếu route của bạn nằm ở app/api/v1/ và model nằm ở app/models/, Claude Code sẽ đặt các file vào đúng chỗ của chúng. Nó cũng kết nối các route mới với instance ứng dụng hiện có của bạn và thêm các mã trạng thái HTTP cùng phản hồi lỗi phù hợp.

Sau khi xây dựng endpoint, hãy yêu cầu Claude Code viết bài kiểm thử. Nó sẽ tạo ra các bài kiểm thử pytest bao quát đường chạy thuận lợi, lỗi xác thực, xử lý trùng lặp, lỗi xác thực danh tính, và các trường hợp biên. Với các dự án FastAPI, nó dùng httpx.AsyncClient cùng với các fixture kiểm thử phù hợp. Với Django, nó dùng APIClient cùng với dữ liệu kiểm thử dựa trên factory. Sau đó nó chạy các bài kiểm thử để xác minh mọi thứ đều đạt trước khi bạn commit.

Claude Code có thể đọc và hiểu các file Jupyter notebook (.ipynb), phân tích kết quả của các cell, và giúp bạn gỡ lỗi code trong notebook. Tuy nhiên, Claude Code hoạt động từ terminal, nên nó hoạt động tốt nhất khi bạn tách logic của notebook ra thành các script hoặc module Python. Với việc khám phá dữ liệu, nhiều developer dùng Claude Code để viết code phân tích trong các file .py rồi import vào notebook để trực quan hóa.

Claude Code hoạt động với tất cả các framework Python chính: Django, FastAPI, Flask, Starlette, và Tornado cho phát triển web; pandas, NumPy, polars, và scikit-learn cho data science; pytest, unittest, và hypothesis cho kiểm thử; SQLAlchemy, Tortoise ORM, và Django ORM cho truy cập database; Celery và Dramatiq cho hàng đợi tác vụ. Nó đọc các dependency của dự án bạn để hiểu bạn đang dùng framework nào và áp dụng các mẫu riêng cho framework đó.

Claude Code tự động phát hiện cấu hình virtual environment của bạn. Nó đọc pyproject.toml, requirements.txt, Pipfile, và poetry.lock để hiểu các dependency của dự án bạn. Khi chạy kiểm thử hoặc script, nó tuân theo thiết lập của dự án bạn. Bạn có thể thêm lệnh kích hoạt virtual environment và công cụ chạy kiểm thử của bạn vào file CLAUDE.md để Claude Code dùng đúng môi trường cho mỗi lần thao tác.

Có. Claude Code rất mạnh trong việc viết pipeline chuyển đổi dữ liệu, các phép toán pandas, câu truy vấn SQL, và code phân tích thống kê. Nó có thể đọc file CSV, hiểu schema dữ liệu, viết logic làm sạch và chuyển đổi dữ liệu, và tạo ra các biểu đồ trực quan bằng matplotlib hoặc plotly. Với các pipeline dữ liệu phức tạp, nó giúp chia nhỏ các phép biến đổi nhiều bước thành các hàm dễ đọc, có thể kiểm thử, thay vì dồn vào một cell notebook khổng lồ.

Yêu cầu Claude Code viết bài kiểm thử pytest cho các hàm của bạn bằng cách mô tả hành vi mong đợi. Nó đọc các mẫu kiểm thử hiện có, fixture, và conftest.py của bạn để tạo ra các bài kiểm thử phù hợp với phong cách của bạn. Hãy dùng quy trình TDD: mô tả hành vi trước, để Claude Code viết bài kiểm thử, rồi triển khai code để bài kiểm thử đó đạt.

Có. Claude Code có thể trích xuất hàm, đổi tên biến trên nhiều file, chuyển class thành dataclass, thêm type hint, tái cấu trúc cách tổ chức module, và hiện đại hóa code cũ. Nó đọc toàn bộ dự án của bạn để hiểu các dependency trước khi thực hiện thay đổi, và chạy bộ kiểm thử của bạn sau khi refactor để xác minh không có gì bị hỏng.