Trả lời nhanh: Bạn có thể chạy ERNIE 5.5 Flash miễn phí trong OpenCode và Claude Code thông qua endpoint baidu/ernie-5.5-flash-preview:free của OpenRouter. Trong OpenCode, kết nối OpenRouter và đặt "model": "openrouter/baidu/ernie-5.5-flash-preview:free". Trong Claude Code, trỏ ANTHROPIC_BASE_URL tới OpenRouter và cố định slug của ERNIE làm model của bạn. Chi phí là $0 mỗi token, nhưng nếu chưa mua credit bạn chỉ được 50 yêu cầu mỗi ngày.
Giới hạn hàng ngày này chính là yếu tố quyết định đối với coding agent. Agent không chỉ gửi một yêu cầu cho mỗi tác vụ; nó gửi một yêu cầu cho mỗi bước. Bài hướng dẫn này sẽ thiết lập cả hai agent, trình bày một tác vụ lập trình phù hợp với ngân sách miễn phí, và chỉ ra điểm mà đường dẫn miễn phí gặp trục trặc.
Tất cả giới hạn dưới đây đã được kiểm tra trên các trang chính thức của OpenRouter vào ngày 12 tháng 11 năm 2026.
ERNIE 5.5 Flash Preview là gì?
ERNIE 5.5 Flash Preview là model chat và agent của Baidu được phát hành vào ngày 10 tháng 11 năm 2026. Đây là model sparse mixture-of-experts với tổng cộng 280 tỷ tham số, 14 tỷ tham số hoạt động cho mỗi token và cửa sổ ngữ cảnh 1.024.000 token. Baidu định vị nó cho lập trình, công việc dạng agentic và nghiên cứu chuyên sâu, còn OpenRouter liệt kê nó là model có khả năng suy luận (reasoning) và hỗ trợ gọi công cụ (tool calling).
Còn có một phiên bản ERNIE 5.5 Flash Base chỉ dành cho tiền huấn luyện (pretraining) trên Hugging Face, nhưng đó là bản để bạn fine-tune hoặc tự vận hành. Phiên bản Preview mới là thứ mà coding agent của bạn giao tiếp. Để xem phân tích chi tiết về model, hãy đọc bài ERNIE 5.5 Flash là gì. Nếu bạn đang chuyển từ thế hệ trước, bài tổng quan ERNIE 5.1 sẽ trình bày những thay đổi.
Giới hạn miễn phí của ERNIE 5.5 Flash trên OpenRouter
Trang model của OpenRouter hiển thị biến thể :free với giá $0 đầu vào và $0 đầu ra, được cung cấp bởi một nhà cung cấp duy nhất, Baidu Qianfan. Các giới hạn tốc độ đến từ tài liệu giới hạn của OpenRouter và áp dụng cho mọi model ID kết thúc bằng :free.
| Mục | Giá trị (kiểm tra ngày 12-11-2026) |
|---|---|
| Model ID | baidu/ernie-5.5-flash-preview:free |
| Giá | $0 đầu vào, $0 đầu ra |
| Cửa sổ ngữ cảnh | 1.024.000 token |
| Yêu cầu mỗi phút | 20 |
| Yêu cầu mỗi ngày, tổng credit từng mua dưới 10 | 50 |
| Yêu cầu mỗi ngày, tổng credit từng mua từ 10 trở lên | 1.000 |
| Nhà cung cấp phía sau | 1 (Baidu Qianfan) |
Hai chi tiết quan trọng đối với agent. Trang giá của OpenRouter cho biết các lần thử thất bại cũng được tính vào giới hạn hàng ngày. Và số dư credit âm sẽ chặn các model miễn phí với lỗi 402 cho đến khi bạn nạp thêm.
Mức 1.000 yêu cầu mỗi ngày phụ thuộc vào credit bạn đã mua, không phải credit bạn chi tiêu.
Thiết lập ERNIE 5.5 Flash trong OpenCode
OpenCode hỗ trợ OpenRouter gốc, nên đây là cách thiết lập ngắn hơn trong hai cách. Bạn cần một tài khoản OpenRouter và một API key từ dashboard OpenRouter.
- Cài đặt hoặc cập nhật OpenCode, sau đó khởi động trong thư mục dự án của bạn:
cd your-project
opencode
- Kết nối OpenRouter. Trong OpenCode, chạy
/connect, chọn OpenRouter và dán key của bạn. Bạn cũng có thể xuất biến môi trường trước khi khởi động:
export OPENROUTER_API_KEY="sk-or-v1-..."
- Cố định model trong
opencode.jsonở thư mục gốc dự án. Tài liệu providers của OpenCode hướng dẫn sử dụng đầy đủ model ID của OpenRouter sau tiền tốopenrouter/:
{
"$schema": "https://opencode.ai/config.json",
"model": "openrouter/baidu/ernie-5.5-flash-preview:free"
}
- Xác nhận lựa chọn bằng
/models. Nếu ERNIE không xuất hiện trong danh sách, giá trị trong config vẫn có hiệu lực, nên hãy kiểm tra chính tả của slug, bao gồm cả:free.
Từ giờ, mỗi prompt sẽ được gửi tới ERNIE 5.5 Flash Preview qua OpenRouter. Nếu bạn đã theo dõi hướng dẫn GLM-5.3-Flash với OpenCode hoặc hướng dẫn DeepSeek V4.1 Flash của chúng tôi, quy trình hoàn toàn giống nhau: chỉ cần thay slug.
Thiết lập ERNIE 5.5 Flash trong Claude Code
Claude Code có thể giao tiếp với OpenRouter vì OpenRouter cung cấp endpoint Messages tương thích với Anthropic. Trang model của ERNIE liệt kê POST https://openrouter.ai/api/v1/messages là route được hỗ trợ cho model này.
Hãy nắm rõ mức độ hỗ trợ trước. Hướng dẫn tích hợp Claude Code của OpenRouter nói rằng Claude Code với OpenRouter "chỉ được đảm bảo hoạt động với nhà cung cấp chính thức Anthropic" và rằng Claude Code "có thể không hoạt động chính xác với các nhà cung cấp khác". Chạy ERNIE ở đây hoạt động thông qua các cài đặt được tài liệu hóa, nhưng đây không phải là kết hợp được đảm bảo.
- Đặt các biến kết nối trong hồ sơ shell của bạn, đúng như OpenRouter tài liệu hóa:
export OPENROUTER_API_KEY="sk-or-v1-..."
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY="" # must be explicitly empty
- Cố định ERNIE cho mọi loại model mà Claude Code sử dụng, để không bước nào âm thầm chuyển sang model Anthropic trả phí:
export ANTHROPIC_DEFAULT_OPUS_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_SONNET_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="baidu/ernie-5.5-flash-preview:free"
Bạn có thể đặt các khóa tương tự vào khối env của .claude/settings.json nếu muốn giới hạn thiết lập cho một dự án.
- Tải lại shell, khởi động
claude, và chạy/status. Bạn sẽ thấyAuth token: ANTHROPIC_AUTH_TOKENvàAnthropic base URL: https://openrouter.ai/api. Nếu nó hiển thịANTHROPIC_API_KEYhoặc đăng nhập tài khoản Claude, nghĩa là các biến chưa đến được phiên làm việc. - Mở
/modelđể xác nhận các loại model trỏ tới ERNIE, sau đó kiểm tra cột model trong bảng hoạt động OpenRouter sau prompt đầu tiên của bạn.
Chúng tôi trình bày chi tiết thiết lập Claude Code tổng quát trong bài cách dùng Claude Code với OpenRouter.
Một tác vụ lập trình thực tế phù hợp với 50 yêu cầu
Với 50 yêu cầu mỗi ngày, bạn không thể để agent tự do lang thang. Hãy giao cho nó một tác vụ có giới hạn mà bạn đã biết "hoàn thành" trông như thế nào. Dưới đây là một tác vụ hoạt động tốt trên repo nhỏ:
In src/routes/orders.ts, GET /orders/:id returns 500 when the order
doesn't exist. Make it return 404 with {"error":"order_not_found"}.
Read only the files you need, make the smallest change, then run
the orders tests with npm test and stop. Don't refactor anything else.
Tại sao dạng này hiệu quả trên gói miễn phí:
- Nó nêu rõ tên file. Agent bỏ qua việc tìm kiếm toàn repo, tiết kiệm nhiều yêu cầu.
- Nó xác định rõ bản sửa. Mã trạng thái và nội dung phản hồi đã có trong prompt, không phải qua lại hỏi đáp.
- Nó giới hạn phạm vi. "Dừng sau khi chạy test" kết thúc vòng lặp thay vì để agent mài giũa mã.
Một tác vụ như vậy thường chỉ cần một ít lần gọi model: đọc route, đọc trình xử lý lỗi, sửa mã, chạy test, báo cáo. Một prompt mơ hồ như "dọn dẹp module orders" có thể đốt sạch hạn mức cả ngày trước khi có gì được hoàn thành.
Cửa sổ ngữ cảnh 1M là lý do khác khiến ERNIE phù hợp với agent. Bạn có thể dán một stack trace dài hoặc cả file OpenAPI vào một prompt thay vì trải qua nhiều lượt. Một yêu cầu lớn tốt hơn năm yêu cầu nhỏ khi mỗi yêu cầu đều đáng giá.
Cho ERNIE chạy các bài test API của bạn với Apidog CLI
Sau khi agent đã sửa một endpoint, bạn cần bằng chứng rằng API vẫn hoạt động đúng, chứ không chỉ một unit test pass. Apidog CLI cho phép cùng agent đó chạy các kịch bản test mà nhóm của bạn đã lưu trong Apidog, đọc các lỗi thất bại, sửa mã và chạy lại. Bạn chỉ viết một prompt; ERNIE sẽ chạy các lệnh.
Cài đặt CLI, đăng nhập và thêm kỹ năng agent:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick OpenCode or Claude Code when prompted
Sau đó đưa cho agent một prompt:
Run the "Orders API" test scenario in Apidog project <projectId> against
the local environment. If any step fails, find the endpoint in this repo
that causes it, fix it, and rerun the scenario until it passes.
Summarize what you changed.
Agent tìm kịch bản, chạy với báo cáo JSON mà nó có thể phân tích, rồi chạy lại sau khi sửa:
apidog test-scenario list --project <projectId>
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --out-dir ./apidog-reports
# agent edits the failing route, then:
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --upload-report
Cờ --upload-report gửi tóm tắt lần chạy tới Apidog để nhóm của bạn có thể mở trong ứng dụng. apidog test-report list --project <projectId> truy xuất các lần chạy trước nếu agent cần so sánh.
Tuy nhiên, hãy tính toán ngân sách. Mỗi lần chạy test, đọc báo cáo và sửa mã là một bước của agent, nên một vòng sửa-và-chạy-lại có thể tốn tới 10 yêu cầu model. Với mức 50 yêu cầu mỗi ngày, chỉ chạy vòng lặp này một hoặc hai lần, đừng chạy cả buổi chiều. Hướng dẫn Apidog CLI trong Claude Code và tài liệu tham khảo lệnh apidog run trình bày các cờ còn lại. Gói Free của Apidog hỗ trợ nhóm tối đa 4 người dùng.
Khi đường dẫn miễn phí gặp trục trặc
Endpoint miễn phí là một model preview phía sau một nhà cung cấp duy nhất. Dưới đây là những gì bạn nên mong đợi và cách xử lý.
| Triệu chứng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
429 sau một loạt bước liên tiếp |
20 yêu cầu mỗi phút | Giảm tốc agent hoặc chờ một phút |
429 trong phần còn lại của ngày |
Đã dùng hết 50 yêu cầu hàng ngày (các lần thử thất bại cũng được tính) | Chờ đặt lại theo giờ UTC hoặc mua 10 credit để có 1.000 yêu cầu mỗi ngày |
402 trên model miễn phí |
Số dư tài khoản âm | Nạp credit để đưa số dư lên trên 0 |
| Agent gặp lỗi với đầu ra JSON | Lỗi đầu ra có cấu trúc | Yêu cầu văn bản thuần và tự phân tích |
| Các tính năng Claude Code hoạt động sai | Model không phải Anthropic phía sau Claude Code | Dùng OpenCode cho ERNIE, hoặc chuyển model về mặc định |
Dòng về đầu ra có cấu trúc xứng đáng có con số cụ thể. Vào ngày 12 tháng 11 năm 2026, trang model của OpenRouter hiển thị tỷ lệ lỗi đầu ra có cấu trúc là 21,70% và tỷ lệ lỗi gọi công cụ là 1,01% cho endpoint này. Gọi công cụ — thứ mà coding agent dựa vào — trông ổn. Còn schema JSON nghiêm ngặt thì không, nên hãy giữ quy trình agent trên công cụ và văn bản thuần.
Tốc độ cũng khác với con số quảng cáo. Mô tả của Baidu khẳng định hơn 200 token mỗi giây, trong khi OpenRouter đo được P50 là 79 token mỗi giây trên endpoint miễn phí vào ngày đó.
Cuối cùng, "Preview" có trong tên là có lý do. Model, các giới hạn của nó và biến thể :free có thể thay đổi mà không báo trước. Nếu slug không còn hoạt động, hãy kiểm tra trang OpenRouter trước khi debug cấu hình. Để truy cập trả phí hoặc trực tiếp, hướng dẫn API ERNIE 5.5 Flash đề cập đến Baidu Qianfan.
Câu hỏi thường gặp
ERNIE 5.5 Flash có thực sự miễn phí trong OpenCode? Có. Endpoint baidu/ernie-5.5-flash-preview:free có giá $0 cho mỗi token đầu vào và đầu ra trên OpenRouter. Bạn bị giới hạn 20 yêu cầu mỗi phút và 50 mỗi ngày trừ khi đã mua ít nhất 10 credit OpenRouter.
Claude Code có chính thức hỗ trợ ERNIE 5.5 Flash không? Không chính thức. OpenRouter tài liệu hóa cách trỏ Claude Code tới các model khác, nhưng nói rằng thiết lập này chỉ được đảm bảo với nhà cung cấp chính thức Anthropic. Nó vẫn chạy, nhưng hãy sẵn sàng gặp vấn đề với công cụ. OpenCode là lựa chọn an toàn hơn cho ERNIE.
Model ID của ERNIE 5.5 Flash trên OpenRouter là gì? Đó là baidu/ernie-5.5-flash-preview:free cho biến thể miễn phí. Trong OpenCode, thêm tiền tố openrouter/ vào trước. Trong Claude Code, dùng nguyên dạng trong các biến ANTHROPIC_DEFAULT_*_MODEL.
Với 50 yêu cầu mỗi ngày, tôi có thể hoàn thành bao nhiêu tác vụ lập trình? Tùy thuộc vào tác vụ. Một bản sửa có phạm vi chặt chẽ có thể tốn 5 đến 10 bước agent, nên vài tác vụ là vừa. Các bản refactor mở có thể dùng hết hạn mức trong một lần. Hãy nêu rõ tên file và định nghĩa "hoàn thành" trong prompt của bạn.
Tôi có thể dùng toàn bộ ngữ cảnh 1 triệu token miễn phí không? OpenRouter liệt kê cửa sổ ngữ cảnh 1.024.000 token cho biến thể miễn phí, giống với cửa sổ đầy đủ của model. Các prompt lớn vẫn tính là một yêu cầu mỗi prompt, điều này giúp prompt ngữ cảnh dài hiệu quả với giới hạn hàng ngày.
Có lựa chọn miễn phí nào không qua OpenRouter không? Hướng dẫn dùng ERNIE 5.5 Flash miễn phí của chúng tôi so sánh mọi đường dẫn $0. Baidu cũng đã công bố ERNIE 5.5 Flash Base trên Hugging Face, mà bạn có thể tự vận hành, như trình bày trong bài chạy ERNIE 5.5 Flash cục bộ với vLLM.