Trải nghiệm khi dùng Claude Code Router
Bạn tải app desktop về cho Windows, macOS hoặc Linux và mở lên. Trong phần Providers, bạn thêm một nhà cung cấp mô hình bằng cách chọn mẫu có sẵn hoặc địa chỉ tự nhập, dán API key và chọn các mô hình muốn dùng. Sau đó bạn bật máy chủ cục bộ, mặc định lắng nghe ở http://127.0.0.1:3456 theo README.
Bước tiếp theo là nối công cụ code AI của bạn vào cổng này. App có phần cấu hình agent cho Claude Code, Codex, OpenCode và nhiều công cụ khác: bạn chọn mô hình rồi áp dụng, thay vì tự sửa file cấu hình từng công cụ. Từ lúc đó bạn dùng Claude Code như cũ nhưng yêu cầu thực tế được chuyển tới nhà cung cấp mà bạn đã chọn.
Phần có ích khi dùng lâu là định tuyến và theo dõi. Bạn đặt quy tắc chuyển mô hình, thử lại khi lỗi, mô hình dự phòng theo thứ tự, và xem nhật ký từng yêu cầu: dùng mô hình nào, trễ bao lâu, tốn bao nhiêu token và ước tính chi phí.
Tính năng nổi bật
Một địa chỉ cho nhiều công cụ
Claude Code, Codex, Grok CLI, Kimi CLI, Kilo Code, OpenCode, Pi và vài công cụ khác dùng chung một cổng cục bộ.
Đổi nhà cung cấp không phải sửa cấu hình
Chuyển mô hình hoặc nhà cung cấp trong app mà không phải sửa lại từng file cấu hình của từng agent.
Thử lại và mô hình dự phòng
Có retry, nhiều khoá xoay vòng và danh sách mô hình dự phòng để yêu cầu không bị đứt khi một bên lỗi.
Nhật ký và ước tính chi phí
Xem từng yêu cầu: nhà cung cấp, mô hình, độ trễ, số token, chi phí ước tính và trạng thái tài khoản.
Thêm năng lực cho mô hình
Các tính năng như Fusion vision, tìm web, công cụ MCP và ToolHub giúp mô hình vốn không có sẵn những khả năng đó.
Khoá riêng cho từng máy khách
Tạo khoá CCR riêng có hạn dùng và giới hạn số yêu cầu hoặc token cục bộ.
Tận dụng Claude Code Router vào việc gì?
Lập trình viên cá nhân
Dùng Claude Code với mô hình giá rẻ hơn
Nối Claude Code vào một nhà cung cấp mô hình như DeepSeek hoặc OpenRouter mà README liệt kê hỗ trợ để giảm chi phí cho tác vụ đơn giản.
Đội phát triển nhỏ
Một nơi quản lý khoá API cho cả nhóm
Gom khoá nhà cung cấp vào gateway, phát khoá CCR riêng cho từng người kèm giới hạn.
Người dùng agent chạy lâu
Giữ công việc chạy khi một nhà cung cấp lỗi
Đặt mô hình dự phòng để agent tự chuyển sang bên khác khi bên chính hết hạn mức hoặc bị lỗi.
Chủ doanh nghiệp, trưởng nhóm
Theo dõi chi phí dùng AI
Xem nhật ký số token và chi phí ước tính để biết công cụ nào đang tiêu nhiều tiền.
Người mày mò AI
So sánh mô hình trên cùng một công việc
Đổi mô hình trong app rồi chạy lại cùng tác vụ để thấy khác biệt, không cần cài lại công cụ.
Cần chuẩn bị gì?
- Windows, macOS hoặc Linux cho app desktop; README nói bản CLI cần Node.js 22 trở lên.
- API key của ít nhất một nhà cung cấp mô hình (OpenAI, Anthropic, Gemini, OpenRouter, DeepSeek và các nhà cung cấp tương thích khác).
- Một công cụ code AI muốn nối vào gateway, ví dụ Claude Code.
Hướng dẫn cài đặt chi tiết
Cài trên Ứng dụng desktop
Mở trang Releases của kho, tải bản cho hệ điều hành của bạn (Windows, Linux, macOS Apple Silicon hoặc Intel) và cài như phần mềm thường.
https://github.com/musistudio/claude-code-router/releasesMở app, vào phần Providers rồi thêm nhà cung cấp: chọn mẫu có sẵn hoặc nhập địa chỉ riêng, dán API key và chọn mô hình.
Vào phần Server và bật máy chủ. Theo README, gateway mặc định ở địa chỉ dưới đây.
http://127.0.0.1:3456Vào phần cấu hình agent, chọn công cụ của bạn (ví dụ Claude Code), chọn mô hình và áp dụng; sau đó xem phần Logs để kiểm tra yêu cầu đã đi qua gateway.
Cài trên CLI qua npm
Cần Node.js 22 trở lên. Cài gói toàn cục rồi mở giao diện quản lý trên trình duyệt.
npm install -g @musistudio/claude-code-router ccr uiMở trình duyệt tới địa chỉ giao diện quản lý, rồi làm theo luồng Providers, Server, Agent Profiles như bản desktop. Gateway vẫn ở cổng 3456.
http://127.0.0.1:3458
Cài trên Docker
README đưa lệnh npm chạy Docker Compose từ thư mục mã nguồn của kho. Hãy đọc hướng dẫn Docker chính thức trước khi mở truy cập từ xa.
npm run docker:compose:upGiao diện quản lý và các đường dẫn gateway mặc định ở http://127.0.0.1:3458.
Dùng thử lần đầu
Cài app theo tab Ứng dụng desktop và mở lên.
Thêm một nhà cung cấp trong Providers với API key của bạn, chọn một mô hình rẻ để thử.
Bật Server và kiểm tra gateway đang chạy ở cổng được hiển thị.
Trong phần cấu hình agent, chọn Claude Code, chọn mô hình vừa thêm rồi áp dụng.
Mở Claude Code, hỏi một câu đơn giản, rồi sang phần Logs xem yêu cầu đã đi qua nhà cung cấp nào, mất bao lâu và tốn bao nhiêu token.
Mẹo dùng hay
- Thử bằng một mô hình rẻ và tác vụ nhỏ trước khi giao việc lớn cho mô hình lạ.
- Dùng khoá CCR riêng cho từng máy hoặc từng người thay vì chia sẻ khoá nhà cung cấp gốc.
- Đặt mô hình dự phòng cho những phiên làm việc dài để không bị gián đoạn.
- Đọc tài liệu Troubleshooting trên trang ccrdesk.top khi agent không kết nối được.
Lưu ý và hạn chế
- Gateway nhận và chuyển mọi nội dung hội thoại cùng khoá API, nên đừng mở cổng ra Internet; README còn dặn đọc hướng dẫn Docker trước khi mở truy cập từ xa.
- Mô hình không phải Claude có thể xử lý tác vụ agent (gọi công cụ nhiều bước) kém hơn, và một số tính năng của Claude Code có thể không hoạt động như bản gốc.
- Nhiều nhà cung cấp có điều khoản riêng; kiểm tra điều khoản của hãng trước khi dùng gateway để gọi dịch vụ hoặc gói đăng ký của họ.
Câu hỏi thường gặp
Claude Code Router có miễn phí không?
Phần mềm miễn phí, giấy phép MIT. Bạn vẫn trả tiền cho nhà cung cấp mô hình mà bạn dùng qua gateway.
Có cần biết lập trình không?
Bản desktop có giao diện để thêm nhà cung cấp và chọn mô hình nên không cần viết code, nhưng bạn nên quen với công cụ code AI như Claude Code và khái niệm API key.
Có an toàn không?
Gateway chạy trên máy bạn nên nội dung chỉ đi tới nhà cung cấp bạn chọn. Hãy giữ gateway ở địa chỉ nội bộ, bảo vệ file cấu hình chứa khoá API và tải app từ trang Releases chính thức.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/musistudio/claude-code-router.gitRepo tương tự nên xem
LiteLLM
BerriAI / litellm
Cổng AI thống nhất: gọi hơn 100 mô hình của OpenAI, Anthropic, Gemini... bằng cùng một định dạng
Claude Code
anthropics / claude-code
Trợ lý AI viết code của Anthropic chạy trong Terminal, đọc hiểu dự án, sửa file và xử lý Git bằng lời thường
OpenCode
anomalyco / opencode
Trợ lý AI viết code mã nguồn mở, chạy trong Terminal hoặc app desktop, nối được nhiều nhà cung cấp mô hình