Source: https://aiprimetech.io/vi/blog/claude-code-router/

Tháng Chín 17, 2026 · 8 phút · Mã nguồn mở 

# Claude Code Router: Chạy Claude Code trên các mô hình khác (và khi nào cổng API đơn giản hơn) 

 A  Tác giả [AI Prime Tech](https://aiprimetech.io/vi/)  · Có AI hỗ trợ    

Claude Code Router cho phép bạn kết nối Claude Code với các mô hình khác thông qua một cổng kết nối cục bộ xử lý việc chọn nhà cung cấp, chuyển đổi giao thức và định tuyến. Hướng dẫn này trình bày cách cài đặt, hồ sơ tác nhân, phương án dự phòng và tích hợp OpenCode Go có trong v3.1.1 tính đến ngày 17 tháng Chín năm 2026. Bạn cũng sẽ tìm hiểu khi nào một cổng kết nối được lưu trữ sẵn giúp giảm các bước thiết lập cục bộ. 

## Claude Code Router có chức năng gì 

Claude Code Router của musistudio, thường được viết tắt là CCR, tự mô tả là một “cổng kết nối mô hình cục bộ và lớp điều khiển cho các tác nhân lập trình”. Công cụ cung cấp một điểm cuối cục bộ ổn định cho Claude Code và các ứng dụng khách khác, cùng thông tin xác thực của nhà cung cấp, quy tắc định tuyến, cơ chế thử lại, các phương án dự phòng theo thứ tự và nhật ký yêu cầu. 

Thư mục [v3.1.1 README](https://raw.githubusercontent.com/musistudio/claude-code-router/v3.1.1/README.md) liệt kê khả năng hỗ trợ các định dạng OpenAI Chat và Responses, Anthropic Messages, cùng Gemini Generate Content và Interactions. Việc chuyển đổi giao thức giúp Claude Code có thể chạy với các mô hình khác thông qua CCR. 

CCR được cấp phép theo MIT, với bản quyền thuộc musistudio năm 2025, và được cung cấp “NGUYÊN TRẠNG”. Quyền sử dụng phần mềm không đồng nghĩa với việc suy luận qua nhà cung cấp thượng nguồn là miễn phí. Phí và hạn mức của nhà cung cấp vẫn được tính riêng; giá trước đây của nhà cung cấp và hạn mức tính bằng đô la của OpenCode Go chưa được xác minh cho ngày xuất bản này. 

### Bản phát hành Claude Code Router 3.1 liên quan 

Phiên bản 3.1.1 được phát hành vào ngày 16 tháng Chín năm 2026. Phiên bản này bổ sung hỗ trợ nhập cục bộ tích hợp sẵn cho OpenCode Go, hiển thị từng lần xử lý thất bại tại cổng kết nối và sửa cách tính giá sử dụng cho các mô hình được định tuyến. 

Bản phát hành này cũng chấp nhận --daemon trên start và serve, sửa worker xử lý nội dung nhật ký của giao diện Docker và cung cấp các bản dựng cho macOS Apple Silicon và Intel, trình cài đặt Windows cùng AppImage cho Linux. Phần thiết lập bên dưới sử dụng bản phân phối npm và tài liệu được cố định ở v3.1.1. 

## Cài đặt CCR và kết nối Claude Code 

Bản phân phối npm yêu cầu Node.js 22 trở lên. Tài liệu [hướng dẫn CLI được cố định theo phiên bản](https://raw.githubusercontent.com/musistudio/claude-code-router/v3.1.1/docs/src/content/docs/en/guides/cli.md) trình bày các lệnh sau: 

```
npm install -g @musistudio/claude-code-router
ccr --help
ccr ui

```

Để khởi động mà không mở trình duyệt: 

```
ccr ui --no-open

```

Giao diện quản lý và cổng kết nối mô hình có các địa chỉ mặc định riêng: 

  | Thành phần  | Địa chỉ mặc định  | Mục đích    

  | Giao diện quản lý  | http://127.0.0.1:3458  | Cấu hình nhà cung cấp, hồ sơ và định tuyến  

  | Cổng kết nối mô hình  | http://127.0.0.1:3456  | Nhận yêu cầu mô hình từ các ứng dụng khách    

Phân biệt rõ các vai trò này sẽ hữu ích khi kiểm tra vị trí kết nối gặp lỗi. Việc trang quản lý hoạt động không tự nó xác nhận rằng cổng kết nối mô hình đã chấp nhận cấu hình. 

### Thêm nhà cung cấp và khóa ứng dụng khách 

Mở Nhà cung cấp → Thêm nhà cung cấp, chọn một cấu hình có sẵn hoặc Khác / điểm cuối API tùy chỉnh, rồi nhập điểm cuối và khóa API. CCR phát hiện các giao thức và mô hình; Cài đặt nâng cao cho phép bạn chọn giao thức theo cách thủ công. 

Sử dụng Kiểm tra kết nối để kiểm tra nhà cung cấp. Thao tác này gửi một yêu cầu thực, nên có thể tiêu thụ token hoặc một phần hạn mức yêu cầu của nhà cung cấp. 

Tạo một khóa ứng dụng khách CCR trên Khóa API cho các yêu cầu mô hình. Khóa đó tách biệt với token của giao diện quản lý/RPC: hãy coi quyền truy cập của ứng dụng khách và quyền truy cập quản lý là các mục cấu hình riêng biệt. 

### Tạo hồ sơ Claude Code 

Trong Cấu hình tác nhân, tạo một hồ sơ được bật cho Claude Code, chọn một mô hình như Provider/model, rồi lưu. Với hồ sơ có tên “Claude Code - Work”, hãy khởi chạy bằng: 

```
ccr "Claude Code - Work"

```

Các lệnh khởi chạy do ứng dụng máy tính tạo sử dụng ccr-app. Tài liệu [hướng dẫn hồ sơ Claude Code](https://raw.githubusercontent.com/musistudio/claude-code-router/v3.1.1/docs/src/content/docs/en/configuration/agents/claude-code.md) phân biệt hai phạm vi:  
- Chỉ mở từ CCR áp dụng cấu hình cho các lần khởi chạy từ CCR. 
- Mặc định hệ thống cũng ảnh hưởng đến các lần khởi chạy Claude Code trực tiếp.  

Hồ sơ hỗ trợ ghi đè Fable, Opus, Sonnet và Haiku. Xác minh lựa chọn đang hoạt động bằng /model, sau đó kiểm tra mục Nhật ký yêu cầu của CCR để xem các yêu cầu đi qua cổng kết nối. Hãy để [hướng dẫn về mô hình Claude Code](/vi/claude-code/models/) ở gần để tham khảo khi lập kế hoạch cho các lựa chọn đó. 

## Cấu hình định tuyến, thử lại và phương án dự phòng 

Các quy tắc định tuyến của CCR có thể kiểm tra request.header và request.body, và có thể viết lại request.body.model. Điều này cho phép bạn kiểm soát việc chọn mô hình dựa trên yêu cầu đầu vào, ngoài mô hình được chọn trong hồ sơ tác nhân. 

Cấu hình phương án dự phòng sử dụng mode, models, và retryCount. Ba chế độ là off, retry, và model-chain. 

  | Hành vi  | Phản hồi liên quan  | Tác động khi vận hành    

  | Thử lại  | 408, 409, 429 và 5xx  | Thử lại yêu cầu sau các lỗi đủ điều kiện  

  | Đích dự phòng  | Bất kỳ 4xx hoặc 5xx nào  | Có thể chuyển yêu cầu sang một mô hình khác đã được cấu hình  

  | Xử lý độ trễ  | Giá trị dương của Retry-After, nếu có  | Sử dụng thời gian chờ thử lại được cung cấp  

  | Thời gian chờ mặc định  | Khi không có giá trị dương của Retry-After được áp dụng  | Bắt đầu từ một giây, giới hạn ở 30 giây cho mỗi lần thử    

Sự khác biệt giữa điều kiện thử lại và điều kiện chuyển sang phương án dự phòng rất quan trọng. Một phản hồi không đủ điều kiện để thử lại vẫn có thể đủ điều kiện để chuyển sang đích dự phòng. 

### Kiểm tra mô hình thực sự xử lý yêu cầu 

Một chuỗi mô hình có thể thay đổi mô hình cuối cùng xử lý yêu cầu. Nhật ký CCR hiển thị nhà cung cấp và mô hình cuối cùng, vì vậy hãy dùng những nhật ký đó khi kiểm tra hành vi hoặc mức sử dụng ngoài dự kiến. 

Bắt đầu với một hồ sơ mà bạn có thể xác định nhà cung cấp và mô hình. Thêm quy tắc định tuyến và đích dự phòng một cách có chủ đích, rồi kiểm tra đích cuối cùng sau khi chạy thử chúng. Cách này giúp dễ liên hệ những thay đổi về phản hồi hoặc chi phí với cấu hình định tuyến. 

Phiên bản 3.1.1 cũng hiển thị từng lần xử lý thất bại tại cổng kết nối. Các bản ghi đó giúp phân biệt phản hồi cuối cùng thành công với những lần thử trước đó. 

## Sử dụng tính năng nhập OpenCode Go trong v3.1.1 

Bản phát hành Claude Code Router v3.1.1 của musistudio bổ sung hỗ trợ nhập cục bộ tích hợp sẵn cho OpenCode Go. Tích hợp này tách riêng Zen, được định danh là opencode, khỏi Go, được định danh là opencode-go, bao gồm cả thông tin xác thực và các ID mô hình trùng nhau của chúng. 

Trình nhập đọc cấu hình OpenCode, auth.json, và siêu dữ liệu mô hình được lưu trong bộ nhớ đệm. OPENCODE_API_KEY áp dụng cho cả hai dịch vụ; OPENCODE_GO_API_KEY cung cấp cấu hình ghi đè riêng cho Go. Quá trình khám phá lọc mô hình theo giao thức và đối chiếu siêu dữ liệu đã lưu trong bộ nhớ đệm với kết quả trực tiếp từ /models . 

### Vì sao header phiên lại quan trọng 

Thư mục [PR tích hợp OpenCode Go](https://github.com/musistudio/claude-code-router/pull/1786) ghi nhận rằng các yêu cầu gửi đến https://opencode.ai/zen/go/v1 yêu cầu x-opencode-session. Nếu thiếu, điểm cuối sẽ trả về 400 MissingSessionID. 

CCR chọn giá trị phiên theo thứ tự sau: cấu hình tường minh, header tường minh từ ứng dụng khách, các header phiên Claude, metadata.user_id, và cuối cùng là giá trị dự phòng ổn định theo tiến trình. Việc chèn header chỉ áp dụng cho điểm cuối Go chính thức. 

Điều này giải thích vì sao chỉ nhập điểm cuối và thông tin xác thực có thể chưa đủ đối với Go. Yêu cầu về phiên là một phần của cơ chế tích hợp nhà cung cấp. 

### Làm mới kết quả khám phá và xem giới hạn sử dụng 

Nếu không thể nhập từ Go, hãy kết nối OpenCode Go trong OpenCode, làm mới bộ nhớ đệm mô hình cục bộ của ứng dụng, rồi quét lại trong CCR. 

CCR lấy dữ liệu sử dụng từ GET https://opencode.ai/zen/go/v1/usage và hiển thị tỷ lệ phần trăm còn lại cho các khoảng thời gian năm giờ, hằng tuần và hằng tháng. Tài liệu được ghim không nêu hạn mức tính bằng đô la. Hãy hiểu các giá trị này là tỷ lệ phần trăm còn lại trong các khoảng thời gian được nêu; chúng không thể hiện số dư tiền. 

## Khắc phục sự cố kết nối theo từng giai đoạn 

Tài liệu khắc phục sự cố của CCR đề cập đến việc bỏ qua định tuyến, lỗi xác thực, thiếu mô hình, lựa chọn mô hình ngoài dự kiến, chi phí tăng đột biến, hết thời gian chờ và thiếu dấu vết tác tử. Một trình tự chẩn đoán hữu ích là theo dõi yêu cầu từ cấu hình khởi chạy đến nhà cung cấp cuối cùng. 

### Claude Code bỏ qua CCR 

Kiểm tra xem hồ sơ Agent Config dự định sử dụng đã được bật hay chưa và bạn có khởi chạy thông qua hồ sơ đó hay không. Hồ sơ được đặt thành Chỉ mở từ CCR chỉ áp dụng cấu hình cho các lần khởi chạy qua CCR; các lần khởi chạy trực tiếp chịu ảnh hưởng khi Mặc định hệ thống được chọn. 

Sử dụng /model và nhật ký Request của CCR cùng nhau để xác minh thiết lập. Tài liệu [tài liệu tham khảo CLI của Claude Code](/vi/claude-code/cli/) cung cấp nguồn tham khảo rộng hơn về cách làm việc với ứng dụng khách. 

### Lỗi xác thực hoặc thiếu mô hình 

Đối với lỗi 401/403, hãy kiểm tra thông tin xác thực ở từng lớp liên quan: khóa API của nhà cung cấp, khóa ứng dụng khách CCR dùng cho yêu cầu mô hình và token quản lý riêng biệt. Các thông tin xác thực này có vai trò khác nhau. 

Đối với model not found, hãy kiểm tra các mô hình đã phát hiện, giao thức đã chọn và lựa chọn nhà cung cấp/mô hình của hồ sơ. Với OpenCode Go, hãy làm mới bộ nhớ đệm cục bộ và quét lại nếu không thể nhập. 

### Lỗi khởi động và hết thời gian chờ 

Phiên bản 3.1.1 tăng thời gian chờ chấp nhận cấu hình gateway từ năm giây lên 30 giây. Điều này giải quyết các trường hợp giao diện quản lý khởi động nhưng gateway gặp lỗi khi máy chủ chịu tải, đặc biệt trên Windows. 

CCR_GATEWAY_CONFIG_TIMEOUT_MS ghi đè thời gian chờ. Giá trị không hợp lệ hoặc thấp hơn 1,000 mili giây sẽ quay về giá trị mặc định. 

Cấu hình được lưu trong ~/.claude-code-router trên macOS/Linux và %APPDATA%\claude-code-router trên Windows. Các tệp liên quan bao gồm config.sqlite, tệp được tạo gateway.config.json, và service.json. Các lệnh dịch vụ bao gồm ccr start, ccr stop, và lệnh chạy ở tiền cảnh ccr serve. 

## Khi nào gateway được lưu trữ sẵn đơn giản hơn 

CCR phù hợp với các quy trình cần quản lý nhà cung cấp cục bộ, định tuyến theo yêu cầu, nhóm thông tin xác thực hoặc chuỗi dự phòng tường minh. Gateway được lưu trữ sẵn có thể giảm số bước thiết lập cục bộ khi mục tiêu trước mắt của bạn là kết nối Claude Code với một dịch vụ thượng nguồn. 

Thông báo của OpenRouter [ngày 4 tháng Tám năm 2026](https://openrouter.ai/blog/announcements/ori-harness/) nêu các thiết lập kết nối sau: 

```
ANTHROPIC_BASE_URL=https://openrouter.ai/api
ANTHROPIC_AUTH_TOKEN=<openrouter-api-key>
ANTHROPIC_API_KEY=

```

Thông báo cũng nêu các thiết lập bổ sung cho mô hình và tính năng. Ba biến này là các thiết lập kết nối, không phải cấu hình đầy đủ cho mọi mô hình. OpenRouter lưu ý rằng phần lớn mô hình mở không hỗ trợ tìm kiếm công cụ, nên thiết lập sẽ khác nhau tùy mô hình. 

Ori CLI của dịch vụ tự động hóa việc thiết lập thông qua: 

```
ori login
ori claude

```

Các quy trình tương tự cũng có thể chạy qua một API gateway như AI Prime Tech, một dịch vụ độc lập không liên kết với Anthropic hay OpenAI; xem hướng dẫn về [sử dụng Claude Code với khóa API](/vi/learn/claude-code-api-key-setup/). 

Hãy lựa chọn dựa trên các khả năng kiểm soát bạn cần. CCR cung cấp một nơi cục bộ để quản lý tuyến, kiểm tra các lần thử và cấu hình phương án dự phòng; cách tiếp cận dùng dịch vụ lưu trữ sẵn được nêu trong tài liệu loại bỏ nhu cầu vận hành CCR cục bộ. 

## Những điểm chính  
- Claude Code Router kết nối Claude Code và các ứng dụng khách khác với nhà cung cấp thông qua một điểm cuối cục bộ ổn định, có khả năng chuyển đổi giao thức. 
- Bản phân phối npm yêu cầu Node.js 22+, và giao diện quản lý cùng gateway mô hình sử dụng các cổng mặc định riêng biệt. 
- Phạm vi Agent Config xác định liệu hồ sơ chỉ áp dụng cho các lần khởi chạy qua CCR hay cả các lần khởi chạy trực tiếp. 
- Các phương án dự phòng có thể thay đổi mô hình xử lý yêu cầu; hãy kiểm tra nhật ký Request để biết nhà cung cấp và mô hình cuối cùng. 
- v3.1.1 bổ sung khả năng nhập từ OpenCode Go với thông tin xác thực riêng và xử lý header phiên bắt buộc. 
- Gateway được lưu trữ sẵn có thể giảm việc thiết lập cục bộ khi bạn không cần các khả năng kiểm soát định tuyến cục bộ của CCR.  

## Câu hỏi thường gặp 

### Claude Code Router có miễn phí không? 

Claude Code Router được cấp phép theo giấy phép MIT, cho phép sử dụng phần mềm. Điều đó không có nghĩa là hoạt động suy luận ở thượng nguồn được miễn phí, và giá trước đây của nhà cung cấp hay hạn mức bằng đô la của OpenCode Go không được xác minh ở đây. 

### Tôi có thể dùng Claude Code với các mô hình khác thông qua CCR không? 

Có. CCR cung cấp khả năng chuyển đổi giao thức và lựa chọn nhà cung cấp/mô hình, đồng thời các hồ sơ Claude Code của CCR cho phép bạn chọn mô hình như Provider/model. Các định dạng thượng nguồn được hỗ trợ bao gồm OpenAI Chat/Responses, Anthropic Messages và Gemini Generate Content/Interactions. 

### Claude Code Router 3.1.1 có gì thay đổi? 

Được phát hành ngày 16 tháng Chín năm 2026, v3.1.1 bổ sung khả năng nhập cục bộ từ OpenCode Go được hỗ trợ trực tiếp, hiển thị từng lần thử thất bại và sửa cách tính giá sử dụng cho các mô hình được định tuyến. Phiên bản này cũng tăng thời gian chờ chấp nhận cấu hình gateway lên 30 giây và chấp nhận --daemon trên start và serve. 

### Vì sao OpenCode Go trả về MissingSessionID? 

Điểm cuối OpenCode Go chính thức yêu cầu header x-opencode-session và trả về 400 MissingSessionID khi thiếu header này. Cơ chế tích hợp Go của CCR chọn giá trị phiên theo thứ tự ưu tiên đã xác định và chỉ chèn header cho điểm cuối Go chính thức. 

[Claude](/vi/blog/tag/claude/)[Lập trình](/vi/blog/tag/coding/)[Mã nguồn mở](/vi/blog/tag/open-source/) 

A

[AI Prime Tech](https://aiprimetech.io/vi/)

AI Prime Tech xuất bản blog này. Các bài viết được soạn với sự hỗ trợ của AI; hãy đối chiếu những chi tiết phụ thuộc vào phiên bản như ID mô hình, giá và giới hạn với tài liệu chính thức trước khi dựa vào chúng. 

 Truy cập Claude API với chi phí thấp hơn 

Một khóa API cho Claude Opus 5.5, Sonnet 5, Haiku 4.5 và Fable 5.1, cùng GPT-6 mô hình. Thanh toán theo mức sử dụng, không cần đăng ký thuê bao. [Nhận khóa API của bạn →](/register)  

AI Prime Tech là cổng API bên thứ ba độc lập. Claude™ và Anthropic® là các nhãn hiệu của Anthropic, PBC. Không hàm ý có sự liên kết hay chứng thực.