Courses
Bạn cài đặt Claude Code trong khoảng ba mươi giây, chạy claude bên trong thư mục dự án, rồi nhận ra tài khoản bạn đang có không mở được cánh cửa. Đó là lúc đa số người dùng bắt đầu tìm bản miễn phí — và cũng là nơi câu trả lời trở nên mù mờ, vì “miễn phí” có nghĩa khác nhau tùy bạn muốn tác nhân trên terminal, giao diện chat, hay quy trình Claude Code nhưng dùng một mô hình khác suy luận ở phía dưới.
Bài viết này trình bày bốn con đường để có thiết lập không tốn phí, sắp xếp xấp xỉ theo mức độ tương đồng với bản “xịn”. Yêu cầu tối thiểu: một terminal và các nền tảng được Claude Code hỗ trợ (macOS 13+, Windows 10 build 1809+, Ubuntu 20.04 hoặc Debian 10+, RAM 4 GB). Trình cài đặt native mang theo runtime riêng, nên Node.js chỉ quan trọng nếu bạn chọn đường npm.
Tóm lược
-
Gói miễn phí Claude.ai không bao gồm Claude Code.
-
Tài khoản console mới nhận một khoản tín dụng API dùng một lần, cho phép truy cập CLI dùng thử.
-
Claude Code đọc endpoint từ
ANTHROPIC_BASE_URL, điều này khiến các phương án OpenRouter và Ollama khả thi. -
Hai phương án đó mang lại quy trình Claude Code với một mô hình khác ở phía dưới, không phải Claude.
-
Các maintainer nguồn mở có thể nhận 6 tháng truy cập gói cao cấp nhất.
Claude Code là gì?
Claude Code là công cụ lập trình tác nhân (agentic) của Anthropic cho terminal. Nó chạy trong thư mục dự án của bạn, đọc file, chỉnh sửa, thực thi lệnh, và xử lý các tác vụ nhiều bước mà bạn không cần sao chép gì vào một thẻ trình duyệt.
Lý do cần trả phí mang tính cấu trúc hơn là thương mại. Mỗi hành động của nó là một cuộc gọi API, và các phiên tác nhân vốn dĩ “nhiều lời”: mô hình đọc lại ngữ cảnh, gọi công cụ, kiểm tra kết quả, rồi thử lại. Một buổi chiều bận rộn trong một kho mã lớn có thể ngốn vài đô la tiền token mà vẫn không thấy đặc biệt hiệu quả.
Nếu bạn muốn cái nhìn đầy đủ về những gì công cụ làm hằng ngày, hướng dẫn Claude Code của chúng tôi covers thiết lập, tái cấu trúc và gỡ lỗi trong thực tế.
Claude Code có miễn phí không?
Câu trả lời trực tiếp là không. Tài liệu thiết lập của Anthropic nêu rõ Claude Code cần tài khoản Pro, Max, Team, Enterprise, hoặc Console, và gói miễn phí Claude.ai không bao gồm quyền truy cập. Pro bắt đầu từ 20 USD/tháng, hoặc 17 USD/tháng nếu bạn trả trước 200 USD cho cả năm.
Phương án thay thế là thanh toán qua console, nơi bạn trả theo token và không gắn với đăng ký. Claude Sonnet 5 thường ở mức 3 USD cho mỗi triệu token đầu vào và 15 USD cho mỗi triệu token đầu ra. Claude Opus 5 ở mức 5 USD và 25 USD, còn Haiku 4.5 là 1 USD và 5 USD.
Hai cách này tính phí theo logic hoàn toàn khác, và chọn sai là cách nhiều người trả quá tay hoặc bị bóp băng thông giữa chừng. Dưới đây là so sánh.
|
Đăng ký Claude (Pro, Max, Team) |
Console trả theo token |
|
|
Bạn trả cho |
Phí cố định hàng tháng bao gồm một mức sử dụng |
Chỉ các token bạn thực sự gửi và nhận |
|
Chi phí |
20 USD/tháng cho Pro, 100 hoặc 200 USD cho Max, 125 USD mỗi ghế Team Premium |
Không phí tháng. Sonnet 5 ở 2/10 USD mỗi triệu token, Opus 5 ở 5/25 USD, Haiku 4.5 ở 1/5 USD |
|
Quyền truy cập mô hình |
Mặc định Sonnet 5, có Opus trên Pro và cao hơn |
Mọi mô hình trong bảng giá, gồm Haiku 4.5 cho công việc rẻ và Fable 5 ở đỉnh |
|
Giới hạn bởi |
Cửa sổ 5 giờ cuốn và hạn mức hàng tuần, chia sẻ giữa chat Claude, Cowork, và Claude Code |
Giới hạn tốc độ gắn với bậc sử dụng (Start, Build, hoặc Scale) thay vì hạn mức tin nhắn |
|
Khi chạm trần |
Bạn chờ cửa sổ đặt lại, hoặc mua thêm ở mức giá API |
Không gì dừng lại cho tới khi tín dụng trả trước cạn, lúc đó yêu cầu sẽ lỗi do thanh toán |
|
Dự đoán chi phí |
Cố định. Bạn biết con số trước khi tháng bắt đầu |
Biến động. Một tuần tái cấu trúc nặng tốn gấp nhiều lần tuần yên ắng |
|
Điểm khởi đầu miễn phí |
Không. Không có dùng thử cho Pro hoặc Max |
Tín dụng khởi đầu một lần cho tài khoản mới |
|
Phù hợp nhất cho |
Sử dụng đều đặn hằng ngày, nơi phí cố định rẻ hơn tính theo token so với trả theo lưu lượng |
Sử dụng bộc phát hoặc thỉnh thoảng, đánh giá, và những ai không muốn cam kết theo tháng |
Điểm giao nhau là sự đều đặn sử dụng, không phải khối lượng. Đăng ký mua token với mức hiệu quả tốt hơn API cho tới khi bạn chạm trần gói, nên người dùng hằng ngày gần như luôn có lợi với Pro. Trả theo lưu lượng thắng khi các tuần của bạn chẳng giống nhau, vì bạn không trả gì trong những tuần yên ắng.
Vậy “miễn phí” đến từ đâu? Đại khái có ba nguồn.
- Tín dụng khởi đầu mà Anthropic cấp cho tài khoản API mới
- Thực tế là Claude Code có thể trò chuyện với bất kỳ server nào nói định dạng Anthropic Messages, gồm cả server miễn phí, dù là hosted (OpenRouter) hay cục bộ (Ollama)
- Một chương trình tài trợ nhắm tới maintainer nguồn mở
Hạng mục thứ hai đáng có lời cảnh báo trước. Chỉ định Claude Code dùng một mô hình miễn phí sẽ cho bạn giao diện và vòng lặp tác nhân, nhưng không phải Claude. Khoảng cách chất lượng ở suy luận nhiều bước là có thật, tôi sẽ quay lại điểm này.
Gói miễn phí có bao gồm Claude Code không?
Hãy xử lý hiểu lầm phổ biến nhất trước, vì nó khiến nhiều người mất cả buổi tối.
Tầng miễn phí không bao gồm Claude Code. Không có bản giới hạn, không có bản dùng thử, không có gì cả. Tài liệu của chính Anthropic rất rõ ràng: gói miễn phí bao gồm Claude trên web, iOS, Android, và desktop; tác nhân terminal không được bao gồm.
Những gì bạn nhận được thì thực sự ổn. Từ 1/7/2026, gói miễn phí chạy Claude Sonnet 5 làm mô hình mặc định, kèm tìm kiếm web, tải tệp, Projects và Artifacts — tất cả vốn trước đây ở sau paywall. Để dán một stack trace và hỏi có gì sai, nó đáp ứng tốt.
Những giới hạn tầng miễn phí mà nhà phát triển chạm phải sớm nhất
Anthropic không công bố số lượng tin nhắn, và ai trích dẫn con số chính xác là đang đoán. Công ty mô tả Pro là ít nhất gấp năm lần mức sử dụng mỗi phiên của Free, nghĩa là Free là đường cơ sở chứ không phải hạn mức cố định. Trên thực tế, báo cáo tập trung quanh 15 đến 40 tin nhắn trong cửa sổ 5 giờ cuốn, với tin nhắn dài và tệp đính kèm khiến hạn mức cạn nhanh hơn.
Một vài giới hạn quan trọng hơn số lượng tin nhắn:
- Cửa sổ 5 giờ bắt đầu cuốn khi bạn gửi tin nhắn đầu tiên.
- Không có quyền truy cập CLI Claude Code. Đây là điểm khó, và không có mẹo nào thay đổi được.
- Giới hạn linh hoạt theo tải máy chủ, nghĩa là giờ cao điểm sẽ tệ hơn.
- Cuộc trò chuyện dài tốn nhiều hơn mỗi lượt vì toàn bộ luồng được đọc lại mỗi lần.
Điểm rơi: tầng chat miễn phí ổn cho câu hỏi lẻ và review code, và sụp đổ ngay khi bạn muốn trao đổi qua lại bền bỉ trên một codebase. Đó chính xác là việc Claude Code sinh ra để làm.
Phương án 1: Tín dụng miễn phí Anthropic API
Đây là con đường chính thức ít người biết nhất và, theo tôi, là nơi hầu hết nên bắt đầu.
Tạo tài khoản tại platform.claude.com mang lại môt khoản tín dụng khởi đầu dùng một lần. Tài liệu giá của Anthropic mô tả đây chỉ là “một ít tín dụng miễn phí” mà không nêu con số, dù báo cáo bên thứ ba liên tục cho biết khoảng 5 USD.
Tín dụng API xác thực CLI Claude Code. Bạn nhận được tác nhân thật, chạy mô hình Claude thật, trên codebase thật của bạn. Tín dụng không gia hạn và hết hạn sau 14 ngày, nên coi đây là dùng thử chứ không phải nguồn cung.
Thiết lập tài khoản API và nhận tín dụng
Toàn bộ quy trình từ đăng ký mới tới tác nhân hoạt động mất khoảng 10 phút, và phần lớn là chờ cài đặt. Tôi chia thành năm bước vì bước ba có một bẫy khiến nhiều người phải khởi động lại.
Bước 1: Tạo tài khoản Console
Truy cập platform.claude.com và đăng ký bằng email của bạn. Console là sản phẩm tách biệt với giao diện chat claude.ai, nên tài khoản Claude sẵn có sẽ không tự mang sang, và bạn có thể cần đăng ký lại bằng cùng địa chỉ.

