راهنمای اتصال

اتصال Claude Code به نکسامدل

دستیار کدنویسی انتروپیک در ترمینال. آدرس سرور را از متغیرهای محیطی می‌خواند.

نمونه‌ها با آدرس واقعی API نوشته شده‌اند؛ فقط کلید API خودتان را جای $NEXAMODEL_API_KEY بگذارید. کلید را بعد از ثبت‌نام در پنل می‌سازید و همین تنظیمات آن‌جا با کلید خودتان آماده است.

مراحل راه‌اندازی

Claude Code آدرس سرور را از متغیرهای محیطی می‌خواند. کافی است آدرس و کلید نکسامدل را آنجا بگذارید.

۱

نصب کنید

terminal
npm install -g @anthropic-ai/claude-code

به Node.js نسخهٔ ۲۲ یا بالاتر نیاز دارد. دستور را بدون sudo اجرا کنید. بعد از نصب، claude --versionشمارهٔ نسخه را نشان می‌دهد.

۲

اگر با حساب دیگری وارد شده‌اید، خارج شوید

اگر در Claude Code با حساب دیگری وارد شده‌اید، Claude Code به‌جای این تنظیمات از همان حساب استفاده می‌کند. داخل Claude Code دستور /logout را بزنید.

۳

تنظیمات را بنویسید

~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.nexamodel.app",
"ANTHROPIC_AUTH_TOKEN": "$NEXAMODEL_API_KEY",
"ANTHROPIC_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5.1",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
این بخش هم لازم است~/.zshrc · ~/.bashrc
~/.zshrc · ~/.bashrc
# The same settings, as environment variables.
export ANTHROPIC_BASE_URL="https://api.nexamodel.app"
export ANTHROPIC_AUTH_TOKEN="$NEXAMODEL_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4.5"
export ANTHROPIC_DEFAULT_FABLE_MODEL="claude-fable-5.1"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

در ویندوز همین فایل در %USERPROFILE%\.claude\settings.json است.

۴

اجرا کنید

terminal
claude
# /status ← which server and model you are on
# /model claude-sonnet-5
Claude Code فقط با مدل اصلی کار نمی‌کند: کارهای پس‌زمینه را به مدل «haiku» می‌فرستد و /model opus و ساب‌ایجنت‌ها هم نام مدل خودشان را دارند. اگر این نام‌ها به مدل‌های نکسامدل وصل نشوند، آن درخواست‌ها با خطای 403 رد می‌شوند. تنظیمات بالا همین کار را کرده است: haiku به claude-haiku-4.5، sonnet به claude-sonnet-5 و opus به claude-opus-5.
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ارسال آمار و گزارش خطای خود Claude Code را خاموش می‌کند. Claude Code برای کار با نکسامدل به آن‌ها نیازی ندارد.