پرش به مطلب اصلی

اتصال Codex CLI به چابکان

Codex CLI چیست؟​

Codex یک عامل برنامه‌نویسی از OpenAI است که می‌تواند از داخل ترمینال یا افزونه IDE روی repository کار کند. کاربر می‌تواند از Codex برای توضیح کد، پیاده‌سازی قابلیت، رفع bug، اجرای تست و بازبینی تغییرات استفاده کند. Codex به‌جای دریافت یک سؤال منفرد، می‌تواند context پروژه و نتیجه ابزارها را در چند مرحله دنبال کند.

در این راهنما، چابکان به‌عنوان model provider سفارشی Codex تعریف می‌شود. Codex درخواست‌های این provider را از طریق Responses API می‌فرستد و درگاه چابکان مسیر /v1/responses را پشتیبانی می‌کند. در نتیجه انتخاب مدل، کلید و گزارش مصرف در چابکان انجام می‌شود، اما دسترسی فایل و اجرای فرمان همچنان تحت کنترل خود Codex است.

چه زمانی Codex انتخاب مناسبی است؟​

  • وقتی یک coding agent خط فرمان با گردش‌کار OpenAI می‌خواهید؛
  • وقتی کار شما شامل تحلیل و تغییر چند فایل و اجرای تست است؛
  • وقتی همان تنظیم را در CLI و افزونه VS Code استفاده می‌کنید؛
  • وقتی مدل انتخابی شما با Responses و tool calling سازگار است.

برای افزونه گرافیکی، پس از این صفحه راهنمای Codex در VS Code را بخوانید.

۱. نصب Codex CLI​

یکی از روش‌های رسمی زیر را استفاده کنید.

macOS و Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

یا با npm:

npm install -g @openai/codex

سپس نصب را بررسی کنید:

codex --version

۲. قرار دادن کلید در متغیر محیطی​

macOS، Linux و WSL:

export CHABOKAN_AI_API_KEY="sk-chbk-کلید-واقعی-شما"

PowerShell:

$env:CHABOKAN_AI_API_KEY = "sk-chbk-کلید-واقعی-شما"

۳. افزودن provider چابکان​

فایل ~/.codex/config.toml را بسازید یا باز کنید و تنظیم زیر را به آن اضافه کنید:

model = "openai/gpt-4o-mini"
model_provider = "chabokan"

[model_providers.chabokan]
name = "Chabokan AI"
base_url = "https://ai.chabokan.net/v1"
env_key = "CHABOKAN_AI_API_KEY"
wire_api = "responses"

مقدار model را با شناسه دقیق مدلی که در زبانه مدل‌های قابل استفاده دیده‌اید جایگزین کنید. کلید را مستقیماً داخل config.toml ننویسید؛ env_key فقط نام متغیر محیطی را نگه می‌دارد.

اگر از قبل تنظیمات دیگری در این فایل دارید، آن‌ها را حذف نکنید. فقط مقادیر سطح بالا را یک‌بار تعریف و جدول provider را اضافه کنید.

۴. اجرای Codex​

cd /path/to/your/project
codex

برای اولین آزمون بنویسید:

ساختار این پروژه را بررسی کن و بدون تغییر فایل‌ها، سه بخش اصلی آن را توضیح بده.

آزمون غیرتعاملی:

codex exec "فقط بنویس: اتصال چابکان برقرار است"

۵. انتخاب موقت مدل بدون تغییر فایل​

برای یک اجرا می‌توانید مدل را با گزینه خط فرمان تعیین کنید:

codex --model "شناسه-دقیق-مدل"

provider همچنان از config.toml خوانده می‌شود.

خطاهای خاص Codex​

  • خطای نبودن متغیر: مطمئن شوید Codex را از همان ترمینالی اجرا می‌کنید که CHABOKAN_AI_API_KEY در آن تنظیم شده است.
  • خطای مدل: شناسه مدل را بدون تغییر از پنل کپی کنید.
  • خطای مسیر یا پاسخ نامعتبر: base_url باید دقیقاً به /v1 ختم شود و wire_api باید responses باشد.

منبع: مرجع رسمی پیکربندی Codex