Cmd. /fast
Opus fast mode를 켜고 끄는 속도 우선 명령 (research preview)
핵심 요약
- fast mode 전환
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
fast mode 전환
/fast [on|off]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/fast토글 방식은 두 가지입니다.
# /fast 입력 후 Tab으로 on/off 토글
/fast# 인자로 명시적 지정
/fast on
/fast off사용자 설정 파일에서 "fastMode": true로 켤 수도 있습니다.
{
"fastMode": true
}켜지면 다음이 표시됩니다.
- 다른 모델을 쓰고 있었다면 자동으로 Opus로 전환됩니다.
- "Fast mode ON" 확인 메시지가 뜹니다.
- fast mode가 활성화된 동안 프롬프트 옆에 작은
↯아이콘이 나타납니다. /fast를 다시 실행하면 현재 on/off 상태를 확인하거나 끌 수 있습니다.
/fast로 꺼도 모델은 Opus로 유지됩니다. 이전 모델로 되돌아가지 않으니 다른 모델을 쓰려면
/model을 사용하세요.
fast mode 설정은 기본적으로 세션 간에 유지됩니다. 관리자가 세션마다 초기화되도록 설정할 수도 있습니다.
선택 시점
응답 지연이 비용보다 더 중요한 인터랙티브 작업에 적합합니다.
- 코드 변경의 빠른 반복(rapid iteration)
- 라이브 디버깅 세션
- 마감이 촉박한 시간 민감 작업
- 낮은 effort와 결합해 단순 작업을 최대 속도로 처리할 때
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/fast | 같은 품질의 Opus를 더 낮은 지연으로 | 지연 시간이 비용보다 중요할 때 |
/effort | 사고 시간(thinking) 조절 → 속도/품질 | 복잡도와 품질 균형 조정 |
/model | 모델 자체 전환 | 모델/공급자 정책 변경 |
/usage | 사용량·비용 확인 (/cost 별칭) | fast mode 비용 영향 점검 |
fast mode와 effort level은 둘 다 속도에 영향을 주지만 방식이 다릅니다. fast mode는 모델 품질은 그대로 두고 지연만 낮추는 대신 비용을 올립니다. effort를 낮추면 thinking 시간이 줄어 더 빨라지지만 복잡한 작업에서는 품질이 떨어질 수 있습니다. 둘을 같이 쓰면 단순 작업의 속도를 극대화할 수 있습니다.
실행 결과와 유지 범위
지원되는 모델의 빠른 처리 경로를 전환합니다. 추론 강도를 낮추는 설정과는 별개이며 요금·할당량도 확인해야 합니다.
/fast는 fast mode를 켜고 끄는 명령입니다.
공식 명령어 표의 설명은 "Toggle fast mode on or off"입니다.
fast mode는 Claude Opus가 더 빠르게 응답하도록 구성한 고속 설정입니다. 토큰당 비용은 더 비싸지만 모델이 최대 2.5배 빨라집니다. 별도 모델이 아니라 같은 Opus를 속도 우선 API 설정으로 돌리는 것이라, 품질과 기능은 표준 모드와 똑같습니다.
- fast mode는 현재 Opus 5 · Opus 4.8에서 지원되며, Sonnet · Haiku 등 다른
모델에서는 사용할 수 없습니다. 2026-09-01 출시된 Fable 5.1도 Fable 5와 마찬가지로 fast mode
지원 대상이 아닙니다. Fable 계열에서
/fast를 켜면 Opus로 전환됩니다. - Opus 4.7 fast mode는 2026-06-25 deprecated, 2026-07-24 제거됐습니다. Opus 4.7로 전환하면 fast mode가 꺼집니다.
- 아직 research preview 기능입니다. 기능·가격·제공 범위가 피드백에 따라 바뀝니다.
- CLI에서는
/fast로 토글하고, VS Code 확장은fastMode설정을 따르며 선택 모델이 지원할 때 Toggle fast mode 명령을 제공합니다.
Remote 세션
cloud·self-hosted runner의 Claude Code Remote 세션에서도 host의 fast-mode 설정 또는 /fast를 적용합니다. 조직에서 허용하는 경우에만 사용할 수 있습니다.
비용·요금 (research preview)
fast mode는 표준 Opus보다 토큰당 단가가 높으며, 배수는 모델에 따라 다릅니다.
| 모델 | 입력 (MTok) | 출력 (MTok) |
|---|---|---|
| Opus 5 | $10 | $50 |
| Opus 4.8 | $10 | $50 |
- fast mode 단가는 1M 토큰 전체 컨텍스트 구간에서 동일하게(flat) 적용됩니다.
- 대화 중간에 fast mode로 전환하면 그 시점까지의 전체 컨텍스트 입력 토큰이 fast mode 비캐시 단가로 다시 과금됩니다. 세션 초반에 켜는 편이 비용 면에서 유리합니다.
- 표준 Opus 단가와 비교하려면 Claude 가격 안내를 참고하세요.
주의사항
- 공급자 제약: fast mode는 Anthropic Console API와 구독 플랜(usage credits)에서만 사용할 수 있습니다. Amazon Bedrock · Google Vertex AI · Microsoft Azure Foundry · Claude Platform on AWS에서는 사용할 수 없습니다.
- usage credits 필요: 계정에 usage credits(플랜 포함량 초과 과금 허용)가 켜져 있어야 합니다. 구독 플랜(Pro/Max/Team/Enterprise)에서도 fast mode 사용량은 플랜에 남은 사용량과 무관하게 첫 토큰부터 usage credits에서 직접 차감됩니다.
- Team/Enterprise: 기본적으로 비활성화되어 있어 관리자가 명시적으로 켜야 합니다.
관리자가 켜지 않았다면
/fast실행 시 "Fast mode has been disabled by your organization"이 표시됩니다. - 세션별 opt-in: 관리자가 managed settings에서
fastModePerSessionOptIn을true로 설정하면 각 세션이 fast mode 꺼진 상태로 시작합니다. - fast mode 완전 비활성화:
CLAUDE_CODE_DISABLE_FAST_MODE=1환경 변수로 끌 수 있습니다. - 이전 모델 정리: v2.1.219에서 Opus 4.7은 fast mode 지원 대상에서 제거됐습니다. 현재 운영 문서는 Opus 5 또는 Opus 4.8을 기준으로 삼으세요.
- 모델 전환 연동: fast mode를 지원하지 않는 모델(Fable 5.1·Fable 5·Sonnet·Haiku·Opus 4.7)로 바꾸면 fast mode가 자동으로 꺼지고, 지원 Opus로 돌아오면 저장된 선호가 on일 때 다시 켜집니다.
fastModePerSessionOptIn이 켜져 있으면 되돌아와도 자동으로 켜지지 않습니다. - 비대화형(
-p):--settings '{"fastMode": true}'로 시작한 세션에서만/fast가 동작하며 그 세션에만 적용됩니다. - rate limit: fast mode는 표준 Opus와 별도의 rate limit pool을 가집니다. 한도에 도달하거나 usage credits가 소진되면 자동으로 표준
속도·표준 가격으로 폴백되고
↯아이콘이 회색으로 바뀝니다. 쿨다운이 끝나면 자동 재활성화됩니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록