클로드 코드 노력 수준 — 오퍼스 5.5 중간 시작 이유와 조직 상한

오퍼스 5로 쓸 때 노력 수준을 높음으로 저장해 뒀는데 오퍼스 5.5로 바꾸니 중간으로 떠 있다면, 설정이 날아간 게 아닙니다. 오퍼스 5.5는 예전 방식으로 저장한 값을 보지 않습니다.

오퍼스 5.5 출시 소식을 전할 때는 값과 캐시 이야기에 집중했는데, 클로드 코드 쪽에서 체감이 큰 변화는 노력 수준입니다. 모델 설정 문서의 노력 수준 절을 다시 읽어 보니 오퍼스 5.5의 기본값, 노력 수준이 정해지는 순서, 모델별로 따로 저장되는 방식, 그리고 기업 요금제에서 역할별로 거는 상한까지 한 번에 정리돼 있었습니다. 노력 수준 상한 설정을 다룬 글의 뒷이야기이기도 합니다.

짧게 정리하면

• 노력을 지원하는 모델은 대부분 기본값이 높음인데, 오퍼스 5.5는 중간, 오퍼스 4.7은 매우 높음이 기본입니다.
• 사용자 설정 파일 맨 위에 적힌 옛 방식의 노력 값은 오퍼스 5.5와 그 이후 모델에는 적용되지 않고, 이제 노력 수준은 모델별로 따로 저장됩니다.
• 기업 요금제는 역할마다 모델별 노력 상한을 걸 수 있고, 어느 요금제든 관리 설정의 노력 상한과 겹치면 둘 중 낮은 쪽이 적용됩니다.

클로드 코드 공식 모델 설정 문서의 노력 수준 조정, 노력 수준 고르기, 노력 수준 설정, 조직 노력 상한 절을 대조했습니다. 노력 수준 이름은 낮음·중간·높음·매우 높음·최대로 옮겨 적었습니다.

오퍼스 5.5는 한 칸 낮게 시작합니다

노력 수준은 모델이 단계마다 생각을 할지, 얼마나 할지를 스스로 정하는 적응형 추론을 조절합니다. 낮출수록 빠르고 싸며, 높일수록 복잡한 문제에서 깊이 생각합니다. 문서에 따르면 오퍼스 5.5의 기본값은 오퍼스 5의 기본값인 높음보다 한 칸 낮은 중간입니다. 앤트로픽 자체 시험에서 중간의 오퍼스 5.5가 코딩과 지식 작업 평가에서 높음의 오퍼스 5와 같거나 앞섰고, 같은 수준에서 오퍼스 5.5가 차례마다 더 많이 생각하는 경향이 있다는 설명이 붙어 있습니다. 그래서 오퍼스 5에서 옮겨 올 때는 쓰던 수준을 그대로 가져오지 말고 중간에서 시작하라고 권합니다.

노력 척도는 모델마다 따로 맞춰져 있어서 같은 이름이라도 모델이 다르면 실제 값이 같지 않다는 점도 문서가 짚습니다. 모델마다 쓸 수 있는 수준도 다릅니다. 페이블 5.1·페이블 5, 오퍼스 5.5·오퍼스 5·소넷 5·오퍼스 4.8·오퍼스 4.7은 다섯 단계를 모두 쓰고, 오퍼스 4.6과 소넷 4.6에는 매우 높음이 없습니다. 지원하지 않는 수준을 고르면 그 아래에서 지원하는 가장 높은 수준으로 돕니다.

모델 설정 문서 기준, 세션의 노력 수준이 정해지는 순서

순서	어디서 정하나
첫째, 명시적 선택	노력 환경 변수, 시작 옵션, 세션 안의 노력 명령
둘째, 설정	그 모델용으로 저장한 수준, 또는 노력 설정 키
셋째, 모델 기본값	대부분 높음, 오퍼스 5.5는 중간, 오퍼스 4.7은 매우 높음, 조직 기본 모델에 조직이 정한 기본 노력이 있으면 그 값

이 순서는 초고강도 작업 모드 설정이 꺼져 있을 때 기준입니다. 셋째 줄의 조직 기본 노력은 관리자가 정하는 조직 기본 모델을 쓸 때에만 해당합니다.

사용자 설정 맨 위의 노력 값은 오퍼스 5.5에 적용되지 않습니다. 그 값은 노력 명령이 모델별 저장을 하기 전에 쓰던 옛 방식이라, 오퍼스 5·페이블 5.1과 그 이전 모델에는 계속 적용되지만 오퍼스 5.5와 이후 모델은 자기 기본값에서 시작합니다. 노력 명령이나 모델 선택 창에서 오퍼스 5.5용 수준을 한 번 골라야 저장됩니다. 반대로 프로젝트·로컬·관리 설정이나 시작 시 넘긴 설정에 적힌 노력 값은 모든 모델에 적용됩니다. 같은 키라도 어느 파일에 있느냐에 따라 오퍼스 5.5에 먹고 안 먹는 셈입니다.

저장과 이번 세션만의 차이

내 컴퓨터의 대화형 세션에서 낮음·중간·높음·매우 높음을 고를 때는 확인 방식으로 유지 기간이 갈립니다. 노력 슬라이더나 모델 선택 창에서 엔터를 누르거나 노력 명령 뒤에 수준을 직접 적으면 기본값으로 저장돼 다음 세션에도 적용되고, 이번 세션만 적용 키를 누르면 그 세션에만 적용됩니다. 이번 세션만 적용은 2.1.257판부터입니다. 저장은 사용자 설정의 모델별 설정 칸에 모델마다 따로 됩니다.

