Trang chủ / Hướng dẫn / Cách dùng Claude Code miễn phí

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 | bash

Mở 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>
claude

Thiết lập thủ công (Windows PowerShell)

$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claude
Quan trọng: dùng ANTHROPIC_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.

Model miễn phí cho Claude Code: gọi công cụ và ngữ cảnh 128K trở lên
Mô hìnhMiễn phí trênNgữ cảnhGiới hạn miễn phí (ưu đãi tốt nhất)Công cụThị giác
GLM 5.3UnoRouter1M1 yêu cầu/phút
1 req/min per model
CóKhông
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 yêu cầu/phút
40 RPM
CóCó
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaCóCó
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceCóKhông
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditCóCó
Gemini 3.7 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditCóCó
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 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 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 yêu cầu/phút
50 yêu cầu/ngày
Shared rate limit
CóKhông
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 yêu cầu/phút
250 yêu cầu/ngày
70,000 token/phút
~6M
CóCó
Gemini 3.6 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayCó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ạ haiku tớ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 /clear giữa các tác vụ để gửi ít token hơn.

Khắc phục sự cố

Vấn đềNguyên nhânCách khắc phục
Claude Code yêu cầu bạn đăng nhậpCá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 độngANTHROPIC_API_KEY đã được đặtXóa nó bằng unset ANTHROPIC_API_KEY
Lỗi 429 ở mọi yêu cầuMọi khóa nhà cung cấp của bạn đều đạt giới hạnThê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ừngModel 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ậmPrompt lớn trên một model miễn phí chậmGhim một model nhanh, ví dụ một model Groq hoặc Cerebras
Dùng tất cả các mô hình này qua một khóa duy nhất. FreeLLMAPI là bộ định tuyến mã nguồn mở, tự lưu trữ. Nó đặt tất cả các gói miễn phí này sau một endpoint duy nhất tương thích OpenAI, và tự chuyển sang nhà cung cấp khác khi một nhà cung cấp bị giới hạn tốc độ. Xem danh mục hoặc bắt đầu.

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

Nguồn

Tất cả hướng dẫn · Xem tất cả mô hình miễn phí