Để rõ ràng, một số tài khoản sẽ được yêu cầu xác minh số điện thoại ở bước này. Khi xong, tín dụng khởi đầu sẽ được áp dụng tự động chứ không phải nhập từ ô khuyến mãi.
Bước 2: Kiểm tra số dư tín dụng
Mở mục Billing từ điều hướng của console. Số dư ban đầu sẽ hiển thị ở đó, cùng tùy chọn thêm phương thức thanh toán, thứ mà bạn chưa cần.
Hãy kiểm tra trước khi làm gì khác. Nếu số dư là 0, thì cấu hình đúng tới đâu sau này cũng không tạo được phiên hoạt động.
Bước 3: Tạo API key
Vào Settings > API Keys và tạo khóa mới. Đặt tên sao cho ba tháng nữa bạn vẫn nhận ra, vì đa số rồi sẽ có vài khóa.

Giá trị đầy đủ của khóa chỉ hiển thị đúng một lần. Sao chép vào trình quản lý mật khẩu ngay khi xuất hiện, vì đóng hộp thoại mà không sao chép đồng nghĩa mất khóa và phải làm lại bước này.
Bước 4: Xuất khóa và cài đặt Claude Code
Xuất khóa dưới dạng biến môi trường trong shell của bạn, rồi cài CLI. Anthropic khuyến nghị trình cài đặt native, kèm runtime riêng và không cần Node.js.
export ANTHROPIC_API_KEY="sk-ant-your-key-here"
curl -fsSL https://claude.ai/install.sh | bash

