Cmd. /usage-credits
사용량 한도 도달 후 작업을 이어가기 위한 usage credits 설정 명령 (구 /extra-usage)
핵심 요약
/usage-credits는 사용량 한도에 도달했을 때 작업을 이어가도록 usage credits를 설정하는 명령입니다.- 이전 이름은
/extra-usage이며, 현재 공식 표에는/usage-credits항목만 있고 끝에Previously /extra-usage로 표기됩니다. - 같은 크레딧 체계가
/ultrareview(/code-review ultra)의 무료 횟수를 다 쓴 뒤 추가 실행에도 쓰입니다. - 인자·별칭이 없는 일반 내장 명령이고, 노출 여부는 버전보다 플랜·플랫폼·환경에 달려 있습니다.
명령어 원본 선언
/usage-credits이 명령은 이전에 **
/extra-usage**라는 이름이었습니다. 현재 공식 명령 참조 표에는/usage-credits항목만 존재하며, 그 설명 끝에Previously /extra-usage라고 명시되어 있습니다. 새 문서·자동화·온보딩 자료에서는/usage-credits를 사용하세요.
공식 설명 요약
공식 명령 참조의 /usage-credits 설명 원문은 다음과 같습니다.
Configure usage credits to keep working when you hit a limit. Previously
/extra-usage
사용량 한도(limit)에 걸렸을 때 작업을 계속하도록 사용량 크레딧(usage credits)을 설정하는
명령입니다. /extra-usage는 이 명령의 옛 이름이고, 지금 문서에서는 /usage-credits 하나로
합쳐졌습니다. 그래서 /extra-usage는 더 이상 별도 명령으로 문서화하지 않고,
옛 transcript·문서와의 호환을 위한 legacy 명칭으로만 남겨 둡니다.
사용량 크레딧은 유료 Claude 플랜에서 한도를 넘겼을 때 추가 사용을 열어 주는 기능과 이어집니다. 같은
크레딧 체계가 /ultrareview(또는 /code-review ultra)처럼 무료 실행 횟수를 다 쓴 뒤 추가
실행에도 쓰입니다. 자세한 정책은 Anthropic 지원 문서(아래 출처 참고)에 정리돼 있습니다.
최소 지원 버전
- 공식 명령 참조 문서에는
/usage-credits(구/extra-usage)에 대한 별도의 최소 버전(min-version) 표기가 없습니다. 따라서 특정 버전을 단정하지 않습니다. (/run,/verify,/reload-skills등은 공식 표에 min-version이 명시되어 있지만 이 명령에는 그런 표기가 없습니다.) - 명령이 실제로 보이느냐는 버전보다 플랜·플랫폼·환경에 달려 있습니다. 공식 문서도 "모든 명령이 모든 사용자에게 보이는 것은 아니며, 가용성은 플랫폼·플랜·환경에 따라 달라진다"고 못박습니다.
사용법
# 현재(공식) 이름 — 인자 없음
/usage-credits
# 이전(legacy) 이름 — 동일 기능을 가리키던 구 명칭
/extra-usage- 인자(argument)는 없습니다. 입력하면 사용량 크레딧 설정 화면/흐름이 열립니다.
- 공식 표에는 별칭(alias)이 표기되어 있지 않습니다. (
/usage가/cost·/stats별칭을 갖는 것과 대조적으로,/usage-credits에는 별칭이 없습니다.) - 번들 스킬(Skill)로 표시된 명령이 아닙니다. (
/batch,/run,/verify등은 공식 표에서 Skill로 명시되지만/usage-credits는 일반 내장 명령입니다.)
좋은 사용 예
- 장기 세션 중 사용량 한도에 막혀,
/usage-credits로 크레딧을 설정해 작업을 이어가야 할 때 /usage(또는 별칭/cost·/stats)에서 남은 한도와 활동 breakdown을 확인한 뒤, 이어서 작업할지 판단할 때- 한도 초과 빈도가 높은 팀에서, 한도 도달 시 크레딧 사용 정책을 사전 합의해 두고 진입 경로로 활용할 때
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/usage-credits | 한도 도달 시 사용량 크레딧 설정 (구 /extra-usage) | 한도 도달 뒤 연속 작업 |
/usage | 세션 비용·플랜 한도·활동 통계 조회 (/cost·/stats 별칭) | 현재 사용량/한도 확인 |
/upgrade | 상위 플랜으로 전환하는 업그레이드 페이지 열기 (Pro·Max에서만 노출) | 요금제 자체를 올릴 때 |
활용 사례
- 한도 초과 대응 플레이북:
/usage로 현재 한도를 확인하고, 한도에 걸리면/usage-credits로 크레딧을 설정, 근본적으로 플랜이 부족하면/upgrade로 분기. - 이전 문서·매크로·온보딩 자료에
/extra-usage가 남아 있다면/usage-credits로 갱신. /ultrareview·/code-review ultra의 무료 실행 횟수를 다 쓴 경우에도 같은 usage credits 체계로 추가 실행이 이어지므로, 크레딧 정책을 함께 검토.
주의사항
- 이름 변경:
/extra-usage는/usage-credits로 이름이 바뀌었습니다. 공식 명령 참조에는/usage-credits항목만 존재하므로, 새 문서·자동화·온보딩 자료에서는 반드시/usage-credits를 사용하세요. - 가용성 차이: 명령 노출 범위는 플랜·플랫폼·환경에 따라 다릅니다. 사용량 크레딧 명령도 결제·플랜 상태에 따라 노출이 달라질 수 있습니다.
- 개인/팀 결제 정책과 관리자 승인 기준을 먼저 확인하세요. credits 사용은 작업 편의가 아니라 비용 정책의 일부로 문서화해 두는 편이 좋습니다.
출처
- Commands (공식 명령 참조,
/usage-credits항목): https://code.claude.com/docs/en/commands - Extra usage for paid Claude plans (지원 문서): https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans