Blog

Hướng Dẫn Sử Dụng GPT-5 Miễn Phí với Cursor CLI

Ashley Innocent

Ashley Innocent

8 tháng 8 2025

Hướng Dẫn Sử Dụng GPT-5 Miễn Phí với Cursor CLI

Apidog cho doanh nghiệp

Triển khai tại chỗ

SSO & RBAC

Tuân thủ SOC 2

Khám phá Apidog Enterprise

Việc tích hợp các mô hình AI tiên tiến như GPT-5 vào quy trình phát triển đánh dấu một bước tiến đáng kể trong năng suất cho các nhà phát triển. Với việc phát hành gần đây của Cursor CLI, người dùng giờ đây có quyền truy cập vào các công cụ dòng lệnh mạnh mẽ tận dụng AI tiên tiến.

💡
Trước khi bắt đầu, hãy tải xuống Apidog (miễn phí) để quản lý, tạo mock và kiểm thử các tạo phẩm API bạn sẽ tạo bằng GPT-5 + Cursor CLI. Apidog tăng tốc việc nhập thông số kỹ thuật OpenAPI, máy chủ mock và chạy kiểm thử tự động — hoàn hảo cho quy trình làm việc dưới đây. 
tải ứng dụng

Hướng dẫn này cung cấp một hướng dẫn kỹ thuật, từng bước để sử dụng GPT-5 thông qua Cursor CLI để tạo thiết kế API và mã máy chủ, sau đó nhập và xác thực các tạo phẩm đó bằng Apidog. Bạn sẽ nhận được các lệnh chính xác, ví dụ về lời nhắc thực tế, các mẫu tự động hóa cho CI và các mẹo tăng cường bảo mật. Bất cứ khi nào có thể, tôi đều liên kết đến tài liệu và ví dụ chính thức để bạn có thể tái tạo mọi bước.

Tìm hiểu về Cursor CLI và Tích hợp GPT-5

Cursor CLI đại diện cho một biên giới mới trong phát triển được hỗ trợ bởi AI, mang khả năng của nền tảng Cursor trực tiếp đến thiết bị đầu cuối của bạn. Được ra mắt dưới dạng bản beta sớm, nó cho phép tương tác liền mạch giữa giao diện dòng lệnh (CLI) và trình chỉnh sửa của bạn, hỗ trợ nhiều mô hình AI, bao gồm GPT-5 mới được giới thiệu từ OpenAI. GPT-5, nổi tiếng với khả năng suy luận và mã hóa nâng cao, hứa hẹn sẽ xử lý các tác vụ phức tạp với độ chính xác cao hơn so với các phiên bản tiền nhiệm.

Việc tích hợp GPT-5 vào Cursor CLI cho phép các nhà phát triển thực thi lệnh, tự động hóa quy trình làm việc và tạo mã trực tiếp từ thiết bị đầu cuối. Giao diện, như được hiển thị trong các hình ảnh bài đăng trên X, bao gồm các tùy chọn như tải tác phẩm nghệ thuật từ API, kích hoạt phát lại và xuất tóm tắt thay đổi, với GPT-5 cung cấp năng lượng cho việc thực thi lệnh. Thiết lập này cung cấp một môi trường linh hoạt nơi các nhà phát triển có thể chuyển đổi mô hình và quản lý các tác vụ một cách hiệu quả.

Cài đặt và xác minh Cursor CLI

Bước 1 — cài đặt (một dòng):

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

Đây là dòng cài đặt chính thức được Cursor tài liệu hóa cho CLI. Sau đó, các lệnh CLI sẽ có sẵn (ví dụ: cursor-agent). (Cursor, Cursor)

Bước 2 — xác minh cài đặt và phiên bản:

cursor-agent --version
cursor-agent status

CLI hỗ trợ các lệnh --version và status (lệnh sau hiển thị trạng thái xác thực và cấu hình điểm cuối). (Cursor)

Bước 3 — xác thực (hai tùy chọn)

Luồng trình duyệt (khuyến nghị cho máy phát triển):

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

Khóa API (khuyến nghị cho script / CI):

Tạo một khóa API trong bảng điều khiển Cursor của bạn.

Xuất 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 chấp nhận --api-key hoặc biến môi trường CURSOR_API_KEY cho tự động hóa không tương tác.

Lưu ý an toàn: Cursor Agent có thể đọc, sửa đổi và chạy các lệnh shell — chỉ chạy nó trong các ngữ cảnh đáng tin cậy hoặc các trình chạy CI an toàn. Tài liệu CLI nêu rõ các biện pháp bảo vệ an ninh đang phát triển.

