Tool Integrations29 tháng 6, 2026Flatkey

Cài đặt API Router cho Claude Code: URL cơ sở, Mô hình và Nhật ký sử dụng

Việc thiết lập API router cho Claude Code không giống như thay đổi URL cơ sở của OpenAI SDK. Claude Code giao tiếp theo định dạng gateway của Anthropic Messages, vì vậy các kiểm tra quan trọng là gốc router, tiêu đề xác thực, tên mô hình mà Claude Code sẽ gửi và các bản ghi sử dụng để chứng minh yêu cầu đã được tiếp nhận.

Việc cài đặt router API Claude Code không giống như việc thay đổi URL cơ sở của SDK OpenAI. Claude Code giao tiếp theo định dạng cổng Anthropic Messages, vì vậy các kiểm tra quan trọng là gốc của router, tiêu đề thông tin xác thực, tên mô hình mà Claude Code sẽ gửi và các bản ghi sử dụng chứng minh rằng các yêu cầu đang đến đúng tài khoản.

Hướng dẫn này cung cấp một cài đặt Flatkey hướng đến môi trường sản xuất cho các nhà phát triển, đội ngũ sản phẩm AI, người xây dựng tự động hóa, kỹ sư nền tảng, người vận hành tài chính và người đánh giá mua sắm. Nó bao gồm URL cơ sở, kiểm tra sơ bộ một token, tên mô hình, khám phá mô hình qua cổng, nhật ký sử dụng và các chế độ lỗi trước khi bạn chuyển công việc lập trình hàng ngày sang **router API Claude Code**.

Ghi chú nguồn: thông tin này đã được kiểm tra vào ngày 29 tháng 6 năm 2026 dựa trên tài liệu về cổng LLM của Claude Code, hướng dẫn kết nối cổng Claude Code, tham chiếu giao thức cổng, tài liệu cấu hình mô hình, tài liệu giám sát, và các trang công khai hiện tại của Flatkey. Không có khóa Flatkey dành riêng cho tài khoản nào được sử dụng để kiểm tra nhanh (smoke test) trực tiếp với Claude Code, vì vậy các đoạn mã dưới đây là các mẫu để bạn chạy với khóa của riêng mình và mô hình đã được phê duyệt.

Câu trả lời nhanh: Cài đặt router API Claude Code

Để cài đặt **router API Claude Code** với Flatkey, hãy cấu hình Claude Code với gốc router Claude Code của Flatkey, một khóa Flatkey và tên mô hình Claude chính xác mà tài khoản của bạn có thể gọi. Sau đó, hãy kiểm tra điểm cuối Anthropic Messages trước khi bắt đầu một phiên lập trình dài.

Trường cài đặt	Giá trị hoặc kiểm tra của Flatkey	Tại sao nó quan trọng
URL cơ sở	`https://router.flatkey.ai` cho trường hợp sử dụng Claude Code trừ khi tài khoản Flatkey của bạn hiển thị một giá trị mới hơn dành riêng cho Claude Code	Claude Code nối thêm `/v1/messages`. Đừng dán một URL cơ sở của SDK OpenAI kết thúc bằng `/v1` trừ khi thử nghiệm của bạn xác nhận rằng nó không tạo ra `/v1/v1/messages`.
Thông tin xác thực	`ANTHROPIC_AUTH_TOKEN` cho định tuyến bearer-token, hoặc `ANTHROPIC_API_KEY` khi cổng yêu cầu `x-api-key`	Tài liệu chính thức của Claude Code ánh xạ mỗi biến đến một tiêu đề HTTP khác nhau. Một khóa hợp lệ nhưng đặt sai biến vẫn sẽ trả về lỗi `401`.
Kiểm tra sơ bộ điểm cuối	`$ANTHROPIC_BASE_URL/v1/messages`	Trang giá hiện tại của Flatkey liệt kê `/v1/messages` trong bản đồ điểm cuối, đây là đường dẫn mà Claude Code cần cho lưu lượng Anthropic Messages.
Mô hình	Sử dụng ID mô hình Claude chính xác hoặc một bí danh Claude Code phân giải đến một tuyến Flatkey đã được kích hoạt	Việc chọn mô hình tách biệt với định tuyến URL cơ sở. Router quyết định lưu lượng đi đâu; Claude Code vẫn gửi tên mô hình.
Bằng chứng sử dụng	Kiểm tra việc sử dụng Flatkey và dữ liệu từ xa của Claude Code sau lời nhắc đầu tiên	Kết quả thành công là chưa đủ. Các đội ngũ cần bằng chứng về khóa, mô hình, dấu thời gian, phiên, chi phí và token.

