اتصال به برنامهها
سیستمعامل و برنامهتان را انتخاب کنید؛ راهنمای قدمبهقدم با کلید و مدل خودتان آماده میشود.
۱ سیستمعامل
۲ برنامه
برای اپ رسمی Claude فقط مدلهای Claude قابل استفاده است؛ برای گفتگو با GPT روی دسکتاپ از Cherry Studio استفاده کنید.
کلید فقط در مرورگر شما جایگزین میشود و جایی ارسال نمیشود.
وارد شوید تا بتوانید همینجا کلید بسازید.
ضریب مصرف هر مدل در صفحهی مدلها آمده است.
راهنمای اتصال Codex CLI
Windows · ۶ قدم-
۱
انتخاب یا ساخت کلید API
از بالای همین صفحه کلید کامل خود را بچسبانید یا با دکمهی «ساخت کلید جدید برای این برنامه» یک کلید تازه بسازید؛ کدهای این راهنما خودکار با کلید و مدل انتخابی شما پر میشوند.
کلید کامل فقط یک بار، هنگام ساخت، نمایش داده میشود. آن را در جای امنی نگه دارید و در گروهها یا اسکرینشاتها منتشر نکنید.
-
۲
نصب Node.js و Codex
Node.js نسخهی ۱۸ یا بالاتر را از
nodejs.orgنصب کنید، سپس در ترمینال:ترمینالnpm install -g @openai/codex
-
۳
ساخت فایل تنظیمات Codex
تنظیمات در فایل
%USERPROFILE%\.codex\config.tomlقرار میگیرد. این دستور فایل را باز میکند:ترمینالNew-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null notepad "$env:USERPROFILE\.codex\config.toml"
-
۴
وارد کردن آدرس و مدل
متن زیر را در فایل بگذارید و ذخیره کنید:
config.tomlmodel = "claude-sonnet-5" model_provider = "api2928" [model_providers.api2928] name = "2928" base_url = "https://api.2928.ir/v1" env_key = "API2928_KEY" wire_api = "responses"
-
۵
ذخیرهی کلید در متغیر محیطی
Codex کلید را از متغیر
API2928_KEYمیخواند. این دستور آن را برای همیشه ذخیره میکند:PowerShellsetx API2928_KEY "sk-..."بعد از
setxترمینال (و VS Code) را ببندید و دوباره باز کنید تا متغیر خوانده شود. -
۶
اجرا
در پوشهی پروژه دستور
codexرا بزنید و یک پیام کوتاه بفرستید.ترمینالcodex
اگر Codex از شما خواست با حساب ChatGPT وارد شوید، یعنی فایل تنظیمات یا متغیر کلید خوانده نشده؛ مسیر فایل و نام متغیر را بررسی کنید و ترمینال را از نو باز کنید.
خطاهای رایج
- 401 (Unauthorized)
- کلید اشتباه است یا ناقص چسبانده شده. کلید کامل را دوباره وارد کنید و مطمئن شوید فاصله یا خط جدید اضافه ندارد.
- 403 (اعتبار تمام شده)
- اعتبار حساب تمام یا منقضی شده است. از صفحهی «خرید اعتبار» بسته بخرید یا تمدید کنید.
- 503 — model_not_found
- نام مدل اشتباه است. نام را دقیقاً از صفحهی «مدلها» کپی کنید.
- 404 (Not Found)
- آدرس پایه باید
https://api.2928.ir/v1باشد. خود برنامه مسیر/chat/completionsرا اضافه میکند؛ آن را به آدرس اضافه نکنید. - پاسخ دیر شروع میشود
- مدلهای بزرگ (Opus، GPT-6 و Sol) گاهی چند ثانیه تا دهها ثانیه قبل از شروع پاسخ فکر میکنند؛ برای کارهای سریع از Sonnet یا Haiku استفاده کنید. وضعیت لحظهای مدلها در صفحهی «وضعیت سرویس» است.
بگویید در کدام قدم ماندید و متن خطا را بفرستید.