Cách dùng Claude Code miễn phí
Claude Code là agent lập trình của Anthropic. Nó cần một Anthropic Messages API. Hướng dẫn này cho thấy cách kết nối Claude Code với model miễn phí qua FreeLLMAPI. Bạn đặt hai biến môi trường. Bạn không cần khóa Anthropic.
Mã, tên mô hình và nhãn danh mục trực tiếp được hiển thị bằng tiếng Anh.
Bạn nhận được gì và không nhận được gì
Claude Code gửi mỗi yêu cầu tới một API theo định dạng của Anthropic. FreeLLMAPI hỗ trợ định dạng đó tại /v1/messages. Nó dịch từng yêu cầu và gửi tới một model miễn phí, ví dụ Gemini, GPT-OSS, Qwen hoặc GLM.
- Bạn nhận được: giao diện Claude Code, các công cụ, chỉnh sửa tệp và vòng lặp agent của nó, trên model miễn phí.
- Bạn không nhận được: các model Claude của Anthropic. Không nhà cung cấp nào cấp model Claude miễn phí qua API. Đọc Có API Claude miễn phí không? để biết chi tiết.
- Chi phí: $0 cho suy luận. Các gói miễn phí có giới hạn tốc độ. FreeLLMAPI chuyển sang nhà cung cấp tiếp theo khi một giới hạn chặn yêu cầu.
Bước 1: Cài đặt FreeLLMAPI
FreeLLMAPI là mã nguồn mở. Nó chạy trên máy tính của bạn trong Docker. Khóa nhà cung cấp của bạn vẫn nằm trên máy tính của bạn.
macOS hoặc Linux
curl -fsSL https://freellmapi.co/install.sh | bashMở bảng điều khiển tại http://localhost:3001. Thêm ít nhất hai khóa nhà cung cấp miễn phí ở trang Keys. Google AI Studio và Groq mỗi nơi cấp một khóa miễn phí trong khoảng một phút. Sao chép khóa thống nhất của bạn từ cùng trang.
Bước 2: Kết nối Claude Code
Cách nhanh nhất là lệnh thiết lập. Lệnh đọc danh mục trực tiếp của bạn, sao lưu ~/.claude/settings.json và thêm cài đặt cổng.
Một lệnh
npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>Để thiết lập thủ công, đặt hai biến môi trường và khởi động Claude Code:
Thiết lập thủ công (macOS hoặc Linux)
export ANTHROPIC_BASE_URL=http://localhost:3001
export ANTHROPIC_AUTH_TOKEN=<unified-key>
claudeThiết lập thủ công (Windows PowerShell)
$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claudeANTHROPIC_AUTH_TOKEN. Đừng dùng ANTHROPIC_API_KEY. Nếu ANTHROPIC_API_KEY được đặt, Claude Code thấy một thông tin xác thực xung đột và không khởi động.Để chắc rằng yêu cầu đi tới cổng, chạy npx freellmapi doctor. Mỗi phản hồi cũng có tiêu đề X-Routed-Via. Tiêu đề này cho biết nhà cung cấp và model đã trả lời.
Bước 3: Chọn model cho công việc agent
Claude Code gửi các prompt dài. Một yêu cầu điển hình có system prompt lớn, định nghĩa công cụ và nội dung tệp. Dùng model có gọi công cụ và cửa sổ ngữ cảnh lớn. Các gói miễn phí nhỏ với token mỗi phút thấp sẽ lỗi với các yêu cầu này.
Ở tab Keys, Anthropic, ánh xạ mỗi họ Claude (opus, sonnet, haiku) tới auto hoặc tới một model. Với auto, bộ định tuyến chọn một model miễn phí cho mỗi yêu cầu. Bảng hiển thị các model miễn phí có gọi công cụ và ít nhất 128K ngữ cảnh, từ danh mục hôm nay.
| Mô hình | Miễn phí trên | Ngữ cảnh | Giới hạn miễn phí (ưu đãi tốt nhất) | Công cụ | Thị giác |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 yêu cầu/phút 1 req/min per model | Có | Không |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 yêu cầu/phút 40 RPM | Có | Có |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Có | Có |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Có | Không |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Có | Có |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Có | Có |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 yêu cầu/phút 50 yêu cầu/ngày 50 req/day account-wide (1,000 after a $10 purchase) | Có | Có |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 yêu cầu/phút 50 yêu cầu/ngày Shared rate limit | Có | Không |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 yêu cầu/phút 250 yêu cầu/ngày 70,000 token/phút ~6M | Có | Có |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Có | Có |
Đang hiển thị 12 trong số 109 mô hình miễn phí phù hợp. Xem tất cả mô hình.
Dữ liệu trực tiếp từ danh mục FreeLLMAPI (phiên bản 2026.11.19, đã kiểm tra 2026-11-19). Giới hạn miễn phí thay đổi thường xuyên. Danh mục được kiểm tra mỗi ngày.
Giới hạn tốc độ và cách chuyển dự phòng giúp ích
Một tác vụ Claude Code có thể gửi 20 đến 100 yêu cầu. Một gói miễn phí đơn lẻ sẽ làm bạn dừng nhanh. Ví dụ, một khóa Gemini Flash miễn phí cho phép ít yêu cầu mỗi ngày. FreeLLMAPI đếm hạn mức của từng khóa. Khi một nhà cung cấp gửi lỗi 429, bộ định tuyến thử nhà cung cấp tiếp theo trong nhóm. Phiên Claude Code của bạn tiếp tục.
- Thêm khóa từ bốn nhà cung cấp trở lên. Nhiều khóa hơn cho nhiều yêu cầu hơn mỗi ngày.
- Ánh xạ
haikutới một model nhỏ và nhanh. Claude Code dùng nó cho các tác vụ nền ngắn. - Giữ ngữ cảnh nhỏ. Dùng
/cleargiữa các tác vụ để gửi ít token hơn.
Khắc phục sự cố
| Vấn đề | Nguyên nhân | Cách khắc phục |
|---|---|---|
| Claude Code yêu cầu bạn đăng nhập | Các biến môi trường chưa được đặt trong shell này | Đặt ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN, rồi khởi động lại claude |
| "Conflicting credential" hoặc không khởi động | ANTHROPIC_API_KEY đã được đặt | Xóa nó bằng unset ANTHROPIC_API_KEY |
| Lỗi 429 ở mọi yêu cầu | Mọi khóa nhà cung cấp của bạn đều đạt giới hạn | Thêm khóa từ nhiều nhà cung cấp hơn ở trang Keys |
| Lệnh gọi công cụ lỗi hoặc agent dừng | Model không hỗ trợ gọi công cụ tốt | Ánh xạ họ tới một model trong bảng ở trên |
| Yêu cầu chậm | Prompt lớn trên một model miễn phí chậm | Ghim một model nhanh, ví dụ một model Groq hoặc Cerebras |
Câu hỏi thường gặp
Claude Code có miễn phí để dùng không?
Chương trình Claude Code miễn phí để cài đặt. Nó cần một API model để hoạt động. Với FreeLLMAPI, nó dùng các gói miễn phí của nhà cung cấp, nên chi phí suy luận là $0.
Tôi có nhận được model Claude thật miễn phí không?
Không. Anthropic không cấp API Claude miễn phí. Claude Code chạy trên các model miễn phí khác, ví dụ Gemini, GPT-OSS, Qwen hoặc GLM, qua endpoint theo định dạng Anthropic.
Vì sao dùng ANTHROPIC_AUTH_TOKEN mà không dùng ANTHROPIC_API_KEY?
Claude Code gửi ANTHROPIC_AUTH_TOKEN như một Bearer token tới cổng của bạn. Nếu ANTHROPIC_API_KEY được đặt, Claude Code coi nó là thông tin xác thực bên thứ nhất và từ chối khởi động.
Model miễn phí nào tốt nhất cho Claude Code?
Dùng model có gọi công cụ và cửa sổ ngữ cảnh từ 128K token trở lên. Bảng trong trang này cho thấy các model miễn phí mạnh nhất đáp ứng cả hai điều kiện hiện nay.
Cách này có chạy trên Windows không?
Có. Đặt hai biến trong PowerShell bằng $env:ANTHROPIC_BASE_URL và $env:ANTHROPIC_AUTH_TOKEN, rồi khởi động claude.
Hướng dẫn liên quan
- Có API Claude miễn phí không?
- API model lập trình miễn phí tốt nhất
- Dùng Codex CLI với mô hình miễn phí
- Cline, Roo Code và Kilo Code với API miễn phí
- Giới hạn tốc độ API LLM miễn phí
Nguồn
- FreeLLMAPI docs: Anthropic and Claude clients (đã kiểm tra 20 November 2026)
- FreeLLMAPI CLI generators (đã kiểm tra 20 November 2026)
- Claude Code documentation: LLM gateway configuration (đã kiểm tra 20 November 2026)