Ücretsiz GPT-5 Kullanımı: Cursor CLI ile Nasıl Yapılır?

GPT-5 gibi gelişmiş yapay zeka modellerinin geliştirme iş akışlarına entegrasyonu, geliştiriciler için üretkenlikte önemli bir ilerleme sağlamaktadır. Cursor CLI'ın yakın zamanda piyasaya sürülmesiyle, kullanıcılar artık en son yapay zekadan yararlanan güçlü komut satırı araçlarına erişebiliyor.

Bu kılavuz, API tasarımları ve sunucu kodu oluşturmak için GPT-5'i Cursor CLI aracılığıyla kullanmaya, ardından bu yapıtları Apidog ile içe aktarmaya ve doğrulamaya yönelik teknik, adım adım bir rehber sunmaktadır. Tam komutlar, pratik istem örnekleri, CI için otomasyon kalıpları ve sağlamlaştırma ipuçları edineceksiniz. Mümkün olan her yerde, her adımı yeniden oluşturabilmeniz için resmi belgelere ve örneklere bağlantı veriyorum.

Cursor CLI ve GPT-5 Entegrasyonunu Anlamak

The Cursor CLI, yapay zeka destekli geliştirmede yeni bir sınırı temsil ederek Cursor platformunun yeteneklerini doğrudan terminalinize getiriyor. Erken beta olarak piyasaya sürülen bu araç, komut satırı arayüzünüz (CLI) ile düzenleyiciniz arasında sorunsuz etkileşim sağlayarak, OpenAI'dan yeni tanıtılan GPT-5 dahil olmak üzere birden fazla yapay zeka modelini desteklemektedir. Gelişmiş muhakeme ve kodlama yetenekleriyle bilinen GPT-5, karmaşık görevleri önceki sürümlerine göre daha yüksek hassasiyetle yerine getirme vaadi sunuyor.

GPT-5'in entegrasyonu Cursor CLI'a, geliştiricilerin doğrudan terminalden komutları yürütmesine, iş akışlarını otomatikleştirmesine ve kod oluşturmasına olanak tanır. X gönderisi görüntülerinde gösterildiği gibi arayüz, API'lerden çizim yükleme, oynatmayı tetikleme ve değişiklik özetlerini çıktı olarak verme gibi seçenekleri içerirken, komut yürütmesini GPT-5 desteklemektedir. Bu kurulum, geliştiricilerin modelleri değiştirebileceği ve görevleri verimli bir şekilde yönetebileceği esnek bir ortam sunar.

Cursor CLI'ı Kurun ve Doğrulayın

Adım 1 — Kurulum (tek satır):

curl https://cursor.com/install -fsS | bash

Bu, Cursor tarafından CLI için belgelenmiş resmi kurulum satırıdır. Bundan sonra, CLI komutları kullanılabilir hale gelir (örneğin, cursor-agent). (Cursor, Cursor)

Adım 2 — Kurulumu ve sürümü doğrulayın:

cursor-agent --version
cursor-agent status

CLI, --version ve status komutlarını destekler (ikincisi kimlik doğrulama durumunu ve uç nokta yapılandırmasını gösterir). (Cursor)

Adım 3 — Kimlik Doğrulama (iki seçenek)

Tarayıcı akışı (geliştirme makineleri için önerilir):

cursor-agent login
# This opens your browser and completes auth.
cursor-agent status

API anahtarı (betikler / CI için önerilir):

Cursor kontrol panelinizde bir API anahtarı oluşturun.

Dışa aktarın:

export CURSOR_API_KEY="sk_XXXX..."
# or pass it inline for single commands:
cursor-agent --api-key sk_XXXX... "refactor the auth module"

CLI, etkileşimli olmayan otomasyon için --api-key veya CURSOR_API_KEY ortam değişkenini kabul eder.

Güvenlik notu: Cursor Agent, kabuk komutlarını okuyabilir, değiştirebilir ve çalıştırabilir — yalnızca güvenilir bağlamlarda veya güvenli CI çalıştırıcılarında çalıştırın. CLI belgeleri, gelişen güvenlik önlemlerini açıkça belirtmektedir.

