Claude Opus 4.7 코딩 활용법: xhigh와 비전 업그레이드로 바뀐 실전 워크플로우
claude opus 4.7 사용법 한 줄 요약
짧은 답: Claude Opus 4.7은 모델 이름만 바꾸면 끝나는 업그레이드가 아니에요. 코딩과 에이전트처럼 여러 단계를 이어서 하는 작업은
xhigh를 기본으로 두고, 짧은 질의나 동시 세션은high나medium으로 낮춰야 토큰이 덜 새거든요. API에선thinking: {type: "adaptive"}와output_config로 요청 바디를 바꾸고, 스크린샷 분석은 2,576px 비전으로 따로 써야 4.7의 장점이 제대로 살아나요.
4.6에서 4.7로 올리고 제일 먼저 한 게 effort부터 다시 잡는 일이었어요. 그냥 모델 이름만 바꾸면 끝일 줄 알았는데, 토큰 쓰는 방식이 달라져서 Pro 한도가 생각보다 빨리 닳더라고요.
claude opus 4.7 사용법이라고 검색해서 왔다면 먼저 볼 건 딱 두 가지예요. Claude Code에서 지금 내가 어느 사용 환경에서 4.7을 실제로 쓰는지 확인하고, API에선 adaptive thinking, 그러니까 모델이 필요할 때만 길게 생각하게 하는 모드로 요청 바디를 바꾸는 거예요. 비전도 꽤 달라졌어요. 긴 설명보다 스크린샷 한 장 올려서 UI 버그 위치를 짚게 하는 흐름이 훨씬 실용적으로 바뀌었거든요.
근데 코딩 말고 긴 문서 요약이나 리서치 정리는 무조건 업그레이드라고 단정하면 위험해요. 그래서 2026년 4월 18일 기준으로 어디서 4.7을 쓸 수 있는지, xhigh를 언제 켜고 언제 낮출지, API에선 뭘 뜯어고쳐야 하는지, 토큰 폭주를 어떻게 막을지 실무 순서대로 묶어뒀어요.
어디서 쓸 수 있나 사용 환경 먼저 정리
먼저 사용 환경부터 정리해야 해요. 같은 Claude Opus 4.7이라도 웹앱, Claude Code, API, GitHub Copilot에서 잡는 방식이 조금씩 다르거든요.
아직도 터미널 하나만 보고 “난 이미 4.7 쓰는 중”이라고 생각하고 있진 않죠?
| 묶음 | 실제 사용 환경 | 언제 쓰면 좋나 |
|---|---|---|
| Claude 앱 | 웹, Desktop, iOS, Android | 빠른 질문, 이미지 확인, 이동 중 이어서 보기 |
| Claude Code | CLI, Desktop, Web, VS Code, JetBrains, Slack, Chrome, GitHub Actions, GitLab | 저장소 단위 코딩, PR 리뷰, 브라우저 디버깅, 자동화 |
| API와 클라우드 | Claude API, Amazon Bedrock, Google Vertex AI, Microsoft Foundry | 파이프라인 자동화, 비용 통제, 서버 쪽 통합 |
| GitHub Copilot 롤아웃 | VS Code, Visual Studio, JetBrains, Xcode, github.com, Mobile, Copilot CLI, Cloud Agent | 조직이 Copilot 중심일 때 4.7만 골라 쓰기 |
공식 기준으로 4.7은 Claude의 Pro, Max, Team, Enterprise에서 쓸 수 있고, API 가격은 백만 토큰당 입력 $5, 출력 $25예요. 개인 요금은 Pro가 월 $20, Max 5x가 월 $100, Max 20x가 월 $200으로 잡혀 있어요. 값만 보면 4.6이랑 같아 보이는데, 4.7은 새 토크나이저 때문에 같은 텍스트가 더 비싸게 느껴질 수 있거든요. 가격표만 보고 “그럼 체감도 같겠네”라고 보면 오판하기 쉬워요. 기준은 모델 개요, Claude Code 플랫폼 문서, 요금 페이지, Max 플랜 안내로 잡는 게 안전해요.
표면별 차이가 헷갈리면 GitHub Copilot vs Claude Code: 가격부터 실사용까지 비교를 같이 열어두세요. 어디서 4.7을 쓰는 게 덜 답답한지 판단이 빨라져요.
claude code opus 4.7 전환은 이렇게 해요
Claude Code에선 “내가 지금 정말 4.7을 쓰는가”부터 확인하면 돼요. Anthropic 직통 계정인지, Bedrock·Vertex·Foundry 같은 클라우드 제공사를 쓰는지에 따라 짧은 모델 이름이 다르게 풀릴 수 있거든요.
그냥 opus만 치면 끝날까요?
2026년 4월 18일 기준으로 Anthropic API 쪽에선 opus 별칭이 4.7을 가리켜요. 근데 Bedrock, Vertex AI, Foundry에선 아직 opus가 4.6으로 풀릴 수 있어요. 그래서 팀에서 여러 제공사를 섞어 쓰면 짧은 이름보다 claude-opus-4-7 전체 이름으로 박는 쪽이 덜 헷갈려요.
# Claude Code 버전 먼저 체크
claude --version
# 4.7 세션 시작
claude --model claude-opus-4-7
# 4.6 비교 세션도 하나 열어두기
claude --model claude-opus-4-6
# 세션 안에서 모델 다시 고르기
/model
# 긴 세션이면 1M 컨텍스트로 고정
/model claude-opus-4-7[1m]
체크할 건 이 정도면 충분해요.
- 지금 로그인한 계정이 Anthropic 직통인지, Bedrock·Vertex·Foundry인지 본다
claude --model claude-opus-4-7로 4.7 세션을 하나 연다- 같은 작업을 4.6 세션에도 한 번 돌려본다
- 장기 작업이면
/model claude-opus-4-7[1m]로 문맥 창도 같이 맞춘다 - 롤백용 명령을 따로 메모해둔다
claude-opus-4-7 전체 이름과 1M 토큰 컨텍스트 확인설치부터 다시 보고 싶으면 Claude Code 사용법: 설치부터 첫 실행까지 5분 가이드를 먼저 보고 오는 게 빨라요. 로그인 타입이 꼬이면 여기서부터 설정이 다 엉키거든요.
claude opus 4.7 xhigh 언제 켜고 언제 낮출까
xhigh는 high와 max 사이에 새로 들어온 effort level, 그러니까 추론 깊이 조절 단계예요. 4.7에선 코딩과 에이전트 작업의 기본 추천값이 이쪽이라, 복잡한 작업은 그냥 여기서 시작하는 게 편하죠.
모든 작업을 xhigh로 두면 속 편하지 않을까요?
그렇게 두면 Pro 한도부터 먼저 바닥나요. 공식 문서도 4.7 토크나이저가 텍스트에 따라 이전 모델보다 대략 1배에서 1.35배까지 더 많은 토큰을 쓸 수 있다고 적어뒀거든요. 세 번만 주고받았는데 갑자기 사용량 경고가 뜨는 느낌, 여기서 많이 나와요.
/effort xhigh
/effort high
/effort medium
/effort auto
| 작업 종류 | 추천 effort | 이유 |
|---|---|---|
| API 설계, 스키마 설계, 대형 리팩터링 | xhigh | 깊게 생각하는 시간이 실제로 이득인 일 |
| 복잡한 버그 추적, 코드 리뷰 | xhigh 또는 high | 난도는 높은데 세션 수가 많으면 high가 낫기도 함 |
| 로그 요약, 짧은 질의응답, 문서 초안 | high | 품질 손해가 작고 토큰 절감이 큼 |
| 단순 분류, 빠른 확인, 비용 민감 작업 | medium | 속도와 비용이 훨씬 낫죠 |
| 정말 어려운 실험성 과제 | max | 품질 상승이 있을 수 있지만 과하게 오래 생각할 수 있음 |
실무에선 “첫 턴 xhigh, 후속 정리는 high”가 제일 덜 피곤하더라고요. 큰 방향 잡을 때는 xhigh로 밀고, 수정 반복이나 자잘한 질의는 high로 내리는 식이죠. 동시 세션을 여러 개 열어둘 땐 더 그래요. 이때까지 전부 xhigh로 두면 모델보다 내 한도가 먼저 끝나요.
여러 서브에이전트를 한꺼번에 돌릴 생각이면 Claude Code 서브에이전트 만들기 실전 가이드: 자동 위임·비용 절감 세팅까지도 같이 보세요. 여기선 xhigh를 어디에만 써야 덜 아픈지가 핵심이거든요.
claude opus 4.7 비전 어디에 바로 써먹나
4.7 비전의 핵심은 “이제 스크린샷이 진짜 디버깅 입력이 됐다”는 거예요. 최대 해상도가 2,576px, 약 375만 화소까지 올라갔고 좌표도 실제 픽셀과 1:1로 맞아서 UI 분석이 훨씬 덜 삐끗해요.
스크린샷 올려놓고도 계속 텍스트로만 설명하고 있진 않죠?
코딩에서 바로 체감 나는 건 세 가지예요. 한국어 UI 버그 위치 찾기, 복잡한 대시보드 레이아웃 깨짐 확인, 다이어그램이나 설계 캡처에서 누락된 상태 전이 찾기. 예전엔 “왼쪽 두 번째 카드 아래 버튼”처럼 길게 설명해야 했는데, 이젠 화면을 그대로 넣고 번호 매기라고 하면 훨씬 잘 맞아요. 근데 해상도가 올라간 만큼 토큰도 더 먹어요. 전체 화면이 꼭 필요 없으면 미리 잘라서 보내는 게 나아요.
실전 프롬프트는 이 정도면 충분해요.
이 화면에서 저장 버튼이 비활성으로 보이는 이유를 찾아줘.
문제 위치를 번호로 적고,
개발자가 바로 고칠 수 있게 프론트엔드 수정 포인트를 체크리스트로 줘.
추측이면 추측이라고 적어줘.
체크 포인트도 같이 보세요.
- 전체 맥락이 필요한지 먼저 판단한다
- 버튼, 입력창, 에러 토스트가 한 장에 같이 보이게 캡처한다
- 고해상도가 필요 없으면 먼저 잘라서 보낸다
- 답은 “문제 위치 + 수정 포인트 + 검증 항목” 순서로 받는다
브라우저 상태, 로그, 외부 서비스까지 한 번에 엮고 싶으면 MCP 서버 사용법: Claude Code 연결 가이드를 붙여서 보세요. 화면만 보는 것보다 원인 추적이 훨씬 빨라져요.
API 마이그레이션에서 꼭 바꿀 4가지
API 쪽은 4.6 요청 바디를 그대로 들고 오면 바로 깨질 수 있어요. 특히 thinking, sampling, prefill, provider alias 네 군데가 많이 걸리죠.
4.6에서 돌던 코드가 4.7에서도 그냥 되겠지 싶지 않나요?
공식 기준으로는 Anthropic 마이그레이션 가이드와 What’s new in Claude Opus 4.7 두 문서를 같이 보는 게 제일 정확해요. 바꿔야 할 건 이 네 가지예요.
| 4.6 습관 | 4.7에서 바꿀 것 | 왜 중요한가 |
|---|---|---|
thinking: {"type":"enabled","budget_tokens":...} |
thinking: {"type":"adaptive"} + output_config.effort |
고정 thinking budget은 400 에러가 나요 |
temperature, top_p, top_k 커스텀 값 |
아예 빼기 | 4.7은 non-default 값에서 400이 날 수 있어요 |
assistant prefill, 그러니까 응답 앞부분 미리 채우기 |
system prompt 또는 output_config.format |
prefill도 400으로 막혀 있어요 |
opus 별칭에 기대기 |
claude-opus-4-7 전체 이름 고정 |
제공사별 별칭 해석이 달라질 수 있거든요 |
토큰도 다시 잡아야 해요. 4.7은 100만 토큰 문맥 창과 128k 최대 출력이 장점인데, 새 토크나이저 때문에 같은 텍스트라도 비용 체감이 달라질 수 있어요. 자동화 파이프라인이면 count_tokens부터 다시 재보는 게 맞아요.
from anthropic import Anthropic
client = Anthropic()
response = client.beta.messages.create(
model="claude-opus-4-7",
max_tokens=64000,
thinking={"type": "adaptive"},
output_config={
"effort": "xhigh",
"task_budget": {"type": "tokens", "total": 64000},
},
betas=["task-budgets-2026-03-13"],
messages=[
{
"role": "user",
"content": "Review this patch and return a refactor plan."
}
],
)
여기서 task_budget은 에이전트 루프 전체에 주는 토큰 예산이에요. hard cap인 max_tokens랑 다르고, 모델이 “이 안에서 적당히 끝내야겠다”라고 스스로 판단하게 만드는 가드레일이죠. 공식 문서 기준 최소값은 20k고, 품질이 더 중요하면 아예 안 주는 편이 나아요.
긴 문서 작업은 조금 보수적으로 가세요. 코딩과 비전은 4.7로 옮길 이유가 충분한데, 계약서나 리서치 PDF처럼 장문 맥락 회수가 핵심인 흐름은 샘플 몇 개를 4.6과 같이 돌려보고 결정하는 편이 안전해요. 여기서 성급하게 전면 교체하면 “왜 예전보다 덜 집요하지?” 같은 반응이 바로 나와요.
긴 컨텍스트를 통째로 던질지, 어디서부터 다른 도구로 분담할지 감 잡으려면 AI 컨텍스트 엔지니어링: Notion·Claude·Cursor 분담법도 같이 보세요. 1M 토큰을 무조건 쓰는 게 항상 답은 아니거든요.
자동화 파이프라인으로 더 밀어붙일 생각이면 Claude Agent SDK 사용법: 커스텀 에이전트 빌드 실전 가이드를 이어서 보세요. 여기서부터는 세션이 아니라 시스템 설계 문제로 넘어가거든요.
자주 묻는 질문
Q1: Claude Opus 4.7이 4.6보다 무조건 좋나요?
A: 코딩, 비전, 긴 에이전트 작업은 4.7 쪽으로 기우는 게 맞아요. 근데 긴 문서 분석까지 무조건 우위라고 단정하긴 이르죠. 샘플 워크로드를 4.6과 같이 돌려보고 갈아타는 게 안전해요.
Q2: xhigh는 언제 쓰는 게 맞나요?
A: API 설계, 레거시 마이그레이션, 복잡한 코드 리뷰처럼 “한 번 깊게 생각해야 값이 나오는 일”에 쓰면 돼요. 짧은 Q&A나 여러 세션을 동시에 돌릴 땐 high가 더 실용적일 때가 많아요.
Q3: Pro 플랜이 너무 빨리 닳는 게 정상인가요?
A: 가격표가 바뀌지 않았어도 체감은 달라질 수 있어요. 4.7은 토크나이저가 바뀌어서 같은 텍스트에 더 많은 토큰이 들어갈 수 있거든요. xhigh까지 겹치면 한도 경고가 빨리 뜨는 게 이상한 일만은 아니에요. /usage 분석으로 어디서 새는지 잡는 방법은 Claude Code 비용 절감: /usage 분석으로 월 사용료 절반 줄이기에 따로 정리했어요.
Q4: prefill 400 에러는 왜 나나요?
A: 4.7에선 assistant prefill, 그러니까 응답 앞부분을 미리 넣어두는 방식이 막혀 있어요. system prompt로 형식을 강하게 지시하거나 output_config.format으로 바꾸는 쪽이 맞아요.
Q5: Bedrock나 Vertex AI에서도 opus만 쓰면 4.7이 되나요?
A: 그건 조심해야 해요. 2026년 4월 18일 기준 Claude Code 문서에선 Anthropic API 쪽 opus는 4.7을 가리키지만, Bedrock·Vertex·Foundry에선 전체 모델명으로 고정하라고 안내하고 있어요. 헷갈리면 claude-opus-4-7을 그대로 쓰세요.
다음 단계
오늘은 먼저 claude --model claude-opus-4-7 세션 하나 열고, 같은 문제를 /effort xhigh와 high로 각각 한 번씩만 돌려보세요. 자동화까지 바로 붙일 생각이면 Claude Agent SDK 사용법: 커스텀 에이전트 빌드 실전 가이드로 이어가면 돼요.
