Claude Opus 4.7과 Claude Code 사용을 위한 모범 사례

Anthropic은 Claude Code 환경에서 Claude Opus 4.7 모델을 최대한 활용하기 위한 모범 사례와 이전 버전(4.6) 대비 주요 동작 변화를 공유합니다.

1. 대화형 코딩 세션 구성하기 (Structuring interactive coding sessions)

• 첫 번째 턴에서 작업을 명확히 지정하세요: 의도(intent), 제약 조건, 승인 기준(acceptance criteria), 관련 파일 위치를 포함하여 작업을 처음부터 잘 정의하면 Opus 4.7이 더 강력한 결과물을 내는 데 필요한 컨텍스트를 얻을 수 있습니다. 여러 턴에 걸쳐 점진적으로 전달되는 모호한 프롬프트는 토큰 효율성을 떨어뜨리고 전반적인 품질을 저하시키는 경향이 있습니다.
• 불필요한 상호 작용 횟수를 줄이세요: 사용자의 턴이 추가될 때마다 추론 오버헤드가 발생합니다. 질문과 요청을 일괄적으로 묶어서 모델이 작업을 멈추지 않고 계속 진행할 수 있도록 필요한 컨텍스트를 한 번에 제공하세요.
• 적절할 때 자동(Auto) 모드를 사용하세요: 모델이 지속적인 확인 없이 안전하게 실행할 수 있다고 신뢰하는 작업의 경우, 자동 모드를 사용하면 작업 주기를 크게 단축할 수 있습니다. 특히 초기 컨텍스트를 충분히 제공한 장기 실행(long-running) 작업에 매우 적합합니다. (자동 모드는 현재 Claude Code Max 사용자를 위한 연구 프리뷰로 제공되며 Shift+Tab을 사용하여 켜고 끌 수 있습니다.)
• 작업 완료 알림을 설정하세요: 작업이 끝났을 때 소리를 재생하도록 Claude에게 요청하면, Claude가 자체적인 훅(hook) 기반 알림을 생성할 수 있습니다.

2. Opus 4.7의 권장 노력(Effort) 설정

• Claude Code에서 Opus 4.7의 기본 노력(Effort) 수준은 이제 xhigh**입니다. 이는 high와 max 사이의 새로운 수준으로, 어려운 문제를 해결할 때 추론의 깊이와 대기 시간(latency) 사이의 균형을 사용자가 더 잘 제어할 수 있게 해줍니다.

3. 적응형 사고(Adaptive thinking) 활용하기

• **고정된 예산을 사용하는 ‘확장된 사고(Extended Thinking)‘는 Opus 4.7에서 지원되지 않습니다. 대신 Opus 4.7은 적응형 사고(Adaptive thinking)**를 제공합니다.
• 이를 통해 각 단계에서 사고 과정을 선택적으로 사용할 수 있으며, 컨텍스트에 따라 모델이 언제 더 많은 사고를 할지 스스로 결정합니다. 단순한 질문에는 빠르게 응답하고, 생각하는 것이 크게 도움 되지 않는 단계는 건너뛰며, 가장 유용할 만한 곳에 사고 토큰을 집중적으로 투자합니다. 결과적으로 에이전트 실행 과정 전반에 걸쳐 더 빠른 응답과 향상된 사용자 경험을 제공합니다.
• 적응형 사고는 특히 ‘과도한 생각(overthinking)‘을 방지하도록 개선되었습니다. 사고의 깊이나 속도를 제어하고 싶다면 예산 설정 대신 “신중하게 단계별로 생각하세요” 또는 “깊이보다 속도를 우선시하세요”와 같이 자연어로 프롬프트에 직접 지시하세요.

4. 알아두어야 할 주요 동작 변화 (Opus 4.6 대비)

• **응답 길이는 작업 복잡성에 맞춰 조정됩니다: Opus 4.7은 이전 모델처럼 기본적으로 장황하지 않습니다. 단순한 코드 조회에는 더 짧은 답변을, 개방형 분석에는 긴 답변을 제공합니다. 특정 길이나 상세한 스타일의 답변이 필요하다면 프롬프트에 이를 명시적으로 요청해야 합니다. (“~하지 마세요”라는 부정적 지시보다 원하는 톤의 긍정적인 예시를 제공하는 것이 좋습니다.)
• 도구(Tools)를 덜 호출하고 추론을 더 많이 합니다: 기본적으로 도구 사용을 줄이고 내장된 추론을 더 많이 활용하며, 이는 대부분의 경우 더 나은 결과를 만듭니다. 만약 에이전트 작업 중 적극적인 검색(grep)이나 광범위한 파일 읽기와 같은 도구 사용을 원한다면, 언제 왜 도구를 사용해야 하는지 명시적으로 지시하세요.
• 하위 에이전트(Subagents) 생성이 더 신중해졌습니다: Opus 4.7은 하위 에이전트에게 작업을 위임할 시기를 더 엄격하게 결정합니다. 여러 파일에 걸쳐 작업을 분산하거나 독립적인 항목을 병렬로 처리할 때 하위 에이전트 생성이 필요하다면 프롬프트에 명시적으로 요구해야 합니다. (예: “항목들을 분산 처리할 때 여러 하위 에이전트를 생성하세요.“)
• 지시사항을 문자 그대로 따릅니다: 프롬프트를 훨씬 더 문자 그대로 명시적으로 해석합니다. 한 항목의 지시를 다른 항목으로 임의로 일반화하거나, 사용자가 요청하지 않은 내용을 스스로 추론하여 실행하지 않습니다.

5. 시작하기 위한 팁 (What to try next)

가장 권장되는 시작 방법은 기본 설정인 xhigh를 유지하고, 첫 번째 대화 턴에 프로젝트의 컨텍스트와 목표를 한 번에 명확하게 설명한 뒤, Opus 4.7이 그 초기 프롬프트만으로 얼마나 작업을 잘 주도해 나가는지 관찰하는 것입니다.

출처: https://claude.com/blog/best-practices-for-using-claude-opus-4-7-with-claude-code