Kết nối Claude Code với API bên ngoài | Gọi API dễ | RevidAPI

Bạn có thể kết nối Claude Code với API bên ngoài bằng `ANTHROPIC_BASE_URL` và `ANTHROPIC_AUTH_TOKEN`, rồi chạy `claude` để gửi một câu hỏi kiểm tra. Bài này tập trung vào một cấu hình có thể làm ngay trong terminal: đặt URL nền là tên miền gốc (không thêm `/v1`), gán đúng giá trị API key cho biến xác thực, mở Claude Code và hỏi một câu ngắn như `Trả lời OK để kiểm tra kết nối`. Bạn cũng sẽ biết cách khoanh vùng ba lỗi thường gặp: thừa `/v1` trong URL nền, nhầm tên biến với giá trị key và token có dấu ngoặc kép hoặc ký tự thừa. Khi cần đối chiếu request, endpoint Claude tương thích được cung cấp là `POST https://revidapi.com/v1/messages`.

Tóm tắt nhanh

• Khai báo `ANTHROPIC_BASE_URL` là tên miền gốc `https://revidapi.com`, không thêm `/v1` vì Claude Code tự ghép `/v1/messages`.
• Khai báo `ANTHROPIC_AUTH_TOKEN` bằng API key thực tế, sau đó chạy lệnh `claude` trong terminal.
• Gửi câu hỏi kiểm tra một lượt và đối chiếu `POST /v1/messages` nếu phản hồi lỗi.

Điểm dễ nhầm nằm ở cụm “API bên ngoài”. Claude Code là công cụ chạy Claude trong terminal, nhưng request có thể đi tới API Anthropic, API do đội bạn vận hành, hoặc gateway nhận định dạng Claude. Kết nối không biến mọi API thành Claude; bạn chỉ đổi nơi nhận request và phải đáp ứng đúng hợp đồng dữ liệu của dịch vụ đích. API Anthropic là dịch vụ gốc của Anthropic, thường dùng các route thuộc `/v1`, chẳng hạn Messages. API riêng là endpoint do công ty hoặc nhà cung cấp khác quản lý; nó có thể dùng model, chính sách dữ liệu và tên trường khác. API tương thích định dạng Claude là lớp trung gian chấp nhận cấu trúc gần với Claude, để Claude Code gửi request theo kiểu quen thuộc. Mức tương thích vẫn phải kiểm tra trong tài liệu, vì hỗ trợ route không đồng nghĩa hỗ trợ mọi trường, model hoặc công cụ. `ANTHROPIC_BASE_URL` quyết định request được định tuyến tới đâu. Với RevidAPI, giá trị chỉ là tên miền gốc, không thêm `/v1`. Đây là URL nền, không phải URL đầy đủ của model hay câu hỏi. Thêm `/v1` sẽ khiến Claude Code gọi `/v1/v1/messages` và nhận `404`. `ANTHROPIC_AUTH_TOKEN` chứa giá trị dùng để xác thực, ví dụ key do dịch vụ cấp. Tên biến và giá trị key là hai thứ khác nhau: `ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY` chỉ là mẫu. Nếu shell chưa nạp biến, key rỗng hoặc có ký tự thừa, server có thể trả `401` hoặc `403`; mã lỗi đó chưa chứng minh URL sai. Một cấu hình đúng phải khớp ba điểm: Claude Code gửi tới URL nào qua `ANTHROPIC_BASE_URL`, server xác thực bằng giá trị nào qua `ANTHROPIC_AUTH_TOKEN`, và body theo định dạng nào. Với kiểu Messages, route `POST /v1/messages` chưa đủ; bạn còn phải xác nhận method, header và trường `messages` trong tài liệu. Phần quy trình sẽ tách lệnh khai báo, lần chạy `claude` và cách kiểm tra phản hồi.