GPT-5 erişimini ve model bayraklarını onaylayın

Cursor CLI, modelleri seçmek için -m, --model bayrağını sunar. Örnek modeller arasında sonnet-4, sonnet-4-thinking ve gpt-5 bulunur. Ayrıca etkileşimli oturumlar içinde /model eğik çizgi komutu aracılığıyla modelleri değiştirebilirsiniz. Betikler için -m bayrağını kullanın.

Hızlı kontrol (modelleri etkileşimli olarak listeleme):

CLI'ı başlatın, ardından /model kullanın:

cursor-agent
# inside session, type:
/model
# or use:
cursor-agent -m gpt-5 "print available models and confirm access"

Ayrıca şunu da unutmayın: Cursor, GPT-5'in Cursor içinde kullanılabilirliğini duyurdu; gpt-5'in listelendiğini görmeyi bekleyin.

Somut bir kullanım durumu: GPT-5 ile bir OpenAPI 3.0 belirtimi oluşturma (adım adım)

GPT-5'ten (Cursor CLI aracılığıyla) basit bir ödeme API'si için bir OpenAPI YAML dosyası oluşturmasını isteyeceğiz. Daha sonra bu dosyayı Apidog'a aktaracak ve testleri çalıştıracağız.

Adım 3.1 — Katı bir istem yazın (biçim kontrolü önemlidir)

Makine tarafından okunabilir yapıtlar oluştururken, modele **yalnızca dosya içeriğini çıktı olarak vermesini** (işaretleme çitleri yok, yorum yok) söyleyin. Şemaları ve tutarlı adlandırmayı zorlamak için az sayıda örnek kullanın. OpenAI Cookbook ve Cursor belgeleri, istenmeyen sarmalayıcı metinlerden kaçınmak için katı sistem istemleri ve yanıt biçimlendirmesi önermektedir. (OpenAI Cookbook, Cursor)

Örnek istem (kısa ve açık):

openapi.yamlAuthorizationPOST /paymentsapplication/json201GET /payments/{paymentId}200404PUT /payments/{paymentId}200DELETE /payments/{paymentId}204PaymentRequestPaymentResponseErrorUSDamountcomponents.securitySchemes

Adım 3.2 — Cursor CLI'ı etkileşimli olmayan bir şekilde çağırın ve YAML'ı yakalayın

GPT-5'i seçmek için -m gpt-5 ve yanıtları yazdırmak için -p (etkileşimli olmayan) kullanın. Standart çıktıyı openapi.yaml'ye yönlendirin.

# Set your API key in CI or locally:
export CURSOR_API_KEY="sk_..."

# Non-interactive generation with model selection and print mode
cursor-agent -m gpt-5 -p "Generate OpenAPI 3.0.3 YAML for a Payments API (see prompt above)" > openapi.yaml

Açıklama: -m gpt-5, GPT-5 kullanımını zorlar. -p, model yanıtını yazdırır ve daha sonra kullanmak üzere bir dosyaya yönlendirirsiniz. Cursor CLI, betikleme için --output-format ve -p'yi destekler. (Cursor)

Model yanlışlıkla sarmalayıcı metin içeriyorsa, daha katı bir ifadeyle yeniden çalıştırın: Yalnızca YAML ile yanıt verin, 'openapi:' ile başlayarak — bu, gereksiz çıktıları azaltır.

Oluşturulan YAML'ı yerel olarak doğrulayın (hızlı sağlamlık kontrolleri)

Yüklemeden veya içe aktarmadan önce:

YAML lint:

npm i -g yaml-cli # optional
yaml validate openapi.yaml

OpenAPI linter (Speccy / Spectral):

npm install -g @stoplight/spectral
spectral lint openapi.yaml

Bildirilen şema sorunlarını düzeltin (GPT'ler bazen type: integer yerine format: int64'ü yanlış kullanır, required'ı atlar veya components'i yanlış yere koyar). Bunlar hızlı manuel düzenlemelerdir.

OpenAPI belirtimini Apidog'a aktarın (iki seçenek)

