# Codex در برابر Claude Code: مقایسه‌ای عمیق

> **آخرین بازبینی**: 2026-11-12 · 📄 بر اساس مستندات رسمی (نمای کلی مدل‌ها و قیمت‌گذاری Anthropic؛ پیکربندی مدل Claude Code و تاریخچه تغییرات؛ qcode.cc/models؛ بررسی‌شده در 2026-11-12)

در 2026، چشم‌انداز ابزارهای کدنویسی با هوش مصنوعی به یک رقابت دو اسبه تبدیل شده است: **Claude Code** از Anthropic و **Codex CLI** از OpenAI. هر دو دستیارهای کدنویسی عامل‌محور بومی CLI هستند که می‌توانند به‌صورت خودمختار فایل‌ها را بخوانند و بنویسند، فرمان‌ها را اجرا کنند و وظایف پیچیده توسعه را انجام دهند.

بسیاری از توسعه‌دهندگان به‌طور غریزی می‌پرسند «کدام را انتخاب کنم؟» اما پس از هزاران ساعت استفاده در دنیای واقعی و بازخورد جامعه، بهترین پاسخ در واقع این است: **از آن‌ها با هم استفاده کنید**. نقاط قوت آن‌ها به‌مراتب بیشتر مکمل یکدیگرند تا رقیب.

این مقاله همه چیز را از فلسفه اصلی و 15+ بُعد مقایسه دقیق و توصیه‌های مبتنی بر سناریو گرفته تا گردش‌کارهای ترکیبی عملی پوشش می‌دهد -- و به شما کمک می‌کند هر دو ابزار را به‌طور کامل درک کنید و پربازده‌ترین روش استفاده از آن‌ها را بیابید.

---

## فلسفه اصلی

پیش از ورود به مقایسه، درک فلسفه‌های طراحی از پایه متفاوت آن‌ها کمک‌کننده است:

### Claude Code: برنامه‌نویسی جفتی تعاملی

Claude Code حس **برنامه‌نویسی جفتی با یک مهندس ارشد** را می‌دهد. این ابزار:

- پیش از اجرا، پلن خود را به‌تفصیل توضیح می‌دهد و منتظر تأیید شما می‌ماند
- به‌صورت فعال جایگزین‌ها را پیشنهاد می‌دهد و ریسک‌های بالقوه را علامت‌گذاری می‌کند
- از طریق گفت‌وگوی چندنوبته در مسائل عمیق‌تر می‌شود
- برای وظایف پیچیده به‌صورت خودمختار برنامه‌ریزی می‌کند، اما در نقاط کلیدی تصمیم‌گیری با شما هماهنگ می‌کند

```text
You: Are there any security issues in this auth module?

Claude Code: I've reviewed all files under src/auth/ and found three potential issues:

1. JWT tokens have no expiration set (auth/token.ts:42)
2. Password hashing uses the deprecated MD5 algorithm (auth/password.ts:15)
3. The login endpoint lacks rate limiting (routes/login.ts:28)

I'd suggest fixing these in priority order: #2 first (highest risk), then #1, then #3.
Want me to fix them one by one? Or would you like to review the specific approach first?
```

مزیت این حالت: شما همیشه می‌دانید هوش مصنوعی چه می‌کند و چرا؛ این آن را برای سناریوهایی که به درک عمیق و کنترل دقیق نیاز دارند ایده‌آل می‌کند.

### Codex: اجرای خودمختار عامل

Codex بیشتر شبیه **سپردن یک وظیفه به یک کارآموز توانمند** است. این ابزار:

- به‌محض دریافت دستورالعمل‌ها، اجرا را به‌صورت خودمختار در یک جعبه‌شن آغاز می‌کند
- همه کار را بدون وقفه کامل می‌کند، سپس نتایج را تحویل می‌دهد
- در حین اجرا به تأیید تعاملی نیازی ندارد
- پس از پایان، نتایج را برای بررسی شما ارائه می‌دهد

