
👁 3 lượt xem
Free Claude Code (viết tắt FCC) là một proxy mã nguồn mở cho phép Claude Code gọi model của nhà cung cấp khác thay vì chỉ dùng model của Anthropic. Bạn có thể nối Claude Code với NVIDIA NIM, OpenRouter, Groq, hoặc với model chạy ngay trên máy qua Ollama, LM Studio, llama.cpp. Với người đang học lập trình cùng AI, đây là một cách thực tế để dùng Claude Code miễn phí ở mức thử nghiệm, miễn là nhà cung cấp bạn chọn còn hạn mức miễn phí.
Bài này tóm tắt dự án theo README chính thức trên GitHub (đọc ngày 15/11/2026): nó là gì, chạy ra sao, hỗ trợ những nhà cung cấp nào, cách cài Free Claude Code từng bước với NVIDIA NIM, và những điều bạn nên cân nhắc trước khi đưa mã nguồn của mình đi qua một dịch vụ bên thứ ba.
Nội dung bài viết 7 mục
Free Claude Code là gì?
Free Claude Code là dự án độc lập trên GitHub tại github.com/Alishahryar1/free-claude-code, phát hành theo giấy phép AGPL-3.0. Dự án viết bằng Python và dùng trình quản lý gói uv. README ghi rõ đây không phải sản phẩm của Anthropic, không được Anthropic bảo trợ; Claude và Claude Code là thương hiệu của Anthropic.
Tên gọi dễ khiến người mới hiểu nhầm. FCC không mở khóa model Claude miễn phí. Nó giữ nguyên giao diện dòng lệnh Claude Code mà bạn đã quen (đọc tệp, sửa mã, chạy lệnh, chọn model bằng /model), còn phần “bộ não” phía sau thì do model của nhà cung cấp khác đảm nhận. Nếu nhà cung cấp đó có gói miễn phí, bạn dùng được Claude Code mà không phải mua gói Claude.
Dù tên là Free Claude Code, README liệt kê 12 công cụ lập trình nối được vào FCC, trong đó có Codex, OpenCode, Cline và Aider, cùng tiện ích Claude Code cho VS Code và JetBrains.
Free Claude Code hoạt động như thế nào?
FCC là một máy chủ nhỏ chạy trên máy của bạn, mặc định ở địa chỉ http://127.0.0.1:8082. Luồng xử lý gồm bốn bước:
- Claude Code gửi yêu cầu tới FCC thay vì gửi thẳng tới máy chủ của Anthropic.
- FCC chuyển yêu cầu sang định dạng mà nhà cung cấp bạn chọn hiểu được.
- FCC gửi yêu cầu tới nhà cung cấp (NVIDIA NIM, OpenRouter, Ollama…) và nhận kết quả.
- FCC đổi kết quả về định dạng Claude Code chờ đợi, giữ cả phần trả lời theo luồng, gọi công cụ và phần suy luận xen kẽ.