Apidog, programatik iş akışları için UI aracılığıyla **manuel içe aktarmayı** veya **API içe aktarmayı** (POST /v1/projects/{projectId}/import-openapi) destekler. İşlem hattınıza uygun yaklaşımı seçin. (docs.apidog.com, openapi.apidog.io)

Seçenek A — Manuel UI içe aktarma (hızlı, ilk yineleme için önerilir)

Apidog'u açın → Proje Oluştur → Proje Ayarları → Veri İçe Aktar → OpenAPI.

JSON veya YAML dosyalarınızı aşağıdaki alana sürükleyip bırakabilir veya sisteminizin dosya yöneticisinden istediğiniz dosyayı seçmek için alana tıklayabilirsiniz.

URL içe aktarmayı kullanırken, lütfen Swagger UI'ın Temel URL'sini değil, JSON veya YAML veri dosyasının doğrudan URL'sini sağlayın.

İçe Aktar - Gelişmiş Ayarlar

Seçenek B — Programatik içe aktarma (CI / otomasyon)

openapi.yaml dosyasını sabit bir URL'de (S3, ham GitHub) barındırıyorsanız, OpenAPI içe aktarma uç noktasını çağırın:

# Example: import via Apidog API (requires APIDOG_ACCESS_TOKEN and projectId)
curl --location -g --request POST "https://api.apidog.com/v1/projects/${APIDOG_PROJECT_ID}/import-openapi?locale=en-US" \
  --header "Authorization: Bearer ${APIDOG_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "input": {"url": "https://my-bucket.s3.amazonaws.com/openapi.yaml"},
    "options": {
      "targetEndpointFolderId": 0,
      "endpointOverwriteBehavior": "OVERWRITE_EXISTING"
    }
  }'

Yanıt, oluşturulan/güncellenen uç noktalar ve şemalar için sayaçlar verir — bunu CI'da başarıyı doğrulamak için kullanın. API belgesi bu POST uç noktasını ve örneği içerir.

Apidog'da testler oluşturun veya uç nokta durumlarını içe aktarın (hızlı kılavuz)

OpenAPI belirtimi Apidog'da olduğunda:

İstek şablonlarını ve örnek gövdelerini otomatik olarak oluşturmak için Apidog'un UI'ını kullanın.

