DEV Community

Cover image for 클로드 코드에서 클로드 오푸스 5 사용법
Rihpig
Rihpig

Posted on • Originally published at apidog.com

클로드 코드에서 클로드 오푸스 5 사용법

Claude Opus 5는 2026년 7월 24일에 출시되었으며, 첫날부터 Claude Code에 적용되었습니다. Max 구독자는 이미 기본 모델로 사용하고 있고, Pro 구독자는 이제 최고 성능 모델을 사용할 수 있습니다. API 키로 Claude Code를 사용하는 경우 가격은 Opus 4.8과 동일합니다. 입력 토큰 100만 개당 5달러, 출력 토큰 100만 개당 25달러입니다.

지금 Apidog를 사용해 보세요

주의할 점은 기존 설정이 Opus 5의 동작을 과도하게 증폭할 수 있다는 것입니다. Opus 5는 별도 지시 없이도 작업을 검증하고, 기본 응답을 더 길게 작성하며, Opus 4.8보다 하위 에이전트에 더 쉽게 작업을 위임합니다. 기존 CLAUDE.md에 추가한 검증·위임·상세 설명 지침은 이제 비용과 실행 시간을 늘릴 수 있습니다.

이 글에서는 다음을 바로 적용할 수 있도록 정리합니다.

  • Claude Code에서 Opus 5 선택하기
  • 구독 등급과 API 사용 시 달라지는 점
  • effort 설정과 400 오류 피하기
  • CLAUDE.md에 적용할 네 가지 수정
  • Apidog로 구현 결과를 외부에서 테스트하는 방법

전체 모델 분석은 Claude Opus 5 개요와 Anthropic의 Claude Opus 5 발표에서 확인할 수 있습니다.

구독 등급별 변경 사항

Opus 5에서는 어떤 방식으로 접근하는지가 이전보다 중요합니다.

Max 구독자

Opus 5가 기본 모델입니다. 별도 설정 없이 세션을 시작하면 바로 Opus 5를 사용합니다.

따라서 이전 모델을 기준으로 만든 비용, 응답 길이, 검증 횟수에 대한 감각은 더 이상 정확하지 않을 수 있습니다. 특히 기존 CLAUDE.md에 검증을 반복하도록 지시했다면 먼저 정리하세요.

Claude Opus 5 모델 화면

Pro 구독자

Opus 5는 Pro 구독에서 사용할 수 있는 최고 성능 모델입니다. 이전에는 최상위 모델보다 한 단계 낮은 모델이 스택 상단이었다면, 이제는 Anthropic이 기본 모델로 권장하는 모델을 사용할 수 있습니다.

API 키 사용자

Opus 5는 다음 환경에서 사용할 수 있습니다.

  • Claude API
  • Amazon Bedrock: anthropic.claude-opus-5
  • Google Cloud
  • Microsoft Foundry
  • GitHub Copilot

가격은 Opus 4.8과 동일합니다.

항목 가격
입력 토큰 100만 개 5달러
출력 토큰 100만 개 25달러

Fable 5의 10달러/50달러 대비 절반 수준입니다. 캐싱 및 배치 요금을 포함한 세부 내용은 Opus 5 가격 분석에서 확인하세요.

Claude Opus 5 가격 정보

또 하나 확인할 사양은 지식 마감일입니다. Opus 5의 지식 마감일은 2026년 5월이며, 현재 Claude 모델 중 가장 최신입니다. Fable 5와 Sonnet 5는 2026년 1월까지의 지식을 기준으로 합니다.

최근 분기에 출시된 라이브러리나 API를 다루는 코딩 작업이라면 이 5개월 차이가 실제 구현 품질에 영향을 줄 수 있습니다.

Claude Code에서 Opus 5 선택

Claude Code 세션에서 모델 선택기를 열려면 다음을 실행합니다.

/model
Enter fullscreen mode Exit fullscreen mode

목록에서 Claude Opus 5를 선택하세요.

모델 ID를 직접 지정하려면 다음 명령을 사용합니다.

/model claude-opus-5
Enter fullscreen mode Exit fullscreen mode

정확한 API 모델 ID는 다음과 같습니다.