Sau khi khai báo `ANTHROPIC_BASE_URL` và `ANTHROPIC_AUTH_TOKEN`, bạn có thể nhập prompt trong terminal chạy `claude` và nhận phản hồi từ API bên ngoài thay vì chỉ làm việc với cấu hình mặc định. Một câu như `Đọc file app.js và chỉ ra lỗi xử lý trạng thái` là đủ để kiểm tra đường đi của request và nội dung trả về. Giá trị thực tế nằm ở việc đưa phản hồi đó vào công việc đang mở trong thư mục dự án. Claude Code có thể nhận yêu cầu viết đoạn mã, giải thích lỗi hoặc đề xuất cách sửa; còn API quyết định model nào xử lý, định dạng response ra sao và tài khoản có được phép gọi model đó hay không. Brief hiện cung cấp hai endpoint để đối chiếu: `POST https://revidapi.com/v1/messages` và `POST https://revidapi.com/v1/chat/completions`.

Phân biệt phần việc của Claude Code và API

Một lần cấu hình đúng cần hai biến môi trường: `ANTHROPIC_BASE_URL` trỏ đến tên miền gốc `https://revidapi.com`, còn `ANTHROPIC_AUTH_TOKEN` chứa API key thật. Sau đó bạn mở `claude`, gửi câu “Trả lời OK để kiểm tra kết nối” và đọc phản hồi. Quy trình dưới đây phù hợp khi API riêng hỗ trợ định dạng tương thích Claude, trong đó request chính đi qua `POST /v1/messages`. Bạn cần có API key từ dashboard quản trị API, quyền gọi model tương ứng và một terminal có lệnh `claude`; nếu thiếu một trong ba điều kiện này, việc sửa biến môi trường sẽ không giải quyết được lỗi từ dịch vụ.

Chuẩn bị hai biến môi trường Lấy API key tại dashboard

của nhà cung cấp, rồi đặt giá trị đó vào `ANTHROPIC_AUTH_TOKEN`. Không điền chữ `YOUR_API_KEY` khi kiểm tra thật, cũng không đặt chuỗi `ANTHROPIC_AUTH_TOKEN` làm giá trị của chính biến này. URL nền là tên miền gốc `https://revidapi.com`; Claude Code tự ghép tiếp thành `/v1/messages`. Các lệnh dưới đây dùng cùng một cặp giá trị nhưng khác cú pháp theo shell:

Chạy lượt kiểm tra đầu tiên

1. Lấy key và thay placeholder. Mở dashboard quản trị API, tạo hoặc sao chép key còn hiệu lực, rồi thay `YOUR_API_KEY` bằng chuỗi đó. Không đưa key vào file mã nguồn, prompt, commit Git hoặc ảnh chụp terminal; chỉ cần lộ một ký tự thừa cũng có thể làm giá trị gửi đi khác với key trong dashboard.
2. Đặt URL nền. Chạy lệnh tương ứng với shell đang dùng và không thêm `/v1`. Ví dụ trên macOS hoặc Linux là `export ANTHROPIC_BASE_URL=”https://revidapi.com”`.
3. Đặt token xác thực. Chạy `export ANTHROPIC_AUTH_TOKEN=”YOUR_API_KEY”`, hoặc cú pháp PowerShell là `$env:ANTHROPIC_AUTH_TOKEN=”YOUR_API_KEY”`. Giá trị sau dấu `=` phải là key thật, không phải tên biến, câu lệnh lấy key hay chuỗi có thêm dấu ngoặc kép do bạn sao chép nhầm.
4. Nạp lại môi trường. Mở terminal mới để nhận hai biến vừa đặt. Nếu bạn lưu lệnh trong `~/.zshrc` hoặc `~/.bashrc`, chạy `source ~/.zshrc` hoặc `source ~/.bashrc`, rồi mở lại thư mục dự án trước khi gọi Claude Code.
5. Khởi động Claude Code. Di chuyển đến thư mục cần làm việc bằng `cd /duong-dan/toi-du-an`, sau đó chạy `claude`. Đừng kiểm tra từ một terminal khác chưa có biến môi trường, vì lệnh đó có thể dùng URL hoặc token rỗng.
6. Gửi prompt ngắn. Trong phiên Claude Code, nhập `Trả lời OK để kiểm tra kết nối`. Một câu cố định giúp bạn phân biệt lỗi kết nối với lỗi do prompt dài, quyền truy cập file hoặc yêu cầu xử lý mã nguồn.
7. Đọc phản hồi và mã lỗi. Nếu nhận được `OK`, URL, token và route cơ bản đã đi qua được. Nếu request thất bại, ghi lại mã HTTP mà terminal hoặc log gateway hiển thị: `401` thường hướng đến lỗi xác thực, `404` thường do URL nền bị thừa `/v1`, còn `400` cần xem định dạng body mà API yêu cầu.
8. Đối chiếu request với endpoint. Khi kết quả chưa rõ, kiểm tra request `POST /v1/messages` trong log hoặc tài liệu API, gồm method, URL thực tế, header xác thực và body. Nếu Claude Code đang gọi `/messages` trên domain nhưng gateway chỉ nhận `/v1/messages`, sửa `ANTHROPIC_BASE_URL` rồi mở terminal mới và chạy lại bước 5.

Cách khoanh vùng khi kiểm tra thất bại Có thể tách lỗi thành ba lớp bằng cách kiểm tra theo thứ tự: biến môi trường trong terminal, URL cuối cùng

được gateway ghi nhận và phản hồi

của `POST /v1/messages`. Nếu URL nền đúng nhưng mã `401` vẫn xuất hiện, tập trung vào key hoặc header; nếu mã `404` xuất hiện, kiểm tra phần ghép route; nếu mã `400`, so sánh body với định dạng mà API riêng công bố. Không nên đổi cả URL lẫn token cùng lúc, vì bạn sẽ không biết thay đổi nào đã xử lý được lỗi.

Lỗi khó chịu nhất là domain vẫn mở được nhưng request của Claude Code đi sai route. Nếu `ANTHROPIC_BASE_URL` chỉ trỏ tới ` thay vì ` gateway có thể trả `404 Not Found` hoặc chuyển request tới route không nhận định dạng Anthropic. Trình duyệt truy cập được domain không chứng minh URL dành cho API đã đúng. Hãy kiểm tra URL thực tế trong log, nhất là phần `/v1` và path cuối như `/messages`. Claude Code luôn tự thêm `/v1/messages` vào sau URL nền. Với Claude Code, bạn cần đối chiếu base URL với endpoint mà dịch vụ công bố, chẳng hạn request tương thích Anthropic phải kết thúc ở `POST /v1/messages`. Vì vậy với RevidAPI, base URL cho Claude Code là `https://revidapi.com`, không có `/v1`.

2. Tên biến không phải giá trị khoá Một lỗi khác là gán tên biến vào chính nó, ví dụ `ANTHROPIC_AUTH_TOKEN=ANTHROPIC_AUTH_TOKEN`. Claude Code khi đó vẫn có thể khởi động, nhưng header xác thực

sẽ mang giá trị sai và gateway thường trả `401 Unauthorized` hoặc `403 Forbidden`. Giá trị bên phải phải là chuỗi key thật, còn `ANTHROPIC_AUTH_TOKEN` chỉ là tên biến. Khi kiểm tra, hãy xem tên header được gửi, thường là `Authorization: Bearer ` hoặc header mà gateway yêu cầu; không in toàn bộ token vào log.

3. Token có ký tự thừa Dấu ngoặc kép đôi khi trở thành một phần

của giá trị, nhất là khi bạn đặt biến trong file cấu hình rồi nạp lại bằng shell. Ví dụ `ANTHROPIC_AUTH_TOKEN='”sk-example”‘` có thể gửi cả dấu nháy vào header. Khoảng trắng cuối dòng, xuống dòng khi copy key, hoặc tiền tố `Bearer ` bị lặp cũng gây cùng triệu chứng. Hãy kiểm tra độ dài và vài ký tự đầu/cuối đã che bớt, thay vì in key nguyên vẹn. Nếu URL và header đều đúng mà vẫn nhận `400 Bad Request`, lỗi có thể nằm ở gateway: body không đúng schema Anthropic, model không được hỗ trợ hoặc gateway tự chặn route. Ngược lại, `404` ở `/v1/messages` thường cần kiểm tra base URL và đường dẫn trước khi sửa Claude Code. Tách hai lớp này giúp bạn không đổi biến môi trường khi nguyên nhân thực sự nằm ở dịch vụ API.

