커서에서 클로드 소네트 5 사용법

Claude Sonnet 5는 2026년 6월 30일에 출시되었으며, 대부분의 사람들이 Cursor를 사용하는 방식에 잘 맞습니다. Anthropic은 이를 현재까지 가장 에이전트적(agentic)인 Sonnet 모델이라고 부르며, Opus 4.8에 가까운 도구 사용 성능을 훨씬 저렴한 가격으로 제공합니다. 모델이 파일 읽기, 코드 편집, 명령 반복 실행에 대부분의 시간을 할애하는 Cursor에서는 이 점이 중요합니다. 이 가이드에서는 Cursor에서 Sonnet 5를 활성화하는 방법, 자체 Anthropic API 키를 사용해야 할 때, 에이전트 모드를 최대한 활용하는 방법, 그리고 더 큰 모델로 전환해야 할 때를 보여줍니다. 전체 모델 개요는 Claude Sonnet 5란 무엇인가를 읽어보시고, Anthropic의 공식 발표에서 출시 세부 정보를 확인하세요.

또한 Apidog가 어디에 적합한지 알 수 있습니다: Cursor와 Sonnet 5가 API를 구축할 때, Apidog는 요청을 보내고, 저장하고, 응답을 모의(mock)하고, 엔드포인트에 대해 자동화된 테스트를 실행하는 곳입니다.

Sonnet 5가 Cursor의 좋은 기본 모델인 이유

Cursor의 에이전트는 작고 도구 중심적인 많은 단계를 수행합니다. 파일을 열고, 편집을 적용하고, 코드베이스를 검색하고, 터미널 명령을 실행합니다. 바로 이러한 종류의 작업에서 Sonnet 5가 빛을 발합니다.

Anthropic의 출시 벤치마크에 따르면 Sonnet 5는 에이전트 작업에서 Opus 4.8과 몇 점 차이밖에 나지 않습니다. 코딩 벤치마크인 SWE-bench Pro에서 보고된 수치는 Sonnet 5가 63.2%, Opus 4.8이 69.2%였으며, 이는 Sonnet 4.6의 58.1%에서 증가한 수치입니다. Terminal-Bench 2.1에서는 Sonnet 5가 80.4%, Opus 4.8이 82.7%를 기록했습니다. 컴퓨터 사용 벤치마크인 OSWorld-Verified에서는 Sonnet 5가 81.2%, Opus 4.8이 83.4%를 기록했습니다. 이는 Anthropic이 보고한 수치이며, 저희의 자체 테스트 결과는 아닙니다. 전체 표는 Claude Sonnet 5 벤치마크 분석에서 확인하세요.

이러한 경향은 일관적입니다. 도구를 활용할 경우, Sonnet 5는 Opus 4.8과 약 1~3점 차이를 보입니다. 순수 추론에서는 Opus가 약 6점 앞섭니다. Cursor는 거의 항상 도구를 활용하므로, 최고 수준의 가격을 지불하지 않고도 대부분의 최고 수준 품질을 얻을 수 있습니다.

가격은 또 다른 절반입니다. Sonnet 5는 Sonnet 4.6과 동일한 토큰당 비용을 가집니다: 표준 요율로 백만 입력 토큰당 3달러, 백만 출력 토큰당 15달러입니다. Anthropic은 2026년 8월 31일까지 백만 입력 토큰당 2달러, 백만 출력 토큰당 10달러의 출시 기념 요율을 적용하고 있습니다. Opus 4.8은 백만 입력 토큰당 5달러, 백만 출력 토큰당 25달러입니다. 긴 에이전트 세션에서는 그 차이가 빠르게 누적됩니다.

Cursor에서 Sonnet 5를 사용하는 두 가지 방법

Cursor는 Anthropic의 Claude 모델을 직접 지원하며, 자체 Anthropic 계정을 통해 비용을 청구하려는 경우 BYOK(Bring-Your-Own-Key)도 지원합니다. 메뉴 문구는 Cursor 버전 간에 변경될 수 있으므로, 이를 정확한 단계라기보다는 흐름의 형태로 이해해 주십시오.

옵션 1: Cursor의 내장 모델 선택기

Cursor 요금제에 Claude 모델이 포함되어 있다면, 이것이 가장 빠른 방법입니다.

