Claude Code hiện là một trong những trợ lý lập trình dạng dòng lệnh (CLI agent) xuất sắc nhất hiện nay. Điểm hạn chế lớn nhất là chi phí token API khá tốn kém và các gói thuê bao định kỳ thường xuyên chạm trần giới hạn sử dụng.
Dự án mã nguồn mở Free Claude Code (FCC) ra đời nhằm tháo gỡ hoàn toàn bài toán này. Công cụ giúp các lập trình viên tận dụng nguồn cấp hơn 1.3 tỷ token miễn phí mỗi tháng để trải nghiệm đầy đủ sức mạnh của Claude Code mà không phát sinh bất kỳ khoản phí nào.
1. Bản Chất Của Free Claude Code Là Gì?
Free Claude Code (FCC) là dự án mã nguồn mở độc lập do lập trình viên Ali Shahryar phát triển theo giấy phép AGPL-3.0. Về mặt kiến trúc, FCC đóng vai trò như một Proxy Server cục bộ thông minh.
Thay vì kết nối trực tiếp đến API trả phí của Anthropic, FCC đón nhận toàn bộ luồng lệnh từ client và điều hướng (routing) sang các nhà cung cấp mô hình miễn phí hoặc có dung lượng thử nghiệm cực lớn. Toàn bộ cơ chế phản hồi theo luồng (streaming), khả năng chạy công cụ tự động (tool calling) và chuỗi suy luận phân tầng (interleaved thinking) của agent đều được bảo toàn trọn vẹn.
2. Những Tính Năng Vượt Trội Của FCC
Không chỉ là công cụ chuyển đổi đường dẫn API, FCC mang đến bộ tính năng toàn diện cho lập trình viên:
- Hỗ trợ đồng thời 12 AI Coding Harness: Chạy linh hoạt Claude Code, Codex, Cline, Pi, OpenCode, Aider, Antigravity CLI hay VS Code Chat.
- Tích hợp 61+ nhà cung cấp mô hình: Khai thác từ NVIDIA NIM, OpenRouter, Google AI Studio, Groq, Cerebras cho đến các mô hình mã nguồn mở chạy local như Ollama, LM Studio hay llama.cpp.
- Tiết kiệm đến 90% lượng token: Tích hợp bộ giải pháp RTK (Rust Token Killer) và Headroom giúp tinh gọn ngữ cảnh và lược bỏ triệt để token dư thừa.
- Cơ chế chịu tải và chuyển tiếp thông minh: Tự động retry khi mạng chập chờn, kiểm soát rate limit và tự động nhảy sang mô hình hoặc API Key dự phòng (fallback) nếu đầu phát sinh lỗi.
- Trải nghiệm đa nền tảng: Sử dụng qua Terminal, giao diện trình duyệt Web UI, extension IDE, hoặc giao việc từ xa qua Telegram và Discord bằng tin nhắn thoại.
3. Hướng Dẫn Cài Đặt Chi Tiết Từng Bước
Quá trình thiết lập FCC diễn ra rất nhanh chóng thông qua các câu lệnh tự động hóa trên từng hệ điều hành.
Bước 1: Chạy lệnh cài đặt tự động
- Dành cho Windows (PowerShell):
& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1')))- Dành cho macOS hoặc Linux (Terminal):
curl -fsSL 'https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh' | shKhi màn hình cài đặt đưa ra câu hỏi cấu hình, anh chỉ cần chọn tác vụ Claude Code và xác nhận bật module tối ưu hóa RTK + Headroom.
Bước 2: Bật máy chủ FCC và mở giao diện quản trị
- Trên Windows / macOS: Mở ứng dụng Free Claude Code ngay trên Desktop hoặc Start Menu để chạy nền ở khay hệ thống.
- Trên Linux: Chạy dòng lệnh:
fcc-serverNgay sau khi khởi chạy, trình duyệt sẽ tự động điều hướng vào trang quản trị Admin UI trực quan.
Bước 3: Lấy API Key miễn phí từ NVIDIA NIM
- Truy cập trang tạo key tại build.nvidia.com/settings/api-keys và đăng ký tài khoản miễn phí.
- Tạo một API Key mới rồi sao chép chuỗi khóa.
- Trên giao diện Admin UI của FCC, vào mục Providers, bấm chọn NVIDIA NIM và ấn Add key.
- Dán API Key vào ô nhập rồi chọn Save.
- Ở trường chọn mô hình, chọn mô hình chuyên code như Qwen 3 Coder, DeepSeek V4 hoặc Nemotron rồi ấn Apply.
Bước 4: Bắt đầu lập trình với Claude Code
Mở một cửa sổ dòng lệnh tại thư mục dự án cần xử lý và gõ lệnh:
fcc-claudeLúc này, giao diện agent của Claude Code sẽ khởi động và sẵn sàng nhận lệnh viết code, rà soát lỗi hay tái cấu trúc dự án hoàn toàn tự động.
4. Kinh Nghiệm Thực Chiến Và Tối Ưu
- Luôn cấu hình mô hình Fallback: Tại mục Model Config, nên điền thêm 1-2 mô hình dự phòng (như Google AI Studio hoặc Groq). Khi nhà cung cấp chính quá tải, hệ thống sẽ tự động chuyển tiếp để không ngắt quãng dòng suy nghĩ của agent.
- Bảo mật Proxy: Nếu triển khai chạy server trên VPS từ xa, hãy kích hoạt mục Proxy Authentication trong Admin UI để cấp mật khẩu xác thực truy cập.
- Cập nhật phiên bản: Khi có bản cập nhật mới từ tác giả repo, chỉ cần tắt máy chủ và chạy lệnh fcc-update là toàn bộ gói bổ trợ sẽ được tự động nâng cấp.
Lời Kết
Free Claude Code là giải pháp cân bằng hoàn hảo giữa sức mạnh tự động hóa của AI Agent và bài toán tối ưu ngân sách cho lập trình viên và doanh nghiệp.
