Chuyển đến nội dung

musistudio / claude-code-router

Claude Code Router

Cổng trung gian trên máy để Claude Code, Codex và các agent khác dùng bất kỳ nhà cung cấp mô hình AI nào

Claude Code Router (CCR) là một model gateway chạy cục bộ: các công cụ code AI như Claude Code, Codex, OpenCode, Kilo Code... trỏ vào một địa chỉ duy nhất trên máy, còn bạn quản lý nhà cung cấp, mô hình, khoá API và quy tắc định tuyến ở một nơi. Có app desktop, bản CLI qua npm và bản Docker. Giấy phép MIT.

  • 38.184 sao
  • 3.209 fork
  • TypeScript
  • Cập nhật hôm nay
  • MIT (dùng tự do, kể cả thương mại)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Ứng dụng máy tính, Dòng lệnh (CLI)
Chạy trên
Windows, macOS, Linux, Docker, Node.js
Chi phí
Miễn phí (trả phí API AI nếu dùng)

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

  1. 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.

    Văn bản
    https://github.com/musistudio/claude-code-router/releases
  2. Mở 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.

  3. Vào phần Server và bật máy chủ. Theo README, gateway mặc định ở địa chỉ dưới đây.

    Văn bản
    http://127.0.0.1:3456
  4. Và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

  1. 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.

    Terminal
    npm install -g @musistudio/claude-code-router
    ccr ui
  2. Mở 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.

    Văn bản
    http://127.0.0.1:3458

Cài trên Docker

  1. 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.

    Terminal
    npm run docker:compose:up
  2. Giao 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

  1. Cài app theo tab Ứng dụng desktop và mở lên.

  2. 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ử.

  3. Bật Server và kiểm tra gateway đang chạy ở cổng được hiển thị.

  4. 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.

  5. 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.

Terminal
git clone https://github.com/musistudio/claude-code-router.git

Repo tương tự nên xem

Thư viện & framework AI63,3K

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

KhóWindowsmacOSLinuxDocker+1
AI hỗ trợ lập trình156K

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

VừaWindowsmacOSLinux
AI hỗ trợ lập trình227K

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

VừaWindowsmacOSLinuxNode.js

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: AI hỗ trợ lập trình

AI hỗ trợ lập trình325K

Matt Pocock Skills

mattpocock / skills

Bộ skill nhỏ gọn giúp trợ lý AI viết code hỏi kỹ yêu cầu, viết test trước và giữ code gọn gàng

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình318K

Superpowers

obra / superpowers

Bộ kỹ năng biến trợ lý AI thành người làm phần mềm bài bản: hỏi ý, lập kế hoạch, viết test, rồi mới code

VừaWindowsmacOSLinux
AI hỗ trợ lập trình304K

ECC (Everything Claude Code)

affaan-m / ECC

Kho agent, skill, hook và quy tắc dựng sẵn để trợ lý AI lập trình làm việc có quy trình và có kiểm tra

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình233K

Karpathy-Inspired Claude Code Guidelines

multica-ai / andrej-karpathy-skills

Một file CLAUDE.md gồm bốn nguyên tắc giúp Claude Code bớt đoán mò, bớt làm phức tạp và sửa đúng chỗ cần sửa

DễWindowsmacOSLinux
AI hỗ trợ lập trình195K

Anthropic Agent Skills

anthropics / skills

Kho skill mẫu chính thức của Anthropic: dạy Claude làm Word, Excel, PDF, PowerPoint và việc chuyên biệt

DễWindowsmacOSLinuxWeb+1
AI hỗ trợ lập trình150K

Spec Kit

github / spec-kit

Bộ công cụ của GitHub giúp trợ lý AI code theo đặc tả: viết spec rõ ràng, lập kế hoạch, chia việc rồi mới làm

KhóWindowsmacOSLinuxPython

Xem cả 30 repo AI hỗ trợ lập trình Về Kho Repo