claude-opus-5
Enter fullscreen mode Exit fullscreen mode

날짜 접미사나 버전 스탬프를 붙이지 마세요. Claude Code 스크립트, 프로젝트 기본값, 모델 이름을 참조하는 규칙 파일에서도 이 문자열을 그대로 사용하면 됩니다.

Bedrock 또는 Google Cloud를 사용한다면 Anthropic의 모델 개요 문서에서 플랫폼별 모델 ID를 확인하세요.

Opus 5의 컨텍스트는 기본적으로 최대 1M 토큰입니다. 베타 헤더나 장문 컨텍스트 할증 요금은 없습니다. Messages API의 최대 출력은 128k입니다.

다만 1M 토큰을 지원한다고 해서 매 요청마다 저장소 전체를 전달할 필요는 없습니다. 필요한 파일, 변경 범위, 테스트 대상만 선택해 전달해야 비용을 제어할 수 있습니다. 나머지 명령은 Claude Code 치트 시트에서 확인할 수 있습니다.

노력(effort)의 작동 방식

effort는 비용과 기능을 단순히 전환하는 스위치가 아닙니다. API에서는 output_config.effort로 설정하며, 다음 다섯 가지 값을 지원합니다.

low
medium
high
xhigh
max
Enter fullscreen mode Exit fullscreen mode

사용자 인터페이스에서는 이를 노력 선택기로 노출합니다.

기본값은 high

effort를 지정하지 않으면 기본값은 high입니다.

{
  "output_config": {
    "effort": "high"
  }
}
Enter fullscreen mode Exit fullscreen mode

medium이 기본값도 아니고, 요청마다 자동으로 무한 조정되는 값도 아닙니다.

Opus 4.8 설정을 그대로 가져오지 마세요

Anthropic은 Opus 4.8에서 사용하던 노력 설정을 그대로 재사용하지 말고 자체 평가를 다시 실행하라고 안내합니다.

특히 Opus 5에서는 low와 medium이 이전 Opus 모델보다 강력합니다. Opus 4.8에서는 medium에 맡기지 않았을 작업도 비용을 줄이면서 처리할 수 있습니다.

다만 코딩 및 에이전트 작업의 시작점으로는 여전히 xhigh가 권장됩니다.

thinking을 끄고 xhigh 또는 max를 함께 쓰면 400 오류가 발생합니다

다음 조합은 Opus 5에서 요청별 400 오류를 반환합니다.

{
  "thinking": {
    "type": "disabled"
  },
  "output_config": {
    "effort": "xhigh"
  }
}
Enter fullscreen mode Exit fullscreen mode

또는:

{
  "thinking": {
    "type": "disabled"
  },
  "output_config": {
    "effort": "max"
  }
}
Enter fullscreen mode Exit fullscreen mode

Claude Code 대화형 세션에서는 요청 형식을 관리하므로 보통 이 문제가 나타나지 않습니다. 하지만 SDK나 자동화 스크립트에서 사고 기능을 비활성화한 상태로 고노력 설정을 사용하면 오류가 발생할 수 있습니다.

해결 방법은 둘 중 하나입니다.

  1. 사고 기능을 활성화한 채로 xhigh 또는 max를 사용합니다.
  2. 사고 기능을 비활성화해야 한다면 노력을 high 이하로 제한합니다.

권장 방식은 사고 기능을 켜두고 effort로 비용을 조절하는 것입니다. 사고 기능을 끄면 실행되지 않는 일반 텍스트 형태의 도구 호출이 출력되거나, 내부 XML 태그가 가시적 출력에 나타날 수 있습니다.

비용별 성능을 비교하려면 노력 매개변수 가이드를 참고해 low부터 xhigh까지 실제 작업으로 스윕하세요. Opus 4.8에서의 변경 사항은 마이그레이션 가이드에서 다룹니다.

첫날에 적용할 네 가지 프롬프트 수정 사항

다음 수정은 비용과 불필요한 반복을 줄이는 데 직접적으로 도움이 됩니다. 내용은 Anthropic의 Opus 5 프롬프트 가이드를 기반으로 합니다.

1. 검증 지시를 삭제하세요

