Free Claude Code Giải Thích: Một Local Proxy Cho 50+ Nhà Cung Cấp AI

Bạn muốn dùng Claude Code, Codex hay Pi — nhưng không muốn thêm subscription, không muốn reverse proxy mờ ám, và không muốn setup vỡ ngay khi một provider rate-limit.

Rồi free-claude-code xuất hiện với 50k+ GitHub stars và lời hứa: 1.3 tỷ+ token miễn phí, chín coding agent, thân thiện ToS. Nghe quá tốt. Cái gì đằng sau?

Câu trả lời đơn giản hơn bạn nghĩ: FCC không phải API miễn phí ma thuật. Nó là local proxy + lớp admin đứng giữa coding agent và các provider bạn đã có quyền truy cập — free tier, subscription, API key, hoặc model local. Một lần cài, một UI cấu hình, nhiều agent.

Repository: Alishahryar1/free-claude-code

---

TL;DR

• Nó làm gì: Chạy fcc-server trên máy bạn; agent gọi localhost:8082 thay vì Anthropic/OpenAI trực tiếp.
• Đau khi không có: API key riêng mỗi agent, đổi model thủ công khi provider lỗi, proxy xám có thể bị ban tài khoản.
• Thay đổi gì: Một Admin UI cấu hình 50+ provider, fallback có thứ tự, routing theo tier (Opus/Sonnet/Haiku), launcher như fcc-claude / fcc-codex.
• Ai nên dùng: Dev xoay vòng free tier hoặc nhiều provider, muốn UX Claude Code mà không bị khóa vendor.
• Ai nên bỏ qua: Team đã có hợp đồng Anthropic trả phí duy nhất, không muốn vận hành infra Python local.

Trước FCC, mỗi coding agent là một đảo riêng: env var riêng, ngăn API key riêng, câu chuyện outage riêng.

FCC gom thành một điểm điều khiển: agent gọi local proxy; proxy chọn model, retry, và lần lượt thử danh sách provider bạn cấu hình.

Giữ cặp scene này: không có FCC, bạn là lớp tích hợp. Có FCC, proxy đảm nhận.

---

Bản Đồ Cho Người Mới

Đọc bài theo hai scene trên:

1. Lượt 1: Hiểu vì sao API key riêng mỗi agent thành nợ vận hành.
2. Lượt 2: Nhớ fcc-server → Admin UI → fcc-claude (hoặc fcc-codex).
3. Lượt 3: Học từ vựng: MODEL, danh sách fallback, override tier, RTK.
4. Lượt 4: Chạy bài tập đầu tiên bên dưới trên máy bạn.

Thuật ngữ	Trả lời câu hỏi
fcc-server	Process nào lắng nghe localhost:8082?
Admin UI	Dán API key và chọn model ở đâu?
MODEL	Provider/model mặc định xử lý request?
Fallback Models	Chạy gì khi provider chính thất bại?
fcc-claude	Claude Code tới FCC thay vì Anthropic thế nào?
RTK	FCC giảm output terminal ồn ào trước khi gửi model?

Bài Tập Thực Hành Đầu Tiên

Cài FCC, start server, dán một free provider key (NVIDIA NIM là mặc định README), validate, apply, rồi chạy:

fcc-claude

Trong Claude Code, mở /model và xác nhận model FCC xuất hiện. Nếu có — scene “with” đã thật; phần còn lại chỉ là chi tiết cấu hình.

Mở rộng: Thêm provider thứ hai vào Fallback Models, tạm làm hỏng key chính. Xem cùng một agent turn tiếp tục trên backup mà không restart thủ công.

---

Phần 1: Nền Tảng — mental model

Hãy coi coding agent là thiết bị điện và model provider là công ty điện lực. Claude Code cần “điện” kiểu Anthropic. Codex cần kiểu OpenAI. Groq, Gemini, Ollama local mỗi bên nói một phương ngữ hơi khác.

Không có adapter, bạn mua ổ cắm riêng cho mỗi thiết bị. Với FCC, bạn lắp một ổ cắm thông minh: thiết bị cắm vào localhost:8082; FCC dịch request, chọn nhà cung cấp, và chuyển mạch khi một nhà ngắt.

Đó là điểm điều khiển trung tâm trong scene “with”: fcc-server không phải model — nó là router.

Điểm quan trọng sau con số star: FCC không tạo token miễn phí từ không khí. Nó gom free tier hợp lệ và key bạn cung cấp. Headline “1.3 tỷ+ token miễn phí” là tổng hạn mức tháng được ghi trong catalog — mỗi provider có giới hạn, điều khoản, và tình trạng riêng. Giá trị FCC là điều phối, không phải thuật giả kim.

