Claude Code로 작업하는 개발자는 결국 비용이나 사용량 제약에 부딫히게 됩니다. 그럼에도 개발자는 모델 지능의 최전선에서 작업하고 싶어 하며, 흔히 사용 가능한 가장 강력한 모델을 기본으로 선택합니다.
어떤 모델을 사용하든, 비용과 토큰 사용량을 조절하는 또 다른 중요한 다이얼은 effort 수준입니다. effort를 작업의 복잡도에 맞추세요. 그렇게 하지 않으면 어느 방향으로든 비용이 발생합니다.
Effort는 모델이 아는 것을 바꾸지 않습니다
Effort는 모델이 프롬프트의 작업에 얼마나 많은 리소스를 투입할지 알려줍니다. effort를 가장 낮은 수준으로 설정하면, 모델은 가능한 적은 리소스로 프롬프트의 목표를 달성하려고 시도합니다: 더 적은 도구 호출, 더 적은 토큰, 전반적으로 더 적은 작업량입니다. effort를 최대로 설정하면, 모델에게 프롬프트의 목표를 완수하는 데 필요한 만큼 리소스를 사용할 수 있고 사용해야 한다는 신호를 보내는 것입니다.
Effort는 모델이 얼마나 열심히 작업하는지를 설정하는 것이며, 얼마나 많이 아는지를 설정하는 것이 아닙니다. 선택한 모델이 작업할 수 있는 역량 수준을 결정합니다. Effort는 그 모델이 얼마나 열심히 작업하기를 원하는지에 대한 신호입니다.
Effort를 변경해야 할 때
작업에 비해 effort가 너무 낮으면, 모델은 일찍 멈추고 미완성된 작업을 가지고 돌아올 가능성이 높습니다. 이는 요청한 작업이 허용한 effort보다 더 복잡하다는 신호입니다. 그러면 모델이 어디서 멈췄는지 파악하고 계속하도록 다시 프롬프트를 작성해야 합니다. 결국 이는 effort 수준을 올바르게 설정했을 때보다 더 많은 비용이 들 수 있습니다.
effort가 너무 높으면, 모든 프롬프트나 모든 작업에서 이를 알아차리지 못할 수도 있습니다: 모델은 필요 이상으로 많은 토큰을 사용하고, 응답 시간이 더 길어지며, 과도하게 생각하는 패턴이나 실제로 할당한 것보다 더 많은 작업을 식별하는 패턴을 발견하게 됩니다. "내가 설명하는 것은 정말 복잡하고 어렵다"는 신호를 보내는 것이며, 모델은 그 신호에 맞춰 작업을 그만큼 복잡한 것으로 취급합니다.
기본값은 중간에 위치하며, 이는 임의로 정해진 것이 아닙니다: 대부분의 작업이 과도한 지출 없이 완료되는 수준으로 각 모델에 맞춰 조정되어 있습니다. 그래서 기본값이 시작하기에 적절한 지점인 것입니다.
간단하다고 알고 있고 시간, 턴, 도구 호출, 문서 읽기 등 리소스를 크게 소비할 필요가 없는 작업에는 effort를 낮춥니다. 이미 이런 유형의 작업을 기본 수준에서 실행해 본 적이 있다면, 한 단계 낮춰서 실행해 보고 품질에 차이가 있는지 확인하세요. 차이가 없다면, 차이가 느껴질 때까지 한 단계씩 계속 낮추세요.
오랜 시간이 걸리고 많은 턴과 재확인이 필요한 작업을 설명하고 있다는 것을 알고 있을 때는 기본값에서 effort를 올립니다. effort를 올려야 하는 또 다른 경우는 작업을 직접 빠르게 확인할 수 없어서, 모델이 작업하는 동안 더 많은 자체 확인을 원할 때입니다. 이 방향에서도 같은 규칙이 적용됩니다: 한 단계 올리고, 다시 실행하고, 생각한 대로 작업을 완료하기 시작하면 멈추세요.
어떤 다이얼을 조정해야 할까요: effort인가 모델인가?
effort를 더 높여도 문제가 해결되지 않을 때만 모델을 변경하세요. 모델이 충분히 알지 못했던 것인가요, 아니면 충분히 열심히 시도하지 않았던 것인가요? 충분히 알고 있었지만 충분히 열심히 시도하지 않았다면, effort를 변경하세요. 충분히 알고 있었지만 너무 열심히 작업했다면, 그것도 effort 문제입니다. effort를 변경해도 해결되지 않고 가장 강력한 모델을 사용하고 있지 않다면, 선택한 모델이 해당 작업에 필요한 지식이 없거나 충분히 역량이 없다는 신호입니다.
모델을 변경할 때는 다시 기본값에서 시작하세요
수준 이름은 모든 모델에서 동일하지만, 같은 수준이라도 다른 모델에서는 같은 양의 작업을 의미하지 않습니다.
모델을 선택할 때마다 effort를 기본값에서 시작하고 필요에 따라 올리거나 내리세요. 예를 들어, 더 적은 비용으로 작업을 처리할 수 있는지 확인하기 위해 사용 가능한 가장 낮은 역량의 모델로 어려운 작업을 시도한다고 가정해 봅시다. effort를 가능한 최대로 올린 후에도 모델이 필요한 품질 수준으로 작업을 완료하지 못한다면, 더 상위 모델로 올라갑니다. effort를 최대로 남겨두지 말고, 다시 기본값에서 시도하세요. 더 강력한 모델은 더 적은 effort로도 작업을 완료할 수 있습니다.
이미 사용 중인 모델의 새 버전을 포함해 새로운 모델이 나올 때마다, 지금까지 해왔던 작업을 다시 살펴보세요. 더 강력한 모델로 더 낮은 effort에서 동일한 결과를 얻을 수 있는지 확인하면, 해당 작업의 비용을 줄일 수 있을 것입니다.
Effort 수준 설정하기
다음 방법 중 어느 것으로든 effort를 변경할 수 있습니다:
이 세션에만 적용:
--effort플래그: Claude Code를 실행할 때 수준 이름을 전달합니다
이번 세션과 이후 세션에 적용:
/effort: 인자 없이/effort를 실행하면 대화형 슬라이더가 열리고, 수준 이름을 붙여/effort를 실행하면 직접 설정할 수 있으며,/effort auto를 실행하면 모델 기본값으로 재설정됩니다/model에서: 모델을 선택하는 동안 왼쪽/오른쪽 화살표 키를 사용해 effort 슬라이더를 조정합니다- 설정: 설정 파일에서
effortLevel을low,medium,high,xhigh중 하나로 설정합니다 - 환경 변수:
CLAUDE_CODE_EFFORT_LEVEL을 수준 이름 또는auto로 설정합니다
하나의 스킬 또는 서브에이전트에만 적용:
- 스킬 및 서브에이전트 프런트매터: 스킬 또는 서브에이전트 마크다운 파일에서
effort를 설정하면 실행 중 effort 수준을 재정의합니다
/effort로 설정한 수준은 다음 세션까지 유지되므로, 한 번의 실행에만 적용할 수준을 원한다면 --effort 플래그를 사용하세요. Max는 충분히 많은 리소스를 사용하기 때문에, 환경 변수를 통해 설정하지 않는 한 Claude Code는 이를 세션 전용으로 처리하므로 실수로 계속 켜둘 수 없습니다.
Ultracode는 effort 수준이 아닙니다. 이는 모델을 xhigh로 실행하는 세션 전용 Claude Code 설정이며, 실질적인 작업의 경우 Claude가 동적 워크플로(새 탭에서 열림)를 오케스트레이션하여 여러 에이전트에 작업을 분산시키도록 합니다.
여러 방법으로 effort를 설정한 경우, 아래 순서에서 가장 위에 있는 방법이 우선합니다.
위에서 우선하는 방법이 무엇이든, 조직에서 이를 제한할 수 있습니다. Enterprise 플랜에서는 관리자가 모델별 최대 effort 수준(새 탭에서 열림)을 설정할 수 있습니다. 제한을 초과하는 수준은 /effort 선택기에 표시되지 않으며, /effort 또는 --effort로 해당 수준을 요청하면 Claude Code는 제한 수준에서 실행하고 그 사실을 알려줍니다.
실제 예시
동일한 프롬프트를 하나의 모델에서 low, 기본값, max로 세 번 실행합니다: 각 수준을 재생해 보면서 동일한 결과에 얼마나 많은 작업이 들어가는지 확인하세요. 이 프롬프트는 샘플 파일로 테스트하는 작은 CSV-to-JSON 스크립트를 요청하며, effort 수준 간 차이가 드러날 여지를 주기 위해 의도적으로 단순하게 만들었습니다.
직접 환경에서 시도해 보기
세 개의 별도 세션을 사용합니다. 각 세션에서 동일한 네 단계를 수행하세요. /usage는 현재 있는 세션만 보고하므로, 비교는 직접 조합해야 합니다. 각 실행이 끝날 때 확인하고, 해당 세션에 대해 보고된 토큰 수를 기록한 다음, 종료하고 다음 실행을 새로 시작하세요.
1. 해당 실행의 수준으로, 자체 빈 폴더에서 새 세션을 시작합니다
# 저장소 외부의 빈 폴더에서
# 실행 1 · 낮음
mkdir effort-low && cd effort-low && claude --effort low
# 실행 2 · 기본값
cd .. && mkdir effort-default && cd effort-default && claude
# 그런 다음 /effort auto 실행
# 실행 3 · 최대
cd .. && mkdir effort-max && cd effort-max && claude --effort max/effort로 설정하면 low부터 xhigh까지 다음 세션까지 유지되므로, 플래그(또는 /effort auto)를 사용하면 각 실행이 자체 수준에서 시작됩니다.
2. 동일한 프롬프트를 붙여넣습니다
CSV 파일을 JSON으로 변환하는 스크립트를 작성하세요. 이 폴더에 csv_to_json.py로 저장하세요. sample.csv로 저장된 이 CSV 파일로 테스트하세요:
name,team,start_date
Priya,Payments,2024-03-18
Marcus,Platform,2023-11-02
Lena,Support,2025-01-273. Claude가 작업을 다시 넘겨주면, 이 세션에서 사용한 내용을 확인합니다
/usage세션의 총 토큰 수를 확인하세요. 화면의 나머지 부분은 플랜에 따라 다릅니다.
4. 종료한 다음, 다음 수준을 위해 1단계로 돌아갑니다
/exit세 개의 토큰 수는 low에서 max로 올라가야 하며, 세 폴더 모두 작동하는 변환기를 가지고 있어야 합니다. 세 스크립트를 나란히 열어 보세요: 얼마나 많이 만들어졌는지의 차이가 바로 지불한 비용의 차이입니다.
유지해야 할 습관
effort를 관리하는 것은 하나의 습관으로 귀결됩니다: 기본값에서 시작하고, 돌아오는 결과를 지켜보고, 한 번에 한 단계씩 조정하세요. 이 루프를 계속 유지하면 작업에 어떤 수준이 필요한지 알게 되고, 동료나 관리자에게 그 이유를 설명할 수 있게 됩니다.
더 알아보기
- Claude Code에서 Claude 모델과 effort 수준 선택하기(새 탭에서 열림): Claude Code 팀이 설명하는 모델 선택과 effort의 개념입니다.
- 모델 구성(새 탭에서 열림):
/effort, 설정, 우선순위, 조직 제한에 대한 전체 참조입니다. - Claude Code에서 가치 극대화하기(새 탭에서 열림): Claude Code 팀이 진행한, 세션의 토큰이 어디로 가는지, 적절한 모델과 effort 수준을 선택하는 방법, CLAUDE.md와 MCP 서버가 매 턴마다 추가하는 것이 무엇인지에 대한 녹화된 웨비나입니다.
- 비용과 지능 최적화하기(새 탭에서 열림): Claude Platform 문서에서 제공하는, effort, 프롬프트 캐싱, 모델 선택에 대한 측정 결과를 작업당 비용으로 비교한 내용입니다.
- Claude API에서 비용 최적화하기(새 탭에서 열림): Claude Cookbook에서 제공하는, Platform 빌더를 위해 작동하는 에이전트에 한 번에 하나씩 적용한 비용 절감 방법입니다.