Đó là phiên bản tóm tắt. Phần còn lại của hướng dẫn về **router API Claude Code** này biến những trường đó thành một sổ tay hướng dẫn cài đặt có thể lặp lại.

Những gì tài liệu chính thức về cổng Claude Code xác nhận

Tổng quan chính thức về cổng Claude Code định nghĩa một cổng LLM là một proxy giữa Claude Code và một nhà cung cấp mô hình. Claude Code gửi lưu lượng API đến cổng, và cổng chuyển tiếp nó với thông tin xác thực của nhà cung cấp do tổ chức kiểm soát. Cùng trang đó liệt kê các lợi ích của cổng như thông tin xác thực tập trung, theo dõi sử dụng, kiểm soát chi phí, ghi nhật ký kiểm toán và chuyển đổi nhà cung cấp.

Quy tắc URL cơ sở rất cụ thể. Claude Code thường gửi yêu cầu đến API của Anthropic, nhưng việc đặt ANTHROPIC_BASE_URL sẽ trỏ những yêu cầu đó đến cổng thay thế. Hướng dẫn kết nối sau đó xác minh tuyến đường bằng cách gửi yêu cầu POST đến $ANTHROPIC_BASE_URL/v1/messages với anthropic-version: 2023-06-01.

Tham chiếu giao thức cổng bổ sung các chi tiết phía người vận hành. Đối với định dạng Anthropic Messages, một cổng được chọn bởi ANTHROPIC_BASE_URL phải phục vụ /v1/messages và tùy chọn là /v1/messages/count_tokens. Nó cũng nói rằng các phản hồi suy luận phải được truyền trực tuyến (stream) vì Claude Code tiêu thụ các sự kiện do máy chủ gửi (server-sent events) ngay khi chúng đến.

Đối với một **router API Claude Code**, điều đó có nghĩa là bạn nên xác thực đường dẫn Anthropic Messages, chứ không chỉ đường dẫn hoàn thành trò chuyện tương thích với OpenAI. Một tuyến OpenAI có thể hoạt động cho các công cụ khác trong khi Claude Code vẫn thất bại nếu /v1/messages, tính năng truyền trực tuyến (streaming), hoặc các tiêu đề Anthropic bắt buộc bị thiếu.

Các giá trị Flatkey đã được xác minh cho cài đặt này

Trang chủ của Flatkey được kiểm tra vào ngày 29 tháng 6 năm 2026 có tiêu đề One API gateway for production AI teams và một mô tả meta nói rằng Flatkey hợp nhất quyền truy cập mô hình, định tuyến, thanh toán, phân tích sử dụng và kiểm soát vận hành. Cùng trang chủ đó vẫn hiển thị các ví dụ theo kiểu OpenAI sử dụng https://console.flatkey.ai/v1 và /v1/chat/completions, những ví dụ này hữu ích cho các công cụ tương thích với OpenAI nhưng không phải là mẫu URL cơ sở của Claude Code.

Trang trường hợp sử dụng Flatkey Claude Code hiện tại cho biết Claude Code được cấu hình với https://router.flatkey.ai và một khóa API Flatkey. Trang này cũng hướng dẫn người dùng tạo hoặc sao chép khóa tại https://console.flatkey.ai/keys trước khi chạy trình cài đặt. Sử dụng gốc router dành riêng cho Claude Code đó cho việc cài đặt thủ công bên dưới, trừ khi tài khoản Flatkey của bạn cung cấp một giá trị mới hơn.

Trang giá của Flatkey được kiểm tra vào ngày 29 tháng 6 năm 2026 công bố bảng giá được kết xuất phía máy chủ cho 635 mô hình AI từ 23 nhà cung cấp. Bản đồ điểm cuối của nó bao gồm /v1/messages, /v1/chat/completions, /v1/responses, /v1/images/generations, /v1/video/generations, và /v1beta/models/{model}:generateContent. Bài viết này coi đó là bằng chứng công khai đã cũ về phạm vi phủ sóng của điểm cuối, không phải là sự đảm bảo rằng mọi tài khoản đều có thể gọi mọi mô hình.

Cài đặt từng bước với Flatkey

Tạo hoặc chọn một khóa Flatkey. Sử dụng khóa thuộc sở hữu của đúng người, nhóm hoặc môi trường. Giữ nó tránh xa ảnh chụp màn hình, câu lệnh, kho lưu trữ và bình luận vấn đề.
Bắt đầu với các lệnh export của shell. Không lưu cài đặt vĩnh viễn cho đến khi kiểm tra sơ bộ (preflight) với một token hoạt động.
Sử dụng gốc router của Claude Code. Đối với trang Flatkey Claude Code hiện tại, giá trị đó là https://router.flatkey.ai.
Chọn biến thông tin xác thực. Sử dụng ANTHROPIC_AUTH_TOKEN khi khóa nên được gửi dưới dạng Authorization: Bearer. Chỉ sử dụng ANTHROPIC_API_KEY khi cổng gateway mong đợi x-api-key.
Đặt một mô hình cho lần kiểm tra đầu tiên. Sử dụng một ID mô hình Claude hiện tại đã được kích hoạt cho tài khoản Flatkey của bạn. Nếu mô hình không hiển thị trong bộ chọn của Claude Code, hãy sử dụng tính năng khám phá cổng gateway hoặc thêm tùy chọn mô hình tùy chỉnh sau khi kiểm tra sơ bộ hoạt động.
Chạy kiểm tra sơ bộ bằng curl. Một yêu cầu một token sẽ tách biệt định tuyến Flatkey khỏi trạng thái giao diện người dùng của Claude Code.
Khởi động Claude Code từ cùng một shell. Điều này làm cho CLI kế thừa các biến bạn vừa kiểm tra.
Chạy /status. Xác nhận dòng URL cơ sở Anthropic hiển thị router Flatkey và dòng thông tin xác thực nêu tên biến bạn đã đặt.
Gửi một câu lệnh nhỏ. Sau đó, kiểm tra việc sử dụng Flatkey và bất kỳ dữ liệu đo từ xa nào của Claude Code mà bạn đã bật.

Cài đặt shell

export ANTHROPIC_BASE_URL="https://router.flatkey.ai"
export ANTHROPIC_AUTH_TOKEN="fk_replace_with_your_flatkey_key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

Nếu hướng dẫn cổng gateway của bạn nêu rõ x-api-key, hãy đổi ANTHROPIC_AUTH_TOKEN thành ANTHROPIC_API_KEY và cập nhật tiêu đề kiểm tra sơ bộ. Không đặt cả hai cho lần kiểm tra đầu tiên; các nguồn thông tin xác thực hỗn hợp làm cho việc cô lập lỗi trở nên khó khăn hơn.

Cài đặt vĩnh viễn sau khi kiểm tra thành công

Sau khi kiểm tra shell hoạt động, bạn có thể đặt các biến tương tự vào khối env của ~/.claude/settings.json. Không đặt thông tin xác thực trong một tệp .claude/settings.json của dự án đã được commit.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://router.flatkey.ai",
    "ANTHROPIC_AUTH_TOKEN": "fk_replace_with_your_flatkey_key",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

Kiểm tra sơ bộ tuyến Messages trước khi khởi chạy Claude Code

Cách kiểm tra API router của Claude Code nhanh nhất là một yêu cầu Messages một token. Nếu thao tác này thất bại, hãy sửa khóa Flatkey, URL cơ sở, đường dẫn mạng hoặc mô hình trước khi thay đổi cài đặt Claude Code.

curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1,
    "messages": [
      {"role": "user", "content": "."}
    ]
  }'

Một phản hồi JSON bắt đầu bằng ID tin nhắn và bao gồm một trường nội dung có nghĩa là tuyến và thông tin xác thực đang hoạt động. Tài liệu chính thức cũng lưu ý rằng lỗi mô hình không xác định vẫn chứng tỏ cổng gateway đã xác thực yêu cầu trước khi từ chối tên mô hình. Lỗi 401 có nghĩa là thông tin xác thực đã bị từ chối hoặc được gửi trong tiêu đề sai.

Hãy xem kỹ URL đã được phân giải. Với ANTHROPIC_BASE_URL=https://router.flatkey.ai, bài kiểm tra sẽ truy cập https://router.flatkey.ai/v1/messages. Nếu lệnh của bạn tạo ra /v1/v1/messages, bạn đã sao chép một URL cơ sở của SDK máy khách vào một trường cổng gateway của Claude Code.

Tên mô hình: bí danh, khám phá và các mục tùy chỉnh

Tên mô hình là nguồn gây lỗi API router của Claude Code phổ biến thứ hai. URL cơ sở gửi lưu lượng truy cập đến Flatkey, nhưng Claude Code vẫn cần một giá trị mô hình để gửi trong yêu cầu.

Tài liệu cấu hình mô hình cho biết Claude Code hỗ trợ các cài đặt mô hình tích hợp sẵn như default, best, sonnet, opus, haiku, và các biến thể ngữ cảnh dài như sonnet[1m] và opus[1m]. Cùng tài liệu đó cho biết ANTHROPIC_MODEL chỉ áp dụng cho phiên bạn khởi chạy cùng với nó, trong khi /model có thể lưu một lựa chọn tương tác cho các phiên sau.

Đối với một tuyến Flatkey, quy tắc an toàn là bắt đầu với một ID mô hình Claude đầy đủ mà Flatkey đã kích hoạt cho khóa của bạn, sau đó quyết định có hiển thị nó trong bộ chọn hay không. Đừng cho rằng một tên họ chung, một nhãn tiếp thị, hoặc một tiêu đề hàng của nhà cung cấp được chấp nhận làm ID mô hình yêu cầu.

Nhu cầu cài đặt mô hình	Cơ chế của Claude Code	Kiểm tra Flatkey
Kiểm tra một phiên	`ANTHROPIC_MODEL` hoặc `claude --model`	Sử dụng ID mô hình Claude đã kích hoạt Flatkey và giữ cho bài kiểm tra ở quy mô nhỏ.
Lựa chọn tương tác	`/model`	Xác nhận tên đã chọn là ID thực tế mà Flatkey mong đợi.
Danh sách mô hình do gateway cung cấp	`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`	Gateway phải phục vụ `/v1/models` một cách nhanh chóng tại URL cơ sở đã được cấu hình.
Nhập thủ công vào bộ chọn	`ANTHROPIC_CUSTOM_MODEL_OPTION`	Sử dụng cách này khi tính năng khám phá bị tắt hoặc không trả về mô hình bạn cần.
Dự phòng khi không khả dụng	`--fallback-model` hoặc `fallbackModel`	Dự phòng không khắc phục được các lỗi xác thực, thanh toán, giới hạn tốc độ, kích thước yêu cầu hoặc lỗi truyền tải.

Khám phá mô hình gateway

Claude Code có thể truy vấn điểm cuối /v1/models của gateway khi khởi động khi ANTHROPIC_BASE_URL trỏ đến một gateway Anthropic Messages và tính năng khám phá được bật. Tài liệu giao thức cho biết yêu cầu là GET /v1/models?limit=1000 với thời gian chờ 3 giây, và Claude Code đọc id cùng với display_name tùy chọn từ phản hồi.

export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
claude --debug

Tính năng khám phá bị tắt theo mặc định để một khóa chia sẻ không tiết lộ mọi mô hình có thể truy cập cho mọi người dùng. Nếu khám phá thất bại, Claude Code sẽ quay lại sử dụng bộ chọn được lưu trong bộ nhớ đệm hoặc tích hợp sẵn. Nếu tài khoản Flatkey của bạn phục vụ một mô hình dưới một bí danh mà tính năng khám phá không hiển thị, hãy thêm một tùy chọn tùy chỉnh thay thế.

Tùy chọn mô hình tùy chỉnh

export ANTHROPIC_CUSTOM_MODEL_OPTION="claude-sonnet-4-6"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Sonnet via Flatkey"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Claude model routed through the Flatkey API router"

Tùy chọn mô hình tùy chỉnh bỏ qua việc xác thực phía máy khách cho ID mô hình đó, vì vậy nó hữu ích cho một chương trình thử nghiệm có kiểm soát. Nó không thể thay thế cho yêu cầu preflight. Nếu danh sách cho phép của tổ chức đang hoạt động, hãy bao gồm cả ID mô hình tùy chỉnh vào đó.

Nhật ký sử dụng: cần kiểm tra gì sau lời nhắc đầu tiên

Một thiết lập API router cho Claude Code đáng tin cậy kết thúc bằng bằng chứng sử dụng, không chỉ là một phản hồi thành công. Định vị công khai của Flatkey cho biết nó hợp nhất việc thanh toán, phân tích sử dụng và kiểm soát vận hành; tài liệu về gateway của Claude Code cũng coi việc theo dõi sử dụng và kiểm soát chi phí là lợi ích của gateway. Hãy chủ động sử dụng cả hai lớp này.

Nguồn nhật ký	Nội dung cần kiểm tra	Tại sao lại quan trọng
Sử dụng Flatkey	Chủ sở hữu khóa, dấu thời gian, mô hình, họ điểm cuối, lượng token sử dụng và bản ghi chi phí nếu có	Xác nhận yêu cầu đã đến đúng tài khoản gateway dự định và có thể được đối chiếu bởi bộ phận vận hành hoặc tài chính.
Trạng thái `/status` của Claude Code	URL cơ sở Anthropic và nguồn thông tin xác thực đang hoạt động	Xác nhận phiên đang chạy đang sử dụng tuyến Flatkey thay vì thông tin đăng nhập claude.ai đã lưu.
Số liệu OpenTelemetry	`claude_code.cost.usage`, `claude_code.token.usage`, số lượng phiên, thời gian hoạt động và điểm vào	Tạo khả năng quan sát ở cấp độ nhóm cho các phiên Claude Code.
Nhật ký/sự kiện OpenTelemetry	Sự kiện lời nhắc, kết quả công cụ, lỗi API và các trường chi phí khi được cấu hình	Giúp gỡ lỗi các lỗi ở cấp độ yêu cầu, nhưng phải được kiểm soát vì nhật ký chi tiết có thể tiết lộ nội dung nhạy cảm.
Header của Gateway	`x-claude-code-session-id`, ID của agent và các header định tuyến tùy chỉnh	Cho phép nhóm các yêu cầu theo phiên hoặc subagent mà không cần phân tích toàn bộ nội dung yêu cầu.

Đối với đo lường từ xa của Claude Code, chỉ bật OpenTelemetry với cài đặt quyền riêng tư có chủ đích. Tài liệu giám sát cho biết văn bản lời nhắc được biên tập lại theo mặc định, trong khi các cài đặt như OTEL_LOG_USER_PROMPTS=1, OTEL_LOG_TOOL_DETAILS=1, và OTEL_LOG_RAW_API_BODIES thêm các chi tiết nhạy cảm. Không đưa việc ghi nhật ký nội dung thô vào thiết lập mặc định của nhà phát triển trừ khi được bộ phận bảo mật của bạn phê duyệt.

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

Sử dụng OTEL_RESOURCE_ATTRIBUTES cho các trường sở hữu có số lượng giá trị riêng biệt thấp như phòng ban, ID nhóm hoặc trung tâm chi phí. Tránh sử dụng tên dự án hoặc ID vé do người dùng nhập làm nhãn trừ khi backend quan sát của bạn có thể xử lý được số lượng giá trị riêng biệt và tác động về quyền riêng tư.

Các chế độ lỗi cần gỡ trước tiên

Triệu chứng	Nguyên nhân có thể	Cách khắc phục đầu tiên
`401` hoặc token không hợp lệ	Khóa bị từ chối, hết hạn, sao chép vào biến sai, hoặc được gửi trong một header mà gateway không đọc.	Chỉ chuyển đổi giữa `ANTHROPIC_AUTH_TOKEN` và `ANTHROPIC_API_KEY` sau khi xác nhận header nào mà Flatkey mong đợi.
Kết nối bị từ chối hoặc hết thời gian chờ	URL cơ sở sai, đường dẫn mạng bị chặn, sự cố VPN, hoặc một điểm cuối router không thể truy cập từ máy của nhà phát triển.	Chạy curl preflight và xác minh URL theo hướng dẫn tài khoản Flatkey của bạn.
Phản hồi bị lỗi với HTTP 200	Một proxy hoặc trang đăng nhập đã trả về HTML thay vì API JSON.	Kiểm tra phần thân phản hồi preflight và sửa tuyến gateway trả về dữ liệu không phải JSON.
`400` có tên `context_management` hoặc các trường bổ sung	Gateway đã chuyển tiếp các trường yêu cầu định dạng Anthropic đến một upstream từ chối chúng.	Chuyển tiếp cặp header/body beta một cách chính xác hoặc đặt `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` như một biện pháp giảm thiểu tạm thời.
`400` có tên `thinking` hoặc `adaptive`	Bản dựng mô hình upstream không chấp nhận lý luận thích ứng được yêu cầu cho các mô hình Claude mới hơn.	Nâng cấp tuyến upstream, hoặc sử dụng cờ vô hiệu hóa tư duy thích ứng đã được ghi nhận chỉ ở những nơi áp dụng.
Thiếu mô hình từ `/model`	Mô hình không có trong bộ chọn tích hợp của Claude Code và tính năng khám phá bị vô hiệu hóa hoặc không thành công.	Bật tính năng khám phá mô hình gateway hoặc thêm `ANTHROPIC_CUSTOM_MODEL_OPTION`.
Claude Code yêu cầu đăng nhập sau khi curl thành công	CLI không nhận được thông tin xác thực ở nơi mà thiết lập lần đầu có thể đọc được.	Đặt thông tin xác thực trong shell, `~/.claude/settings.json`, hoặc cài đặt được quản lý trước khi khởi động.
Không thể đối chiếu việc sử dụng	Thiết lập thiếu chủ sở hữu khóa, tên mô hình, môi trường, ID phiên, hoặc nhãn đo từ xa.	Thêm một hàng runbook trước khi có thêm nhà phát triển sử dụng tuyến này.

Danh sách kiểm tra cho môi trường production dành cho các nhóm

Trước khi bạn chuẩn hóa một API router của Claude Code trong toàn nhóm, hãy ghi lại các thông tin vận hành mà một sự cố trong tương lai hoặc một cuộc rà soát tài chính sẽ cần đến.

Hạng mục kiểm tra	Ghi lại thông tin này
URL cơ sở	Giá trị chính xác được lưu trong shell, cài đặt được quản lý, cài đặt VS Code, CI, hoặc cấu hình Agent SDK.
Nguồn thông tin xác thực	Chủ sở hữu khóa Flatkey, môi trường, chủ sở hữu luân phiên, và liệu nó là tĩnh hay đến từ một `apiKeyHelper`.
Tên mô hình	ID mô hình được yêu cầu, nhãn bộ chọn, chuỗi dự phòng, quy tắc danh sách cho phép, và ngày thử nghiệm.
Bằng chứng điểm cuối	Kết quả `/v1/messages` một token, dấu thời gian yêu cầu, và bất kỳ ID yêu cầu nào được gateway trả về.
Rà soát việc sử dụng	Chế độ xem sử dụng Flatkey, backend đo từ xa của Claude Code, các nhãn, và chủ sở hữu bảng điều khiển.
Cổng bảo mật riêng tư	Liệu các câu lệnh, chi tiết công cụ, phần thân API thô, hoặc nội dung công cụ có được phép trong đo từ xa hay không.
Quay lui	Đăng nhập Claude Code hoặc đường dẫn nhà cung cấp trước đó, mô hình trước đó, và ai có thể bỏ đặt các biến gateway.

Lộ trình di chuyển nội bộ

Nếu Flatkey đang trở thành tuyến đường chia sẻ cho nhiều công cụ của nhà phát triển, hãy giữ cho thiết lập Claude Code đồng bộ với phần còn lại của cụm tích hợp. Sử dụng hướng dẫn di chuyển API tương thích OpenAI cho các mẫu URL cơ sở của SDK, nhưng hãy nhớ rằng Claude Code sử dụng tuyến Anthropic Messages thay vì /v1/chat/completions.

Đối với thiết lập máy khách để bàn, hãy so sánh với hướng dẫn cài đặt API của Cherry Studio. Đối với các mẫu định tuyến trên máy của nhà phát triển liền kề với Claude Code, hãy xem cài đặt cc-switch Claude Code. Sau khi câu lệnh đầu tiên hoạt động, hãy xem lại giá mô hình của Flatkey, sau đó Nhận một khóa cho bất kỳ môi trường bổ sung nào cần một ranh giới thông tin xác thực riêng biệt.

Câu hỏi thường gặp

Tôi nên sử dụng URL cơ sở nào cho một API router của Claude Code với Flatkey?

Sử dụng gốc router Flatkey dành riêng cho Claude Code được hiển thị cho tài khoản của bạn. Vào ngày 29 tháng 6 năm 2026, trang trường hợp sử dụng Claude Code của Flatkey cho biết Claude Code được cấu hình với https://router.flatkey.ai. Preflight phải đến được chính xác một đường dẫn /v1/messages.

Tôi nên sử dụng `ANTHROPIC_AUTH_TOKEN` hay `ANTHROPIC_API_KEY`?

Sử dụng ANTHROPIC_AUTH_TOKEN khi gateway mong đợi một bearer token trong header Authorization. Sử dụng ANTHROPIC_API_KEY khi nó mong đợi x-api-key. Nếu bạn đoán và nhận được lỗi 401, hãy chuyển đổi biến và kiểm tra lại.

Tôi có thể sử dụng URL cơ sở Flatkey tương thích với OpenAI cho Claude Code không?

Không thể sử dụng trực tiếp như một trường được sao chép. Các công cụ tương thích với OpenAI thường sử dụng một URL cơ sở kết thúc bằng /v1, trong khi Claude Code nối thêm /v1/messages vào ANTHROPIC_BASE_URL. Hãy sử dụng giá trị router Flatkey Claude Code và xác minh URL cuối cùng.

Làm cách nào để thêm các mô hình Flatkey vào bộ chọn mô hình của Claude Code?

Bật CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 khi cổng (gateway) phục vụ /v1/models, hoặc thêm một hàng chọn thủ công với ANTHROPIC_CUSTOM_MODEL_OPTION. Trong cả hai trường hợp, hãy xác nhận ID mô hình chính xác được bật cho khóa Flatkey của bạn.

Tôi nên kiểm tra nhật ký sử dụng nào sau khi cài đặt?

Kiểm tra việc sử dụng Flatkey cho khóa, mô hình, họ điểm cuối (endpoint family), dấu thời gian, token và chi phí nếu có. Cũng sử dụng /status của Claude Code và các chỉ số OpenTelemetry như claude_code.cost.usage và claude_code.token.usage khi đo lường từ xa (telemetry) của tổ chức được bật.

Kết luận

Một thiết lập bộ định tuyến API Claude Code đáng tin cậy có bốn điểm chứng minh: URL cơ sở của Flatkey Claude Code, tiêu đề thông tin xác thực chính xác, tên mô hình đã được kiểm tra và một dấu vết sử dụng mà các đội ngũ tài chính và nền tảng có thể xem xét. Bắt đầu với một yêu cầu kiểm tra sơ bộ (preflight) /v1/messages một token, xác nhận /status, sau đó mở rộng quy mô định tuyến chỉ sau khi nhật ký và quy trình khôi phục (rollback) được ghi lại. Khi bạn đã sẵn sàng định tuyến Claude Code qua một cổng (gateway) dùng chung, hãy nhận một khóa và thử nghiệm với lời nhắc (prompt) nhỏ nhất trước tiên.