Trang chủHướng dẫn
Cấu hình endpoint tùy chỉnh cho API Claude Code trên Cursor
Bạn đang tìm cách thiết lập API Claude Code cho Cursor không phụ thuộc vào một nhà cung cấp? Cursor có thể kết nối với bất kỳ endpoint tương thích OpenAI nào, và hướng dẫn này sẽ hiển thị từng cài đặt bạn cần.
Cập nhật

Những gì bạn đang thiết lập
Cursor là một trình soạn thảo có tính năng AI tích hợp. Trong các cài đặt mô hình của nó có một trường cho phép bạn thay thế base URL OpenAI bằng của riêng bạn, cùng với nơi nhập khóa của bạn. Điều này cho phép gửi các yêu cầu trò chuyện đến bất kỳ dịch vụ nào tuân theo định dạng chat-completions của OpenAI. Dịch vụ này tuân theo, vì vậy Cursor có thể sử dụng nó làm mô hình phía sau trò chuyện và chỉnh sửa nội tuyến.
Các giá trị bạn sẽ nhập là cố định. Base URL: https://api.claudecodeapikey.com/v1. Tên mô hình: uncensored. Khóa: khóa từ tài khoản của bạn, được gửi dưới dạng token Bearer. Không cần cấu hình thêm ở phía máy chủ.
Hãy rõ ràng về những gì đây là. Mô hình phía sau endpoint là một mô hình trọng số mở từ nhà cung cấp độc lập. Nó không phải là mô hình Claude và không phải là API chính thức của Anthropic hay bất kỳ ai khác. Nếu bạn đến đây với kỳ vọng về chính Claude trong Cursor, đây là một thứ khác, và các phần cuối giải thích cách đánh giá xem nó có đủ tốt cho công việc của bạn hay không.
Trước khi mở Cursor
Chuẩn bị những điều này trước để bạn không dừng lại giữa chừng.
- Tạo tài khoản với Google hoặc với email và mật khẩu.
- Mở trang khóa API và tạo khóa. Hướng dẫn khóa cho biết vị trí của từng nút.
- Nhận tín dụng dùng thử $0,50 nếu bạn muốn kiểm tra mà không cần trả tiền. Nó chỉ cần một cú nhấp chuột, không cần thẻ và có hiệu lực trong 7 ngày.
- Chạy kiểm tra nhanh từ terminal để xác nhận khóa hoạt động trước khi đổ lỗi cho trình soạn thảo.
curl https://api.claudecodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'
Một phản hồi JSON với thông báo có nghĩa là khóa và URL đều tốt. HTTP 401 có nghĩa là khóa sai hoặc có khoảng trắng thừa. Sửa lỗi này ở đây, vì các thông báo lỗi của Cursor ít cụ thể hơn curl.
Cấu hình từng bước trong Cursor
Tên menu thay đổi giữa các phiên bản Cursor, vì vậy hãy coi các nhãn dưới đây là hướng dẫn và tìm kiếm sự phù hợp gần nhất.
- Mở cài đặt của Cursor và đi đến phần mô hình.
- Tìm trường cho khóa API OpenAI và dán khóa của bạn từ dịch vụ này.
- Bật tùy chọn ghi đè base URL OpenAI và nhập
https://api.claudecodeapikey.com/v1. Bao gồm/v1ở cuối và bỏ bất kỳ đường dẫn đuôi nào như/chat/completions. - Sử dụng tùy chọn thêm mô hình tùy chỉnh và gõ
uncensoredchính xác, viết thường. - Nhấn nút xác minh hoặc lưu bên cạnh trường khóa. Cursor gửi một yêu cầu kiểm tra nhỏ.
- Mở bảng trò chuyện, chọn
uncensoredtrong danh sách thả xuống mô hình và gửi một prompt ngắn.
Nếu bước xác minh thất bại nhưng lệnh curl đã thành công, hãy kiểm tra xem bạn đã nhập URL vào trường base URL thay vì trường khóa, và phiên bản Cursor của bạn không đặt lại phần ghi đè sau khi cập nhật. Hướng dẫn bắt đầu nhanh giữ các bước hiện tại cho trình soạn thảo này.
Một chi tiết đáng biết: một ghi đè duy nhất áp dụng cho khe nhà cung cấp OpenAI. Nếu bạn cũng sử dụng các mô hình OpenAI thực tế thông qua khe đó, chúng bây giờ sẽ được định tuyến đến endpoint này. Nhiều người giữ một hồ sơ Cursor riêng hoặc tắt ghi đè khi họ muốn chuyển lại.
Kiểm tra với một prompt lập trình thực tế
Một lời chào chứng minh rất ít. Hãy sử dụng một prompt thử nghiệm ngữ cảnh và hướng dẫn. Chọn một hàm trong dự án của bạn, mở trò chuyện và yêu cầu một thứ gì đó cụ thể, chẳng hạn như thêm xác thực đầu vào và kiểm tra đơn vị. Hãy chú ý đến ba điều.
- Truyền phát. Câu trả lời sẽ xuất hiện từng token một. Endpoint truyền phát qua SSE, vì vậy việc chờ đợi lâu rồi nhận được một khối văn bản cho thấy proxy hoặc cài đặt đang đệm nó.
- Sử dụng ngữ cảnh. Đính kèm hai hoặc ba tệp và đặt câu hỏi cần tất cả chúng. Cửa sổ ngữ cảnh là 100.000 token, chứa được rất nhiều mã nguồn, nhưng trình soạn thảo của bạn quyết định lượng dữ liệu thực tế gửi đi.
- Tuân thủ hướng dẫn. Yêu cầu phản hồi chỉ dưới dạng diff hoặc định dạng đầu ra nghiêm ngặt và xem liệu mô hình có tuân thủ hay không. Các mô hình trọng số mở khác biệt ở đây, và bạn nên tìm hiểu điều này ngay từ ngày đầu tiên.
Giữ một danh sách ngắn năm nhiệm vụ thực tế từ kho lưu trữ của riêng bạn và chạy lại chúng bất cứ khi nào bạn thay đổi cài đặt như nhiệt độ. Đánh giá từ mã của chính bạn tốt hơn bất kỳ tuyên bố chung nào, bao gồm cả của chúng tôi.
Sửa các lỗi thường gặp
401 hoặc khóa không hợp lệ
Khóa sai, đã hết hạn từ khay nhớ tạm của bạn hoặc có khoảng trắng xung quanh nó. Dán lại nó. Đảm bảo lược đồ Authorization là Bearer, Cursor làm điều này cho bạn khi bạn sử dụng trường khóa OpenAI.
404 hoặc không tìm thấy mô hình
Hầu như luôn là vấn đề base URL. Thiếu /v1 hoặc thêm /chat/completions sẽ phá vỡ đường dẫn. Tên mô hình cũng phải là uncensored, không có chữ hoa hoặc khoảng trắng.
429 với rate_limited hoặc concurrency
Bạn đã chạm giới hạn. Khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút, trong khi khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút. Trình soạn thảo có thể gửi nhiều yêu cầu cùng lúc, chẳng hạn như chat cộng với chỉnh sửa nền, và các luồng truyền phát giữ slot cho đến khi kết thúc. Mã lỗi cho bạn biết giới hạn nào: rate_limited là số yêu cầu mỗi phút, concurrency là quá nhiều yêu cầu cùng lúc. Quá tải tạm thời cũng trả về 429 với Retry-After: 5, vì vậy chờ năm giây và thử lại là đúng.
Câu trả lời bị cắt ngang
Cửa sổ ngữ cảnh là 100.000 token, prompt cộng với phần hoàn thành. Một tệp đính kèm rất lớn để lại ít chỗ cho câu trả lời. Gửi ít tệp hơn hoặc bắt đầu một cuộc trò chuyện mới.
Các tính năng không hoạt động
API chỉ là văn bản và không cung cấp embedding. Nếu một tính năng Cursor cần mô hình embedding hoặc đầu vào hình ảnh, nó sẽ không hoạt động thông qua endpoint này.
Các cài đặt nên tinh chỉnh khi đã hoạt động
Sau khi cuộc trò chuyện thành công đầu tiên, một số điều chỉnh giúp việc sử dụng hàng ngày mượt mà hơn.
Giảm nhiệt độ cho các tác vụ chỉnh sửa. Nếu trình soạn thảo của bạn cho phép, giá trị khoảng 0,2 giúp mã ổn định hơn. Để brainstorming, hãy tăng nó lên. Tiếp theo, hãy theo dõi lượng ngữ cảnh bạn đính kèm. Cửa sổ ngữ cảnh khá rộng, nhưng mọi tệp đính kèm đều được tính phí là đầu vào, vì vậy đóng các tab không liên quan và loại trừ các thư mục build giúp giảm chi phí và tập trung hơn vào câu trả lời.
Nếu bạn sử dụng chế độ agent hoặc đa bước, hãy nhớ hỗ trợ gọi hàm: endpoint chấp nhận tools và tool_choice và truyền phát tool_calls. Việc một tính năng Cursor cụ thể có sử dụng chúng hay không phụ thuộc vào phiên bản, vì vậy hãy chạy một tác vụ agent nhỏ và đọc những gì xảy ra trước khi tin tưởng nó cho một thay đổi lớn. Cuối cùng, hãy nhìn vào tiêu đề X-Balance-USD trong một bài kiểm tra terminal thỉnh thoảng, để số dư thấp không bao giờ làm bạn bất ngờ giữa công việc.
Sử dụng cùng khóa trong các tập lệnh
Một lợi thế của endpoint tương thích OpenAI là khóa bạn đã thiết lập trong Cursor cũng hoạt động trong mã. Đây là một ví dụ Node, hữu ích cho các tập lệnh build hoặc công cụ commit.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.claudecodeapikey.com/v1",
apiKey: process.env.API_KEY,
});
const out = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
],
});
console.log(out.choices[0].message.content);
Lưu khóa trong biến môi trường, không phải trong một tệp bạn commit. Mỗi phản hồi bao gồm tiêu đề X-Balance-USD, vì vậy một tập lệnh có thể cảnh báo bạn khi tín dụng thấp.
Chi phí và khi nào nên giữ nguyên
Sử dụng trong trình soạn thảo tốn nhiều token đầu vào vì mỗi yêu cầu mang ngữ cảnh tệp. Với giá $0,15 cho mỗi 1 triệu token đầu vào và $0,50 cho mỗi 1 triệu token đầu ra, một yêu cầu với 15.000 token đầu vào và 1.000 token đầu ra tốn 0,015 x $0,15 + 0,001 x $0,50 = $0,00225 + $0,0005 = $0,00275. Một trăm yêu cầu như vậy tốn $0,275. Trang giá cả có các mức nạp tiền, bắt đầu từ $20, kèm ưu đãi từ $50.
Hãy giữ nguyên thiết lập hiện tại nếu bạn phụ thuộc vào mô hình của một nhà cung cấp cụ thể cho các công việc tái cấu trúc phức tạp, hoặc nếu quy trình làm việc của bạn dựa vào các tính năng mà một endpoint chat đơn thuần không thể cung cấp. Hãy dùng dịch vụ này khi bạn muốn giá thấp trên mỗi token, một API đơn giản và ít từ chối nội dung hơn đối với các công việc hợp pháp. Nhiều nhà phát triển cấu hình cả hai và chuyển đổi tùy theo nhiệm vụ.
Hướng dẫn khác
Hỏi đáp
Tôi nhập Base URL nào trong Cursor?
Nhập https://api.claudecodeapikey.com/v1 bao gồm cả /v1. Không thêm /chat/completions vào cuối.
Tôi nên thêm tên mô hình nào?
Thêm một mô hình tùy chỉnh tên là uncensored, viết thường. Đây là ID mô hình duy nhất mà API cung cấp.
Điều này có cho tôi các mô hình Claude trong Cursor không?
Không. Endpoint này cung cấp một mô hình trọng số mở từ một nhà cung cấp độc lập. Đây không phải là API chính thức của Anthropic hay bất kỳ nhà cung cấp nào khác.
Tại sao tôi nhận lỗi 429 trong trình soạn thảo?
Hoặc bạn đã vượt quá giới hạn theo phút, hoặc bạn đang gửi quá nhiều yêu cầu cùng lúc. Khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút, khóa đầy đủ cho phép 8 và 300.
Tôi có thể dùng thử mà không cần trả tiền không?
Có. Người dùng mới có thể nhận $0,50 tín dụng dùng thử trên trang khóa API. Bạn không cần thẻ và tín dụng này có hiệu lực trong 7 ngày.
Khóa của bạn chỉ cách một biểu mẫu
Tạo tài khoản, sao chép khóa, thay đổi base URL. Đó là toàn bộ thiết lập.