Bir **Ortam** yapılandırın (hazırlık temel URL'si + API belirteci ortam değişkeni).

Bir **Test Senaryosu** oluşturun: standart yaşam döngüsü testlerini (oluştur → oku → güncelle → sil) sıralayın. Apidog, Testler modülü aracılığıyla test senaryosu oluşturmayı ve otomatik onaylamaları destekler. (docs.apidog.com)

Test oluşturmayı otomatikleştirmeyi tercih ederseniz, test senaryolarını programatik olarak oluşturmak için Appdog API çağrılarını betikleyebilirsiniz (Apidog, kendi API'sine bir OpenAPI sunar). Uç noktalar için Apidog API belgelerine bakın. (openapi.apidog.io)

Apidog CLI'ı kurun ve testleri yerel olarak veya CI'da çalıştırın

Global olarak kurun:

# Node.js (v16+) required
npm install -g apidog-cli
# verify
node -v && apidog -v

Apidog CLI, dışa aktarılan test senaryolarını kullanarak **çevrimiçi** (erişim belirteci ile) veya **yerel/çevrimdışı** çalışabilir. Çevrimiçi çalıştırmalar için, Apidog Erişim Belirtecinizle birlikte --access-token'ı geçirin.

Kaydedilmiş bir test senaryosunu çalıştırın (çevrimiçi):

export APIDOG_ACCESS_TOKEN="sk_apidog_..."
apidog run --access-token $APIDOG_ACCESS_TOKEN -t <TEST_ID> -e <ENV_ID> -r html,cli

Yerel olarak çalıştırın (dışa aktarılan test senaryolarından):

apidog run ./exported-scenarios/payment-tests.json --report cli

Apidog CLI, CI işlem hatlarına sorunsuz bir şekilde entegre olur ve test çalıştırmaları için CLI/HTML raporları üretir.

Uçtan uca otomasyon örneği: GPT-5 ile belirtim oluşturma, Apidog'a aktarma, testleri çalıştırma (GitHub Actions)

Aşağıda, kalıbı gösteren minimal bir GitHub Actions iş akışı bulunmaktadır.

name: GPT5 → Apidog CI

on: [push]

jobs:
  generate-and-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Node.js and Apidog CLI
        uses: actions/setup-node@v4
        with:
          node-version: '18'
      - run: npm install -g apidog-cli

      - name: Install Cursor CLI
        run: curl https://cursor.com/install -fsS | bash

      - name: Generate OpenAPI via Cursor (headless)
        env:
          CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
        run: |
          cursor-agent -m gpt-5 -p "Generate OpenAPI 3.0.3 YAML for a Payments API. Only return raw YAML." > openapi.yaml
          # Basic validation
          npx @stoplight/spectral lint openapi.yaml || true

      - name: Upload openapi.yaml to S3 (or GitHub Raw)
        run: |
          # upload steps here -- depends on your infra
          echo "Upload to bucket and set OPENAPI_URL"

      - name: Import to Apidog via API
        env:
          APIDOG_ACCESS_TOKEN: ${{ secrets.APIDOG_ACCESS_TOKEN }}
          APIDOG_PROJECT_ID: ${{ secrets.APIDOG_PROJECT_ID }}
        run: |
          curl -s -X POST "https://api.apidog.com/v1/projects/${APIDOG_PROJECT_ID}/import-openapi?locale=en-US" \
            -H "Authorization: Bearer ${APIDOG_ACCESS_TOKEN}" \
            -H "Content-Type: application/json" \
            --data-raw "{\"input\":{\"url\":\"${{ env.OPENAPI_URL }}\"},\"options\":{}}"

      - name: Run Apidog tests
        env:
          APIDOG_ACCESS_TOKEN: ${{ secrets.APIDOG_ACCESS_TOKEN }}
        run: |
          apidog run --access-token $APIDOG_ACCESS_TOKEN -t 637132 -e 358171 -r cli

Notlar:

S3 / yükleme adımlarını yapıt barındırmanızla değiştirin.

CURSOR_API_KEY, APIDOG_ACCESS_TOKEN ve APIDOG_PROJECT_ID sırlarını depo sırlarında saklayın.

Oluşturulan belirtimi üretime dağıtmadan önce onaylayın ve inceleyin.

Apidog ve Cursor, başsız/CI kullanımını destekler: Cursor'ın CLI'ı, ortamlar arasında başsız aracı kullanımını açıkça destekler ve Apidog CLI, CI entegrasyonu için oluşturulmuştur.

Gelişmiş: aracının kodu düzenlemesini, testleri yerel olarak çalıştırmasını ve yamaları işlemesini sağlayın

Cursor'ın aracısı dosyaları düzenleyebilir ve kabuk komutlarını çalıştırabilir (onaylara tabidir). Bu yetenek size şunları sağlar:

GPT-5'ten sunucu kodunu (Express/Flask/FastAPI) iskelelemesini isteyin.

Terminaldeki farkları inceleyin.

Uygulamayı kabul edin, npm test'i çalıştırın ve değişiklikleri otomatik olarak işleyin.

Örnek sıra (yerel geliştirme):

# generate code + apply
cursor-agent -m gpt-5 "Create an Express v4 route at src/routes/payments.js with handlers for POST/GET/PUT/DELETE and unit tests (jest). Run tests after applying."
# Cursor CLI will propose edits; review and allow or deny specific shell commands.

Belgeler, Aracının araç setini (dosya işlemleri, arama, kabuk komutlarını çalıştırma) açıklar ve inceleme kontrol noktalarını ve teslim iş akışlarını vurgular. Otomatik düzenlemeler üzerinde kontrolü sürdürmek için bunları kullanın.

Yaygın hata modlarında hata ayıklama

GPT geçersiz YAML üretti — "yalnızca YAML" istemiyle yeniden çalıştırın veya öndeki satırları kaldırmak için sed/yq ile son işlem yapın.

Apidog içe aktarma eksik alanlar bildiriyor — components ve operationId'leri inceleyin; Apidog, uç nokta adları için summary, operationId ve path'i tercihli olarak eşler. Bunları belirtimde düzeltin, ardından yeniden içe aktarın.

Apidog CLI değişkenler veya dosya yolları nedeniyle başarısız oluyor — CLI çalıştırmalarında dosya yüklemeleri için mutlak yollar kullanın ve ortam değişkenlerinin ayarlandığını doğrulayın. Apidog belgeleri, yaygın dosya yolu sorunlarını ve CLI çalıştırmalarının nasıl yapılandırılacağını açıklar.

Güvenlik ve Yönetişim (çok önemli)

Aracıyı asla yükseltilmiş kimlik bilgileriyle güvenilmeyen kod üzerinde çalıştırmayın. Cursor, CLI'ın kabuk komutlarını çalıştırabileceği ve dosyaları değiştirebileceği konusunda uyarıyor; üretim sırlarını dikkatlice koruyun.

Sırlar yönetimi: API anahtarlarını ve ortam sırlarını CI sır deposunuzda saklayın. Belirteçleri belirtimlere gömmek yerine Apidog Vault / ortam değişkenlerini kullanın. Apidog, kasa entegrasyonlarını (HashiCorp, Azure Key Vault) destekler.

Aracı değişikliklerini manuel olarak onaylayın; aracı dosya sistemi veya kabuk işlemleri önerdiğinde; üretim dağıtımları için CI'da en az bir insan onayı adımı gerektirin.

Örnek: kopyalayabileceğiniz kesin istemler

OpenAPI YAML Oluştur (kısa):

cursor-agent -m gpt-5 -p "Output ONLY a valid OpenAPI 3.0.3 YAML for a 'payments' API with POST /payments, GET/PUT/DELETE /payments/{paymentId}. Use components.schemas PaymentRequest and PaymentResponse. Add examples. Do not include any markdown fences or commentary."

Cursor'ın bir Express işleyici ve testler yazmasını sağlayın:

cursor-agent -m gpt-5 -p "Create Express route handlers in src/routes/payments.js with corresponding unit tests in tests/payments.test.js. Implement basic in-memory store. Provide package.json scripts to run tests. Only output a JSON patch showing file names and full contents in JSON format."

Mevcut bir README açıklamasını bir OpenAPI belirtimine dönüştürün:

cursor-agent -m gpt-5 -p "Convert the following README API description into an OpenAPI 3.0.3 YAML. Output only YAML. [paste README paragraphs]"

Neden GPT-5 + Cursor CLI + Apidog eşleştirmesi?

Cursor CLI, GPT-5'i terminale getirir ve etkileşimli olmayan otomasyonu, dosya işlemlerini ve başsız CI kullanımını destekler. Bu, makine tarafından oluşturulan yapıtları doğrudan deponuzda istediğinizde sürtünmeyi azaltır.

GPT-5, kod ve şema oluşturma için daha yüksek doğruluk ve muhakeme sağlar (Cursor, ürün içinde GPT-5 desteği eklemiştir).

Apidog döngüyü tamamlar: ortaya çıkan OpenAPI belirtimini içe aktarın, sahte sunucular oluşturun, temel ve entegrasyon testlerini çalıştırın ve raporları dışa aktarın — sağlam bir geliştirme/test geri bildirim döngüsü sağlar.

Sonuç

Bu iş akışı size pratik bir kalıp sunar: **oluştur** (Cursor CLI aracılığıyla GPT-5) → **içe aktar/incele** (Apidog) → **taklit et ve test et** (Apidog CLI/UI). Prototiplemeyi hızlandırır ve doğrulama (Spectral, birim testleri) ile birleştiğinde fikirden entegrasyona güvenle geçebilirsiniz. Ölçeklendikçe, daha katı koruma önlemleri ekleyin: şema doğrulama kapıları, oluşturulan kod üzerinde manuel onaylar ve sürekli test paketleri.