Dự án cũng nói rõ: open-source độc lập, không liên kết Anthropic. Claude và Claude Code là nhãn hiệu của Anthropic. FCC định tuyến tới endpoint tương thích; không thay sản phẩm hay hỗ trợ của Anthropic.

---

Phần 2: Cuộc Điều Tra — workflow thực tế chạy thế nào?

Đây là happy path từ zero tới code, map với mũi tên trong scene.

Bước 1: Cài hoặc cập nhật

Đọc installer trước khi pipe. Rồi chọn OS.

macOS/Linux:

curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh

Windows PowerShell:

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1")))

Chạy lại lệnh đó để update. Khi được hỏi, chọn ít nhất một coding agent và tùy chọn RTK — bộ lọc cắt noise terminal lặp để ít token hơn tới model.

Chín launcher sau khi cài:

Lệnh	Agent
fcc-claude	Claude Code
fcc-codex	Codex
fcc-pi	Pi
fcc-opencode	OpenCode
fcc-cline	Cline
fcc-hermes	Hermes
fcc-dsh	DeepSeek Harness
fcc-grok	Grok Build
fcc-muse	Muse Code

Bước 2: Start fcc-server

• macOS/Windows: Mở Free Claude Code từ Applications hoặc Start menu.
• Linux: Chạy fcc-server và giữ terminal mở.

Server in URL Admin UI. Icon tray/menu-bar trên desktop OS có restart và quit.

Bước 3: Cấu hình provider trong Admin UI

Ví dụ NVIDIA NIM (mặc định README):

1. Tạo key tại build.nvidia.com/settings/api-keys.
2. Mở Admin UI → dán NVIDIA_NIM_API_KEY.
3. Giữ MODEL ở nvidia_nim/nvidia/nemotron-3-super-120b-a12b hoặc tìm trong dropdown.
4. Validate → Apply.

Tùy chọn: bật Proxy Authentication để chỉ client có bearer token mới gọi được proxy.

ChatGPT không phải API key. Mở Providers → Connected accounts, đăng nhập flow ChatGPT chính thức (device code trên máy headless), rồi restart agent đang chạy. Client kiểu OpenAI dùng openai/<model-id>.

Bước 4: Launch agent qua FCC

fcc-claude    # Claude Code
fcc-codex     # Codex
fcc-pi        # Pi
fcc-opencode  # OpenCode
fcc-cline     # Cline
fcc-hermes    # Hermes
fcc-dsh       # DeepSeek Harness
fcc-grok      # Grok Build
fcc-muse      # Muse Code

Mỗi launcher set env var agent cần (ANTHROPIC_BASE_URL, OpenAI-compatible base URL, …) trỏ về FCC thay vì cloud vendor.

Bước 5: Tích hợp IDE (tùy chọn)

Với Claude Code trong VS Code, trỏ ANTHROPIC_BASE_URL tới http://localhost:8082 và ANTHROPIC_AUTH_TOKEN khớp Admin UI. Bật CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 để /model liệt kê catalog FCC.

Với Codex App, thêm provider fcc trong ~/.codex/config.toml với base_url = "http://127.0.0.1:8082/v1" và auth qua fcc-codex --print-proxy-auth-token.

Mỗi request diễn ra thế nào?

1. Agent gửi request kiểu Anthropic hoặc OpenAI tới FCC.
2. FCC resolve MODEL (hoặc override tier — xem Phần 3).
3. FCC gọi adapter provider (NVIDIA NIM, OpenRouter, Groq, Ollama local, …).
4. Khi thất bại sau retry, FCC đi Fallback Models theo thứ tự — cùng turn, không restart agent.
5. RTK tùy chọn và năm optimization built-in cắt output terminal và metadata trước lần gọi provider tiếp theo.

README claim tới 90% ít token output terminal khi bật RTK — đáng kể khi agent dump build log vào context.

---

Phần 3: Chẩn Đoán — thuật ngữ dễ gây lú

Slug provider-id/model-id

Model trong Admin UI dùng slug hai phần: open_router/openrouter/free, groq/llama-3.3-70b-versatile, ollama/llama3.1. Prefix chọn adapter; suffix là model ID chính xác của provider. Nếu provider không list model, gõ slug thủ công.

Routing theo tier (Fable, Opus, Sonnet, Haiku)

Claude Code gắn nhãn tier nội bộ. FCC cho map mỗi tier sang backend khác:

• MODEL — mặc định cho mọi thứ.
• MODEL_OPUS, MODEL_SONNET, MODEL_HAIKU, MODEL_FABLE — override theo tier; None kế thừa MODEL.

Chiến lược ví dụ: task tier Opus trên NIM free lớn, tier Haiku trên tag lmstudio/ nhanh, MODEL mặc định trên OpenRouter free.

Điều khiển reasoning

Admin UI → Model Config → Reasoning có thể ép effort off/low/high hoặc pass-through từ client. Provider bỏ qua cờ reasoning thì giữ hành vi native — FCC không bịa chain-of-thought.

Tích hợp messaging (Discord / Telegram)

FCC không chỉ terminal. Cấu hình Admin UI → Messaging để chạy agent từ chat, với /stats, /stop, /clear. Voice note tùy chọn qua Whisper local hoặc NVIDIA NIM — gần pitch omnichannel của OpenClaw, nhưng phạm vi session coding-agent trong thư mục được phép.

“Thân thiện ToS” — thực chất là gì

FCC marketing tuân thủ: dùng API và flow subscription chính thức (vd. kết nối ChatGPT trong Admin UI), gỡ tích hợp khi provider cấm. Đó không đảm bảo tài khoản an toàn tuyệt đối — điều khoản provider đổi. Coi free tier là best-effort, đọc giới hạn từng provider, tránh chia sẻ key cho automation lạm dụng.

FCC vs. proxy Claude không chính thức

Cách tiếp cận	Rủi ro	Bạn nhận được
Relay “free Claude API” ngẫu nhiên	Cao — thường vi phạm ToS, key lộ	Dễ vỡ, roulette ban tài khoản
Anthropic API trực tiếp	Thấp — chính thức	Đầy đủ, trả theo token
FCC	Trung bình — phụ thuộc provider bạn cấu hình	Đa agent, đa provider, kiểm soát local

---

Phần 4: Cách Triển Khai — tradeoff và khi nào dùng

Khi FCC phát huy

• Bạn đã xoay giữa free tier (NIM, OpenRouter free, Groq, Gemini flash) và muốn một mặt cấu hình.
• Chạy nhiều agent (Claude Code + Codex + Pi) và không muốn nhân đôi key trong ba file env.
• Outage provider hay gặp ở khu vực bạn — fallback có thứ tự cứu buổi refactor dở dang.
• Muốn model local hoặc hybrid (Ollama, LM Studio, llama.cpp) trong cùng picker với cloud.
• Thử nghiệm từ điện thoại hoặc chat qua Discord/Telegram mà không dựng automation quy mô OpenClaw.

Khi nên bỏ qua hoặc hoãn

• Team chuẩn hóa một hợp đồng Anthropic enterprise — thêm Python proxy là overhead thuần ops.
• Cần SLA vendor, audit trail, ticket hỗ trợ — FCC là infra hobby MIT, không phải managed gateway.
• Không chạy được service local persistent (laptop corp khóa, chỉ CI ephemeral).
• Kỳ vọng fidelity model frontier mỗi session — route free có thể lùi so với Opus mới nhất.

So với OpenClaw

OpenClaw là operator cá nhân chủ động qua messaging, cron, và OS node. FCC là model router cho coding agent. Hai lớp khác nhau: OpenClaw quyết khi nào hành động; FCC quyết model nào trả lời khi Claude Code đã có prompt. Có thể chạy cả hai — OpenClaw kích hoạt task, FCC hỗ trợ session code — nhưng không thay nhau.

Setup tối thiểu theo hướng production

1. Chạy fcc-server trên máy luôn bật (home server hoặc dev box).
2. Bật Proxy Authentication nếu port reachable trên LAN.
3. Cấu hình tối thiểu hai provider — chính + fallback.
4. Ghim version: chạy lại install script để update; kiểm fcc-server --version trước upgrade.
5. Giữ onboarding Claude Code ổn: set "hasCompletedOnboarding": true trong ~/.claude.json nếu vẫn bị hỏi login sau khi cấu hình FCC.

---

Final Take

Free Claude Code là universal adapter cho coding agent — không phải bữa trưa miễn phí, mà là control plane local khiến free tier, subscription, và model local trông như một catalog cho Claude Code, Codex và bạn bè.

Một câu nhớ: trỏ mọi agent vào localhost:8082, để FCC ôm chaos provider.

Làm hôm nay: cài FCC, cấu hình một free provider, chạy fcc-claude, và thêm fallback model trước buổi refactor dài tiếp theo.