Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

claude-max-api-proxy là một công cụ cộng đồng cung cấp gói đăng ký Claude Max/Pro của bạn dưới dạng điểm cuối API tương thích với OpenAI. Điều này cho phép bạn dùng gói đăng ký của mình với bất kỳ công cụ nào hỗ trợ định dạng OpenAI API.
Luồng này chỉ dành cho khả năng tương thích kỹ thuật. Trước đây Anthropic đã chặn một số cách dùng gói đăng ký bên ngoài Claude Code. Bạn phải tự quyết định có sử dụng nó hay không và xác minh các điều khoản hiện tại của Anthropic trước khi dựa vào nó.

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

Cách tiếp cậnChi phíPhù hợp nhất cho
Anthropic APITrả theo token (~15/Mđa^ˋuvaˋo,15/M đầu vào, 75/M đầu ra cho Opus)Ứng dụng production, lưu lượng cao
Gói đăng ký Claude MaxCố định $200/thángSử dụng cá nhân, phát triển, sử dụng không giới hạn
Nếu bạn có gói đăng ký Claude Max 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ể giảm chi phí cho một số quy trình làm việc. API key vẫn là hướng chính sách rõ ràng hơn cho mục đích production.

​
Cách hoạt động

Your App → claude-max-api-proxy → Claude Code CLI → Anthropic (via subscription)
     (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 chúng thành các lệnh Claude Code CLI
  3. Trả về phản hồi ở định dạng OpenAI (hỗ trợ streaming)

​
Bắt đầu

1

Install the proxy

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

# Verify Claude CLI is authenticated
claude --version
2

Start the server

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

Test the 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

Configure OpenClaw

Trỏ OpenClaw đến proxy dưới dạng điểm cuối 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" },
    },
  },
}

​
Danh mục tích hợp sẵn

ID mô hìnhÁ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

Luồng này dùng cùng tuyến tương thích với OpenAI theo kiểu proxy như các backend /v1 tùy chỉnh khác:
  • Không áp dụng đị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 reasoning của OpenAI
  • Các header ghi nhận ẩn của OpenClaw (originator, version, User-Agent) không được chèn vào URL proxy
Tạo LaunchAgent để chạy proxy tự động:
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

​
Liên kết

​
Ghi chú

  • Đây là một công cụ cộng đồng, không được Anthropic hoặc OpenClaw hỗ trợ chính thức
  • Yêu cầu gói đăng ký Claude Max/Pro đang hoạt động và Claude Code CLI đã xác thực
  • 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
  • Phản hồi streaming được hỗ trợ đầy đủ
Để tích hợp Anthropic gốc với Claude CLI hoặc API key, xem Nhà cung cấp Anthropic. Đối với gói đăng ký OpenAI/Codex, xem Nhà cung cấp OpenAI.

​
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 gói đăng ký OpenAI/Codex.

Model selection

Tổng quan về tất cả nhà cung cấp, tham chiếu mô hình và hành vi failover.

Configuration

Tài liệu tham chiếu cấu hình đầy đủ.