Giải pháp thay thế OpenAI cho Claude Code: Thiết lập Agent mã hóa
Claude Code giao tiếp với API riêng của Anthropic, nên bạn không thể chỉ đơn giản trỏ nó vào một endpoint kiểu OpenAI. Dưới đây là những gì hoạt động thay thế: các agent lập trình chấp nhận Base URL tùy chỉnh OpenAI và cách kết nối chúng với API này.
Cập nhật

Điểm chính
- Claude Code được xây dựng xung quanh định dạng API của Anthropic, trong khi dịch vụ này sử dụng định dạng chat completions của OpenAI.
- Các công cụ kiểu Aider, Continue, Cline và Cursor chấp nhận base URL tương thích OpenAI tùy chỉnh và tên mô hình.
- Sử dụng base URL https://api.minimaxapikey.com/v1 với model ID uncensored và một khóa Bearer.
- Hãy kiểm tra bằng curl trước, sau đó giữ concurrency ở mức bằng hoặc dưới 8 yêu cầu, vì các agent bắn ra nhiều lệnh gọi cùng lúc.
Câu trả lời ngắn gọn
Nếu bạn đã tìm kiếm một giải pháp thay thế OpenAI cho Claude Code, điều đầu tiên cần xác định là bạn muốn thay thế cái gì. Claude Code là một agent lập trình trên terminal của Anthropic. Nó được thiết kế để giao tiếp với API riêng của Anthropic, sử dụng định dạng yêu cầu khác với OpenAI. Dịch vụ này triển khai định dạng chat completions của OpenAI, nên hai bên không thể kết nối với nhau chỉ bằng cách thay đổi URL.
Điều hoạt động là họ lớn các agent lập trình và plugin editor chấp nhận bất kỳ endpoint nào tương thích OpenAI. Bạn cung cấp cho chúng một base URL, một key và tên mô hình, và chúng gửi các yêu cầu POST /v1/chat/completions thông thường. Aider, Continue và Cline đều thuộc nhóm này, và một số editor có tùy chọn ghi đè base URL cho các mô hình OpenAI. Đối với API này, ba giá trị là base URL https://api.minimaxapikey.com/v1, model ID uncensored và key của bạn dưới dạng Bearer token.
Hãy giữ kỳ vọng của bạn ở mức thực tế. Mô hình phía sau endpoint là một mô hình trọng số mở do một nhà cung cấp độc lập vận hành, được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người lớn hợp pháp. Nó không phải là Claude, và không phải là API chính thức từ bất kỳ nhà cung cấp mô hình nào. Việc nó có phù hợp với kho lưu trữ của bạn hay không là điều bạn sẽ tự tìm hiểu qua các tác vụ của mình, và bài viết này chỉ cho bạn cách chạy thử nghiệm đó với chi phí thấp.
Tại sao bạn không thể chỉ thay đổi URL trong Claude Code
Định dạng API không chỉ là địa chỉ. API của Anthropic có cấu trúc message riêng, cách biểu diễn system prompt riêng, các khối tool-use riêng và các sự kiện streaming riêng. Máy chủ kiểu OpenAI mong đợi messages có vai trò, mảng tools chứa định nghĩa hàm, và các sự kiện gửi từ máy chủ mang choices[0].delta. Client được xây dựng cho định dạng này sẽ thất bại hoặc hoạt động sai khi tương tác với máy chủ của định dạng khác, ngay cả khi URL có thể truy cập được.
Một số người đặt một lớp dịch giữa hai bên, một proxy nhỏ chuyển đổi các yêu cầu và phản hồi. Điều đó có thể hoạt động, nhưng đó là một phần mềm riêng biệt bạn sẽ tự chạy và gỡ lỗi, và hành vi xung quanh các lệnh gọi hàm và streaming thường là nơi các lớp như vậy bị lỗi. Việc Claude Code có cung cấp cài đặt chính thức cho các endpoint bên thứ ba hay không là điều cần kiểm tra trong tài liệu hiện tại của Anthropic, vì các tùy chọn đó thay đổi.
Đường đơn giản hơn là chọn một agent đã nói ngôn ngữ định dạng OpenAI. Bạn không mất gì về vòng lặp cơ bản: agent đọc các file của bạn, xây dựng một prompt, yêu cầu mô hình chỉnh sửa và áp dụng nó. Mô hình là phần bạn đang thay thế, và phần đó chỉ cần một endpoint tương thích.
Kiểm tra endpoint với curl trước khi chạm vào bất kỳ công cụ nào
Mọi vấn đề tích hợp sẽ dễ chẩn đoán hơn nếu bạn đã biết API thô hoạt động. Tạo khóa trên trang khóa API, xuất nó và thực hiện một yêu cầu. Nếu thành công, mọi lỗi sau đó nằm ở cài đặt công cụ, không phải ở khóa hoặc mạng.
export UNCENSORED_KEY="paste-your-key-here"
curl -s https://api.minimaxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise coding assistant."},
{"role": "user", "content": "Write a Python function that parses an ISO date string."}
]
}'
Bạn cũng có thể liệt kê các mô hình bằng GET /v1/models. Nhiều công cụ gọi endpoint này khi bạn lưu nhà cung cấp để xác nhận khóa hợp lệ, nên hãy đảm bảo nó trả về kết quả trước khi cấu hình bất cứ thứ gì. trang tài liệu có tham chiếu yêu cầu đầy đủ.
Mỗi công cụ lấy base URL ở đâu
Tên của các cài đặt khác nhau, nhưng ý tưởng giống nhau ở mọi nơi. Bảng liệt kê các công cụ mã hóa phổ biến và trường bạn điền vào. Menu di chuyển giữa các phiên bản, vì vậy hãy coi đây là bản đồ và kiểm tra tài liệu riêng của từng công cụ cho bố cục hiện tại.
| Công cụ | Nơi nhập endpoint | Tên mô hình để sử dụng |
|---|---|---|
| Aider | Biến môi trường hoặc cờ dòng lệnh cho base URL và khóa OpenAI | openai/uncensored |
| Continue | Một mục mô hình trong tệp cấu hình của bạn, với provider openai và apiBase | uncensored |
| Cline | Danh sách provider, chọn tùy chọn tương thích OpenAI | uncensored |
| Cursor | Cài đặt mô hình, phần khóa API OpenAI với tùy chọn ghi đè base URL | uncensored làm mô hình tùy chỉnh |
| Kịch bản của riêng bạn | Đối số base_url của bất kỳ SDK OpenAI nào | uncensored |
Vì dịch vụ này chỉ cung cấp chính xác một mô hình, nên không có bộ chọn mô hình để cấu hình. Bất cứ nơi nào công cụ yêu cầu tên mô hình, hãy nhập uncensored. Nếu công cụ khăng khăng yêu cầu danh sách các mô hình đã biết và từ chối các tên chưa biết, hãy tìm tùy chọn "mô hình tùy chỉnh" hoặc "thêm mô hình".
Ví dụ Aider
Aider chạy trong terminal của bạn, chỉnh sửa các tệp trong kho lưu trữ git và commit kết quả, khiến nó trở nên gần gũi nhất với tinh thần của Claude Code. Nó sử dụng LiteLLM ở tầng dưới, vì vậy tên mô hình có tiền tố nhà cung cấp. Đối với máy chủ tương thích OpenAI, tiền tố đó là openai/.
pip install aider-chat
export OPENAI_API_BASE="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
cd your-repo
aider --model openai/uncensored
Khi nó bắt đầu, hãy yêu cầu một thay đổi nhỏ trong một file duy nhất và quan sát diff. Hãy bắt đầu với thứ gì đó bạn có thể xác minh trong vài giây, chẳng hạn như thêm docstring hoặc đổi tên hàm, trước khi giao cho nó một nhiệm vụ đa file. Aider gửi bản đồ kho lưu trữ và các file bạn thêm vào chat ở mỗi bước, nên prompt tăng nhanh. Cửa sổ 100.000 token (prompt cộng với kết quả) khá rộng rãi, nhưng với một kho lưu trữ lớn, bạn vẫn cần chỉ thêm các file quan trọng.
Nếu Aider cảnh báo rằng nó không biết kích thước context hoặc giá cho mô hình, đó là điều dự kiến: nó không có mục nào cho tên mô hình tùy chỉnh. Cảnh báo không ngăn nó hoạt động.
Ví dụ Continue
Continue là một tiện ích mở rộng editor thêm các tính năng chat, chỉnh sửa và tự động hoàn thành trong VS Code và JetBrains. Cấu hình của nó liệt kê các mô hình, mỗi mô hình có một provider và các tùy chọn ghi đè tùy ý. Một mục mô hình cho API này trông như sau. Tên file và schema chính xác phụ thuộc vào phiên bản Continue bạn đã cài đặt, vì vậy hãy so sánh nó với tài liệu hiện tại.
{
"models": [
{
"title": "Uncensored API",
"provider": "openai",
"model": "uncensored",
"apiBase": "https://api.minimaxapikey.com/v1",
"apiKey": "paste-your-key-here"
}
]
}
Các yêu cầu chat và edit hoạt động tốt với một endpoint như thế này. Tab autocomplete là một workload khác: nó được kích hoạt ở hầu hết mọi lần dừng khi gõ và yêu cầu độ trễ rất thấp, điều này phù hợp hơn với một mô hình local nhỏ. Việc sử dụng một mô hình chat được host cho inline completions sẽ tiêu tốn yêu cầu trong giới hạn 300 yêu cầu mỗi phút của bạn với rất ít kết quả.
Tự xây dựng một agent tối giản
Nếu không có công cụ hiện có phù hợp, hỗ trợ gọi hàm giúp tạo một agent nhỏ dễ dàng. API chấp nhận tools và tool_choice, truyền phát tool_calls lại và nhận kết quả dưới dạng các message với role: "tool". Vòng lặp bên dưới cung cấp cho mô hình một hàm đọc tệp, sau đó tiếp tục cho đến khi mô hình trả lời bằng văn bản thuần túy.
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.minimaxapikey.com/v1", api_key="paste-your-key-here")
tools = [{
"type": "function",
"function": {
"name": "read_file",
"description": "Return the text of a file in the current project.",
"parameters": {
"type": "object",
"properties": {"path": {"type": "string"}},
"required": ["path"],
},
},
}]
messages = [{"role": "user", "content": "Summarise what main.py does."}]
while True:
resp = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
msg = resp.choices[0].message
messages.append(msg)
if not msg.tool_calls:
print(msg.content)
break
for call in msg.tool_calls:
args = json.loads(call.function.arguments)
with open(args["path"], encoding="utf-8") as f:
result = f.read()
messages.append({"role": "tool", "tool_call_id": call.id, "content": result})
Thêm một hàm ghi và một lời nhắc xác nhận trước khi nó chạy, và bạn có phần cốt lõi của một agent mã hóa trong khoảng năm mươi dòng. Luôn xác thực các đường dẫn trước khi đọc hoặc ghi: một mô hình có thể yêu cầu bất kỳ đường dẫn nào nó thích.
Các giới hạn và chi phí cần lập kế hoạch
Agent hoạt động khác với người dùng trò chuyện. Chúng gửi các đợt yêu cầu, thường là nhiều yêu cầu đồng thời. Khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút. Khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 mỗi phút, điều này có thể gây hạn chế cho agent. Khi bạn vượt quá giới hạn, API trả về HTTP 429 và mã lỗi rate_limited hoặc concurrency. Trong trường hợp quá tải tạm thời, nó cũng trả về 429 với Retry-After: 5. Hầu hết các client tốt đều thử lại khi nhận 429, nhưng nếu client của bạn không làm vậy, hãy giảm cài đặt parallelism của nó. Một yêu cầu streaming giữ slot đồng thời cho đến khi stream kết thúc, nên các chỉnh sửa stream dài tính vào giới hạn 8.
Về chi phí, thanh toán là trả tiền theo mức sử dụng từ prepaid credit với giá $0.15 cho mỗi 1M input token và $0.50 cho mỗi 1M output token. Giả sử một phiên gửi 40 yêu cầu mang theo 30.000 input token mỗi yêu cầu và nhận được 1.000 output token mỗi yêu cầu. Đó là 1.200.000 input token, tương đương $0.18, cộng với 40.000 output token, tương đương $0.02, tổng cộng $0.20. Các yêu cầu thất bại hoặc bị từ chối không bị tính phí và tín dụng không bao giờ hết hạn. Xem trang giá để biết số tiền nạp tiền và các khoản bonus.
Tài khoản mới có thể nhận $0.50 tín dụng dùng thử miễn phí chỉ với một cú nhấp chuột trên trang key, không cần thẻ, có hiệu lực trong 7 ngày. Điều đó đủ để chạy thử curl và một vài chỉnh sửa nhỏ bằng Aider. Prompts không được sử dụng cho việc huấn luyện.
Hướng dẫn khác
Hỏi đáp
Tôi có thể trỏ chính Claude Code vào API này không?
Không trực tiếp. Claude Code được thiết kế cho định dạng API của Anthropic, trong khi dịch vụ này triển khai chat completions kiểu OpenAI. Hãy kiểm tra tài liệu hiện tại của Anthropic để biết những gì Claude Code hỗ trợ, và sử dụng agent tương thích OpenAI nếu bạn muốn dùng endpoint này.
Những công cụ lập trình nào hoạt động với Base URL tùy chỉnh OpenAI?
Aider, Continue và Cline đều cho phép bạn nhập Base URL tương thích OpenAI, khóa API và tên mô hình. Cursor cũng cung cấp tùy chọn ghi đè Base URL cho các mô hình kiểu OpenAI, dù bạn nên kiểm tra cài đặt và giới hạn kế hoạch hiện tại của nó.
API có hỗ trợ tool calling cho agents không?
Có. Bạn có thể gửi công cụ và tool_choice, nhận tool_calls truyền phát (streaming), và trả về kết quả với role: tool. Việc một plugin trình soạn thảo cụ thể có sử dụng các trường này hay không phụ thuộc vào plugin đó.
Một phiên lập trình tốn bao nhiêu?
Giá là $0.15 cho mỗi 1M input token và $0.50 cho mỗi 1M output token. Các agent gửi lại rất nhiều ngữ cảnh, nên input token thường chiếm phần lớn hóa đơn.
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.