CLAUDE.md에서 다음과 유사한 지시를 찾으세요.

  • 항상 작업을 두 번 확인하라
  • 보고 전에 변경 사항을 검증하라
  • 테스트 통과를 확인하고 다시 확인하라
  • verify
  • double-check
  • confirm

Opus 5는 요청하지 않아도 스스로 검증하는 경향이 있습니다. 여기에 검증 지시를 추가하면 이미 읽은 파일을 다시 읽고, 이미 실행한 테스트를 반복하고, 이미 확인한 결과를 다시 검사할 수 있습니다.

프로젝트별 CLAUDE.md와 전역 CLAUDE.md를 모두 검색해 중복 검증 지시를 제거하세요.

grep -niE "verify|double-check|confirm" CLAUDE.md
Enter fullscreen mode Exit fullscreen mode

검증 자체를 포기하라는 뜻은 아닙니다. 모델 내부의 반복 검증 대신 CI, 테스트 러너, API 계약 테스트처럼 외부에서 재현 가능한 검증을 사용해야 합니다.

2. 하위 에이전트 생성을 제한하세요

Opus 5는 Opus 4.8보다 하위 에이전트에 작업을 더 쉽게 위임합니다. 대규모 병렬 조사에는 유용하지만, 단순한 수정에도 여러 에이전트를 생성하면 토큰과 실행 시간이 늘어납니다.

프로젝트 지침에 다음을 추가하세요.

## 위임

한 번의 실행으로 완료될 수 있는 작업에 대해서는 하위 에이전트를 생성하지 마십시오.
최대 두 개의 병렬 하위 에이전트를 사용하십시오.
만약 작업에 더 많은 하위 에이전트가 필요해 보인다면, 분할 방식을 설명하고
생성하기 전에 질문하십시오.
Enter fullscreen mode Exit fullscreen mode

목표는 위임을 금지하는 것이 아니라, 모델이 위임의 필요성을 먼저 판단하도록 만드는 것입니다.

의도적으로 하위 에이전트 구조를 구성하고 있다면 Claude Code 하위 에이전트 생성 가이드를 참고하세요.

3. 응답 길이를 프롬프트에서 제한하세요

Opus 5는 Opus 4.8보다 기본 응답, 요약, 설명, 문서를 길게 작성하는 경향이 있습니다.

effort를 낮춘다고 출력이 짧아지지는 않습니다. effort는 사고 깊이를 제어하며, 가시적 출력 길이를 직접 제어하지 않습니다.

응답 길이는 CLAUDE.md 또는 작업 프롬프트에서 명시하세요.

## 응답 스타일

자세한 내용을 요청하지 않는 한 결과를 150단어 이내로 보고하십시오.
차이점(diff)을 볼 수 있다면 방금 수행한 작업에 대한 요약을 생략하십시오.
서론을 건너뛰십시오. 답변부터 시작하십시오.
Enter fullscreen mode Exit fullscreen mode

작업 단위 프롬프트에서도 같은 원칙을 적용할 수 있습니다.

변경을 구현하세요. 완료 보고는 다음 형식으로 5줄 이내로 작성하세요.

- 변경한 파일
- 변경 내용
- 실행한 테스트
- 테스트 결과
- 남은 위험 요소
Enter fullscreen mode Exit fullscreen mode

4. 좁은 작업은 변경 경계를 명확히 지정하세요

Opus 5는 이전 버전보다 작업 범위를 넓게 해석할 수 있습니다. 예를 들어 함수 하나의 버그를 수정하라고 요청하면 주변 모듈의 개선 필요성까지 판단해 함께 수정할 수 있습니다.

정확히 한 가지 변경만 원한다면 작업 범위를 명시하세요.

parseConfig의 null 검사를 수정하고 다른 파일이나 동작은 변경하지 마십시오.
Enter fullscreen mode Exit fullscreen mode

다음보다 더 구체적입니다.

parseConfig의 null 검사를 수정하십시오.
Enter fullscreen mode Exit fullscreen mode

필요하다면 허용 범위와 금지 범위를 함께 작성하세요.

다음만 수행하세요.