Xác nhận quyền truy cập GPT-5 và các cờ mô hình

Cursor CLI hiển thị cờ -m, --model để chọn mô hình. Các mô hình ví dụ bao gồm sonnet-4, sonnet-4-thinking và gpt-5. Bạn cũng có thể chuyển đổi mô hình trong các phiên tương tác thông qua lệnh gạch chéo /model. Sử dụng cờ -m cho các script.

Kiểm tra nhanh (liệt kê các mô hình tương tác):

Bắt đầu CLI, sau đó sử dụng /model:

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

Cũng lưu ý: Cursor đã công bố khả năng có sẵn GPT-5 bên trong Cursor; hãy mong đợi thấy gpt-5 được liệt kê.

Một trường hợp sử dụng cụ thể: tạo một thông số kỹ thuật OpenAPI 3.0 với GPT-5 (từng bước)

Chúng ta sẽ yêu cầu GPT-5 (thông qua Cursor CLI) tạo một tệp OpenAPI YAML cho một API thanh toán đơn giản. Sau đó, chúng ta sẽ nhập tệp đó vào Apidog và chạy các kiểm thử.

Bước 3.1 — soạn một lời nhắc nghiêm ngặt (kiểm soát định dạng là quan trọng)

Khi tạo các tạo phẩm có thể đọc được bằng máy, hãy hướng dẫn mô hình chỉ xuất nội dung tệp (không có dấu markdown, không có chú thích). Sử dụng các ví dụ few-shot để buộc các schema và đặt tên nhất quán. Sách nấu ăn OpenAI và tài liệu Cursor khuyến nghị các lời nhắc hệ thống nghiêm ngặt và định dạng phản hồi để tránh văn bản bao bọc không mong muốn. (OpenAI Cookbook, Cursor)

Ví dụ lời nhắc (ngắn gọn và rõ ràng):

OpenAPI 3.0.3openapi.yaml

Bảo mật: Mã thông báo Bearer Authorization (HTTP bearer)

Điểm cuối:

POST /payments — tạo thanh toán; nội dung yêu cầu application/json; phản hồi 201

GET /payments/{paymentId} — lấy thanh toán theo ID; phản hồi 200 hoặc 404

PUT /payments/{paymentId} — cập nhật siêu dữ liệu; phản hồi 200

DELETE /payments/{paymentId} — hủy; phản hồi 204

Các thành phần/schema cho PaymentRequest, PaymentResponse và một schema Error

Các nội dung ví dụ cho yêu cầu và phản hồi

Sử dụng USD và bao gồm amount dưới dạng số nguyên cent

components.securitySchemes

Bước 3.2 — gọi Cursor CLI không tương tác và thu thập YAML

Sử dụng -m gpt-5 để chọn GPT-5 và -p để in phản hồi (không tương tác). Chuyển hướng stdout đến openapi.yaml.

# 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

Giải thích:

Nếu mô hình vô tình bao gồm văn bản bao bọc, hãy chạy lại với từ ngữ nghiêm ngặt hơn: Chỉ phản hồi bằng YAML, bắt đầu bằng 'openapi:' — điều này giúp giảm rác.

Xác thực YAML đã tạo cục bộ (kiểm tra nhanh)

Trước khi bạn tải lên hoặc nhập:

Kiểm tra cú pháp YAML (YAML lint):

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

Công cụ kiểm tra cú pháp OpenAPI (OpenAPI linter) (Speccy / Spectral):

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

Khắc phục mọi vấn đề về schema được báo cáo (GPT đôi khi sử dụng sai type: integer so với format: int64, bỏ qua required, hoặc đặt sai vị trí components). Đây là những chỉnh sửa thủ công nhanh chóng.

Nhập thông số kỹ thuật OpenAPI vào Apidog (hai tùy chọn)

Apidog hỗ trợ nhập thủ công qua giao diện người dùng hoặc nhập qua API (POST /v1/projects/{projectId}/import-openapi) cho các quy trình làm việc có lập trình. Chọn phương pháp phù hợp với quy trình của bạn. (docs.apidog.com, openapi.apidog.io)

Tùy chọn A — Nhập thủ công qua giao diện người dùng (nhanh, khuyến nghị cho lần lặp đầu tiên)

Mở Apidog → Tạo Dự án → Cài đặt Dự án → Nhập Dữ liệu → OpenAPI.