Developer xử lý yêu cầu mã nguồn Một developer freelance có thể mở Claude Code ngay trong thư mục dự án, rồi gửi yêu cầu phân tích một file như `src/auth.ts` qua API riêng. Quy trình thực tế gồm ba lượt: yêu cầu đọc luồng đăng nhập, yêu cầu chỉ ra vị trí cần sửa, sau đó yêu cầu tạo patch để bạn xem trước bằng `git diff`. Claude Code xử lý phần trao đổi trong terminal; API riêng cung cấp model và quyền truy cập theo cấu hình

của đội ngũ. Cách này phù hợp khi mã nguồn không nên đưa qua một tài khoản cá nhân không kiểm soát được. Bạn vẫn cần kiểm tra diff, test bằng lệnh của dự án và tránh đưa `.env`, token hoặc dữ liệu khách hàng vào prompt. Một câu hỏi như “Liệt kê file cần đọc trước khi sửa lỗi này” thường an toàn hơn việc yêu cầu công cụ tự thay đổi cả repository.

Marketer ghép nội dung với video Một marketer bán hàng qua TikTok có thể dùng Claude Code để biến brief sản phẩm thành ba đầu ra cụ thể: kịch bản 30 giây, danh sách cảnh và caption ngắn. Sau bước duyệt nội dung, workflow gọi API tạo video, rồi chuyển kết quả qua bước cắt hoặc thêm caption; người dùng kiểm tra từng file trước khi đăng, thay vì để một prompt tạo ra cả chuỗi không kiểm soát. Bạn có thể bắt đầu từ Workflow miễn phí để thử quy trình với một video mẫu. Khi cần tách bước duyệt nội dung, tạo video và xử lý phụ đề cho chiến dịch, Workflow kinh doanh là nơi tham khảo cách sắp xếp các công đoạn; trang này không thay thế việc kiểm tra giới hạn và chi phí của từng API.

Creator tự động hóa tác vụ lặp lại Creator có lịch đăng đều có thể dùng Claude Code làm lớp điều phối: đọc một file CSV gồm `title`, `hook`, `duration`, tạo prompt theo từng dòng, gọi workflow video, rồi ghi trạng thái `done` hoặc `failed` vào file kết quả. Với 10 video, bạn vẫn nên chạy thử một dòng trước, kiểm tra tỷ lệ khung hình và nội dung chữ, sau đó mới xử lý chín dòng còn lại. Thư viện workflow hữu ích khi bạn muốn tìm một quy trình gần với việc đang làm, chẳng hạn tạo nội dung hàng loạt hoặc xử lý video

sau khi sinh. Claude Code có thể giúp đọc cấu hình, đổi giá trị đầu vào và lặp tác vụ; quyền đăng tải cuối cùng vẫn nên để người dùng xác nhận, nhất là với tài khoản thương hiệu.

Cấu hình Claude Code bằng biến môi trường Bạn có thể trỏ Claude Code đến gateway tương thích Anthropic bằng hai biến môi trường, rồi kiểm tra ngay bằng một câu hỏi ngắn. Lấy key tại RevidAPI Dashboard, sau đó chạy trong terminal:

export ANTHROPIC_BASE_URL="https://revidapi.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
claude

Trong phiên Claude Code, nhập `Trả lời OK để kiểm tra kết nối`. Nếu nhận

được phản hồi, bước định tuyến cơ bản đã hoạt động. `ANTHROPIC_BASE_URL` là `https://revidapi.com`, không thêm `/v1`; thêm vào sẽ thành `/v1/v1/messages` và báo `404`. `YOUR_API_KEY` là giá trị key thật, không phải tên biến hay chuỗi có dấu ngoặc kép thừa. Để đối chiếu request, dùng `POST https://revidapi.com/v1/messages` với header `x-api-key` hoặc `Authorization: Bearer`, cùng body theo định dạng Anthropic. Kiểm tra lần lượt method, URL, header, body và mã HTTP trước khi sửa Claude Code. Lỗi `401` thường liên quan xác thực; lỗi `404` thường do URL nền bị thừa `/v1`. Chúng tôi chưa đo độ trễ giữa Claude Code và gateway, nên không nên suy ra hiệu năng từ một lượt hỏi.

Gọi model qua endpoint tương thích OpenAI Khi ứng dụng hoặc thư viện

của bạn dùng chuẩn OpenAI, endpoint tương ứng là `POST https://revidapi.com/v1/chat/completions`. Danh sách model và giá theo token được cung cấp qua `GET https://revidapi.com/v1/chat/models`; hãy đọc dữ liệu hiện tại thay vì ghi cứng giá vào tài liệu.

export REVIDAPI_API_KEY="YOUR_API_KEY"
curl https://revidapi.com/v1/chat/completions \ -H "x-api-key: $REVIDAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Xin chào"}]}'

Với Python, SDK OpenAI nhận `base_url=”https://revidapi.com/v1″` và `api_key` từ biến môi trường. Cách này phù hợp khi bạn nối Claude Code với một script, workflow app hoặc n8n; mỗi hệ thống vẫn cần kiểm tra schema body và mã HTTP riêng. Không ghi API key trực tiếp trong mã nguồn, file commit hoặc prompt gửi cho model.

Claude Code dùng biến nào để kết nối API ngoài?

Bạn cần đặt `ANTHROPIC_BASE_URL` cho địa chỉ gateway và `ANTHROPIC_AUTH_TOKEN` cho API key, rồi chạy lệnh `claude`. Với Claude Code và RevidAPI, URL là `https://revidapi.com`, không thêm `/v1`.

Có nên thêm `/v1` vào `ANTHROPIC_BASE_URL`?

Không. Claude Code tự ghép `/v1/messages` vào sau URL nền, nên thêm `/v1` sẽ thành `/v1/v1/messages` và nhận `404`, dù domain vẫn mở

được trên trình duyệt. Khi kiểm tra độc lập, endpoint Anthropic

của RevidAPI là `POST https://revidapi.com/v1/messages`. Endpoint tương thích OpenAI là `POST https://revidapi.com/v1/chat/completions`; hai đường dẫn này không thay thế cho nhau nếu body hoặc định dạng request khác nhau.

`ANTHROPIC_AUTH_TOKEN` nhận tên biến hay giá trị API key?

Biến này nhận chính chuỗi key, chẳng hạn `sk-…`, không nhận chữ `API_KEY` hay tên biến khác. Tránh thêm dấu cách ở đầu hoặc cuối giá trị; với shell, kiểm tra lại lệnh `export ANTHROPIC_AUTH_TOKEN=”…”` trước khi mở phiên `claude` mới.

Làm gì khi gặp lỗi xác thực hoặc `404`?

Với lỗi xác thực, kiểm tra key còn hiệu lực, header mà gateway yêu cầu và việc biến môi trường có tồn tại trong đúng terminal hay không. Với `404`, kiểm tra lại `ANTHROPIC_BASE_URL`, đặc biệt xem có bị thừa `/v1` không, rồi đối chiếu method `POST` và route `/messages`. Nếu request tới `/v1/messages` vẫn thất bại, thử một request ngắn bằng endpoint

được tài liệu cung cấp để tách lỗi Claude Code khỏi lỗi gateway. Không nên suy ra nguyên nhân chỉ từ thông báo trong terminal; mã HTTP và URL thực tế cần khớp nhau.

Có thể kiểm tra RevidAPI bằng `/v1/messages` và `/v1/chat/completions` không?

Có, nhưng hãy kiểm tra từng route với đúng định dạng body. Claude Code cần cấu hình theo giao diện Anthropic, còn `/v1/chat/completions` dùng giao diện chat tương thích OpenAI; hãng chưa công bố trong dữ liệu này rằng mọi model hoặc mọi tham số

sẽ hoạt động giống nhau trên hai route. Quy trình kiểm tra ngắn gồm ba bước: đặt `ANTHROPIC_BASE_URL` và `ANTHROPIC_AUTH_TOKEN`, chạy `claude`, rồi gửi câu hỏi như `Trả lời OK để kiểm tra kết nối`. Hãy thử request nhỏ trước khi đưa cấu hình vào workflow dài.

Khám phá workflow miễn phí tại AI Tạo ảnh & Video và lấy API key tại API Marketplace RevidAPI.