- src/config/parseConfig.ts의 null 검사 수정
- 기존 테스트가 실패하면 해당 테스트만 수정

다음은 하지 마세요.

- API 이름 변경
- 주변 모듈 리팩터링
- 새 의존성 추가
- 문서 구조 변경
Enter fullscreen mode Exit fullscreen mode

더 많은 복사-붙여넣기 예시는 Opus 5 프롬프트 작성 가이드에서 확인할 수 있습니다.

API를 구축한 다음 Opus 5가 테스트하도록 하세요

Claude Code는 라우트와 핸들러를 스캐폴딩할 수 있습니다. 하지만 실행 중인 엔드포인트가 실제 계약대로 동작하는지는 별도 검증이 필요합니다.

이 간극에서 “코드상으로는 맞아 보였지만 실제 요청에서는 실패하는” 문제가 발생합니다. 모델의 자체 검증만으로는 실제 API 계약, 응답 형식, 인증, 상태 코드까지 보장할 수 없습니다.

Apidog에서 먼저 API 계약을 설계하고 모의 테스트하세요.

  1. 엔드포인트를 정의합니다.
  2. 요청 및 응답 스키마를 작성합니다.
  3. 현실적인 데이터를 반환하는 모의 서버를 만듭니다.
  4. Claude Code가 구현할 때 Apidog MCP 서버를 통해 실제 스펙을 참조하게 합니다.
  5. 구현 후 테스트 시나리오를 실행합니다.

예를 들어 사용자 가입 플로우를 CLI에서 실행할 수 있습니다.

apidog run --access-token $APIDOG_TOKEN \
  --project-id $PROJECT_ID \
  --test-scenario "user-signup-flow"
Enter fullscreen mode Exit fullscreen mode

실패한 어설션은 모델이 읽고 수정할 수 있는 출력으로 반환됩니다. 이는 모델 내부의 자체 검사보다 더 신뢰할 수 있는 외부 검증 루프입니다.

Claude API를 코드에서 직접 호출하는 경우에도 같은 방식이 유용합니다. Apidog에서 다음을 검증할 수 있습니다.

  • claude-opus-5 요청 전송
  • SSE 스트리밍 이벤트 도착 확인
  • 도구 호출 페이로드 검사
  • API 키를 코드에 하드코딩하지 않고 환경 변수로 관리
  • 동일 프롬프트를 여러 effort 값으로 실행
  • usage 블록을 읽어 캐시 적중 여부 확인

로컬 환경에서 시작하려면 Apidog를 다운로드하세요.

솔직한 한계

Opus 5가 Claude 스택의 모든 영역에서 최상위 모델은 아닙니다. 워크로드를 위임하기 전에 이 점을 구분해야 합니다.

Fable 5는 여전히 Anthropic이 “가장 유능한 광범위하게 출시된” 모델로 설명하는 모델입니다. 또한 Opus 5는 사이버 보안 익스플로잇 및 자율 생물학 연구에서 Mythos 5에 뒤처집니다.

Claude Code 작업이 이 두 영역에 속한다면 Opus 5가 적절한 한계가 아닐 수 있습니다. Mythos 등급 설명에서 해당 등급의 목적을 확인하세요.

벤치마크 역시 주의해서 해석해야 합니다. Anthropic은 다음과 같이 보고합니다.

  • Opus 4.8 대비 Frontier-Bench v0.1 점수가 두 배 이상
  • ARC-AGI 3에서 다음으로 높은 모델의 약 3배
  • Fable 5의 CursorBench 3.2 최고치에 0.5% 이내
  • Fable 5 대비 절반 가격

다만 이는 공급업체가 자체 실행한 수치입니다. 2026년 7월 25일 기준으로 독립 재현 결과는 없습니다. 확정된 결론으로 받아들이기보다, 팀의 실제 리포지토리와 작업 유형으로 평가를 실행해야 하는 이유로 보세요.

다른 모델을 사용해야 할 때

다음 작업에는 Opus 5를 계속 사용하는 것이 적합합니다.

  • 에이전트 기반 코딩
  • 다중 파일 리팩터링
  • 장기 실행 작업
  • 명령을 실행하고 출력을 반복 해석해야 하는 작업

다만 다음 조건에서는 다른 모델도 고려하세요.

상황 선택
대량 처리와 비용 최적화가 우선 Sonnet 5
표준적인 편집·수정 작업 Sonnet 5
가장 어려운 최첨단 문제 Fable 5 또는 Mythos 5
복잡한 에이전트 코딩·다중 파일 작업 Opus 5

Claude Code에서는 한 명령으로 전환할 수 있습니다.

/model claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

비용 민감한 작업에 Sonnet 5를 사용하고, 어려운 구간에서 다시 Opus 5로 전환하세요.

/model claude-opus-5
Enter fullscreen mode Exit fullscreen mode

이미 Claude Code에서 Sonnet 5 또는 Claude Code에서 Fable 5를 사용했다면 같은 워크플로우를 적용하면 됩니다.

실용적인 체크리스트

  • 먼저 CLAUDE.md를 감사하세요. 검증 반복 지시를 제거하고, 출력 길이 제한과 하위 에이전트 상한선을 추가하세요.
  • effort를 다시 측정하세요. Opus 4.8의 설정을 그대로 쓰지 말고 low, medium, high, xhigh를 실제 작업으로 비교하세요.
  • 사고 기능을 켜두세요. 사고 기능을 끄는 대신 effort로 비용을 제어하세요.
  • 컨텍스트 범위를 제한하세요. 1M 토큰은 저장소 전체를 매 턴마다 전달하라는 의미가 아닙니다.
  • 외부 테스트를 실행하세요. 모델의 자체 검증보다 API 계약에 대한 실패 테스트가 더 유용합니다.

FAQ

Claude Code에서 Claude Opus 5를 사용할 수 있나요?

네. 2026년 7월 24일 출시부터 사용할 수 있습니다.

/model
Enter fullscreen mode Exit fullscreen mode

선택기를 열어 Claude Opus 5를 선택하거나, 다음처럼 직접 지정하세요.

/model claude-opus-5
Enter fullscreen mode Exit fullscreen mode

Max 구독자에게는 기본 모델이며, Pro 구독자에게는 사용 가능한 최고 성능 모델입니다.

Opus 5를 위해 CLAUDE.md를 변경해야 하나요?

대부분의 경우 변경하는 편이 좋습니다.

Opus 5는 별도 지시 없이도 작업을 검증하는 경향이 있으므로, 기존의 검증 반복 지시는 과도한 검증을 유발할 수 있습니다. 검증 지시를 제거하고, 대신 다음을 추가하세요.

  • 명시적인 응답 길이 제한
  • 하위 에이전트 수 제한
  • 좁은 작업의 변경 범위
  • 외부 테스트 실행 지시

노력을 낮춰도 응답이 짧아지지 않는 이유는 무엇인가요?

effort는 사고의 깊이를 제어하며, 가시적 출력 길이를 직접 제어하지 않습니다.

노력을 낮추면 추론 토큰은 줄어들 수 있지만 응답 텍스트 길이는 거의 같을 수 있습니다. 더 짧은 출력을 원한다면 프롬프트에 길이 제한을 직접 작성하세요.

노력을 xhigh로 설정했을 때 400 오류가 발생하는 이유는 무엇인가요?

다음 조합은 Opus 5에서 400 오류를 반환합니다.

{
  "thinking": {
    "type": "disabled"
  },
  "output_config": {
    "effort": "xhigh"
  }
}
Enter fullscreen mode Exit fullscreen mode

thinking을 활성화하거나, 사고 기능을 비활성화해야 한다면 effort를 high 이하로 제한하세요. 자세한 변경 사항은 마이그레이션 가이드를 참고하세요.

무료 요금제에서 Claude Code의 Opus 5를 사용할 수 있나요?

Opus 5는 Pro 및 Max 구독과 API를 통해 사용할 수 있습니다.

  • Pro: 해당 등급에서 사용할 수 있는 최고 성능 모델
  • Max: 기본 모델
  • API: 모델 ID claude-opus-5로 호출 가능

무료 접근 및 가장 저렴한 유료 경로는 Opus 5 무료 액세스 가이드에서 확인할 수 있습니다.

Top comments (0)