Chuyển đến nội dung chính
claude-max-api-proxy là một công cụ cộng đồng cung cấp subscription Claude Max/Pro của bạn dưới dạng endpoint API tương thích với OpenAI. Điều này cho phép bạn dùng subscription của mình với bất kỳ công cụ nào hỗ trợ định dạng API OpenAI.
Đường dẫn này chỉ dành cho khả năng tương thích kỹ thuật. Anthropic từng chặn một số cách sử dụng subscription bên ngoài Claude Code trong quá khứ. Bạn phải tự quyết định có dùng nó hay không và xác minh các quy tắc tính phí hiện tại của Anthropic trước khi dựa vào nó.Tài liệu hỗ trợ hiện tại của Anthropic nói rằng claude -p là cách sử dụng Agent SDK/lập trình. Bản cập nhật hỗ trợ ngày 15 tháng 6 năm 2026 của Anthropic đã tạm dừng kế hoạch credit Agent SDK riêng đã công bố. Hiện tại, Claude Agent SDK, claude -p, và việc sử dụng ứng dụng bên thứ ba vẫn lấy từ giới hạn sử dụng của subscription đã đăng nhập.Trước khi dựa vào đường dẫn này, hãy kiểm tra bài viết về gói Agent SDK của Anthropic, cùng với các bài viết hỗ trợ Claude Code cho tài khoản Pro/Max hoặc Team/Enterprise.

​
Vì sao dùng cách này?

Cách tiếp cậnTuyến chi phíPhù hợp nhất cho
Anthropic APITrả tiền theo token qua Claude Console hoặc cloudỨng dụng production, tự động hóa dùng chung, lưu lượng lớn
Proxy subscription ClaudeQuy tắc gói và credit của Claude Code / claude -pThử nghiệm cá nhân với công cụ tương thích
Nếu bạn có subscription Claude Max hoặc Pro và muốn dùng nó với các công cụ tương thích với OpenAI, proxy này có thể phù hợp với một số quy trình cá nhân. Đây không phải là đường dẫn giá cố định không giới hạn. API key vẫn là đường dẫn chính sách và tính phí rõ ràng hơn cho mục đích production.

​
Cách hoạt động

Your App → claude-max-api-proxy → Claude Code CLI / claude -p → Anthropic
     (OpenAI format)              (converts format)          (uses your login)
Proxy:
  1. Chấp nhận yêu cầu theo định dạng OpenAI tại http://localhost:3456/v1/chat/completions
  2. Chuyển đổi chúng thành lệnh Claude Code CLI
  3. Trả về phản hồi theo định dạng OpenAI (hỗ trợ streaming)

​
Bắt đầu

1

Cài đặt proxy

Yêu cầu Node.js 22+ và Claude Code CLI.
npm install -g claude-max-api-proxy

# Verify Claude CLI is authenticated
claude --version
2

Khởi động máy chủ

claude-max-api
# Server runs at http://localhost:3456
3

Kiểm thử proxy

# Health check
curl http://localhost:3456/health

# List models
curl http://localhost:3456/v1/models

# Chat completion
curl http://localhost:3456/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
4

Cấu hình OpenClaw

Trỏ OpenClaw đến proxy như một endpoint tùy chỉnh tương thích với OpenAI:
{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

​
Catalog tích hợp

ID modelÁnh xạ tới
claude-opus-4Claude Opus 4
claude-sonnet-4Claude Sonnet 4
claude-haiku-4Claude Haiku 4

​
Cấu hình nâng cao

Đường dẫn này dùng cùng tuyến kiểu proxy tương thích với OpenAI như các backend tùy chỉnh /v1 khác:
  • Không áp dụng việc định hình yêu cầu chỉ dành riêng cho OpenAI gốc
  • Không có service_tier, không có Responses store, không có gợi ý prompt-cache, và không có định hình payload tương thích với reasoning của OpenAI
  • Các header ghi nhận nguồn ẩn của OpenClaw (originator, version, User-Agent) không được chèn vào URL proxy
Tạo một LaunchAgent để tự động chạy proxy:
cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.claude-max-api</string>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/node</string>
    <string>/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js</string>
  </array>
  <key>EnvironmentVariables</key>
  <dict>
    <key>PATH</key>
    <string>/usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin</string>
  </dict>
</dict>
</plist>
EOF

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist

​
Ghi chú

  • Đây là công cụ cộng đồng, không được Anthropic hoặc OpenClaw hỗ trợ chính thức
  • Yêu cầu subscription Claude Max/Pro đang hoạt động với Claude Code CLI đã xác thực
  • Kế thừa hành vi tính phí, usage-credit và rate-limit của Claude Code claude -p
  • Proxy chạy cục bộ và không gửi dữ liệu đến bất kỳ máy chủ bên thứ ba nào
  • Hỗ trợ đầy đủ phản hồi streaming
Để tích hợp Anthropic gốc bằng Claude CLI hoặc API key, xem Anthropic provider. Đối với subscription OpenAI/Codex, xem OpenAI provider.

​
Liên quan

Anthropic provider

Tích hợp OpenClaw gốc với Claude CLI hoặc API key.

OpenAI provider

Dành cho subscription OpenAI/Codex.

Chọn model

Tổng quan về tất cả provider, model ref và hành vi failover.

Cấu hình

Tham chiếu cấu hình đầy đủ.