패스트 모드로 응답 속도 올리기

패스트 모드로 응답 속도 올리기 (Speed up responses with fast mode)

패스트 모드는 Claude Opus를 위한 고속 설정으로, 모델 응답을 최대 2.5배 빠르게 만들어 주는 대신 토큰당 비용은 더 높아져요. 빠른 반복 작업이나 라이브 디버깅처럼 속도가 중요한 인터랙티브 작업이 필요할 때 /fast로 켜고, 대기 시간보다 비용이 더 중요할 때는 꺼두면 됩니다.

출처: 공식문서

본문

패스트 모드는 [research preview](#research-preview) 상태입니다. 기능·가격·가용성은 피드백에 따라 바뀔 수 있습니다.

패스트 모드는 별도의 모델이 아니에요. 속도를 비용 효율보다 우선하는 API 설정으로 Claude Opus를 사용하는 것뿐입니다. 응답이 빠르다는 점만 다르고 품질과 기능은 동일해요. 패스트 모드는 Opus 5와 Opus 4.8에서 지원되며, Sonnet·Haiku 등 다른 모델에서는 사용할 수 없습니다.

Claude Code는 패스트 모드를 지원하지 않는 모델(Opus 4.7 포함)을 일반 모델처럼 취급합니다. Opus 4.7로 전환하면 패스트 모드가 꺼집니다. Opus 4.7용 패스트 모드는 2026년 6월 25일에 폐기(deprecated)되고 2026년 7월 24일에 제거되었습니다.

알아두면 좋은 점:

• Claude Code CLI에서 /fast로 패스트 모드를 켜고 끕니다. VS Code 확장은 fastMode 설정을 따르며, 선택된 모델이 패스트 모드를 지원하면 Toggle fast mode 명령을 제공합니다.
• 패스트 모드 가격은 Opus 5와 Opus 4.8 모두 입력 MTok당 \$10, 출력 MTok당 \$50입니다.
• 구독 플랜(Pro/Max/Team/Enterprise)과 Claude Console의 Claude Code 사용자가 사용할 수 있습니다. Team·Enterprise 조직은 Owner가 먼저 활성화해야 하고, Console 조직은 Requirements에 설명된 대로 먼저 액세스가 프로비저닝되어야 합니다.
• 구독 플랜(Pro/Max/Team/Enterprise)의 Claude Code 사용자에게 패스트 모드는 usage credits로만 사용할 수 있고 구독 속도 제한에는 포함되지 않습니다.

패스트 모드 켜고 끄기

CLI에서는 다음 두 가지 방법 중 하나로 패스트 모드를 토글합니다.

• /fast를 입력하고 Tab을 눌러 켜거나 끄기
• 사용자 설정 파일에 "fastMode": true 설정

기본적으로 인터랙티브 세션에서 켠 패스트 모드는 세션을 넘어서도 유지됩니다. -p 플래그를 쓰는 비인터랙티브 모드에서는 /fast가 --settings 값에 fast mode가 포함된 세션에서만 동작합니다. 예: claude -p --settings '{"fastMode": true}'. 그러면 토글이 그 세션에만 적용되고 기본값으로 저장되지 않으며, 다른 비인터랙티브 세션에서는 패스트 모드를 사용할 수 없다는 보고가 나옵니다. 세션마다 리셋되도록 설정할 수도 있는데, 세션별 옵트인 요구에서 설명합니다.

Claude가 작업 중일 때도 /fast를 실행할 수 있고, Claude Code는 턴이 끝나기를 기다리지 않고 패스트 모드를 토글합니다. 현재 돌고 있는 턴은 원래 속도로 끝나므로, 속도 변화는 다음 턴부터 적용됩니다. 현재 모델이 패스트 모드를 지원하지 않으면 켤 때 모델도 함께 바뀌고, Claude Code는 그 턴의 다음 요청부터 새 모델을 사용합니다.

비용 효율을 가장 좋게 하려면 대화 중간에 바꾸지 말고 세션 시작 때 패스트 모드를 켜세요. 비용 트레이드오프 이해에서 자세히 다룹니다.

패스트 모드를 켜면:

• 현재 모델이 패스트 모드를 지원하지 않으면 Claude Code가 Opus로 전환
• "Fast mode ON" 확인 메시지 표시
• 패스트 모드가 활성화된 동안 프롬프트 옆에 작은 ↯ 아이콘 표시
• 언제든 /fast를 다시 실행해 패스트 모드가 켜졌는지 꺼졌는지 확인

Claude Code v2.1.219 이상에서 Opus 5가 패스트 모드 기본값입니다. v2.1.219 이전에는 v2.1.154v2.1.218에서 기본값이 Opus 4.8, v2.1.142v2.1.153에서는 Opus 4.7이었습니다.

/fast로 패스트 모드를 다시 끄면 Opus에 그대로 남아 있습니다. 다른 모델로 바꾸려면 /model을 쓰세요.

패스트 모드가 켜진 상태에서 모델 전환

패스트 모드는 양방향으로 모델 전환을 따라갑니다.

• 전환(떠나기): 패스트 모드를 지원하지 않는 모델로 전환하면 Claude Code가 패스트 모드를 끕니다. Opus 4.7도 포함됩니다. v2.1.221 이전에는 Opus 4.7로 전환한 뒤에도 패스트 모드가 켜진 채로 남아 API가 그 요청을 거부했어요.
• 전환(돌아오기): 저장된 패스트 모드 선호가 켜져 있으면 지원되는 Opus 모델로 다시 전환할 때 패스트 모드도 다시 켜집니다. 새 세션이 기본적으로 시작하는 그 선호와 같아요. 모델 전환은 저장된 선호가 꺼진 세션에서 패스트 모드를 켜지 않으며, 세션별 옵트인을 설정한 경우에도 다시 켜지 않습니다. /fast로 다시 활성화하면 됩니다.

모델 전환이 패스트 모드를 켜거나 끌 때마다 Claude Code는 Fast mode ON 또는 Fast mode OFF 확인을 표시하고, 패스트 모드가 켜져 있는 동안 ↯ 아이콘이 나타납니다. /model로 전환하든, /config model=<model>로 전환하든, Remote Control로 연결된 기기에서 전환하든 동일합니다.

Claude Code는 모델 전환·재연결·가용성 확인 실패 이후 Remote Control로 연결된 기기에 세션의 패스트 모드 상태를 다시 보냅니다.

비용 트레이드오프 이해하기

패스트 모드는 표준 Opus보다 토큰당 가격이 높습니다.

모델	입력 (MTok)	출력 (MTok)
Opus 5	\$10	\$50
Opus 4.8	\$10	\$50

패스트 모드 가격은 전체 1M 토큰 컨텍스트 창에 걸쳐 고정(flat)입니다. 비교할 표준 Opus 요율은 Claude 가격 레퍼런스를 참고하세요.

대화에서 패스트 모드를 처음 켜면, 전체 대화 컨텍스트에 대해 패스트 모드의 캐시되지 않은 입력 토큰 가격을 전액 지불합니다. 대화가 깊을수록 비용이 커지므로 처음부터 켜는 것이 더 쌉니다. 이 비용은 대화당 한 번만 적용되므로, 나중에 껐다 다시 켜도 반복되지 않습니다. 메커니즘은 패스트 모드가 프롬프트 캐시와 상호작용하는 방식을 참고하세요.

패스트 모드 지출이 어디에 표시되는지

로그인 방식에 따라 패스트 모드 지출이 보이는 곳이 다르므로, 먼저 /status로 확인해 보세요. Claude Max account 같은 Login method 행이 보이면 Claude 구독으로 로그인한 것입니다. 대신 API key 행이 보이면 요청이 Claude Console 조직에 청구됩니다.

• Pro와 Max: 패스트 모드를 usage credits에서 지불합니다. claude.ai의 Settings > Usage에서 Usage credits 섹션이 이번 달 사용한 usage credits를 보여줍니다. 그 수치에 패스트 모드가 포함되지만 별도로 나누어 표시되지는 않습니다.
• Team과 Enterprise: 조직이 usage credits로 패스트 모드 사용량을 지불합니다. 자신의 usage credits 지출을 보려면 /usage를 실행하세요. 조직이 그 지출을 보는 곳은 Claude for Teams and Enterprise를 참고하세요.
• Claude Console: 조직이 나머지 API 사용량과 함께 패스트 모드를 지불합니다. Console의 Usage와 Cost 페이지에서 Group by 메뉴의 **Speed (Research Preview)**를 선택하면 패스트 모드를 표준 속도 사용량과 분리해서 볼 수 있습니다. 선택한 날짜 범위에 패스트 모드 사용량이 있을 때만 그 옵션이 보입니다.

패스트 모드를 쓸 때 정하기

패스트 모드는 비용보다 응답 대기 시간이 중요한 인터랙티브 작업에 가장 적합합니다.

• 코드 변경의 빠른 반복
• 라이브 디버깅 세션
• 마감이 임박한 시간 민감 작업

표준 모드는 다음과 같은 경우에 더 좋습니다.

• 속도가 덜 중요한 긴 자율 작업
• 배치 처리 또는 CI/CD 파이프라인
• 비용 민감 워크로드

패스트 모드 vs 노력 수준(effort level)

패스트 모드와 노력 수준은 모두 응답 속도에 영향을 주지만 방식이 다릅니다.

설정	효과
패스트 모드	동일한 모델 품질, 더 낮은 대기 시간, 더 높은 비용
노력 수준 낮추기	사고 시간 감소, 응답 빨라짐, 복잡한 작업에선 품질이 낮아질 수 있음

둘을 조합할 수도 있어요. 단순한 작업에서는 낮은 노력 수준과 함께 패스트 모드를 써서 최대 속도를 얻을 수 있습니다.

요구 사항 (Requirements)

패스트 모드를 쓰려면 다음이 모두 필요합니다.

• Anthropic API 또는 구독 전용: 패스트 모드는 Anthropic Console API와 usage credits를 쓰는 Claude 구독 플랜에서만 사용할 수 있습니다. Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, Claude Platform on AWS에서는 사용할 수 없어요. Console 조직도 fast mode access provisioning이 되어 있어야 합니다.
• 구독 플랜에서 usage credits 켜기: Pro, Max, Team, Enterprise 플랜에서 계정의 usage credits가 켜져 있어야 패키지에 포함된 사용량을 넘어 청구할 수 있습니다. 켜기 전까지 /fast는 "Fast mode requires usage credits"라고 보고합니다. 켜는 방법은 플랜에 따라 다릅니다.
  • Pro와 Max에서는 claude.ai의 Settings > Usage에 있는 Usage credits 섹션에서 켜거나, /usage-credits를 실행해 그 페이지를 엽니다.
  • Team과 Enterprise에서는 결제(billing) 권한이 있는 멤버가 조직에 대해 Admin settings > Usage에서 켜고, 권한이 없는 멤버는 /usage-credits를 실행해 조직 관리자에게 요청을 보냅니다.

플랜에 남은 사용량이 있어도 패스트 모드 사용량은 usage credits에서 직접 차감됩니다.

• 유료 Console 조직: Claude Console 계정은 usage credits를 쓰지 않고, 조직이 나머지 API 사용량과 함께 토큰당 패스트 모드를 지불합니다. Console의 무료 Evaluation 플랜에서는 /fast가 "Fast mode unavailable during evaluation. Please purchase credits."를 표시합니다. 해결하려면 Console 결제 설정에서 크레딧을 구매하세요.
• Team·Enterprise의 Owner 활성화: 패스트 모드는 Team·Enterprise 조직에서 기본적으로 비활성입니다. Owner가 패스트 모드를 명시적으로 활성화해야 사용자가 접근할 수 있습니다.

조직에서 패스트 모드를 활성화하지 않았다면 `/fast`가 "Fast mode has been disabled by your organization."을 표시합니다. 조직의 [`availableModels`](/docs/en/model-config#restrict-model-selection) 허용 목록이 패스트 모드 Opus 모델을 제외한다면 `/fast`는 "is not in your organization's allowed models"로 거부됩니다. 예외는 이미 허용된 Opus 모델에서 패스트 모드를 지원하는 세션입니다. 그 경우 `/fast`가 모델을 전환하는 대신 현재 모델에서 패스트 모드를 켭니다.

조직에서 패스트 모드 활성화

패스트 모드를 활성화하는 위치는 조직이 쓰는 제품에 따라 다릅니다.

• Console(API 고객): 관리자가 Claude Code preferences에서 활성화합니다. 패스트 모드는 research preview이므로, 패스트 모드 요청이 성공하려면 조직에 패스트 모드 액세스도 프로비저닝되어 있어야 합니다. 액세스를 얻으려면 계정 매니저에게 연락하거나 Claude API의 패스트 모드에 설명된 대로 웨이트리스트에 등록하세요.
  • 액세스가 프로비저닝되지 않으면 API가 각 패스트 모드 요청을 429로 거부하고, Claude Code는 각 거부를 패스트 모드 속도 제한으로 처리합니다. 속도 제한의 쿨다운과 달리, 액세스가 프로비저닝될 때까지 거부가 계속됩니다.
• Claude AI(Team과 Enterprise): Owner가 Admin Settings > Claude Code에서 활성화합니다.

패스트 모드를 완전히 비활성화하는 또 다른 방법은 CLAUDE_CODE_DISABLE_FAST_MODE=1을 설정하는 것입니다. 환경 변수를 참고하세요.

프록시와 LLM 게이트웨이 뒤에서 패스트 모드 사용

패스트 모드를 제공하기 전에 Claude Code는 api.anthropic.com으로 직접 요청을 보내 조직의 패스트 모드 가용성을 확인합니다. 이 확인은 ANTHROPIC_BASE_URL을 따르지 않으므로, LLM 게이트웨이를 통해 Claude 트래픽을 라우팅하고 api.anthropic.com으로의 직접 이그레스(egress)를 차단하는 네트워크에서는 추론 요청이 동작해도 확인이 실패합니다. 이 확인은 설정된 HTTP 프록시는 사용하므로, 프록시를 통해서도 api.anthropic.com에 도달할 수 없는 경우에만 네트워크 차단이 확인을 실패시킵니다.

확인이 실패하면 조직에서 패스트 모드를 활성화해도 /fast가 "Fast mode unavailable due to network connectivity issues"라고 보고하고 요청은 표준 속도로 실행됩니다. 과거에 성공한 확인은 캐시된 결과로 계속 동작하므로, 차단된 확인은 대부분 새 설치에 영향을 줍니다.

열린 네트워크에서 확인이 api.anthropic.com에 도달했는데 Anthropic이 거부하는 자격 증명을 제시할 때도 같은 연결 메시지가 나타납니다. resolve된 키가 ANTHROPIC_API_KEY에 있거나 apiKeyHelper로 생성된 게이트웨이 발급 자격 증명인 세션은 그 키로 확인을 보내고, 거부된 요청은 연결 실패로 보고됩니다.

패스트 모드를 복원하려면, 네트워크 차단이 원인이라면 api.anthropic.com으로의 직접 이그레스를 허용 목록에 추가하거나, 확인이 실패하는 방식에 맞는 변수를 설정하세요.

• CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1은 실패한 확인을 사용 가능으로 처리하면서 "disabled by your organization" 응답은 여전히 존중합니다. 네트워크가 연결을 거부하거나 Anthropic이 게이트웨이 자격 증명을 거부할 때 쓰세요. 자격 증명의 경우 차단된 게이트웨이 자격 증명은 없으므로 허용 목록이 도움이 되지 않습니다.
• CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1는 확인을 완전히 건너뜁니다. 네트워크가 요청을 거부하는 대신 가로챌 때 쓰세요.

조직에서 패스트 모드를 활성화했더라도, 다음 두 게이트웨이 구성은 연결 메시지 대신 "Fast mode has been disabled by your organization"을 보고합니다.

• ANTHROPIC_AUTH_TOKEN만으로 인증하는 세션은 확인을 건너뜁니다. claude.ai 로그인이나 Anthropic API 키 없이, 그리고 캐시된 성공 확인도 없으면 Claude Code는 요청을 보내지 않고 패스트 모드가 조직에 의해 비활성된 것으로 처리합니다.
• 확인을 가로채 자기 페이지로 응답하는 프록시(예: HTTP 200 차단 페이지를 돌려주는 TLS 검사 프록시)는 조직이 패스트 모드를 비활성화했다는 응답으로 읽힙니다.

두 경우 모두 CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1을 설정해 패스트 모드를 복원하세요. CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS는 두 경우 모두 적용되지 않습니다. 실패한 확인만 우회하고 이 둘은 비활성 응답을 만들기 때문입니다. 베어러 토큰(bearer-token)의 경우는 요청을 아예 보내지 않으므로 직접 이그레스 허용 목록도 도움이 되지 않습니다.

이 변수들은 클라이언트 측 확인에만 영향을 줍니다. 조직에서 패스트 모드를 비활성화했다면 설정 여부와 무관하게 API가 패스트 모드 요청을 거부합니다.

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC을 설정해도 가용성 확인이 억제됩니다. 이전에 캐시된 성공 확인이 없으면 /fast는 "Fast mode is currently unavailable"이라고 보고하고, 두 스킵 변수 모두 그 구성에서도 패스트 모드를 복원합니다.

세션별 옵트인 요구 (Require per-session opt-in)

기본적으로 인터랙티브 세션에서 사용자가 켠 패스트 모드는 세션을 넘어 유지됩니다. 이를 바꾸려면 아무 설정 파일에서 fastModePerSessionOptIn을 true로 설정하세요. 그러면 각 세션이 패스트 모드 꺼짐으로 시작하고 사용자가 /fast로 명시적으로 활성화해야 합니다. Team 또는 Enterprise 플랜의 Owner는 server-managed settings를 통해 조직 전체에 배포할 수 있습니다.

{
  "fastModePerSessionOptIn": true
}

이 설정은 사용자가 여러 동시 세션을 실행하는 조직에서 비용을 제어할 때 유용합니다. 사용자의 패스트 모드 선호는 여전히 저장되므로, 이 설정을 제거하면 기본적인 지속 동작이 복원됩니다.

속도 제한 처리 (Handle rate limits)

패스트 모드는 표준 Opus와 별도의 속도 제한이 있습니다. 지원되는 모든 Opus 모델이 하나의 패스트 모드 속도 제한 풀을 공유합니다. 어느 모델의 사용량이든 같은 제한에서 차감돼요. 패스트 모드 속도 제한에 도달하면:

1. 패스트 모드가 자동으로 표준 속도로 폴백
2. ↯ 아이콘이 회색으로 변해 쿨다운을 나타냄
3. 표준 속도와 가격으로 계속 작업
4. 쿨다운이 끝나면 패스트 모드가 자동으로 다시 활성화

쿨다운을 기다리지 않고 수동으로 끄려면 /fast를 다시 실행하세요.

세션 중간에 usage credits가 바닥나면, Claude Code는 거부된 각 패스트 모드 요청을 표준 속도와 가격으로 재시도하므로 계속 작업할 수 있고 쿨다운도 없습니다. 거부가 보이는 방식은 세션 유형에 따라 다릅니다.

• 인터랙티브 세션에서는 Claude Code가 "Fast mode disabled · usage credits exhausted" 알림을 표시하고 나머지 세션 동안 패스트 모드를 끕니다. 저장된 패스트 모드 선호는 바뀌지 않으므로 /fast로 다시 켤 수 있습니다.
• --output-format stream-json을 쓰는 비인터랙티브 모드와 Agent SDK에서는 Claude Code가 usage credits가 부족한 동안 턴당 한 번씩 메시지 스트림에 notification 서브타입의 system 메시지로 같은 텍스트를 내보냅니다. 패스트 모드는 켜진 채 유지됩니다. Claude Code v2.1.221 이상이 필요합니다.

Research preview

패스트 모드는 research preview 기능입니다. 의미하는 바는 다음과 같습니다.

• 피드백에 따라 기능이 바뀔 수 있음
• 가용성과 가격이 바뀔 수 있음
• 기본 API 구성이 진화할 수 있음

문제나 피드백은 평소 쓰는 Anthropic 지원 채널로 보고하세요.

더 알아보기

• 모델 구성: 모델 전환과 노력 수준 조정
• 비용 효율적 관리: 토큰 사용량 추적과 비용 절감
• 상태줄 구성: 모델과 컨텍스트 정보 표시