최대는 가장 깊은 수준인데, 환경 변수로 정하지 않는 한 그 세션에만 적용됩니다. 문서는 최대가 까다로운 작업에서 성능을 높일 수 있지만 효과가 줄어들 수 있고 지나치게 생각하기 쉬우니, 넓게 쓰기 전에 시험해 보라고 적었습니다. 명령줄 한 번 실행에서 노력 명령을 쓰면 그 세션에만 적용되고 기본값으로 저장하지 않습니다. 노력 수준을 바꾸지 않고 한 번만 깊게 생각시키고 싶다면 그 차례에만 쓰는 키워드가 따로 있습니다.

조직이 거는 상한 두 가지

조직이 노력 수준을 제한하는 방법은 둘입니다. 둘 다 한 모델에 걸리면 낮은 쪽 상한이 적용됩니다.

조직 노력 상한 절 기준, 두 상한 비교

항목	역할별 상한	관리 설정의 노력 상한
쓸 수 있는 곳	클로드 기업 요금제	모든 요금제, 외부 클라우드 사업자 포함
어디서 거나	조직 관리자가 사용자 지정 역할마다 모델별로	클라이언트 쪽 관리 설정
역할이 여럿이면	같은 모델을 준 역할 중 가장 느슨한 상한	해당 없음
필요한 판	2.1.195 이상	이 절에는 표기 없음

역할별 상한이 걸리면 상한보다 높은 수준은 노력 명령의 선택지에서 빠지고, 시작 옵션이나 노력 명령으로 더 높은 수준을 적어도 상한에서 돕니다. 대화형 세션과 일반 텍스트 출력의 명령줄 실행에서는 요청한 수준과 적용된 수준을 알려 주는 경고가 뜨지만, 구조화된 출력 형식이나 백그라운드 에이전트에서는 조용히 깎입니다. 상한은 모델마다 걸리므로 모델을 바꾸면 고를 수 있는 수준도 달라집니다. 이 상한은 조직 모델 제한과 함께 전달되고 같은 세션에 닿습니다.

스킬이나 하위 에이전트 정의에 노력 수준을 적어 두면 그게 돌 때 세션 수준을 덮어쓰지만, 두 상한은 여전히 그 위를 막습니다. 관리 설정에 노력 값 자체를 넣는 건 설정 단계의 기본값일 뿐이라 사용자가 노력 명령이나 시작 옵션으로 바꿀 수 있습니다. 그 이하로 묶으려면 상한 설정을 써야 합니다. 초고강도 작업 모드는 매우 높음이 필요해서, 매우 높음보다 낮은 상한이 걸린 모델에서는 쓸 수 없습니다.

9월 28일 나온 소넷 5.5도 같은 구조입니다. 클로드 코드와 앱에서는 중간이 기본이고, 에이피아이를 직접 쓰면 높음이 기본입니다. 개발 문서는 소넷 5.5의 노력 수준을 다시 맞췄으니 소넷 5에서 쓰던 값을 그대로 가져오지 말고 다시 재 보라고 권합니다. 소넷 5.5 가격·성능과 옮길 때 깨지는 자리를 정리했습니다.

노력 수준을 낮추는 것 말고 추론을 줄이는 다른 길도 나왔습니다. 파이어웍스는 키미 K3의 노력 수준을 낮추면 품질이 너무 떨어져, 아예 효율적으로 생각하도록 다시 학습시킨 엠버-1을 내놨고 토큰을 약 40% 덜 쓴다고 밝혔습니다. 엠버-1의 절감 주장과 연구 미리보기 조건을 정리했습니다.

자주 묻는 질문

지금 세션이 어떤 노력 수준인지 어디서 보나요

세션 머리 부분의 모델 이름 옆에 표시되고, 시작할 때와 바뀔 때 아래쪽에도 잠깐 나타납니다.

저장해 둔 노력 수준을 지우려면요

노력 명령 뒤에 자동을 붙이면 지금 모델에 저장된 수준이 지워지고 기본값을 따릅니다.

설정 파일에 최대를 적어 두면 되나요

모델별 설정 칸과 노력 설정 키 모두 최대를 받지 않습니다. 최대를 계속 쓰려면 환경 변수로 정해야 합니다.

작업 도중에 노력 수준을 바꿔도 되나요

됩니다. 클로드가 일하는 중에도 노력 명령을 쓸 수 있고, 캐시 경고가 뜨면 확인한 뒤 그 차례의 다음 요청부터 새 수준이 적용됩니다.

오퍼스 5.5로 옮긴 뒤 답이 얕아졌다고 느끼면 바로 노력을 올리고 싶어지는데, 문서의 권고는 반대 방향입니다. 중간에서 먼저 써 보고, 부족한 작업에서만 한 칸씩 올리는 쪽입니다. 저라면 오퍼스 5 시절에 사용자 설정 맨 위에 적어 둔 노력 값이 있는지부터 확인하겠습니다. 그 값이 오퍼스 5.5에는 적용되지 않는다는 걸 모르면, 왜 설정대로 안 도는지 한참 헤맬 수 있습니다.

확인한 곳: 클로드 코드 공식 모델 설정 문서(노력 수준 조정, 노력 수준 고르기, 한 차례 깊은 추론, 노력 수준 설정, 조직 노력 상한). 2026년 9월 28일 기준이며 모델별 기본값은 판에 따라 바뀔 수 있습니다.