Codex CLI

Codex CLI ابزار کدنویسی خط فرمان OpenAI است: در پوشهٔ پروژه اجرا می‌شود، کد را می‌خواند، تغییر می‌دهد و فرمان اجرا می‌کند. Codex اجازه می‌دهد یک «سرویس‌دهندهٔ مدل» (model provider) سفارشی تعریف کنید؛ با یک بخش کوتاه در فایل تنظیمش، درخواست‌ها به Responses API گیسو می‌روند و هزینه از اعتبار گیسو کم می‌شود.

نصب

npm install -g @openai/codex
codex --version

نصب از npm انجام می‌شود، نه از گیسو. Codex به Node.js نیاز دارد؛ نسخهٔ لازم را در صفحهٔ خود Codex ببینید.

فایل config.toml

این بخش را به ~/.codex/config.toml اضافه کنید. اگر فایل نیست، بسازیدش:

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

# ~/.codex/config.toml   (Windows: %USERPROFILE%\.codex\config.toml)
model = "gpt-5.3-codex"
model_provider = "gisoo"
model_reasoning_effort = "medium"

[model_providers.gisoo]
name = "Gisoo"
base_url = "https://gisoo.pro/api/v1"
env_key = "GISOO_API_KEY"
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 5

# A cheaper profile for small jobs: codex --profile gisoo-fast
[profiles.gisoo-fast]
model = "gpt-5-mini"
model_provider = "gisoo"
model_reasoning_effort = "low"

کلید و اجرا

# Linux / macOS (add the export line to ~/.bashrc or ~/.zshrc to keep it)
export GISOO_API_KEY="sk-gisoo-v1-..."
codex

# One-off job without the interactive screen
codex exec "Add a README section that explains how to run the tests"

# Windows PowerShell
[Environment]::SetEnvironmentVariable("GISOO_API_KEY", "sk-gisoo-v1-...", "User")
# open a new window, then:
codex

اگر پیش‌تر با حساب ChatGPT وارد Codex شده‌اید، با این تنظیم درخواست‌ها به گیسو می‌روند و از اعتبار گیسو کم می‌شوند، نه از اشتراک ChatGPT.

کدام مدل را بگذارید

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

جست‌وجوی وب در Codex

اگر جست‌وجوی وب را در Codex روشن کنید، مدل از ابزار داخلی web_search استفاده می‌کند و هر اجرای آن علاوه بر توکن‌ها هزینهٔ جدا دارد. با قیمت امروز، هر جست‌وجو حدود $0.014 است. جزئیات در هزینهٔ ابزارهای داخلی آمده است.

خطاهای رایج

اول همان مسیری را بیازمایید که Codex به کار می‌برد. اگر این جواب داد، کلید و مدل درست‌اند:

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

# Same path Codex uses: POST /responses (a few tokens, a tiny cost)
curl https://gisoo.pro/api/v1/responses \
  -H "Authorization: Bearer $GISOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.3-codex", "input": "ping", "max_output_tokens": 16}'

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

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