Đặt cài đặt endpoint API cá nhân cho Claude Code với Gateway Phần mềm Mở Trung Quốc

Claude Code có thể được cấu hình để kết nối với một endpoint tương thích với Anthropic thay vì sử dụng trực tiếp endpoint của nhà cung cấp. Điều này cho phép bạn kiểm tra một quy trình làm việc được quản lý bởi cổng kết nối với các mã ID mô hình được cung cấp bởi cổng kết nối, bao gồm các mô hình phần mềm mở Trung Quốc hiện có trong danh sách mô hình hiện tại của ECAIX.

Bài hướng dẫn này về một quy trình tương thích với nhà cung cấp, thứ ba. Tài liệu chính thức của Anthropic về cổng kết nối Claude Code giải thích rằng Anthropic không hỗ trợ chuyển hướng Claude Code đến các mô hình không phải Claude qua cổng kết nối. ECAIX không tuyên bố rằng quy trình này được hỗ trợ chính thức bởi Anthropic, và một mô hình không phải Claude có thể không cung cấp tất cả các tính năng của Claude Code.

Kết nối nhanh

Nếu bạn đã hiểu rõ giới hạn tương thích, hãy bắt đầu với đường dẫn ngắn nhất:

1. Mở danh sách mô hình hiện tại của ECAIX và chọn một mã ID mô hình hoạt động.
2. Tạo một API key của ECAIX và giữ nó ở ngoài kho lưu trữ nguồn.
3. Cài đặt biến môi trường ANTHROPIC_BASE_URL thành https://ecaix.com/api/ai/v1/anthropic.
4. Gửi yêu cầu kiểm tra dưới đây và ghi lại mã HTTP.
5. Thử chạy Claude Code trong một dự án kiểm tra đọc-only với lệnh claude -p.
6. Kiểm tra các công cụ, luồng dữ liệu, giới hạn ngữ cảnh và quyền riêng tư riêng biệt.

Trạng thái xác minh tại thời điểm công bố

Bảng này có ý nghĩa: một ví dụ cấu hình không phải là kết quả tương thích đo lường.

Những thay đổi cấu hình này làm gì

Cấu hình có bốn phần riêng biệt:

1. Claude Code là ứng dụng khách tạo nhiệm vụ lập trình và gửi yêu cầu.
2. Cổng kết nối tương thích với Anthropic nhận các yêu cầu tại một endpoint theo phong cách Anthropic.
3. Mã ID mô hình chọn mô hình nguồn được cổng kết nối暴露.
4. Mã API xác thực yêu cầu và xác định tài khoản, hạn mức và quyền riêng tư.

Thay đổi endpoint không chuyển một mô hình không phải Claude thành Claude. Nó chỉ thay đổi bề mặt API tương thích nào nhận được yêu cầu. Sử dụng công cụ, xử lý ngữ cảnh, tên gọi mô hình, hành vi luồng dữ liệu và các luồng quyền có thể khác nhau tùy theo phiên bản ứng dụng và triển khai của cổng kết nối.

Trước khi bắt đầu

Bạn cần:

• Một phiên bản Claude Code hỗ trợ cấu hình endpoint dựa trên môi trường hoặc thiết lập.
• Một API key của ECAIX.
• Một mã ID mô hình hiện đang tồn tại trong danh sách mô hình của ECAIX.
• Một terminal nơi bạn có thể chạy một yêu cầu kiểm tra nhỏ mà không lưu trữ API key trong kho lưu trữ nguồn.

Danh sách mô hình thay đổi theo thời gian. Trước khi sao chép mã ID mô hình vào một tệp cấu hình, hãy mở danh sách mô hình ECAIX và xác nhận rằng mô hình đang hoạt động và có sẵn cho phong cách API bạn dự định sử dụng.

Cấu hình cổng kết nối endpoint

Claude Code lưu các thiết lập trong tệp ~/.claude/settings.json trên nhiều phiên bản cài đặt. Schema thiết lập chính xác có thể thay đổi, vì vậy hãy xem xét mẫu dưới đây như một mẫu khởi đầu và so sánh với tài liệu cho phiên bản cài đặt của bạn.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ecaix.com/api/ai/v1/anthropic",
    "ANTHROPIC_API_KEY": "YOUR_ECAIX_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT": "1"
  },
  "model": "deepseek-v4.1-flash"
}

Đừng commit tệp này vào một kho lưu trữ công khai nếu nó chứa một API key thực tế. Thay vào đó, sử dụng một biến môi trường địa phương, một quản lý bí mật hoặc cơ chế xác thực được khuyến nghị bởi phiên bản Claude Code của bạn.

Bạn cũng có thể cấu hình endpoint trong một phiên bản shell khi kiểm tra:

export ANTHROPIC_BASE_URL="https://ecaix.com/api/ai/v1/anthropic"
export ANTHROPIC_API_KEY="YOUR_ECAIX_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"

Tên biến và các thiết lập được hỗ trợ bởi một phiên bản cụ thể của Claude Code có thể thay đổi. Nếu ứng dụng khách không chấp nhận ANTHROPIC_MODEL, hãy sử dụng trường mô hình hoặc cơ chế tên gọi mô hình được tài liệu phiên bản của bạn mô tả. Cổng kết nối vẫn cần phải nhận dạng mã ID mô hình cuối cùng.

Xác minh endpoint tương thích với Anthropic trước khi bắt đầu

Trước khi bắt đầu một phiên làm việc lập trình tương tác, hãy gửi một yêu cầu nhỏ. Điều này phân biệt các vấn đề về endpoint, xác thực và mã ID mô hình với hành vi riêng của Claude Code.