Trong Windows PowerShell, trình cài đặt là irm https://claude.ai/install.ps1 | iex. Nếu bạn thích npm, lưu ý rằng kể từ Claude Code v2.1.198, gói yêu cầu Node.js 22 trở lên, thay đổi so với mức tối thiểu Node.js 18 mà các hướng dẫn cũ vẫn nêu:
npm install -g @anthropic-ai/claude-code
Thêm dòng export vào ~/.zshrc hoặc ~/.bashrc nếu bạn muốn khóa tồn tại qua cửa sổ terminal mới. Sau đó xác nhận cài đặt đã xong:
claude --version
Bước 5: Chạy phiên đầu tiên
Chuyển vào thư mục dự án và khởi động tác nhân. Chạy claude từ thư mục home về mặt kỹ thuật vẫn hoạt động, nhưng công cụ gần như vô dụng nếu không có codebase để đọc.
cd ~/projects/my-app
claude
Ở lần chạy đầu với ANTHROPIC_API_KEY được đặt, Claude Code sẽ nhắc bạn duyệt phê duyệt khóa một lần thay vì mở trình duyệt cho OAuth. Hãy phê duyệt, và bạn sẽ vào màn hình chào mừng với thư mục làm việc hiển thị ở cuối:

Để xác nhận phương án thanh toán thay vì chỉ xác nhận cài đặt, chạy /status trong phiên. Dòng API key nêu ANTHROPIC_API_KEY cho biết phiên đang dùng tín dụng Console thay vì đăng nhập claude.ai đã lưu.
Nếu thấy điều gì đó sai ở bước này, claude doctor sẽ in chẩn đoán cài đặt và thiết lập mà không khởi động phiên, và đây là động tác nhanh hơn việc tìm lỗi theo chuỗi thông báo.
Tín dụng miễn phí dùng được bao xa?
Tính nhẩm, dùng Sonnet 5 theo mức giới thiệu hiện tại. Hình dung mười lăm lượt trao đổi trên một kho mã thực, mỗi lượt gửi khoảng 30.000 token ngữ cảnh và sinh khoảng 1.500 token đầu ra. Lượt đầu trả toàn bộ giá đầu vào, còn mười bốn lượt sau chủ yếu trúng bộ nhớ đệm ở mức 10% của giá đó.
|
Mục chi |
Tính toán |
Chi phí |
|
Lượt đầu, đầu vào chưa cache |
30.000 token ở mức 2 USD/MTok |
0,06 USD |
|
Mười bốn lượt sau, đọc từ cache |
420.000 token ở mức 0,20 USD/MTok |
0,08 USD |
|
Đầu ra trên cả mười lăm lượt |
22.500 token ở mức 10 USD/MTok |
0,23 USD |
|
Tổng phiên |
0,37 USD |
|
|
Cùng phiên nếu không có cache |
450.000 token đầu vào ở giá đầy đủ |
1,13 USD |
Hãy coi đó là bậc độ lớn chứ không phải báo giá. Mô hình tính trên coi ngữ cảnh phẳng và bỏ qua phí ghi cache, vốn là 1,25 lần giá đầu vào cơ bản cho cache 5 phút, nên phiên thực tế của bạn sẽ nằm đâu đó hai bên con số này.
Khoảng cách giữa hai hàng cuối là phần đáng ghi nhớ. Cache giảm khoảng ba phần tư hóa đơn, đó là lý do các phiên Claude Code rẻ hơn nhiều so với đếm token ngây thơ, và lý do bất cứ thứ gì phá cache (nhảy giữa các kho mã, khởi động lại phiên liên tục, đổi mô hình giữa phiên) âm thầm nhân ba chi phí. Trang giá của Anthropic có đầy đủ bảng hệ số nếu bạn muốn mô phỏng chuẩn.
Khác biệt mức giá giữa các mô hình
Lựa chọn mô hình tác động con số nhiều hơn bất kỳ thứ gì bạn kiểm soát. Chạy cùng phiên mười lăm lượt trên toàn bộ dải mô hình:
|
Mô hình |
Đầu vào / đầu ra mỗi MTok |
Chi phí mỗi phiên |
Số phiên trên 5 USD |
|
Haiku 4.5 |
1 USD / 5 USD |
0,18 USD |
khoảng 27 |
|
Sonnet 5 (giới thiệu, tới 31/8/2026) |
2 USD / 10 USD |
0,37 USD |
khoảng 13 |
|
Sonnet 5 (chuẩn, từ 1/9/2026) |
3 USD / 15 USD |
0,55 USD |
khoảng 9 |
|
Opus 5 |
5 USD / 25 USD |
0,92 USD |
khoảng 5 |
|
Fable 5 |
10 USD / 50 USD |
1,85 USD |
dưới 3 |
Vậy số dư năm đô la mua được từ năm tới hai mươi bảy phiên, hoàn toàn tùy thuộc mô hình bạn chọn. Sonnet 5 là mặc định hợp lý để đánh giá.
Hãy dùng số dư đó cho một tác vụ thực sự thay vì ví dụ đồ chơi. Tái cấu trúc một mô-đun mà bạn thực sự sở hữu, hoặc lần theo một lỗi qua ba tệp, vì đó là cách duy nhất để biết công cụ có xứng đáng một chỗ trong tuần làm việc của bạn không.
Khi số dư chạm 0, sẽ không có phương án dự phòng. Thanh toán Console là trả theo sử dụng, và Claude Code không có tầng miễn phí bên dưới chờ sẵn.
Phương án 2: Mô hình miễn phí trên OpenRouter
OpenRouter là một cổng API ngồi trước vài trăm mô hình, và một vài mô hình luân phiên trong số đó miễn phí khi gọi. Không cần thẻ, không phí tháng, không đăng ký.
Lý do cách này kết nối được với Claude Code là CLI đọc endpoint từ một biến môi trường. Đổi biến là đổi nơi gửi yêu cầu. OpenRouter vận hành cái họ gọi là “Anthropic Skin”, một endpoint chấp nhận định dạng Anthropic Messages và truyền qua thinking blocks và việc dùng công cụ gốc không đụng chạm, nên không cần proxy cục bộ.
Hãy rõ ràng về những gì bạn nhận được, vì đây không phải mô hình Claude. Bạn giữ giao diện Claude Code, vòng lặp tác nhân, chỉnh sửa tệp, và lệnh gạch chéo, trong khi một biến thể Qwen hoặc Llama đảm nhiệm suy luận.
Tài liệu của chính OpenRouter cảnh báo rằng Claude Code chỉ được đảm bảo hoạt động khi yêu cầu được định tuyến tới nhà cung cấp first-party của Anthropic và “có thể không hoạt động đúng với các nhà cung cấp khác”. Tôi muốn trích nguyên văn hơn là nói khác đi.
Cách chuyển hướng hoạt động
Ba biến đảm nhiệm công việc:
-
ANTHROPIC_BASE_URLtrỏ tớihttps://openrouter.ai/apithay vì endpoint của Anthropic. -
ANTHROPIC_AUTH_TOKENmang key OpenRouter và được gửi dưới dạng headerAuthorization: Bearer. -
ANTHROPIC_API_KEYphải được đặt thành chuỗi rỗng một cách tường minh; nếu không, Claude Code có thể rơi về xác thực với Anthropic.
Bạn có thể đặt các biến này trong profile shell hoặc trong file thiết lập của Claude Code. Một điều nên tránh: file .env của dự án sẽ không hoạt động, vì trình cài đặt native không đọc các file .env tiêu chuẩn.
json
{
"env": {
"ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
"ANTHROPIC_AUTH_TOKEN": "sk-or-v1-your-openrouter-key",
"ANTHROPIC_API_KEY": ""
}
}
Vị trí đặt file quan trọng hơn bạn nghĩ. Dùng ~/.claude/settings.json cho cấu hình toàn cục, hoặc .claude/settings.local.json cho một dự án đơn lẻ, vì Claude Code thêm file sau vào gitignore của bạn.
Đừng đặt thông tin xác thực vào .claude/settings.json của dự án, vì file đó được commit và chia sẻ với mọi người clone kho mã.
Thiết lập Claude Code với OpenRouter
-
Cài đặt Claude Code bằng trình cài đặt native nếu bạn chưa làm.
-
Tạo tài khoản miễn phí tại openrouter.ai và tạo key trong Settings > Keys. Không cần thẻ cho tài khoản chỉ gọi mô hình miễn phí.
-
Ghi cấu hình vào
~/.claude/settings.jsonnhư khối ở trên, hoặc xuất cùng ba biến đó trong profile shell của bạn. -
Nếu bạn từng đăng nhập Claude Code bằng tài khoản Anthropic, chạy
/logouttrong CLI, sau đó thoát và mở lại. Phiên lưu cache sẽ ghi đè biến của bạn và hiện ra dưới dạng lỗi không tìm thấy mô hình. -
Khởi động
claudevà kiểm tra nơi yêu cầu được gửi tới.
> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://openrouter.ai/api
Các yêu cầu của bạn cũng sẽ xuất hiện trong bảng hoạt động của OpenRouter trong vài giây, đây là cách nhanh nhất để xác nhận chuyển hướng đã có hiệu lực.
Chọn mô hình miễn phí trên OpenRouter
ID mô hình miễn phí kết thúc bằng :free, và danh sách này thay đổi liên tục khi nhà cung cấp thêm, gỡ, hoặc thay đổi giá mô hình. Bộ sưu tập OpenRouter free models cho biết mô hình nào hiện miễn phí. openrouter/free là auto-router của OpenRouter cho mô hình miễn phí. Nó chọn bất cứ thứ gì sẵn có và phù hợp yêu cầu của bạn, giúp thiết lập của bạn tiếp tục hoạt động sau khi từng mô hình riêng lẻ bị thay thế. Điểm khởi đầu đơn giản nhất, nhưng chất lượng biến thiên mạnh.
Giá, lượng tín dụng và danh sách mô hình miễn phí trên OpenRouter đều thay đổi theo chu kỳ hàng tháng, và một số đã thay đổi ngay trong lúc tôi viết. Hãy kiểm tra trang giá của Anthropic và bộ lọc free của OpenRouter trước khi bạn đưa ra kế hoạch dựa trên bất kỳ con số nào ở đây.
Còn nữa là giới hạn tốc độ, thứ cắn đau hơn cả lựa chọn mô hình. Mô hình miễn phí cho phép 20 yêu cầu mỗi phút bất kể tài khoản của bạn, và 50 yêu cầu mỗi ngày nếu bạn chưa từng mua tín dụng. Mua 10 USD tín dụng một lần, duy nhất, thì hạn mức ngày tăng lên 1.000 và vẫn giữ ở đó ngay cả khi số dư trở lại 0.
Năm mươi yêu cầu mỗi ngày nghe có vẻ ổn cho tới khi bạn nhớ rằng một phiên tác nhân tiêu tốn yêu cầu như một đồng nghiệp nhiều lời tiêu tốn buổi chiều của bạn. Một tác vụ đủ phức tạp có thể dùng hết một phần ba hạn mức ngày. Các lần thử thất bại cũng tính, nên thử mù làm tình hình tệ thêm chứ không khá hơn.
Để định tuyến vai trò mô hình cụ thể, Claude Code phơi ra các biến riêng cho từng tầng:
bash
export ANTHROPIC_DEFAULT_SONNET_MODEL="cohere/north-mini-code:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="cohere/north-mini-code:free"
export CLAUDE_CODE_SUBAGENT_MODEL="cohere/north-mini-code:free"
Các chỉnh sửa đơn giản, sửa một tệp và giải thích giữ vững khá tốt. Dù vậy, công việc nhiều bước dài xuống cấp thấy rõ, và chế độ lỗi thường là gọi công cụ hơn là chất lượng code thô, nên mô hình chọn sai công cụ, đọc sai kết quả hoặc lặp.
Nếu bạn muốn cách tiếp cận có chủ đích hơn để pha trộn mô hình theo tác vụ, hướng dẫn Claude Code Router của chúng tôi trình bày chi tiết định tuyến đa mô hình.
Phương án 3: Mô hình cục bộ với Ollama
Ollama chạy các mô hình mở trên chính máy của bạn. Không cần API key, không giới hạn tốc độ, và không cần internet sau khi tải trọng số.
Tháng 1/2026, Ollama thêm khả năng tương thích với Anthropic Messages API ở v0.14.0, khiến quy trình này khả thi. Trước đó, bạn cần một proxy dịch ở giữa. Giờ Claude Code nói chuyện trực tiếp với localhost.
Chi phí không biến mất; nó chuyển sang phần cứng — cụ thể là băng thông bộ nhớ, không chỉ dung lượng.
-
Trên Apple Silicon, bộ nhớ hợp nhất là con số cần theo dõi: 16 GB chạy được mô hình ~14B như
gpt-oss:20b, nhưng các mô hình lập trình lớp 30B đáng dùng muốn 32 GB hoặc hơn khi bạn thêm cửa sổ ngữ cảnh 32K. -
Trên máy Windows hoặc Linux, con số liên quan là VRAM GPU, không phải RAM hệ thống — mô hình vừa RAM nhưng chạy trên CPU sẽ quá chậm cho công việc tác nhân, nơi mỗi tác vụ bắn ra hàng chục cuộc gọi.
Thiết lập Ollama với Claude Code
-
Cài đặt Ollama. Trên macOS và Linux là
curl -fsSL https://ollama.com/install.sh | sh, còn trên Windows, bạn tải trình cài đặt từ ollama.com và chạy. -
Kéo một mô hình lập trình. Dù không thể cạnh tranh với các mô hình Claude hiện tại, Qwen3-Coder là lựa chọn ổn:
ollama pull qwen3-coder. -
Xác nhận mô hình đã có bằng
ollama list. -
Tăng độ dài ngữ cảnh, vì đây là thiết lập mọi người hay quên rồi đổ lỗi cho mô hình. Ollama gợi ý ít nhất 32K token cho Claude Code.
-
Chỉ định Claude Code trỏ vào endpoint cục bộ và chọn mô hình.
bash
export OLLAMA_CONTEXT_LENGTH=32768
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3-coder
Auth token là yêu cầu của giao thức và bị Ollama bỏ qua, nên giá trị không quan trọng. Nếu bạn muốn cấu hình này cố định, ba khóa tương tự nằm trong khối env của ~/.claude/settings.json.
Có hai khoảng trống bạn nên biết trước khi đánh giá kết quả:
-
Bộ nhớ đệm prompt của Anthropic không áp dụng, nên mỗi yêu cầu xử lý lại system prompt và toàn bộ lịch sử hội thoại từ đầu, điều này chậm chứ không đắt ở đây.
-
Lớp tương thích của Ollama cũng bỏ qua
tool_choice, trường mà Claude Code đôi khi dùng để ép gọi một công cụ cụ thể, và khi điều đó quan trọng, tác nhân có thể chọn sai công cụ và mắc kẹt trong vòng lặp.
Để có hướng dẫn chi tiết hơn, chúng tôi có bài hướng dẫn riêng về sử dụng Claude Code với mô hình cục bộ Ollama, cũng như các hướng dẫn riêng để chạy Qwen 3 và DeepSeek R1 cục bộ.
Đánh giá thực tế phần cứng
|
Bộ nhớ hợp nhất / VRAM |
Chạy được gì |
Đánh giá trung thực |
|
8 GB |
Chỉ các mô hình 7B |
Vật lộn với suy luận đa tệp. Ổn cho câu hỏi một hàm, nản cho bất kỳ việc tác nhân nào. |
|
16 GB |
7B-14B thoải mái: |
Có thể dùng cho chỉnh sửa và giải thích đơn giản ở ngữ cảnh 32K. |
|
24 GB |
|
Ngưỡng thực tế cho lập trình tác nhân. Một card 24 GB (RTX 3090/4090) hoặc Mac 24 GB nằm ở đây. |
|
32 GB+ |
Mô hình lập trình lớp 30B ở ngữ cảnh 32K đầy đủ |
Đây là lúc cục bộ thôi không còn là thỏa hiệp và bắt đầu cạnh tranh với lựa chọn đám mây miễn phí. |
Với đa số nhà phát triển, OpenRouter thắng Ollama trừ khi bạn có 32 GB hoặc hơn bộ nhớ hợp nhất/VRAM, cần offline, hoặc muốn mã nguồn không rời khỏi máy. Lý do cuối là chính đáng, và đó là lý do tôi không loại bỏ con đường này chỉ vì hiệu năng.
Phương án 4: Chương trình Claude for Open Source
Phần lớn hướng dẫn về chủ đề này dừng ở ba lựa chọn và bỏ lỡ phương án cho bạn sản phẩm thực, ở tầng cao nhất, trong nửa năm.
Anthropic ra mắt Claude for Open Source vào tháng 2/2026 và mở rộng vào tháng 7. Các maintainer và contributor đủ điều kiện nhận 6 tháng Claude Max 20x, gói 200 USD/tháng, miễn phí. Bao gồm Claude Code, với hạn mức sử dụng ở đỉnh tầng người dùng cá nhân.
Các tiêu chí đủ điều kiện công bố rộng hơn nhiều người nghĩ:
- Maintainer các gói có 500+ kho phụ thuộc, 100+ gói phụ thuộc, hoặc 200.000+ lượt tải hàng tháng cộng dồn qua npm, PyPI, crates.io, RubyGems, hay registry tương tự.
- Người có tên committers trên các dự án quỹ/ngôn ngữ được công nhận như CPython, đội Rust, Node.js TSC, một Apache PMC, CNCF, Kubernetes, nhân Linux, Django, hoặc Rails.
- Bất kỳ ai tác giả 100+ pull request đã được merge vào các kho họ không sở hữu trong 12 tháng qua.
- Nhà xây dựng cộng đồng có kho nhận 20+ contributor bên ngoài duy nhất với pull request đã merge trong năm qua.
- Maintainer của bất kỳ dự án nào có điểm criticality OpenSSF từ 0,4 trở lên.
Trang của Anthropic nêu rõ mời các trường hợp ranh giới cứ nộp và giải thích điều hệ sinh thái đang âm thầm phụ thuộc. Chương trình giới hạn 10.000 người nhận và duyệt cuốn chiếu; nộp đơn qua claude.com/contact-sales/claude-for-oss.
Một lưu ý: chương trình này bao gồm đăng ký, không phải tín dụng API. Việc sử dụng ANTHROPIC_API_KEY vẫn tính phí riêng, nên đây là gói cá nhân chứ không phải để trỏ vào pipeline CI.
Chọn phương án miễn phí phù hợp với bạn
Hai câu hỏi quyết định. Bạn cần Claude Code để làm gì, và bạn sẵn sàng cấu hình đến mức nào trước khi chán?
Bảng so sánh
|
Phương án |
Mô hình Claude thật? |
Claude Code CLI |
Giới hạn |
Phù hợp nhất cho |
Công sức thiết lập |
|
Tầng miễn phí Claude.ai (không phải Claude Code) |
Có (Sonnet 5) |
Không |
~15 đến 40 tin/5 giờ, linh động |
Câu hỏi lập trình thỉnh thoảng và review code |
Không |
|
Tín dụng API miễn phí |
Có (bất kỳ mô hình nào) |
Có |
Tín dụng khởi đầu một lần, khoảng 5 USD |
Đánh giá thực sự Claude Code |
Thấp |
|
Mô hình miễn phí OpenRouter |
Không (Qwen, Llama, GPT-OSS) |
Có |
20 yêu cầu/phút, 50/ngày (1.000/ngày sau một lần mua 10 USD) |
Sử dụng miễn phí lâu dài không cần phần cứng cục bộ |
Trung bình |
|
Mô hình cục bộ Ollama |
Không (mô hình mở cục bộ) |
Có |
Phụ thuộc phần cứng, không giới hạn tốc độ |
Làm việc offline, riêng tư, không tốn phí theo token |
Cao |
|
Claude for Open Source |
Có (Max 20x) |
Có |
6 tháng, chương trình có trần, cần đủ điều kiện |
Maintainer OSS đủ điều kiện |
Thấp, kèm nộp đơn |
Nên chọn cái nào?
- Nếu bạn chưa từng dùng Claude Code và muốn biết nó có đáng 20 USD/tháng không, hãy lấy tín dụng API khởi đầu. Đây là con đường duy nhất cho bạn thấy sản phẩm thật, và một tá phiên là quá đủ để hình thành quan điểm.
- Nếu bạn muốn truy cập miễn phí lâu dài và không nhất thiết cần Claude, OpenRouter cho tỷ lệ chất lượng/công sức tốt nhất. Dành một buổi tối cho thiết lập lần đầu và kỳ vọng sẽ chạm hạn mức yêu cầu ngày sớm hơn mong muốn.
- Nếu bạn cần offline, hoặc công ty bạn có quan điểm về nơi mã nguồn được chuyển tới, Ollama là câu trả lời, dù hóa đơn phần cứng có thể cao. Dưới 16 GB bộ nhớ hợp nhất/VRAM, tôi sẽ không bận tâm.
- Nếu bạn duy trì thứ gì đó người khác xây trên đó, hãy kiểm tra tài trợ nguồn mở trước khi làm gì khác. Sáu tháng ở tầng cao nhất khiến câu hỏi này tự biến mất.
Khắc phục sự cố với các thiết lập chuyển hướng
Phương án 3 và 4 có bề mặt lỗi chung, và cùng một vài vấn đề chiếm phần lớn. Vì cả Anthropic lẫn các nhà cung cấp gateway đều khó debug tổ hợp cụ thể của bạn, dưới đây là những thứ cần kiểm tra đầu tiên.
-
Claude Code cứ yêu cầu bạn đăng nhập. CLI không có thông tin xác thực riêng, và một base URL truy cập được không tính là một. Một khối env trong
.claude/settings.jsoncủa dự án chỉ áp dụng sau wizard chạy lần đầu, nên hãy đặtANTHROPIC_AUTH_TOKENở nơi được đọc sớm hơn: một biến shell export hoặc~/.claude/settings.json. -
Cảnh báo khi khởi động nêu hai nguồn thông tin xác thực. Cả thông tin xác thực gateway và đăng nhập đã lưu đều đang hoạt động. Chạy
/logoutđể xóa đăng nhập đã lưu, hoặc bỏ đặt biến để quay về đăng nhập trước đó. -
Lỗi 400 nhắc đến trường không được nhận diện. Claude Code gửi các trường tới endpoint định dạng Anthropic mà một số upstream từ chối. Đặt
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1sẽ ẩn hầu hết trường tiền phát hành và làm rõ vấn đề. -
Lỗi 400 nhắc đến thinking hoặc adaptive. Mô hình upstream không chấp nhận adaptive reasoning, thứ mà Claude Code yêu cầu cho các mô hình Claude gần đây. Trường hợp này thường cần cập nhật upstream của gateway hơn là sửa từ phía client.
-
Điều khiển từ xa và nhập liệu giọng nói dừng hoạt động. Cả hai dựa vào danh tính claude.ai và không khả dụng khi biến thông tin xác thực gateway được đặt. Từ v2.1.196, điều khiển từ xa cũng bị vô hiệu khi
ANTHROPIC_BASE_URLtrỏ tới host không phải Anthropic.
Khi thứ gì đó hoạt động sai và bạn không rõ lớp nào gây ra, /status trong phiên sẽ cho biết base URL và nguồn thông tin xác thực nào thực sự đang dùng. Chỉ một lệnh đó giải quyết nhiều ca hơn bất kỳ lượng re-export nào.
Lời kết
Bốn con đường dùng Claude Code miễn phí, không cái nào hoàn hảo, và các đánh đổi mới là phần thú vị chứ không phải suy nghĩ sau cùng.
Khuyến nghị của tôi thì hẹp. Nếu thứ bạn muốn là tác nhân CLI Claude Code chứ không phải cửa sổ chat, hãy bắt đầu bằng tín dụng API, vì bạn sẽ học được nhiều hơn từ một phiên thực trên sản phẩm thật so với một buổi tối cấu hình bản thay thế. Nếu nó xứng đáng trong quy trình của bạn, 20 USD/tháng là một khoản hợp lý. Nếu không, bạn chẳng mất gì, và giờ bạn biết vì sao.
Về đường dài, OpenRouter là lựa chọn miễn phí bền vững nhất, và Ollama thắng ngay khi quyền riêng tư hoặc truy cập offline là điều không thể thương lượng thay vì tốt thì có.
Về các thói quen phân biệt một phiên hữu ích với một phiên bực bội, Claude Code Best Practices của chúng tôi trình bày lập kế hoạch, truyền ngữ cảnh và phát triển hướng kiểm thử trên dự án thực. Và nếu bạn bắt đầu từ số 0, Claude Code 101 dạy nền tảng qua các bài học tương tác, có cấu trúc, đưa bạn từ cài đặt đầu tiên tới một quy trình làm việc hoạt động.
Câu hỏi thường gặp về truy cập Claude Code miễn phí
Claude Code có miễn phí không?
Không. Claude Code cần một đăng ký Claude trả phí (Pro, Max, Team, hoặc Enterprise) hoặc một tài khoản Console tính theo token. Thay vào đó có một vài con đường miễn phí hợp lệ, và mỗi con đường đều phải đánh đổi điều gì đó.
Tôi có thể dùng Claude Code trên gói miễn phí của Claude không?
Không. Gói miễn phí bao gồm giao diện chat trên web, di động và desktop, nhưng tài liệu thiết lập của chính Anthropic nêu rõ là không bao gồm quyền truy cập Claude Code. Tác nhân terminal nằm sau paywall.
Tín dụng API miễn phí thực sự dùng được bao xa?
Anthropic cấp cho tài khoản Console mới một ít tín dụng khởi đầu, thường được báo cáo khoảng 5 USD, dù Anthropic không công bố con số. Với mức Sonnet 5, khi prompt caching phát huy tác dụng, một phiên tập trung trên kho mã thực ra khoảng 30–40 xu. Tương đương khoảng một tá phiên, đủ để đánh giá công cụ có hợp quy trình làm việc của bạn không.
Claude Code có hoạt động với các mô hình miễn phí của OpenRouter không?
Về mặt kỹ thuật là có, vì OpenRouter phơi ra một endpoint nói định dạng Anthropic Messages. Bản thân OpenRouter cũng cảnh báo rằng Claude Code chỉ được đảm bảo hoạt động khi yêu cầu được định tuyến tới mô hình của chính Anthropic, nên backend miễn phí như Qwen hoặc Llama là thỏa thuận best-effort chứ không phải được hỗ trợ chính thức.
Tôi cần gì để chạy Claude Code với Ollama?
Ollama v0.14.0 trở lên, vì phiên bản đó thêm tương thích với Anthropic Messages API. Bạn cũng cần một mô hình có ít nhất 32K ngữ cảnh và đủ RAM để chứa, trên thực tế nghĩa là sàn 16 GB và 32 GB trước khi kết quả thôi không còn cảm giác thỏa hiệp. Hai biến môi trường xử lý phần dây nối còn lại.
Josep là một Nhà khoa học dữ liệu tự do chuyên về các dự án châu Âu, có chuyên môn về lưu trữ dữ liệu, xử lý, phân tích nâng cao và kể chuyện bằng dữ liệu tạo tác động.
Với vai trò giảng dạy, anh phụ trách môn Dữ liệu lớn trong chương trình Thạc sĩ tại Đại học Navarra và chia sẻ góc nhìn qua các bài viết trên các nền tảng như Medium, KDNuggets và DataCamp. Josep cũng viết về Dữ liệu và Công nghệ trong bản tin Databites (databites.tech).
Anh có bằng Cử nhân Vật lý Kỹ thuật từ Đại học Bách khoa Catalonia và bằng Thạc sĩ Hệ thống Tương tác Thông minh từ Đại học Pompeu Fabra.