Vì Claude Code có nhiều cấp model (Opus, Sonnet, Haiku…), FCC cho bạn chọn một model chung tên MODEL, rồi gán riêng model cho từng cấp nếu muốn qua các mục MODEL_OPUS, MODEL_SONNET, MODEL_HAIKU. Bạn cũng có thể khai báo danh sách model dự phòng: khi model chính lỗi, FCC thử lần lượt model tiếp theo. README cảnh báo một yêu cầu thất bại có thể đã tiêu hạn mức ở nhiều nhà cung cấp trước khi thành công.
FCC còn tự thử lại khi lỗi và cho đặt giới hạn tốc độ, hữu ích khi dùng gói miễn phí.
Các nhà cung cấp được hỗ trợ
README hiện liệt kê 61 nhà cung cấp, gồm loại miễn phí, trả phí, thuê bao và chạy cục bộ. Một số cái tên đáng chú ý:
Nhà cung cấp đám mây
- NVIDIA NIM: nhà cung cấp mà README dùng làm ví dụ mặc định, lấy key tại build.nvidia.com.
- OpenRouter: cổng gom nhiều model, có nhóm model miễn phí.
- Groq, Cerebras, SambaNova: nổi tiếng vì tốc độ trả lời nhanh.
- Google AI Studio (Gemini), DeepSeek, Mistral, Kimi, Hugging Face, Ollama Cloud và nhiều dịch vụ khác.
- Gói trả phí sẵn có như OpenAI API, GitHub Copilot hay API Anthropic (tính tiền riêng).
Model chạy cục bộ
- Ollama: tải model bằng
ollama pull, chạyollama serve, rồi chọn model với tiền tốollama/. - LM Studio: bật máy chủ cục bộ của LM Studio (mặc định
http://localhost:1234/v1) và chọn model với tiền tốlmstudio/. - llama.cpp: chạy
llama-server(mặc địnhhttp://localhost:8080/v1) và chọn model với tiền tốllamacpp/.
Chạy cục bộ thì mã nguồn không rời khỏi máy, nhưng cần máy đủ mạnh. README khuyên chọn model biết gọi công cụ (tool calling) và có cửa sổ ngữ cảnh đủ lớn, vì riêng phần lời nhắc hệ thống và mô tả công cụ của Claude Code đã khá dài.
Cách cài Free Claude Code từng bước
Các bước dưới đây theo đúng phần Quick Start trong README, dùng Claude Code NVIDIA NIM làm ví dụ. Lệnh cài có thể đổi theo phiên bản, nên hãy đối chiếu lại README trước khi chạy.
Bước 1: Cài đặt
Trên macOS hoặc Linux, mở Terminal và chạy:
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | shTrên Windows, mở PowerShell và chạy:
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1")))Trong lúc cài, trình cài hỏi bạn muốn dùng công cụ lập trình nào. Chọn ít nhất một, ở đây là Claude Code. Bạn có thể bật thêm RTK và Headroom, hai công cụ giảm lượng token gửi đi; README nói chúng giúp tiết kiệm tới 90% token, con số thực tế tùy cách bạn dùng.

Bước 2: Khởi động FCC
- Windows: mở Free Claude Code từ màn hình nền hoặc menu Start.
- macOS: mở Free Claude Code từ màn hình nền hoặc thư mục Applications.
- Linux: chạy lệnh dưới đây và để nguyên cửa sổ Terminal đó.
fcc-serverKhởi động xong, FCC tự mở trang quản trị (Admin UI).
Bước 3: Tạo API key NVIDIA và thêm vào FCC
- Đăng nhập tài khoản NVIDIA và tạo API key tại
build.nvidia.com/settings/api-keys. - Mở địa chỉ Admin UI hiện trong nhật ký của máy chủ.
- Vào mục Providers, mở NVIDIA NIM, bấm Add key, dán key rồi bấm Save.
- Giữ
MODELở giá trị mặc địnhnvidia_nim/nvidia/nemotron-3-ultra-550b-a55b, hoặc tìm và chọn model khác trong danh sách. - Bấm Apply để lưu lựa chọn.


Muốn khóa proxy bằng mã xác thực, bật Proxy Authentication trong trang quản trị.
Bước 4: Chạy Claude Code qua FCC
fcc-claudeLệnh này mở Claude Code đã trỏ sẵn về FCC; các lệnh khởi chạy tự bật máy chủ nếu nó chưa chạy. Bên trong Claude Code, gõ /model để thấy và chọn các model của FCC. Công cụ khác có lệnh riêng như fcc-codex, fcc-opencode, fcc-aider.


Về sau, cập nhật bằng fcc-update (dừng FCC trước), còn khi gặp lỗi thì chạy fcc-doctor và gửi kết quả kèm báo lỗi trên GitHub.
Lưu ý và rủi ro khi dùng Free Claude Code
Hạn mức miễn phí không cố định
README nói rõ việc có gói miễn phí hay không, và giới hạn bao nhiêu, là do từng nhà cung cấp quyết định và có thể thay đổi. Vì vậy bài này không ghi con số hạn mức cụ thể của NVIDIA NIM; hãy xem trang tài khoản của bạn trên NVIDIA. Gói miễn phí thường bị giới hạn tốc độ, nên Claude Code có thể chạy chậm hoặc phải chờ khi bạn giao việc dài.
Chất lượng phụ thuộc model
Claude Code được thiết kế quanh model Claude. Khi thay bằng model khác, độ chính xác khi sửa mã, khả năng gọi công cụ và độ ổn định khi làm việc nhiều bước sẽ khác đi, có lúc tốt, có lúc kém hơn hẳn. Hãy thử với một dự án nhỏ trước khi giao việc quan trọng.
Mã nguồn của bạn đi qua bên thứ ba
Khi dùng nhà cung cấp đám mây, mọi tệp, đoạn mã và kết quả lệnh mà Claude Code đọc được sẽ được gửi tới máy chủ của nhà cung cấp đó. Trước khi dùng cho dự án công ty hay mã có dữ liệu khách hàng, hãy đọc điều khoản sử dụng và chính sách dữ liệu của nhà cung cấp, nhất là với gói miễn phí. Nếu cần giữ kín mã, chọn model chạy cục bộ qua Ollama, LM Studio hoặc llama.cpp.
Đây là phần mềm cộng đồng
FCC không phải sản phẩm của Anthropic, nên khi gặp lỗi bạn hỏi cộng đồng dự án trên GitHub chứ không phải bộ phận hỗ trợ của Anthropic. Lệnh cài dạng curl … | sh hoặc irm … sẽ chạy ngay một đoạn script tải từ Internet; nếu cẩn thận, hãy mở và đọc script trên GitHub trước khi chạy. Ngoài ra, giấy phép AGPL-3.0 có những nghĩa vụ riêng nếu bạn sửa mã FCC rồi cung cấp lại cho người khác.
Ai nên dùng Free Claude Code?
- Sinh viên IT muốn làm quen với cách làm việc cùng một agent lập trình mà chưa có ngân sách mua gói trả phí.
- Người đang học AI coding muốn so sánh nhiều model trên cùng một công cụ, cùng một dự án.
- Người muốn thử trước khi trả tiền, để biết quy trình làm việc với Claude Code có hợp với mình không.
- Người cần giữ mã trên máy và có máy đủ mạnh để chạy model cục bộ.
Với dự án thương mại cần kết quả ổn định, gói chính thức hoặc API trả phí vẫn dễ đoán hơn.
Muốn tìm thêm công cụ cho Claude Code, bạn có thể xem kho Repo Skill AI trên trang này, trong đó có bài giới thiệu Claude Code, plugin ghi nhớ Claude Mem và bộ skill gstack.
Câu hỏi thường gặp
Free Claude Code có cho dùng model Claude miễn phí không?
Không. FCC giữ giao diện Claude Code nhưng gửi yêu cầu tới model của nhà cung cấp khác. Muốn dùng model Claude qua FCC, bạn vẫn cần API key Anthropic trả phí.
Dùng Claude Code NVIDIA NIM có mất phí không?
NVIDIA NIM có hạn mức dùng thử, nhưng mức cụ thể do NVIDIA quyết định và có thể thay đổi. Hãy xem trang tài khoản NVIDIA của bạn để biết hạn mức hiện tại.
Có cần cài Claude Code trước không?
Không bắt buộc. Khi bạn chọn Claude Code trong lúc cài, trình cài của FCC kiểm tra máy; nếu chưa có Claude Code, nó tải bản cài chính thức về. FCC chạy được trên Windows, macOS và Linux.
Có dùng hoàn toàn offline được không?
Phần chạy model thì được, nếu bạn dùng Ollama, LM Studio hoặc llama.cpp trên chính máy mình. Bước cài đặt và cập nhật vẫn cần Internet để tải phần mềm và model.
Mã nguồn của tôi có an toàn không?
Điều đó tùy nhà cung cấp bạn chọn. Với nhà cung cấp đám mây, mã được gửi tới máy chủ của họ và chịu điều khoản của họ. Với model cục bộ, mã chỉ ở trên máy bạn.