Lệnh dưới đây lưu trữ các thẻ phản hồi và thể phản hồi riêng biệt, sau đó in mã HTTP. Hãy sử dụng một API key thực tế chỉ trong phiên shell của bạn; bao giờ cũng không dán nó vào bài viết, vấn đề hoặc log chia sẻ.

curl -sS -D /tmp/ecaix-anthropic-headers.txt \
  -o /tmp/ecaix-anthropic-response.json \
  -w '\nHTTP %{http_code}\n' \
  "${ANTHROPIC_BASE_URL}/messages" \
  -H "x-api-key: ${ANTHROPIC_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 128,
    "messages": [
      {"role": "user", "content": "Reply with one short sentence."}
    ]
  }'

Đánh giá mong đợi:

• 200: kiểm tra hình dạng phản hồi và xác nhận trường mô hình hoặc sử dụng mô hình đã trả về.
• 401 hoặc 403: kiểm tra key, thẻ, tài khoản và phạm vi quyền trước khi thay đổi câu hỏi.
• 404: kiểm tra URL cơ sở, phần đuôi /messages và triển khai endpoint.
• 400: giảm yêu cầu xuống nhỏ nhất có thể và kiểm tra các trường mô hình cụ thể.
• 5xx hoặc timeout: ghi lại thời gian yêu cầu và thể phản hồi, sau đó phân biệt hành vi timeout của cổng kết nối, nguồn và ứng dụng khách.

Một phản hồi thành công xác nhận rằng key, endpoint, định dạng yêu cầu và mã ID mô hình đã hoạt động cùng nhau cho yêu cầu đó. Nó không chứng minh rằng tất cả các tính năng của Claude Code sẽ hoạt động.

Chọn mã ID mô hình

Danh sách mô hình của ECAIX chứa các gia đình mô hình từ các nhà cung cấp Trung Quốc. Mã mô hình bắt đầu phù hợp với nhiệm vụ, không chỉ là tên mô hình.

Lập trình và phát triển chung

Bắt đầu với một mô hình DeepSeek, Qwen, GLM hoặc Seed có khả năng lập trình và hiện đang được hiển thị trong danh sách. Ví dụ, danh sách có thể hiển thị các mã ID như deepseek-v4.1-flash, qwen3.8-flash, glm-5.3, hoặc seed-2.0-code. Tính khả dụng và khả năng có thể thay đổi, vì vậy hãy luôn kiểm tra trang mô hình hiện tại trước khi công bố cấu hình.

Làm việc với ngữ cảnh dài và dự án kho

Đối với các dự án lớn hoặc các tài liệu kỹ thuật dài, so sánh chiều dài ngữ cảnh được hiển thị trong danh sách mô hình. Một cửa sổ ngữ cảnh lớn hơn không tự động có nghĩa là kết quả tốt hơn cho dự án kho: cấu trúc câu hỏi, hỗ trợ công cụ, giới hạn xuất lực và giới hạn yêu cầu của cổng kết nối cũng quan trọng.

Gọi công cụ và quy trình agent

Nếu quy trình cần gọi công cụ hoặc công cụ, hãy kiểm tra tài liệu mô hình và endpoint. Một số nhà cung cấp cung cấp gọi công cụ thông qua các API tương thích với OpenAI, trong khi những người khác cung cấp tên trường khác hoặc chỉ hỗ trợ một phần của hành vi gọi công cụ. Bắt đầu với một kiểm tra gọi công cụ nhỏ trước khi cho phép mô hình truy cập vào một kho dự án thực tế hoặc hệ thống bên ngoài.

Phát triển công việc có nội dung tiếng Trung

Các mô hình phần mềm mở Trung Quốc có thể hữu ích khi cơ sở mã, tài liệu, bảng tra cứu vấn đề hoặc quy trình làm việc của nhóm chứa nội dung tiếng Trung. Đánh giá mô hình với các câu hỏi và mẫu kho của riêng bạn thay vì dựa vào chỉ số xếp hạng chung.

Kiểm tra Claude Code sau khi yêu cầu API thành công

Khi yêu cầu trực tiếp thành công, bắt đầu với một lệnh đọc-only hoặc thấp nguy cơ:

claude -p "Explain what this repository does without editing files."

Sau đó kiểm tra một nhiệm vụ hẹp:

claude -p "List the likely entry points for the web application. Do not modify files."

Sử dụng các kiểm tra ngày càng đòi hỏi cao hơn:

1. Trả lời văn bản đơn giản.
2. Giải thích ngắn về mã.
3. Tra cứu kho dự án.
4. Một chỉnh sửa kiểm soát trong nhánh tạm thời.
5. Sử dụng công cụ hoặc nhiệm vụ đa bước.
6. Hành vi luồng và hành vi ngữ cảnh dài.

Đừng giả định rằng một phản hồi văn bản thành công chứng minh rằng các quy trình xác thực quyền, gọi công cụ, luồng dữ liệu, giới hạn ngữ cảnh hoặc chỉnh sửa tệp hành động tương tự như một phiên làm việc của Claude.

Chọn đường dẫn API phù hợp

Claude Code chỉ là một trong nhiều công cụ làm việc. Đường dẫn API phù hợp phụ thuộc vào công cụ và tập tính năng mà bạn cần:

Đối với ECAIX, hãy sử dụng Tài liệu API Messages Anthropic cho đường dẫn theo phong cách Anthropic và Tài liệu Chat Completions cho các ứng dụng tương thích với OpenAI. Hãy sử dụng Danh sách mô hình để xác nhận mô hình hiện tại và Trang giá để xác nhận giá hiện tại hiển thị.

Bảng tương thích

Bảng sau đây là một giới hạn chứng cứ tại thời điểm công bố, không phải là một tuyên bố rằng tất cả tính năng đều được hỗ trợ: