OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

پروکسی API کلود مکس

claude-max-api-proxy یک بستهٔ npm ساخته‌شده توسط جامعه است (نه یک Plugin برای OpenClaw) که اشتراک Claude Max/Pro را به‌صورت یک نقطهٔ پایانی API سازگار با OpenAI ارائه می‌کند؛ بنابراین می‌توانید به‌جای کلید API متعلق به Anthropic، هر ابزار سازگار با OpenAI را به اشتراک خود متصل کنید.

چرا از این استفاده کنیم

روش مسیر هزینه مناسب برای
کلید API متعلق به Anthropic پرداخت به‌ازای هر توکن از طریق Claude Console برنامه‌های عملیاتی، خودکارسازی مشترک، حجم بالا
پروکسی اشتراک Claude قوانین طرح و اعتبار Claude Code / claude -p آزمایش‌های شخصی با ابزارهای سازگار

این پروکسی امکان استفاده از اشتراک Claude Max یا Pro را با ابزارهای سازگار با OpenAI فراهم می‌کند. این روشی نامحدود با نرخ ثابت نیست؛ بلکه محدودیت‌های استفادهٔ Claude Code را به ارث می‌برد. برای استفادهٔ عملیاتی، کلیدهای API همچنان مسیر شفاف‌تری برای صورت‌حساب هستند.

نحوهٔ کار

text
برنامهٔ شما -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic     (قالب OpenAI)                  (تبدیل قالب)                    (استفاده از ورود شما)

پروکسی برای هر درخواست، Claude Code CLI را به‌صورت یک زیرفرایند اجرا می‌کند، درخواست‌های گفت‌وگو با قالب OpenAI را به اعلان‌های CLI تبدیل می‌کند و پاسخ را به‌صورت جریانی (یا یک‌جا) با قالب OpenAI بازمی‌گرداند.

شروع به کار

  • Install the proxy

    به Node.js 20+ و یک Claude Code CLI احراز هویت‌شده نیاز دارد.

    bash
    npm install -g claude-max-api-proxy # Verify Claude CLI is authenticatedclaude --versionclaude auth login   # if not already authenticated

  • Start the server

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

  • Test the proxy

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

  • Configure OpenClaw

    OpenClaw را طوری تنظیم کنید که از پروکسی به‌عنوان یک نقطهٔ پایانی سفارشی سازگار با OpenAI استفاده کند:

    json5
    {  env: {    OPENAI_API_KEY: "not-needed",    OPENAI_BASE_URL: "http://localhost:3456/v1",  },  agents: {    defaults: {      model: { primary: "openai/claude-opus-4" },    },  },}
    • شناسهٔ مدل نام مستعار CLI نگاشت فعلی
    claude-opus-4 opus Claude Opus 4.5
    claude-sonnet-4 sonnet Claude Sonnet 4
    claude-haiku-4 haiku Claude Haiku 4

    پیکربندی پیشرفته

    Proxy-style OpenAI-compatible notes

    این روش از مسیر عمومی و سفارشی /v1 سازگار با OpenAI در OpenClaw استفاده می‌کند؛ همان مسیری که برای هر بک‌اند خودمیزبانِ سازگار با OpenAI به‌کار می‌رود:

    • شکل‌دهی درخواست که فقط مختص OpenAI بومی است، اعمال نمی‌شود.
    • /fast و service_tier فقط برای ترافیک مستقیم api.anthropic.com اعمال می‌شوند؛ مسیرهای پروکسی service_tier را بدون تغییر باقی می‌گذارند (به حالت سریع ارائه‌دهندهٔ Anthropic مراجعه کنید).
    • شکل‌دهی بار داده برای store در Responses، راهنمایی‌های کش اعلان یا سازگاری استدلال OpenAI انجام نمی‌شود.
    • سرآیندهای انتساب OpenAI/Codex متعلق به OpenClaw (originator، version، User-Agent) فقط در ترافیک OAuth بومی api.openai.com ارسال می‌شوند، نه برای مقصدهای سفارشی OPENAI_BASE_URL مانند این پروکسی.
    Auto-start on macOS with LaunchAgent
    bash
    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

    نکات

    • رفتار صورت‌حساب، اعتبار استفاده و محدودیت نرخ claude -p در Claude Code را به ارث می‌برد.
    • فقط به 127.0.0.1 متصل می‌شود و به‌جز فراخوانی خود CLI به Anthropic، داده‌ای به هیچ سرور شخص ثالثی ارسال نمی‌کند.
    • پاسخ‌های جریانی پشتیبانی می‌شوند.
    • خطاهای احراز هویت هنگام راه‌اندازی بررسی نمی‌شوند و فقط پس از اجرای واقعی یک درخواست گفت‌وگو ظاهر می‌شوند؛ اگر CLI احراز هویت نشده باشد، انتظار داشته باشید نخستین درخواست ناموفق شود، نه اینکه سرور از راه‌اندازی خودداری کند.

    موارد مرتبط

    Anthropic provider

    یکپارچه‌سازی بومی OpenClaw با Claude CLI یا کلیدهای API.
    OpenAI provider

    برای اشتراک‌های OpenAI/Codex.
    Model selection

    نمایی کلی از همهٔ ارائه‌دهندگان، ارجاع‌های مدل و رفتار جایگزینی هنگام خرابی.
    Configuration

    مرجع کامل پیکربندی.
    Was this useful?
    On this page

    On this page