Bạn có thể kéo và thả các tệp JSON hoặc YAML của mình vào khu vực hiển thị bên dưới, hoặc chỉ cần nhấp vào khu vực đó để duyệt và chọn tệp mong muốn từ trình quản lý tệp của hệ thống.

manual-import-openapi-specification-upload.png

Khi sử dụng nhập qua URL, vui lòng cung cấp URL trực tiếp đến tệp dữ liệu JSON hoặc YAML, không phải URL cơ sở của Swagger UI.

swagger
manual-import-openapi-specification-url.png

Nhập - Cài đặt Nâng cao

Tùy chọn B — Nhập có lập trình (CI / tự động hóa)

Nếu bạn lưu trữ openapi.yaml tại một URL ổn định (S3, raw GitHub), hãy gọi điểm cuối nhập OpenAPI:

# 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"
    }
  }'

Phản hồi cung cấp bộ đếm cho các điểm cuối và schema đã tạo/cập nhật — sử dụng điều đó để khẳng định thành công trong CI. Tài liệu API bao gồm điểm cuối POST này và ví dụ.

Tạo kiểm thử trong Apidog hoặc nhập các trường hợp điểm cuối (hướng dẫn nhanh)

Khi thông số kỹ thuật OpenAPI đã có trong Apidog:

Nếu bạn muốn tự động hóa việc tạo kiểm thử, bạn có thể tạo script các lệnh gọi API của Appdog để tạo các kịch bản kiểm thử một cách có lập trình (Apidog cung cấp một OpenAPI cho API của chính nó). Xem tài liệu API của Apidog để biết các điểm cuối. (openapi.apidog.io)

Cài đặt Apidog CLI và chạy kiểm thử cục bộ hoặc trong CI

Cài đặt toàn cục:

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

Apidog CLI có thể chạy trực tuyến (với mã thông báo truy cập) hoặc cục bộ/ngoại tuyến bằng cách sử dụng các kịch bản kiểm thử đã xuất. Đối với các lần chạy trực tuyến, hãy truyền --access-token với Mã thông báo truy cập Apidog của bạn.

Chạy một kịch bản kiểm thử đã lưu (trực tuyến):

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

Chạy cục bộ (từ các kịch bản kiểm thử đã xuất):

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

Apidog CLI tích hợp mượt mà vào các quy trình CI và tạo báo cáo CLI/HTML cho các lần chạy kiểm thử.

Ví dụ tự động hóa đầu cuối: tạo thông số kỹ thuật với GPT-5, nhập vào Apidog, chạy kiểm thử (GitHub Actions)

Dưới đây là một quy trình làm việc GitHub Actions tối thiểu minh họa mẫu.

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

Lưu ý:

Nâng cao: làm cho tác nhân chỉnh sửa mã, chạy kiểm thử cục bộ và commit các bản vá

Tác nhân của Cursor có thể chỉnh sửa tệp và chạy các lệnh shell (tùy thuộc vào sự chấp thuận). Khả năng này cho phép bạn:

Chuỗi ví dụ (phát triển cục bộ):

# 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.

Tài liệu mô tả bộ công cụ của Agent (thao tác tệp, tìm kiếm, chạy lệnh shell) và nhấn mạnh các điểm kiểm tra xem xét và quy trình làm việc check-in. Sử dụng chúng để duy trì quyền kiểm soát đối với các chỉnh sửa tự động.

Gỡ lỗi các chế độ lỗi phổ biến

Bảo mật & quản trị (rất quan trọng)

Ví dụ: các lời nhắc chính xác bạn có thể sao chép

Tạo OpenAPI YAML (ngắn gọn):

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."

Yêu cầu Cursor viết một bộ xử lý Express và các kiểm thử:

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."

Chuyển đổi mô tả API README hiện có thành thông số kỹ thuật OpenAPI:

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]"

Tại sao nên kết hợp GPT-5 + Cursor CLI + Apidog?

Kết luận

Quy trình làm việc này cung cấp cho bạn một mẫu thực tế: tạo (GPT-5 qua Cursor CLI) → nhập/kiểm tra (Apidog) → tạo mock & kiểm thử (Apidog CLI/UI). Nó tăng tốc quá trình tạo mẫu, và kết hợp với xác thực (Spectral, kiểm thử đơn vị), bạn có thể an toàn chuyển từ ý tưởng sang tích hợp. Khi bạn mở rộng quy mô, hãy thêm các biện pháp bảo vệ nghiêm ngặt hơn: cổng xác thực schema, phê duyệt thủ công đối với mã được tạo và các bộ kiểm thử luân phiên.

tải ứng dụng

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API

Đăng ký miễn phíTải xuống