Claude Code

Claude Code ابزار کدنویسی Anthropic است که در ترمینال، VS Code و JetBrains کار می‌کند: پروژه را می‌خواند، فایل‌ها را تغییر می‌دهد، فرمان و تست‌ها را اجرا می‌کند. گیسو Messages API شرکت Anthropic را می‌پذیرد، پس Claude Code بدون هیچ تغییری و فقط با چند متغیر محیطی به گیسو وصل می‌شود و هزینه را از اعتبار گیسو برمی‌دارد، نه از اشتراک Claude. این صفحه مرجع فنی این اتصال است. راهنمای قدم‌به‌قدم و تصویری نصب در VS Code را در وبلاگ گیسو نوشته‌ایم.

نصب

Claude Code را با npm نصب کنید، یا با روشی که خود Anthropic برای سیستم‌عامل شما پیشنهاد می‌کند. نصب از منبع Anthropic و npm انجام می‌شود؛ گیسو فقط جای مدل را می‌گیرد.

# Node.js 18 or newer
npm install -g @anthropic-ai/claude-code
claude --version

تنظیم دائمی در settings.json

Claude Code متغیرهای بخش env فایل تنظیمش را پیش از هر اجرا می‌خواند. این فایل برای همهٔ پروژه‌ها ~/.claude/settings.json است (در ویندوز %USERPROFILE%\.claude\settings.json). اگر فایل نیست، بسازیدش:

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gisoo.pro/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-gisoo-v1-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

• تنظیم مخصوص یک پروژه در .claude/settings.json همان پروژه می‌نشیند و معمولاً در گیت می‌رود؛ کلید را آنجا ننویسید. برای تنظیم شخصی یک پروژه، .claude/settings.local.json را به کار ببرید که در گیت نمی‌رود.
• افزونهٔ VS Code و پلاگین JetBrains همان Claude Code را اجرا می‌کنند و همین فایل را می‌خوانند؛ یک تنظیم برای ترمینال و ویرایشگر کافی است.

با متغیر محیطی، برای یک بار امتحان

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

# Linux / macOS — this terminal only
export ANTHROPIC_BASE_URL="https://gisoo.pro/api"
export ANTHROPIC_AUTH_TOKEN="sk-gisoo-v1-..."
export ANTHROPIC_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

# Windows PowerShell — this window only
$env:ANTHROPIC_BASE_URL = "https://gisoo.pro/api"
$env:ANTHROPIC_AUTH_TOKEN = "sk-gisoo-v1-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5-5"
claude

# …or for good (new windows pick it up)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://gisoo.pro/api", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-gisoo-v1-...", "User")

همهٔ متغیرها

نام مدل‌ها

• نام‌های خود Anthropic کار می‌کنند، با خط تیره یا نقطه و با تاریخ یا بدون آن: claude-sonnet-5-5، claude-sonnet-5.5 و claude-sonnet-5-5-latest همه به openrouter/anthropic/claude-sonnet-5.5 می‌رسند.
• شناسهٔ کامل کاتالوگ هم کار می‌کند، مثلاً openrouter/anthropic/claude-sonnet-5.5.
• وسط کار با فرمان /model مدل را عوض کنید؛ نام دلخواه را هم می‌پذیرد، مثلاً /model claude-opus-5-5.
• مدل‌های غیر Claude هم از همین مسیر جواب می‌دهند، مثلاً deepseek-v4-flash. Claude Code برای Claude ساخته شده و مدل‌های دیگر ابزارهایش را با دقت کمتری به کار می‌برند؛ پیش از کار جدی، روی یک کار کوچک امتحانشان کنید.

شناسه‌ها و قیمت‌ها هنگام باز شدن این صفحه از کاتالوگ خوانده می‌شوند و با تغییر قیمت سرویس‌دهنده عوض می‌شوند. فهرست کامل، با قیمت هر مدل به سکه، در صفحهٔ مدل‌ها است.

چه چیزهایی کار می‌کند

جزئیات قالب درخواست، پاسخ جریانی و ابزارها در سازگاری با Anthropic آمده است.

هزینه و محدودیت

• Claude Code در هر قدم کل زمینهٔ کار را می‌فرستد؛ یک کار متوسط ده‌ها درخواست با ورودی بلند است. برای کلیدش سقف هزینه بگذارید.
• پیش از هر درخواست، مبلغی به‌اندازهٔ بیشترین هزینهٔ احتمالی آن (تا ۱۶٬۳۸۴ توکن خروجی) کنار گذاشته می‌شود و بعد فقط هزینهٔ واقعی کم می‌شود. با اعتبار خیلی کم، درخواست‌ها با billing_error رد می‌شوند.
• به‌طور پیش‌فرض ۶۰ درخواست در دقیقه برای هر کلید و ۸ درخواست همزمان برای هر حساب. زیرایجنت‌های موازی ممکن است به این سقف بخورند.
• پیش از احراز هویت، کل مصرف حساب به ۲ دلار محدود است؛ برای کار واقعی احراز هویت را در اپ کامل کنید.

خطاهای رایج

اول کلید و نام مدل را بیرون از Claude Code بیازمایید. اگر این جواب داد، اشکال در تنظیم Claude Code است:

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

# Is the key right and does the model name resolve? (a few tokens, a tiny cost)
curl https://gisoo.pro/api/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-5-5", "max_tokens": 5, "messages": [{"role": "user", "content": "ping"}]}'

پرسش‌های پرتکرار

راهنماهای مرتبط