Cursor를 열고 모델 선택기를 누릅니다. 일반적으로 채팅 또는 Composer 입력창이나 설정(Settings) 아래에 있습니다.
모델 목록에서 Claude Sonnet 5를 찾습니다.
선택합니다. 이제 Cursor는 채팅, 편집 및 에이전트 실행을 위해 Sonnet 5를 통해 요청을 라우팅합니다.

새로운 모델은 특정 Cursor 빌드에 나타나는 데 시간이 약간 걸릴 수 있습니다. 아직 Sonnet 5가 보이지 않으면 Cursor를 최신 버전으로 업데이트한 후 다시 확인하세요. 추가 설정 지원을 위해 Cursor 설정 가이드에서 처음부터 구성하는 방법을 안내합니다.

옵션 2: 자체 Anthropic API 키 사용하기

BYOK는 청구를 직접 제어하고 싶거나, 계정에 연결된 더 높은 제한이 필요하거나, Cursor 요금제에 포함되지 않은 모델을 사용하고 싶을 때 유용합니다.

Claude Console에서 Anthropic API 키를 받습니다. 조직의 API 키 아래에서 키를 생성합니다.
Cursor에서 설정(Settings)을 열고 모델 또는 API 키 섹션을 찾습니다.
Anthropic 공급자 필드에 Anthropic 키를 붙여넣고 저장합니다.
Claude Sonnet 5를 활성 모델로 선택합니다.

Anthropic이 노출하는 모델 ID는 날짜 접미사가 없는 정확한 문자열인 claude-sonnet-5입니다. 일반적으로 Cursor의 UI에 ID를 직접 입력하지는 않지만, API에 대해 직접 스크립팅하는 경우 필요합니다. 저희의 Claude Sonnet 5 API 가이드는 원시 요청 형태, 모델 ID 및 응답 형식을 자세히 다룹니다.

API 키를 코드베이스 외부에 보관하십시오. 환경 변수 또는 OS 키체인에 저장하고, git에 커밋하지 마십시오.

내부적으로 무엇이 변경되었는지 (그리고 Cursor에 왜 중요한지)

Sonnet 5는 API 수준에서 Sonnet 4.6의 드롭인 대체품이지만, Cursor 내부에서도 알아두면 좋은 몇 가지 동작 변경 사항이 있습니다.

적응형 사고(Adaptive thinking)가 이제 기본적으로 활성화됩니다. Sonnet 4.6에서는 thinking 필드가 없는 요청은 사고 없이 실행되었습니다. Sonnet 5에서는 동일한 요청이 적응형 사고와 함께 실행됩니다. Cursor에서 이는 모델이 어려운 작업을 수행하기 전에 더 많이 추론한다는 것을 의미하며, 이는 여러 파일 변경을 계획할 때 원하는 것입니다. 출력에 사고 토큰(thinking tokens)이 포함될 수 있으므로, 까다로운 프롬프트에서는 응답 시간이 약간 길어지고 비용이 약간 더 들 수 있습니다.

Sonnet 5는 또한 새로운 토크나이저를 함께 제공합니다. 동일한 입력 텍스트는 Sonnet 4.6보다 약 30% 더 많은 토큰을 생성하며, 이는 약 1.3배에 해당합니다. 요청 및 응답 형태는 동일하므로 아무것도 깨지지 않습니다. 하지만 토큰으로 측정하는 모든 것이 달라집니다. 100만 토큰 컨텍스트 창은 평균적으로 약간 더 적은 텍스트를 담을 수 있으며, 토큰당 요율이 변경되지 않았음에도 불구하고 동일한 요청의 비용이 더 높을 수 있습니다. Cursor 지출을 추적한다면, 4.6 버전의 숫자를 재사용하는 대신 Sonnet 5에 대해 다시 측정하십시오.

API에 대해 직접 스크립팅하는 경우 두 가지 제약 사항이 더 중요합니다. budget_tokens를 사용한 수동 확장 사고는 400 오류를 반환합니다. temperature, top_p 또는 top_k를 기본값이 아닌 값으로 설정하면 400 오류가 반환됩니다. 대신 프롬프트를 통해 동작을 유도하십시오. Cursor는 자체 모델 호출 내에서 이를 처리하므로, Anthropic API에 직접 구축하는 경우에만 이러한 문제가 발생합니다.