```bash
$ codex "Add comprehensive unit tests for the auth module, covering all edge cases"

# Codex automatically:
# 1. Analyzes all functions under src/auth/
# 2. Creates tests/auth/ directory
# 3. Writes 15 test cases
# 4. Runs tests to confirm they all pass
# 5. Returns an execution summary

✓ Created 4 test files with 15 test cases
✓ All tests passing (15/15)
  - token.test.ts (5 cases)
  - password.test.ts (4 cases)
  - session.test.ts (3 cases)
  - middleware.test.ts (3 cases)
```

مزیت این حالت: بسیار خودکار با توان عملیاتی بالا، ایده‌آل برای وظایف دسته‌ای به‌خوبی تعریف‌شده که می‌توان آن‌ها را از پیش به‌طور کامل توصیف کرد.

---
## مقایسه کامل

### معماری اصلی

| معیار | Codex CLI | Claude Code |
|-----------|-----------|-------------|
| شرکت | OpenAI | Anthropic |
| مجوز | Apache 2.0 (کاملاً متن‌باز) | متن‌بسته (توزیع باینری) |
| زبان | Rust | TypeScript |
| مدل پیش‌فرض | GPT-5.6-terra / GPT-5.5 (1M؛ به `/models` مراجعه کنید) | Opus 5 / Sonnet 5 (1M؛ 4.x هنوز به فروش می‌رسد) |
| انتشار اولیه | سپتامبر 2025 | فوریه 2025 (انتشار عمومی: مه) |
| بررسی نسخه | `codex --version` ([انتشارها](https://github.com/openai/codex/releases)) | `claude --version` ([انتشارها](https://github.com/anthropics/claude-code/releases)) |
| نصب | `npm install -g @openai/codex` | `npm install -g @anthropic-ai/claude-code` |

### قابلیت‌های مدل و استدلال

| معیار | Codex CLI | Claude Code |
|-----------|-----------|-------------|
| مدل پیش‌فرض | GPT-5.6-terra (اولویت با کدنویسی) / GPT-5.5 | Claude Opus 5 / Sonnet 5 (4.8 / 4.6 هنوز به فروش می‌رسد) |
| پنجره زمینه | 1M توکن | 1M روی Fable 5.2، Opus 5.5 / 5 و Sonnet 5.5 / 5 (بر اساس نمای کلی مدل‌های Anthropic؛ 200K روی 4.5 و مدل‌های پیشین) |
| عمق استدلال | قوی، مناسب برای وظایف ساختاریافته | استثنایی، برتری آشکار در استدلال پیچیده و ارزیابی راه‌حل |
| کیفیت تولید کد | بالا، به‌ویژه در تولید مبتنی بر الگو خوب است | بسیار بالا، تأکید بیشتر بر کیفیت کد و بهترین شیوه‌ها |
| درک نیت | خوب، گاهی سوءتفسیر | عالی، به‌ندرت دستورالعمل‌ها را اشتباه می‌فهمد |
| پشتیبانی از زبان‌ها | عالی در زبان‌های جریان اصلی | عالی در زبان‌های جریان اصلی، برتری جزئی در Rust/Go |
| سرعت استنتاج | سریع، GPT-5.5 / 5.4 تأخیر کمتری دارند | متوسط، استدلال عمیق Opus زمان بیشتری می‌برد |

تا تاریخ 2026-11-12، جدیدترین مدل Claude، **Fable 5.2** (`claude-fable-5-2`، منتشرشده در 9 نوامبر 2026) است: پنجره زمینه 1M توکن، تا 128K توکن خروجی، و قیمت رسمی $8 به‌ازای هر یک میلیون توکن ورودی / $40 به‌ازای هر یک میلیون توکن خروجی با خواندن از کش $0.20؛ Fable 5.1 پیشین $10 / $50 با خواندن از کش $0.25 است. هر دو در `/models` مربوط به QCode در دسترس هستند؛ پس از اینکه Claude Code همان‌طور که در راهنمای نصب توضیح داده شده است به Base URL مربوط به QCode اشاره کند، با `/model claude-fable-5-2` تغییر دهید و برای بازگشت از `/model claude-fable-5-1` استفاده کنید. از Claude Code 2.1.321 (9 نوامبر 2026)، Fable 5.2 مدل پیش‌فرض Fable است و نام مستعار `fable` به آن نگاشت می‌شود.

### مدل اجرا و امنیت

| معیار | Codex CLI | Claude Code |
|-----------|-----------|-------------|
| سبک اجرا | عامل خودمختار (ابتدا اجرا، سپس بازبینی) | همکاری تعاملی (ابتدا گفتگو، سپس اجرا) |
| سازوکار سندباکس | سندباکس در سطح هسته (Landlock + seccomp) | مجوزهای سطح برنامه (Hooks + تأیید کاربر) |
| ایزوله‌سازی شبکه | شبکه به‌طور پیش‌فرض غیرفعال است (درون سندباکس) | شبکه به‌طور پیش‌فرض فعال است، رهگیری قابل‌تنظیم توسط کاربر |
| حفاظت از سیستم فایل | سندباکس دامنه قابل‌نوشتن را محدود می‌کند | متکی به تأیید کاربر + رهگیری Hook |
| حالت‌های مجوز | سه سطح `--sandbox`: read-only / workspace-write / danger-full-access (پیش‌تنظیم‌های قدیمی suggest / auto-edit / full-auto حذف شدند) | اجازه/رد برای هر اقدام، سطوح اعتماد قابل‌تنظیم |
| ممیزی امنیتی | متن‌باز، کاملاً قابل ممیزی | متن‌بسته، متکی به تعهدات امنیتی Anthropic |

### پیکربندی و توسعه‌پذیری

| معیار | Codex CLI | Claude Code |
|-----------|-----------|-------------|
| فایل پیکربندی پروژه | `AGENTS.md` | `CLAUDE.md` |
| سلسله‌مراتب پیکربندی | سراسری / مخزن / زیرپوشه (سه سطح) | سراسری / پروژه / زیرپوشه (سه سطح) |
| پروتکل توسعه | MCP (Model Context Protocol) | MCP (Model Context Protocol) |
| سیستم Hook | پشتیبانی می‌شود (رویدادمحور) | پشتیبانی بومی (شش نوع رویداد) |
| زیرعامل‌ها | Cloud Exec (موازی‌سازی چندعاملی مبتنی بر ابر) | Agent Teams (زیرعامل‌های محلی) |
| سیستم Skills | Skills داخلی | Slash Commands داخلی |
| یکپارچه‌سازی با IDE | افزونه VS Code | VS Code / JetBrains / Vim / Emacs |
| یکپارچه‌سازی با CI/CD | GitHub Actions بومی | GitHub Actions / حالت بدون رابط |

### جامعه و اکوسیستم

| معیار | Codex CLI | Claude Code |
|-----------|-----------|-------------|
| ستاره‌های GitHub | 30K+ (مزیت متن‌باز) | ناموجود (متن‌بسته) |
| فعالیت جامعه | بالا (مشارکت‌کنندگان متن‌باز زیاد) | بالا (جامعه کاربری فعال) |
| اکوسیستم افزونه | در حال رشد سریع | بالغ، اکوسیستم MCP غنی |
| کیفیت مستندات | عالی (متن‌باز + رسمی) | عالی (مستندات رسمی جامع) |
| پذیرش سازمانی | در حال رشد سریع | گسترده (Netflix/Spotify از مشتریان شاخص هستند) |

### قیمت‌گذاری

| معیار | Codex CLI (رسمی) | Claude Code (رسمی) |
|-----------|---------------------|------------------------|
| مدل صورت‌حساب | به‌ازای هر توکن | به‌ازای هر توکن / اشتراک Max |
| آستانه ورود | حساب کاربری OpenAI API | حساب کاربری Anthropic API / Max $100/mo |
| دسترسی از چین | نیازمند VPN + پرداخت بین‌المللی | نیازمند VPN + پرداخت بین‌المللی |
| از طریق QCode.cc | دسترسی مستقیم؛ گره‌های آسیا + آمریکا (لس‌آنجلس) | دسترسی مستقیم؛ گره‌های آسیا + آمریکا (لس‌آنجلس) |
| قیمت QCode.cc | تا 80% صرفه‌جویی | تا 80% صرفه‌جویی |

---
## توصیه‌های سناریو

هر ابزار بسته به وظیفه پیش‌رو، نقطه قوت ویژه خود را دارد:

### چه زمانی Claude Code را انتخاب کنید

#### 1. طراحی معماری و ارزیابی راهکار

توانایی‌های استدلال عمیق Claude Code به‌ویژه برای ارزیابی رویکردهای فنی قوی است:

```text
You: We need to break our monolith into microservices. The codebase is 150K lines,
    team of 8. Help me evaluate the migration strategy.

Claude Code will:
- Analyze the code structure and identify module boundaries
- Evaluate 3-4 decomposition strategies with pros/cons
- Factor in team size, deployment costs, and migration risks
- Propose a phased implementation plan
```

#### 2. بررسی باگ و بازبینی کد

گفت‌وگوی تعاملی اشکال‌زدایی را کارآمدتر می‌کند:

```text
You: Users are reporting getting randomly logged out. Investigate the cause.

Claude Code will:
- Analyze code related to the authentication flow
- Inspect session/token management logic
- Pinpoint the specific issue (e.g., race condition)
- Propose a fix and explain the root cause
```

#### 3. بازآرایی پیچیده و بهینه‌سازی کد

وقتی درک زمینه و سنجش بده‌بستان‌ها حیاتی است، مدل تعاملی Claude Code قابل‌اعتمادتر است:

```text
You: Migrate the project from Express.js to Fastify while keeping the API compatible

Claude Code will:
- First analyze the existing route structure and middleware
- Propose a migration plan, flagging key differences
- Execute step by step, confirming at each stage
- Handle edge cases (error handling, plugin replacements, etc.)
```

#### 4. یادگیری فناوری‌های جدید و درک کد

Claude Code در توضیح و آموزش سرآمد است:

```text
You: Explain the design philosophy behind this project's GraphQL schema
You: Why does this Rust lifetime annotation have to be written this way?
You: Help me understand how this distributed lock implementation works
```

### چه زمانی Codex را انتخاب کنید

#### 1. تولید دسته‌ای کد و اسکلت‌بندی

در وظایف دسته‌ای به‌خوبی تعریف‌شده، Codex می‌درخشد:

```bash
$ codex "Generate CRUD API endpoints and matching OpenAPI specs for all data models in src/models/"

# Codex autonomously completes in the sandbox:
# - Scans 12 model files
# - Generates 12 sets of CRUD endpoints
# - Generates corresponding OpenAPI specs
# - Validates generated code syntax
```

#### 2. خودکارسازی CI/CD و اسکریپت‌نویسی

محیط ایزوله Codex تناسب طبیعی با محیط‌های CI/CD دارد:

```bash
$ codex --sandbox workspace-write "Analyze the code changes in this PR, check for potential issues, and generate a review report"

# Great for GitHub Actions integration:
# - Sandbox isolation ensures safety
# - workspace-write sandbox needs no interactive approval
# - Standard output can be used directly as a PR comment
```

#### 3. تولید مورد آزمون

با مشخصات روشن، Codex می‌تواند به‌سرعت تعداد زیادی آزمون تولید کند:

```bash
$ codex "Generate unit tests for all exported functions in src/utils/, targeting > 90% coverage"
```

#### 4. مستندات و توضیحات کد

وظایف مستندسازی مبتنی بر الگو برای Codex ایده‌آل هستند:

```bash
$ codex "Add JSDoc comments to all public APIs, including parameter descriptions, return values, and usage examples"
```

---
## گردش‌کارهای ترکیبی

بیشترین ارزش از **استفاده هم‌زمان از هر دو ابزار** به دست می‌آید. در ادامه الگوهای گردش‌کاری آزموده‌شده در عمل آمده است:

### گردش‌کار 1: Claude برنامه‌ریزی می‌کند + Codex اجرا می‌کند

این الگوی ترکیبی کلاسیک است. از استدلال عمیق Claude Code برای طراحی راه‌حل استفاده کنید، سپس از Codex برای اجرای دسته‌ای کارآمد بهره بگیرید.

**سناریو: افزودن پشتیبانی i18n به یک پروژه**

```bash
# Step 1: Use Claude Code to devise the plan
$ claude
> I need to add i18n support to this React project. Analyze the best approach.

# Claude Code analyzes the project structure, recommends an approach
# (e.g., react-intl vs i18next), and provides a change list + implementation steps

# Step 2: Once the plan is confirmed, use Codex for batch execution
$ codex "Add i18n support following this plan:
  1. Install i18next + react-i18next
  2. Create locales/zh.json and locales/en.json
  3. Extract all hardcoded Chinese strings in src/components/ into i18n keys
  4. Set up i18n initialization and language switching"

# Codex autonomously completes all file changes in the sandbox
```

### گردش‌کار 2: Claude تست می‌نویسد + Codex اجرا و رفع اشکال می‌کند

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

```bash
# Step 1: Use Claude Code to write tests (requires understanding business logic)
$ claude
> Write integration tests for the payment module covering:
> successful payment, insufficient balance, concurrent payment, refund, timeout cancellation

# Claude Code understands the payment flow and writes targeted test cases

# Step 2: Use Codex to run tests and fix failures
$ codex --sandbox workspace-write "Run all tests under tests/payment/,
  fix any failing test cases, and ensure they all pass"
```

### گردش‌کار 3: تغییر ابزار در توسعه روزانه

در توسعه روزانه، بر اساس نوع وظیفه میان ابزارها جابه‌جا شوید:

```bash
# Encountered a complex problem -> switch to Claude Code for discussion
$ claude
> How should I fix this deadlock? Take a look at src/db/connection-pool.ts

# Once the approach is decided, batch changes -> switch to Codex
$ codex "Based on the connection pool redesign plan, update all database query functions to add timeout and retry mechanisms"

# Code review -> back to Claude Code
$ claude
> Review the code that Codex just changed for any issues
```

### گردش‌کار 4: بازآرایی بزرگ‌مقیاس هماهنگ

```bash
# Claude Code: Analyze dependencies, determine a safe refactoring order
$ claude
> I want to migrate the project from CommonJS to ESM. Analyze the dependency graph and give me a safe migration order.

# Codex: Execute module by module in order
$ codex "Convert all files under src/utils/ from CommonJS to ESM syntax"
$ codex "Convert all files under src/services/ from CommonJS to ESM syntax"
$ codex "Update package.json and build config for ESM"

# Claude Code: Verify the final result
$ claude
> Check if the ESM migration is complete. Are there any leftover require() calls?
```

---
## استفاده از هر دو از طریق QCode.cc

تمام جریان‌های کاری بالا فرض می‌کنند که به Claude Code و Codex دسترسی دارید. با QCode.cc این کار ساده است.

### یک پلن، دو ابزار

سهمیه‌های پلن QCode.cc بین Claude Code و Codex **مشترک** است. نیازی به اشتراک‌های جداگانه برای هر سرویس ندارید -- یک پلن هر دو را پوشش می‌دهد:

- درخواست‌های API مربوط به Claude Code از سهمیه پلن شما کسر می‌شود
- درخواست‌های API مربوط به Codex از همان سهمیه پلن کسر می‌شود
- مصرف یکپارچه را در [داشبورد](https://qcode.cc/dashboard) ببینید

### هزینه جابه‌جایی صفر

هر دو ابزار از همان کلید API واحد QCode.cc (که با `cr_` شروع می‌شود) استفاده می‌کنند و یک‌بار پیکربندی می‌شود:

```bash
# Claude Code configuration (~/.claude/.credentials.json)
# See: /docs/getting-started/installation

# Codex configuration (~/.codex/config.toml)
# See: /docs/getting-started/codex-quick-start
```

در طول کار هر زمان که بخواهید بین دو پنجره ترمینال جابه‌جا شوید -- نیازی به احراز هویت مجدد یا تعویض حساب کاربری نیست.

### گره‌های دسترسی آسیا-اقیانوسیه و آمریکا

QCode.cc نقاط پایانی بهینه‌شده‌ای برای منطقه آسیا-اقیانوسیه ارائه می‌دهد. کاربران سرزمین اصلی چین از `asia.qcode.cc` (گره آسیا، نزدیک‌ترین از میان کره / تایوان / هنگ‌کنگ) استفاده کنند؛ کاربران بین‌المللی از `api.qcode.cc` (Route 53 جهانی) استفاده می‌کنند و کاربران آمریکای شمالی / اروپا می‌توانند از `us.qcode.cc` (گره لس‌آنجلس) استفاده کنند. چه از Claude Code استفاده کنید و چه از Codex، توسعه‌دهندگان در چین تجربه‌ای پایدار و کم‌تأخیر دریافت می‌کنند:

- نیازی به VPN نیست
- نیازی به کارت اعتباری بین‌المللی نیست
- از Alipay / WeChat Pay پشتیبانی می‌کند

### مزیت هزینه

| مقایسه | پلن رسمی | QCode.cc |
|------------|-----------------|----------|
| Claude Code | از $100/mo (اشتراک Max) | از $20/mo |
| Codex | از $20/mo (OpenAI API) | سهمیه مشترک با Claude Code |
| هر دو با هم | $120+/mo | از $20/mo |
| روش پرداخت | کارت اعتباری بین‌المللی | Alipay / WeChat Pay |
| دسترسی از چین | نیازمند VPN | دسترسی مستقیم، بدون نیاز به پروکسی |

> برای جزئیات مشخص پلن‌ها [قیمت‌گذاری](https://qcode.cc/pricing) را ببینید.

---

## مقایسه تفصیلی ویژگی‌ها

### مدیریت زمینه

**Claude Code** روی Fable 5.2، Opus 5.5 / 5 و Sonnet 5.5 / 5 پنجره زمینه 1M توکنی دارد (نمای کلی مدل‌های Anthropic پنجره زمینه هر مدل را فهرست می‌کند: Opus 4.6 و نسخه‌های بعد از آن و همچنین Sonnet 4.6 نیز 1M هستند، در حالی که مدل‌های 4.5 و پیش‌تر 200K دارند). راهبرد مدیریت زمینه آن کاملاً هوشمندانه است:

- فایل‌های مرتبط را به‌طور خودکار به زمینه می‌آورد
- هنگامی که گفتگوها طولانی می‌شوند، محتوای قبلی را به‌طور خودکار فشرده می‌کند
- از ارجاع دقیق به فایل‌ها از طریق اشاره‌های `@` پشتیبانی می‌کند
- فرمان `/compact` برای فشرده‌سازی دستی زمینه

**Codex** به‌صورت پیش‌فرض از زمینه 1M توکنی GPT-5.5 / GPT-5.4 استفاده می‌کند. در حین اجرا در سندباکس:

- ساختار فایل‌های پروژه را به‌طور خودکار ایندکس می‌کند
- فایل‌های مرتبط را بر اساس نیاز وظیفه به‌صورت پویا بارگذاری می‌کند
- تمام خروجی اجرا در زمینه نگه داشته می‌شود
- زمینه بزرگ‌تر در هر نشست برای پروژه‌های بزرگ مناسب است

### سندباکس و امنیت

**سندباکس سطح هسته Codex** یکی از بزرگ‌ترین نقاط قوت فنی آن است:

- مبتنی بر Linux Landlock LSM + seccomp-bpf
- دسترسی به فایل‌سیستم و شبکه را در سطح سیستم‌عامل محدود می‌کند
- حتی اگر مدل «بخواهد» عملیات خطرناکی انجام دهد، هسته آن‌ها را مسدود می‌کند
- سه سطح مجوز برای کنترل انعطاف‌پذیر خودکارسازی

**امنیت سطح برنامه Claude Code** بیشتر بر تأیید تعاملی تکیه دارد:

- پیش از عملیات خطرناک، تأیید کاربر را درخواست می‌کند
- سیستم Hook امکان تعریف قواعد رهگیری سفارشی را می‌دهد
- جداسازی سطح هسته وجود ندارد -- مرز اعتماد در لایه برنامه است
- انعطاف‌پذیرتر است اما نیاز دارد کاربر هوشیار بماند

### زیرعامل‌ها و موازی‌سازی

**Agent Teams در Claude Code**:

- فرایندهای زیرعامل را به‌صورت محلی ایجاد می‌کند
- هر زیرعامل زمینه مستقل خود را دارد
- برای تقسیم وظایف بزرگ به زیروظیفه‌های مستقل بسیار مناسب است
- نتایج در گفتگوی اصلی تجمیع می‌شوند

**Cloud Exec در Codex**:

- چندین محیط اجرا را به‌صورت موازی در ابر راه‌اندازی می‌کند
- می‌تواند چندین وظیفه مستقل را هم‌زمان انجام دهد
- ایده‌آل برای عملیات دسته‌ای در مقیاس بزرگ
- هر محیط اجرا جداسازی کامل سندباکس دارد

### مقایسه فایل‌های پیکربندی

**CLAUDE.md** (Claude Code):

```markdown
# CLAUDE.md

## Project Standards
- Use TypeScript strict mode
- All functions must have JSDoc comments
- Test files go in __tests__ directories

## Code Style
- Use Prettier for formatting
- Import order: built-in -> third-party -> local
```

**AGENTS.md** (Codex):

```markdown
# AGENTS.md

- All code must be TypeScript with strict mode
- Use Prettier for formatting
- Tests go in __tests__ directories
- Run `npm test` before completing any task
```

> هر دو از قالب Markdown استفاده می‌کنند، اما قراردادها و جزئیات متفاوت است. برای اطلاعات بیشتر [راهنمای پیکربندی AGENTS.md](/docs/usage/agents-md) را ببینید.

---
## محدودیت‌های شناخته‌شده

به‌انصاف، هر دو ابزار کاستی‌هایی دارند:

### محدودیت‌های Claude Code

- **سرعت**: استدلال عمیق مدل Opus به زمان پاسخ بیشتری نیاز دارد؛ کارهای ساده می‌توانند «کند» به نظر برسند
- **منبع‌بسته**: راهی برای ممیزی کد وجود ندارد؛ باید به تعهدات امنیتی Anthropic اعتماد کنید
- **سطح خودکارسازی**: طراحی تعاملی یعنی بسیاری از کارها به تأیید دستی نیاز دارند و کارایی پردازش دسته‌ای کاهش می‌یابد
- **قیمت**: اشتراک رسمی Max از $100/mo شروع می‌شود که نقطه ورود بالایی است

### محدودیت‌های Codex

- **درک قصد**: دستورهای پیچیده یا مبهم گاهی اشتباه تفسیر می‌شوند؛ نتایج باید با دقت بازبینی شوند
- **تعامل‌پذیری**: حالت اجرای خودکار نقاط بازرسی میان‌کار ندارد -- اگر مسیر اشتباهی را در پیش بگیرد، فقط پس از وقوع می‌توانید آن را اصلاح کنید
- **محدودیت‌های محیط ایزوله**: محیط ایزوله پیش‌فرض با شبکه غیرفعال نمی‌تواند کارهای نیازمند دسترسی شبکه را انجام دهد
- **بلوغ**: به‌عنوان تازه‌وارد، اکوسیستم و غنای مستندات آن هنوز در حال رسیدن به رقبا است

---

## دیدگاه جامعه کاربری

بازخورد جامعه توسعه‌دهندگان را می‌توان چنین خلاصه کرد:

> «Claude Code هم‌بنیان‌گذار فنی شماست؛ Codex تیم اجرای شماست. اولی کمک می‌کند بفهمید چه کاری باید انجام دهید؛ دومی کمک می‌کند آن را به‌شکل کارآمد انجام دهید.»

> «وقتی AGENTS.md را می‌نویسم، اغلب برای ایده‌گرفتن به CLAUDE.md خودم مراجعه می‌کنم -- فلسفه‌های پیکربندی پروژه واقعاً بسیار شبیه‌اند.»

> «در طول یک ماه، حدود 60% وقت از Claude Code و 40% از Codex استفاده می‌کنم. اولی کارهایی را که نیاز به فکر کردن دارند انجام می‌دهد؛ دومی کارهای تکراری و طاقت‌فرسا را.»

---

## مقایسه تاریخچه نسخه‌ها

| دوره | Claude Code | Codex CLI |
|--------|-------------|-----------|
| سه‌ماهه اول 2025 | پیش‌نمایش عمومی منتشر شد | - |
| سه‌ماهه دوم 2025 | انتشار GA، حالت Plan | - |
| سه‌ماهه سوم 2025 | زیرعامل‌ها، پشتیبانی از MCP | انتشار اولیه v0.1، متن‌باز Apache 2.0 |
| سه‌ماهه چهارم 2025 | Opus 4.5، سیستم Hooks | Cloud Exec، GPT-5.1-Codex |
| سه‌ماهه اول 2026 | Opus 4.6 (1M)، Skills | GPT-5.4 (1M)، Skills، AGENTS.md |
| سه‌ماهه دوم 2026 | Opus 4.8/4.7، Dynamic Workflows، زیرعامل‌های تودرتو | Codex CLI به انتشار ادامه داد، GPT-5.5 |
| سه‌ماهه سوم 2026 | Opus 5 / Sonnet 5 / Fable 5.1، Adaptive Thinking | Codex CLI به انتشار ادامه داد، خانواده GPT-5.6 (terra / sol / luna / mini / nano) |

هر دو ابزار بسیار سریع تکرار می‌شوند و هر 1-2 هفته به‌روزرسانی‌های قابلیت‌ها را منتشر می‌کنند.

---

## راهنمای تصمیم‌گیری سریع

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

| وضعیت شما | انتخاب پیشنهادی |
|----------------|--------------------|
| عمدتاً طراحی معماری و تصمیم‌های فنی انجام می‌دهید | Claude Code |
| عمدتاً تولید دسته‌ای کد و کارهای تکراری انجام می‌دهید | Codex |
| همکاری تیمی با نیاز به بازبینی کد | Claude Code |
| یکپارچه‌سازی خودکارسازی CI/CD | Codex |
| یادگیری فناوری‌های جدید و فهم کد | Claude Code |
| مشارکت‌کننده متن‌باز که ممیزی‌پذیری کد برایش مهم است | Codex |
| به بهترین درک قصد نیاز دارید | Claude Code |
| به سریع‌ترین سرعت اجرا نیاز دارید | Codex |
| می‌خواهید هر دو را با بودجه محدود استفاده کنید | **QCode.cc** (یک پلن هر دو را پوشش می‌دهد) |

---

## خلاصه

Codex و Claude Code یک انتخاب «یا این یا آن» نیستند. پربازده‌ترین جریان کاری کدنویسی با هوش مصنوعی در 2026 این است:

1. **Claude Code به‌عنوان لایه راهبرد**: طراحی معماری، ارزیابی راهکار، بازبینی کد، بررسی باگ‌های پیچیده
2. **Codex به‌عنوان لایه اجرا**: تولید دسته‌ای، پوشش تست، مستندات، خودکارسازی CI/CD
3. **هر دو با هم**: Claude برنامه‌ریزی می‌کند + Codex اجرا می‌کند + Claude اعتبارسنجی می‌کند

با [QCode.cc](https://qcode.cc) می‌توانید هر دو ابزار را زیر یک پلن واحد استفاده کنید. سهمیه مشترک یعنی نیازی به مدیریت دو اشتراک جداگانه نیست -- کافی است بین دو پنجره ترمینال جابه‌جا شوید و از ابزاری که برای کار پیش رو مناسب‌تر است استفاده کنید.

**مسئله انتخاب A یا B نیست -- A + B با هم = بهترین تجربه توسعه.**

---

## گام‌های بعدی

- [شروع سریع Codex](/docs/getting-started/codex-quick-start) -- راه‌اندازی Codex در 5 دقیقه
- [راهنمای پیکربندی AGENTS.md](/docs/usage/agents-md) -- سفارشی‌سازی رفتار پروژه Codex
- [شروع سریع Claude Code](/docs/getting-started/quick-start) -- کاربردهای اصلی Claude Code
- [پیکربندی یکپارچه‌سازی Codex](/docs/ide/codex) -- آموزش مفصل راه‌اندازی Codex
- [پلن‌ها و قیمت‌گذاری](https://qcode.cc/pricing) -- مشاهده پلن‌های مشترک QCode.cc