اتصال Codex CLI به 1ai؛ ارائه‌دهنده‌ی سفارشی در config.toml
Codex CLI عامل برنامه‌نویسی OpenAI در ترمینال است: کد پروژه را می‌خواند، فایل‌ها را ویرایش میکند و دستور اجرا میکند. این ابزار با قالب Responses کار میکند و وان ای آی (1ai) همین قالب را در مسیر POST /v1/responses دارد؛ پس کافی است یک ارائه‌دهنده‌ی سفارشی در ~/.codex/config.toml تعریف کنید. اعتبار را با پرداخت ریالی میخرید و برای کلید سقف مصرف می‌گذارید. این تنظیمات با Codex CLI نسخه‌ی 0.166 روی مدلهای GPT، Gemini و Claude و با اجرای دستور در شل آزموده شده‌اند.
چرا با 1ai
همان قالبی که Codex می‌فرستد
Codex CLI درخواست را به POST /v1/responses می‌فرستد و 1ai همین قالب را با استریم و فراخوانی ابزار جواب میدهد.
GPT، Gemini و Claude
هر سه خانواده با یک نوبت اجرای دستور در شل آزموده شده‌اند. نام کوتاه gpt-… خودکار به openai/gpt-… می‌رسد.
پرداخت ریالی
هزینهی هر درخواست به اندازه‌ی مصرف واقعی از اعتبار 1ai کم میشود که با پرداخت ریالی شارژ میشود.
سقف مصرف برای هر کلید
برای کلید Codex سقف ماهانه، مدلهای مجاز و تاریخ انقضا بگذارید و مصرف را در پنل توسعه‌دهنده ببینید.
در چند قدم
- ۱
Codex CLI را نصب کنید
با
npm install -g @openai/codexنصبش کنید. - ۲
کلید API بسازید
در پنل 1ai از بخش توسعه‌دهندگان ← کلیدها یک کلید با نام Codex و سقف ماهانه بسازید.
- ۳
config.toml را تنظیم کنید
ارائه‌دهنده‌ی
oneaiرا باwire_api = "responses"در~/.codex/config.tomlتعریف کنید؛ متن کامل در بخش بعد آمده است. - ۴
کلید را در محیط بگذارید و اجرا کنید
export ONEAI_API_KEY=sk-1ai-...را بزنید و در پوشه‌ی پروژهcodexرا اجرا کنید.
مدلهای مناسب Codex CLI (با پشتیبانی از ابزار)
همه‌ی مدلهاGPT-6 Luna
سریع و بسیار ارزان؛ مدل پیش‌فرض و در نسخه‌ی رایگان
شروع پاسخ ۲٫۶ ثانیه و سرعت ۷۴ توکن در ثانیه
GPT-6.1 Sol
پرچم‌دار اوپن‌ای‌آی برای کارهای دقیق، تحلیلی و چندمرحله‌ای
شروع پاسخ ۵٫۶ ثانیه و سرعت ۵۷ توکن در ثانیه
Claude Haiku 5.5
سریع‌ترین کلود؛ در نسخه‌ی رایگان
شروع پاسخ ۴٫۶ ثانیه و سرعت ۲۹۸ توکن در ثانیه
نمونه پرامپت‌ها
پرامپت را کپی کنید، در 1ai بگذارید و جزئیات خودتان را جایگزین کنید.
شناخت پروژه
Explain the structure of this project and how a request flows through it. Do not change any file yet.
پیش از هر تغییری ببینید پروژه را درست فهمیده است.
رفع خطا
Find the cause of this error and fix it with minimal changes: [متن خطا]. Run `[دستور تست، مثلاً npm test]` afterwards and report what passed.
نوشتن تست
Add tests for [مسیر فایل] covering empty input and invalid input. Run them and fix only the tests, not the code.
گزارش فارسی
با git log بررسی کن در ده commit آخر چه تغییرهایی داده شده و به فارسی خلاصه کن کدام بخش‌های پروژه بیشترین تغییر را داشته‌اند.
تنظیم config.toml برای 1ai
این خطوط را در ~/.codex/config.toml بگذارید:
model_provider = "oneai"
model = "gpt-6.1-sol"
[model_providers.oneai]
name = "1ai"
base_url = "https://1ai.ir/v1"
env_key = "ONEAI_API_KEY"
wire_api = "responses"بعد کلید را در محیط بگذارید:
export ONEAI_API_KEY=sk-1ai-...
codexmodel_providerوmodelباید بالای فایل و پیش از جدول[model_providers.oneai]بیایند؛ وگرنه جزو همان جدول خوانده میشوند.base_urlبا/v1نوشته میشود.env_keyنام متغیر محیطی است، نه خود کلید. کلید را داخل فایل ننویسید.wire_apiبایدresponsesباشد.
انتخاب مدل در Codex CLI
مدل پیش‌فرض همان model در فایل است و برای یک جلسه می‌توانید آن را با -m عوض کنید:
codex -m gpt-6.1-sol
codex -m anthropic/claude-sonnet-5.5
codex -m google/gemini-3.8-flashنام کوتاه gpt-… خودکار به openai/gpt-… می‌رسد و مدلهای دیگر را با شناسهی کامل و پیشوند سازنده بنویسید. Codex بدون فراخوانی ابزار کار نمی‌کند، پس مدلی انتخاب کنید که tools داشته باشد. فهرست این مدلها در همین صفحه آمده و مقایسه‌ی کلی خانواده‌ها در برنامه‌نویسی با هوش مصنوعی است.
مسیر Responses در 1ai چه فرقی دارد؟
- گفتگو نگه داشته نمیشود. مسیر
/v1/responsesدر 1ai بدون حالت (stateless) است وprevious_response_id،conversationوbackgroundرا با خطای 400 رد میکند. - جستجوی وب میزبانی‌شده حذف میشود، مگر مدل برای جستجو قیمت داشته باشد. در این حالت درخواست رد نمیشود، فقط جستجو انجام نمیشود.
- ابزارهای میزبانی‌شده‌ی دیگر مثل
code_interpreter،file_searchوmcpبا400 tool_unsupportedرد میشوند.
خطاهای رایج Codex CLI با 1ai و راه‌حل
- 401
invalid_api_key: کلید اشتباه، باطل یا منقضی است، یاONEAI_API_KEYدر همین ترمینال تنظیم نشده است. - 402: اعتبار یا سقف ماهانه‌ی کلید تمام شده است.
- 404
model_not_found: پیشوند سازنده جا افتاده است؛claude-sonnet-5.5بایدanthropic/claude-sonnet-5.5باشد. - 404 با پیام Unknown endpoint:
base_urlباید دقیقاًhttps://1ai.ir/v1باشد. - 400
unsupported_parameter: درخواست به حالت ذخیره‌شده‌ی گفتگو تکیه کرده است؛ تاریخچه را در خود درخواست بفرستید. - 400
tool_unsupported: ابزاری فرستاده شده که روی این مدل یا در 1ai پشتیبانی نمیشود. اگر با مدل غیر OpenAI پیش آمد، یک مدل GPT را امتحان کنید. - 429
rate_limit_exceeded: سقف درخواست یا توکن در دقیقه پر شده؛ کمی صبر کنید و جلسه‌های هم‌زمان را کم کنید.
چطور هزینهی Codex CLI را کنترل کنیم؟
- برای موضوع تازه جلسه‌ی تازه باز کنید تا تاریخچه‌ی قبلی در هر درخواست فرستاده نشود.
- برای کارهای ساده مدل ارزان‌تری با
-mانتخاب کنید. - برای Codex کلید جدا با سقف ماهانه و فهرست مدلهای مجاز بسازید.
جزئیات در راهنمای کلیدها و کنترل هزینه آمده است. برای عامل‌های ترمینالی دیگر، راهنمای Claude Code و راهنمای Gemini CLI را ببینید.
ابزارهای آماده
توضیح کد و رفع باگ
کد را بفهمید، خطایش را پیدا کنید و تمیزش کنید
ساخت عبارت باقاعده (Regex)
الگوی Regex با توضیح و نمونه‌ی آزمون
ساخت کوئری SQL
درخواست فارسی، کوئری درست و توضیح‌داده‌شده
دستیارهای مرتبط
برنامه‌نویس ارشد
نوشتن، مرور و اشکال‌زدایی کد با توضیح روشن
- «این کد را مرور کن و باگ‌ها و مشکلات امنیتی‌اش را بگو: »
- «یک API ساده برای مدیریت کارها با Node.js و Express بنویس»
سوالات متداول
برای Codex CLI با 1ai به حساب OpenAI نیاز دارم؟
خیر. با این تنظیمات Codex CLI با کلید 1ai کار میکند و هزینهی هر درخواست از اعتبار API کم میشود. اعتبار را جدا میخرید و اشتراک چت 1ai شامل آن نمیشود.
میتوانم Codex CLI را با Claude یا Gemini اجرا کنم؟
بله. Codex CLI با مدلهای GPT، Gemini و Claude روی 1ai آزموده شده است. شناسهی کامل مدل را در model یا با -m بنویسید، مثل anthropic/claude-sonnet-5.5. مدل باید فراخوانی ابزار داشته باشد.
چرا previous_response_id رد میشود؟
1ai گفتگوها را در این مسیر نگه نمیدارد، پس چیزی برای ادامه دادن با این شناسه وجود ندارد. conversation و background هم به همین دلیل رد میشوند. در کد خودتان تاریخچه را در input هر درخواست بفرستید.
جستجوی وب Codex CLI کار میکند؟
فقط روی مدلهایی که برای جستجو قیمت دارند. روی مدلهای دیگر این ابزار از درخواست حذف میشود و Codex بدون جستجو ادامه میدهد؛ خطایی نمیبینید.
کلید را کجا نگه دارم؟
در متغیر محیطی ONEAI_API_KEY، نه داخل config.toml. برای ماندگار شدن، خط export را در ~/.zshrc یا ~/.bashrc بگذارید و کلید را در مخزن پروژه commit نکنید.
چطور پیش از Codex مطمئن شوم کلید و آدرس درست است؟
در ترمینال curl https://1ai.ir/v1/models -H "Authorization: Bearer sk-1ai-..." را اجرا کنید. اگر فهرست مدلها برگشت، کلید و آدرس سالماند و مشکل در config.toml است.
مطالب مرتبط
کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه
چطور کلیدهای API را امن نگه دارید و هزینه را مهار کنید: مدلهای مجاز، سقف اعتبار ماهانه، محدودیت نرخ، تاریخ انقضا، کلیدهای تیمی و گزارش مصرف.
استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL
چطور پروژه‌ای را که با کتابخانه‌ی OpenAI نوشته شده، فقط با تغییر آدرس پایه و کلید به 1ai وصل کنید؛ با نمونه کد Python، Node.js و cURL، استریم، فهرست مدلها و مدیریت خطا.
بهترین هوش مصنوعی برای برنامه نویسی؛ مقایسه مدلها و ابزارها
برای انتخاب دستیار کدنویسی، هم مدل مهم است هم ابزار اجرای آن. مدلهای مطرح، تفاوت چت و ایجنت، انتخاب اقتصادی و روش سنجش پاسخ‌ها روی پروژهٔ واقعی را بررسی می‌کنیم.
وایب کدینگ چیست؟ آموزش ساخت یک سایت ساده با هوش مصنوعی
با توضیح فارسی ایده، یک سایت کوچک بسازید و قدم‌به‌قدم اصلاحش کنید؛ همراه با پرامپت‌های آماده، روش تست و مرز میان نمونه اولیه و محصول قابل اعتماد.
صفحه‌های مرتبط
همه‌ی امکاناتاتصال Claude Code
Claude Code را با چند متغیر محیطی به 1ai وصل کنید، در ترمینال با Claude یا هر مدل چت دیگر کدنویسی کنید و بدانید برای کار بدون خطای اعتبار چه موجودی‌ای لازم است.
اتصال Gemini CLI
Gemini CLI را با دو متغیر محیطی و یک خط در settings.json به 1ai وصل کنید و در ترمینال با Gemini یا هر مدل چت دیگر از یک کلید کدنویسی کنید.
اتصال OpenCode
OpenCode را با یک ارائه‌دهنده‌ی سفارشی در opencode.json به 1ai وصل کنید و در ترمینال با Claude، GPT، Qwen و DeepSeek از یک کلید کدنویسی کنید.
اتصال Aider
Aider را با دو متغیر محیطی به 1ai وصل کنید و در ترمینال، روی مخزن git خودتان، با Claude، GPT، DeepSeek و Qwen کد بنویسید و commit بگیرید.
اتصال Codex CLI به 1ai؛ ارائه‌دهنده‌ی سفارشی در config.toml
Codex CLI را با چند خط در config.toml به 1ai وصل کنید و در ترمینال با مدلهای GPT، Gemini و Claude از یک کلید کدنویسی کنید.
ساخت کلید API