Cursor의 에이전트 모드에서 Sonnet 5 사용하기

에이전트 모드에서 Sonnet 5는 그 가치를 증명합니다. 모델이 프로젝트를 읽고, 변경 사항을 계획하고, 여러 파일을 편집하고, 터미널 명령을 실행한 다음, 자체 작업을 확인할 수 있게 합니다.

잘 작동하는 워크플로우:

단계를 명시하는 대신 결과를 설명하십시오. Sonnet 5에게 무엇을 구축하고 싶은지, 그리고 어떤 파일이나 폴더가 범위에 포함되는지 알려주세요.
먼저 계획하게 하십시오. 적응형 사고가 활성화되면 Sonnet 5는 편집하기 전에 접근 방식을 제시하는 경향이 있습니다. 계획을 읽고, 방향이 벗어나면 초기에 수정하십시오.
작업을 범위 내로 유지하십시오. 작고 잘 정의된 작업은 더 깨끗한 diff를 제공하고, 하나의 거대한 개방형 프롬프트보다 비용이 적게 듭니다.
모든 diff를 검토하십시오. 모델은 에이전트 코딩에 강력하지만, 병합은 여전히 사용자의 책임입니다.

Cursor는 도구를 계속 활용하므로, Sonnet 5의 에이전트적 강점이 직접적으로 나타납니다. 일상적인 작업에서 더 비싼 모델을 사용하지 않고도 읽기, 편집, 실행, 검증 주기를 잘 처리합니다.

현실적인 예시: API를 구축한 다음 테스트하기

Cursor에서 Sonnet 5에게 주문을 생성하고 JSON으로 반환하는 Express 라우트를 스캐폴딩(scaffold)하도록 요청한다고 가정해 봅시다.

// routes/orders.js
const express = require('express');
const router = express.Router();

router.post('/orders', (req, res) => {
  const { customerId, items } = req.body;
  if (!customerId || !Array.isArray(items) || items.length === 0) {
    return res.status(400).json({ error: 'customerId and items are required' });
  }
  const order = {
    id: `order_${Date.now()}`,
    customerId,
    items,
    status: 'created',
  };
  return res.status(201).json(order);
});

module.exports = router;

Cursor와 Sonnet 5는 이를 생성하고, 앱에 연결하고, 심지어 테스트 초안을 작성할 수도 있습니다. 하지만 생성된 코드는 실제 요청에 대한 실제 검증이 여전히 필요합니다. 바로 여기서 Apidog가 등장합니다.

Apidog에서는 다음을 수행할 수 있습니다:

JSON 본문과 함께 POST /orders 요청을 보내고 201 응답과 올바른 응답 형태를 받는지 확인합니다.
요청을 컬렉션에 저장하여 전체 팀이 재사용할 수 있도록 합니다.
기본 URL과 모든 키를 환경 변수로 저장하여 보안 정보를 하드코딩하지 않도록 합니다.
예를 들어 status가 created와 같고 id가 존재하는지 자동화된 어설션(assertion)을 추가한 다음 CI에서 테스트 스위트를 실행합니다.
백엔드가 완성되기 전에 프런트엔드가 실제 응답에 대해 구축할 수 있도록 엔드포인트를 모의(mock)합니다.

Cursor와 Sonnet 5는 코드를 빠르게 작성하며, Apidog는 API가 올바르게 작동하는지 확인할 수 있는 재현 가능한 방법을 제공합니다. 다른 도구에서 전환했다면, 이 Postman 없이 API 테스트하기 워크스루는 테스트 흐름을 처음부터 끝까지 보여줍니다. 자신의 엔드포인트로 따라 하려면 Apidog를 다운로드하세요.

비용 및 사용 참고 사항

Cursor는 자체 청구, 제한 및 모델 접근을 관리하며, 이러한 세부 사항은 시간이 지남에 따라 변경되므로 Cursor의 현재 요금제 세부 정보를 직접 확인하십시오. 요금제와 관계없이 몇 가지 원칙이 유지됩니다:

Sonnet 5는 Opus 4.8보다 실행 비용이 저렴합니다. 일상적인 코딩에는 합리적인 기본 모델입니다.
적응형 사고는 사고 토큰이 출력에 포함되므로 어려운 프롬프트에서 비용을 증가시킬 수 있습니다. 많은 작은 편집에서는 이러한 오버헤드가 일반적으로 작습니다.
새로운 토크나이저는 동일한 코드와 프롬프트가 Sonnet 4.6보다 더 많은 토큰을 소비한다는 것을 의미합니다. 이 점을 염두에 두고 예산을 책정하십시오.
BYOK를 사용하면 Anthropic 청구서에 위 요율에 따른 실제 사용량이 반영됩니다. 이전 Sonnet 숫자와 동일하다고 가정하는 대신 실제 워크로드를 모델링하십시오.

Cursor 내에서 모델을 선택하는 방법에 대한 더 넓은 시야를 위해 최고의 Cursor 모델 비교를 참조하십시오.

모델을 전환해야 할 때

Sonnet 5는 대부분의 Cursor 작업을 잘 처리합니다. 가장 어려운 추론 작업, 즉 복잡한 아키텍처 결정, 심층적인 단계별 추론이 필요한 미묘한 디버깅, 또는 비용보다 품질이 더 중요한 장기적인 자율 실행의 경우 Opus 4.8로 전환하십시오. 도구 없이 순수 추론에서는 보고된 벤치마크에서 Opus 4.8이 Sonnet 5보다 약 6점 앞서며, 이러한 차이는 가장 어려운 작업에서 추가 비용을 지불할 가치가 있을 수 있습니다.

기능 작업부터 리팩토링, 테스트 작성 및 실행에 이르기까지 그 외 모든 작업에서 Sonnet 5는 더 저렴한 가격으로 Opus에 준하는 에이전트 성능을 제공합니다. Sonnet 5를 기본 모델로 유지하고, 작업이 실제로 지연될 때만 Opus 4.8로 전환하십시오.

자주 묻는 질문

Claude Sonnet 5는 Cursor에서 사용 가능한가요? Cursor는 Anthropic의 Claude 모델을 지원하며, Cursor 빌드가 이를 지원하면 Sonnet 5가 모델 선택기에 나타날 것입니다. 만약 보이지 않는다면 Cursor를 최신 버전으로 업데이트하십시오. Anthropic API 키를 사용하여 BYOK(자체 키 사용)를 통해 추가할 수도 있습니다.

Cursor에서 Sonnet 5를 사용하려면 자체 API 키가 필요한가요? 항상 필요한 것은 아닙니다. Cursor 요금제에 Claude 모델이 포함되어 있다면, 키 없이 Sonnet 5를 선택할 수 있습니다. 자체 Anthropic 계정을 통해 비용을 청구하거나 제한을 직접 제어해야 할 때 BYOK를 사용하십시오. Claude Sonnet 5 API 가이드에서 키 생성 방법을 설명합니다.

Cursor에서 코딩할 때 Sonnet 5와 Opus 4.8 중 어느 것이 더 좋나요? 대부분의 Cursor 작업에서는 Sonnet 5가 에이전트 코딩에서 Opus 4.8에 가까운 성능을 더 낮은 가격으로 제공하므로 더 나은 가치를 제공합니다. 가장 어려운 추론 작업에는 Opus 4.8을 사용하십시오. Sonnet 5 대 Opus 4.8 비교에서 이러한 장단점을 분석합니다.

Sonnet 5가 Sonnet 4.6보다 더 많은 토큰을 사용하는 것처럼 보이는 이유는 무엇인가요? Sonnet 5는 동일한 텍스트에 대해 약 30% 더 많은 토큰을 생성하는 새로운 토크나이저를 사용합니다. 토큰당 가격은 변경되지 않았지만, 동일한 요청의 비용이 더 높을 수 있습니다. 이전 토큰 수를 재사용하는 대신 실제 워크로드를 측정하십시오.

Cursor에서 Sonnet 5를 무료로 사용할 수 있나요? 이는 Cursor가 제어하는 Cursor 요금제에 따라 다릅니다. Sonnet 5는 무료 Claude 웹 및 앱 요금제의 기본 모델이지만, 이는 Cursor와는 별개입니다. 포함된 내용에 대해서는 Cursor의 현재 요금제 세부 정보를 확인하십시오.

button