Cursor là gì?
Cursor là trình chỉnh sửa mã đầu tiên dựa trên AI với tính năng trò chuyện tích hợp, quy trình làm việc của tổng đài viên, chỉnh sửa mã và các tính năng phát triển dựa trên mô hình.
Tài liệu Cursor hiện tại không thiết lập lộ trình nhà cung cấp tùy chỉnh chung. Hướng dẫn này coi TokenHub là có điều kiện: chỉ định cấu hình nó khi ứng dụng khách đã cài đặt của bạn cung cấp ghi đè Base URL tùy chỉnh một cách rõ ràng, sau đó kiểm tra từng tính năng một cách độc lập. Cursor không ghi lại đường dẫn chung của nhà cung cấp bên thứ ba cho mọi phiên bản, tài khoản và tính năng. Coi tuyến TokenHub là có điều kiện trên các điều khiển API-key và Base URL hiển thị, đồng thời thử nghiệm Trò chuyện tiêu chuẩn, Agent, Áp dụng và Tab Completion một cách độc lập vì các tính năng dành riêng cho Cursor có thể tiếp tục sử dụng các dịch vụ riêng biệt.
Cursor có thể định tuyến yêu cầu mô hình qua cổng API OpenAI compatible tương thích của TokenHub. Giữ nguyên cách cài đặt chính thức, sau đó thay API key, Base URL và model ID.
Use https://us-api.tokenhub.com/v1 as the OpenAI Base URL override. Depending on the Cursor version and selected model, Cursor may use Chat Completions or Responses-style requests, so do not assume a single endpoint path.
Khi nào nên dùng
Bắt đầu với repository nhỏ hoặc dự án thử nghiệm. Trước tiên yêu cầu công cụ đọc file, giải thích mã hoặc lập kế hoạch, rồi mới bật chỉnh sửa.
Cài đặt hoặc mở công cụ
Làm theo tài liệu chính thức của Cursor để cài đặt hoặc mở công cụ. Nếu giao diện thay đổi, ưu tiên tài liệu hiện tại.
Với công cụ CLI, hãy kiểm tra executable trước khi thêm thông tin xác thực TokenHub:
# open the tool, then open its model or provider settingsChuẩn bị thông tin xác thực TokenHub
Tạo TokenHub API key và chọn một mô hình phù hợp từ danh sách mô hình TokenHub.
export TOKENHUB_API_KEY="sk-..."Lưu key trong shell cục bộ, kho bí mật của IDE hoặc trường API key an toàn của công cụ. Không commit key vào repository.
Cấu hình nhà cung cấp TokenHub
Trong phần Models, Providers, API Keys hoặc OpenAI Compatible, nhập các giá trị dưới đây.
Giá trị provider
Cursor officially supports BYOK for specific providers and standard chat models. A custom OpenAI-compatible endpoint is currently a limited Base URL override, not a first-class custom provider.
| Trường | Giá trị |
|---|---|
| Settings | Cursor Settings → Models → API Keys |
| API key field | OpenAI API Key |
| Base URL option | Override OpenAI Base URL |
| Base URL | https://us-api.tokenhub.com/v1 |
| Mô hình | A TokenHub model compatible with the request format Cursor sends |
Vị trí file cài đặt
| Trường | Giá trị |
|---|---|
| macOS | ~/Library/Application Support/Cursor/User/settings.json |
| Windows | %APPDATA%\Cursor\User\settings.json |
| Linux | ~/.config/Cursor/User/settings.json |
Khi extension sở hữu schema riêng, hãy dùng UI cài đặt trước. UI sẽ lưu cùng giá trị vào user settings và tránh phải đoán private key có thể đổi theo phiên bản.
Custom keys apply only to standard chat models. Tab Completion and Cursor-owned models continue through Cursor. Some current Cursor versions can also send a Responses-shaped body to a Chat Completions path through the override, so verify a read-only chat before relying on Agent mode. If the Base URL override is absent or the request format is rejected, that Cursor version cannot connect to TokenHub reliably.
Do not map Chat, Agent, Composer, Apply, Fast, or Tab as if they were equivalent custom-provider slots. Start with one standard chat model and treat every other feature as unsupported until its requests appear successfully in TokenHub logs.
Biến môi trường tạm thời chỉ để debug
Khi extension sở hữu schema riêng, hãy dùng UI cài đặt trước. UI sẽ lưu cùng giá trị vào user settings và tránh phải đoán private key có thể đổi theo phiên bản.
Chỉ dùng biến tạm thời để kiểm tra key, mạng và tên mô hình. Sau khi xác minh, chuyển cùng giá trị vào cấu hình bền vững ở trên.
Xác minh kết nối
Trước tiên dùng prompt chỉ đọc để xác nhận mô hình đọc được ngữ cảnh và không sửa file. Sau đó mới thử chỉnh sửa hoặc tác vụ agent.
Đọc README của dự án và tóm tắt trong ba câu. Không chỉnh sửa file.Sau khi prompt chạy thành công, kiểm tra log TokenHub để xác nhận tên mô hình, endpoint, lượng token và billing group.
Khắc phục sự cố
| Hiện tượng | Cách xử lý |
|---|---|
| 401 hoặc lỗi xác thực | Kiểm tra TOKENHUB_API_KEY còn hợp lệ và đã lưu trong cùng terminal, IDE hoặc profile client. |
| 404 hoặc không tìm thấy mô hình | Dùng model ID có trong workspace TokenHub và phù hợp với giao thức đã chọn. |
| Sai endpoint | Giữ Base URL đúng như phần trên. Công cụ tương thích OpenAI thường cần /v1; công cụ tương thích Claude thường không cần. |
| Request timeout | Kiểm tra đường mạng tới https://us-api.tokenhub.com, proxy settings và allowlist của workspace. |
| Công cụ dùng mô hình khác | Kiểm tra lại mọi trường chat, edit, apply, fast hoặc autocomplete. |
Chọn mô hình
Cursor tùy chỉnh API compatibility FAQ
Tại sao không có cài đặt Ghi đè OpenAI Base URL trong Cursor?
Cài đặt thay đổi tùy theo phiên bản và tài khoản Cursor. Nếu không có các điều khiển ghi đè hiển thị, trang này sẽ không thiết lập tuyến cấu hình TokenHub trực tiếp.
Tại sao Tab Completion vẫn có thể sử dụng Cursor sau khi tôi định cấu hình TokenHub?
Khóa API tùy chỉnh hoặc ghi đè Base URL không nhất thiết phải áp dụng cho Tab Completion và các khả năng dành riêng cho Cursor khác.
Trò chuyện thành công có nghĩa là Cursor Agent cũng là compatible phải không?
Không. Các tính năng của Cursor có thể sử dụng các định dạng yêu cầu và đường dẫn mô hình khác nhau. Kiểm tra riêng trò chuyện, chỉnh sửa và Agent cũng như xem xét nhật ký yêu cầu TokenHub.
Làm cách nào để khắc phục sự cố 404 kiểu tùy chỉnh Cursor?
Kiểm tra xem Base URL có kết thúc bằng /v1 không và ID mẫu có được giao diện người dùng hiện tại chấp nhận hay không. Nếu TokenHub không nhận được yêu cầu thì tính năng Cursor đó có thể không sử dụng tính năng ghi đè.
Tôi nên kiểm tra riêng những tính năng Cursor nào?
Kiểm tra trò chuyện tiêu chuẩn, Agent, Áp dụng và Tab Completion một cách độc lập. Cài đặt nhà cung cấp tùy chỉnh có thể chỉ ảnh hưởng đến một số đường dẫn yêu cầu.
Tài liệu tham khảo
Cấu hình này dựa trên TokenHub và tài liệu chính thức; lần xác minh gần nhất: 2026-09-04。
