Claude Code fast mode(빠른 모드) 사용법: 단가 2배, 오류 메시지별 해결

Claude Code fast mode(공식 한국어 문서 표기 "빠른 모드")는 모델을 바꾸는 기능이 아니라, 같은 Opus 5.5나 Fable 5.2를 출력 속도 최대 2.5배로 돌리는 설정입니다. 대가는 토큰 단가입니다. 2026년 11월 12일 기준 Opus 5.5는 100만 토큰당 입력 $8·출력 $40으로 표준($4/$20)의 2배, Fable 5.2는 $16/$80으로 역시 2배입니다. Pro·Max·Ultra·Team 구독자도 플랜 사용량이 아니라 사용 크레딧(usage credits)에서만 차감되므로, 크레딧을 켜 두지 않았다면 /fast는 "Fast mode requires usage credits"로 거부됩니다.

켜는 시점은 세션을 시작할 때입니다. 대화 중간에 처음 켜면 그때까지 쌓인 컨텍스트 전체를 fast 단가의 캐시 없는 입력으로 다시 읽기 때문에, Opus 5.5에서 컨텍스트가 10만 토큰이면 그 한 번에 $0.80~$1.00이 붙습니다. 터미널에서 /fast를 실행해 "Fast mode ON"과 프롬프트 옆 ↯ 아이콘을 확인하고, 요청이 실제로 fast로 처리됐는지는 ~/.claude/projects/ 아래 세션 기록(.jsonl)의 "speed":"fast" 값으로 확인합니다.

회사 게이트웨이나 서드파티 중계(릴레이)를 거친다면 아이콘만 믿으면 안 됩니다. 2026년 11월 12일 시험에서 Claude Code 2.1.322는 fast mode가 켜지면 요청에 "speed": "fast"를 실어 보냈지만, 시험한 중계 한 곳은 이 값을 버렸고 속도도 표준과 같았습니다. 그리고 Opus 4.8의 fast mode는 2026년 11월 30일에 제거되므로, 아직 Opus 4.8에서 쓰고 있다면 그 전에 /model로 Opus 5.5로 옮기세요.

fast mode가 바꾸는 것: 같은 모델, 출력 최대 2.5배, 단가 2배

fast mode를 켜도 모델의 품질과 기능은 그대로이고, 바뀌는 것은 출력 속도와 가격뿐입니다. Claude Code 공식 fast mode 문서는 이를 "같은 모델에 속도를 우선하는 다른 API 설정"이라고 설명하고, Claude API의 fast mode 문서는 최대 2.5배가 초당 출력 토큰 기준이라고 밝힙니다. 그래서 화면에 "Opus 5.5 Fast"처럼 보여도 요청의 모델 ID는 claude-opus-5-5 그대로이고, 요청 본문에 speed 값이 하나 더 붙을 뿐입니다.

지원 모델과 단가는 다음과 같습니다. 단위는 100만 토큰당 USD이고, Anthropic 가격표 기준입니다.

fast mode 단가는 100만 토큰 컨텍스트 전체에서 같고, 프롬프트 캐싱 배수와 데이터 레지던시 배수는 이 단가 위에 그대로 곱해집니다. Sonnet과 Haiku에는 fast mode가 없고, Opus 4.7은 2026년 7월 24일에 fast mode가 제거됐습니다. 2026년 초 Opus 4.6 시절 자료에는 fast mode가 입력 $30·출력 $150, 표준의 6배로 소개돼 있지만, 지금 지원되는 네 모델의 fast 단가는 모두 표준의 정확히 2배입니다.

속도를 올리는 다른 방법인 effort 낮추기는 생각하는 양을 줄여 빨라지는 대신 어려운 작업에서 품질이 떨어질 수 있고, 둘을 함께 쓸 수도 있습니다. 차이와 설정은 Claude Code effort 설정과 차이: Opus 5.5 기본값 medium, 안 먹힐 때 해결에서 다룹니다. 구독자가 내는 사용 크레딧(추가 사용량, extra usage라고도 부릅니다)의 과금 방식은 Claude 추가 사용량 요금: 사용 크레딧 계산, 월 $80 넘으면 Max 5x를 참고하세요.

fast mode를 쓸 수 있는 요금제·접속 경로·모델

Anthropic에 직접 연결하는 경로라면 구독이든 API 키든 쓸 수 있지만, 구독은 사용 크레딧이 켜져 있어야 하고 Team·Enterprise는 Owner가 먼저 기능을 켜야 합니다. Amazon Bedrock, Microsoft Foundry, Claude Platform on AWS를 거치는 Claude Code에서는 fast mode를 쓸 수 없고, Google Cloud Agent Platform에서는 Fable 5.2만 됩니다. 아래 표는 2026년 11월 12일 기준 Claude Code 공식 문서의 요구 사항을 경로별로 정리한 것입니다.

모델 쪽에서는 Opus 4.8이 마감이 있습니다. Opus 4.8의 fast mode는 2026년 10월 30일에 지원 종료가 예고됐고 11월 30일에 제거되며, 그 뒤에도 Opus 4.8에 fast mode를 켜 둔 채면 API가 요청을 거부합니다. fast mode를 계속 쓰려면 /model로 Opus 5.5로 바꾸면 되고(Claude Code v2.1.280 이상 필요), Opus 4.8을 표준 속도로 계속 쓰려면 /fast off를 실행합니다.

fast mode를 켤 가치가 있나: 사람이 화면 앞에서 기다릴 때만

fast mode가 값을 하는 경우는 응답 하나하나를 사람이 기다리고 있을 때입니다. 공식 문서도 빠르게 고치고 다시 돌려 보는 반복 작업, 실시간 디버깅, 마감이 급한 작업을 권하고, 오래 혼자 도는 자율 작업, 배치 처리나 CI/CD, 비용이 중요한 작업은 표준 속도가 낫다고 적고 있습니다. 빨라지는 것은 모델이 글을 출력하는 속도이므로, 테스트 실행이나 빌드처럼 도구가 돌아가는 시간은 그대로입니다.

캐시가 데워진 뒤의 한 턴은 정확히 2배가 됩니다. Opus 5.5에서 캐시된 컨텍스트 10만 토큰, 새 입력 3,000토큰, 출력 2,000토큰인 턴을 정가로 계산하면 표준은 100,000 × $4 × 0.05 + 3,000 × $4 + 2,000 × $20 = $0.072(100만 토큰당 단가 기준)이고, fast는 같은 식에 $8과 $40을 넣어 $0.144입니다. 같은 조건의 Fable 5.2는 캐시 읽기가 0.025배라 표준 $0.12, fast $0.25입니다. 하루에 이런 턴을 200번 돌린다면 Opus 5.5에서 약 $14가 더 드는 셈이고, 그 대가로 사람이 기다리는 시간이 줄어드는지가 판단 기준입니다.

최대 2.5배는 Anthropic이 공개한 수치입니다. 아래 게이트웨이 절의 속도 측정은 중계 한 곳에서 한 것이라 Anthropic 직결 경로의 속도를 보여 주지는 않습니다. 비용 없이 속도만 올리고 싶다면 effort를 낮추는 쪽을 먼저 시도하고, 단순한 작업에서 최대 속도가 필요할 때는 fast mode와 낮은 effort를 함께 쓰는 방법도 공식 문서에 나와 있습니다.

세션 중간에 켜면 붙는 비용: 컨텍스트 전체를 fast 단가로 다시 읽는다

세션 도중 처음으로 fast mode를 켜면, 그 요청에서 지금까지의 대화 컨텍스트 전체를 fast 단가의 캐시 없는 입력 가격으로 냅니다. fast와 표준 속도는 캐시를 따로 쓰기 때문에, 껐다가 다시 켤 때마다 컨텍스트를 캐시 없이 다시 읽습니다. 그래서 대화가 길어질수록 전환 비용이 커지고, 세션을 시작할 때 켜는 것이 가장 쌉니다.

아래 표는 2026년 11월 12일 Anthropic 정가로 다시 계산한 값입니다. 계산식은 컨텍스트 토큰 수 × fast 입력 단가이고, 예를 들어 Opus 5.5 10만 토큰은 100,000 × $8 / 1,000,000 = $0.80입니다. 공식 문서는 "캐시 없는 입력 가격"이라고만 적고 있어서, 그 전환 요청에 캐시 쓰기 배수가 붙는 경우를 상한으로 함께 적었습니다. 구독의 fast 사용분은 언제나 사용 크레딧에서 나가고, 사용 크레딧이나 API 키로 쓸 때 Claude Code의 메인 대화는 기본적으로 5분 캐시(쓰기 1.25배)를 쓰므로 현실적인 범위는 기본 단가에서 1.25배 사이입니다. promptCacheTtl 설정이나 CLAUDE_CODE_PROMPT_CACHE_TTL 환경 변수로 1시간 캐시를 강제했다면 쓰기가 2배라 표의 1.25배 값 대신 기본 단가의 2배(Opus 5.5 10만 토큰에서 $1.60)로 보면 됩니다.

켜고 끄기를 반복하면 차이가 더 벌어집니다. Opus 5.5 컨텍스트 15만 토큰에서 켜기($1.20), 끄기(표준 단가로 다시 읽어 $0.60), 다시 켜기($1.20)를 하면 기본 단가로 합계 $3.00, 5분 캐시 쓰기(1.25배)까지 치면 $3.75인데, 한 속도를 유지하며 캐시를 세 번 읽으면 표준 기준 $0.09입니다. 레이트 리밋에 걸려 표준 속도로 자동 전환됐다가 fast로 돌아오는 것도 같은 전환으로 계산됩니다. 이 숫자들은 청구서가 아니라 정가 재계산이며, 생각(thinking) 토큰과 데이터 레지던시 배수는 빠져 있습니다. 캐시가 깨지는 다른 경우는 Claude Code 캐시 미스 토큰 비용: 한 turn 이 갑자기 비싸지는 이유와 Claude(클로드) 프롬프트 캐싱 적용법: 캐시 읽기 0.05배, 최소 512토큰에 정리돼 있습니다.

Claude Code fast mode 켜는 법: 터미널, settings.json, VS Code, 앱, 웹

터미널에서는 /fast를 실행하고 Space로 켜기/끄기를 바꾼 뒤 Enter로 확정합니다. /fast on, /fast off처럼 바로 지정해도 되고, 켜지면 "Fast mode ON" 확인 메시지와 함께 프롬프트 옆에 ↯ 아이콘이 나타납니다. 지금 모델이 fast mode를 지원하지 않으면 /fast가 모델을 Opus로 바꾸며, Claude Code v2.1.280 이상에서는 그 기본값이 Opus 5.5입니다.

입구마다 켜는 위치와 설정이 유지되는 범위가 다릅니다.

데스크톱 앱의 스위치는 공식 fast mode 문서에 설명이 없고, 위치는 Claude Code GitHub 이슈 #100998의 화면 묘사에 따른 것입니다. 비대화형 실행은 --settings에 fastMode를 넣어 시작한 세션에서만 /fast가 통합니다. 2026년 11월 12일 macOS의 Claude Code 2.1.322(로그인하지 않은 상태)에서 claude -p "/fast"를 실행하면 "Fast mode unavailable: Fast mode is not available in the Agent SDK"가 나왔고, settings.json에 "fastMode": true를 적어 둔 경우에도 -p에서는 같은 메시지였습니다. --settings '{"fastMode": true}'를 붙이면 메시지가 "Fast mode has been disabled by your organization"으로 바뀌었는데, 로그인 정보가 없어 조직에서 꺼진 것으로 처리된 결과입니다.

/fast는 Claude가 작업하는 중에도 실행할 수 있지만, 진행 중인 턴은 원래 속도로 끝나고 다음 턴부터 바뀝니다. fast mode가 켜진 상태에서 지원하지 않는 모델로 /model을 바꾸면 fast mode가 꺼지고, 지원 모델로 돌아오면 저장된 설정에 따라 다시 켜집니다. Fable 5.2는 Claude Code v2.1.321 이상이 필요하고, Fable 5.2를 쓰는 중에 직접 켠 경우에만 다음 세션에도 유지됩니다.

여러 세션을 동시에 돌려 비용이 걱정된다면 settings.json에 "fastModePerSessionOptIn": true를 넣어 모든 세션이 fast mode 꺼진 상태로 시작하게 할 수 있습니다. 저장된 선호값은 그대로 남기 때문에 이 키를 지우면 원래 동작으로 돌아오고, 조직이 관리 설정으로 이 키를 배포하면 /fast on은 대화형 터미널 세션에서만 받아들여집니다.

실제로 켜졌는지 확인하는 법: 세션 기록의 speed 값 세기

↯ 아이콘과 "Fast mode ON"은 Claude Code가 자기 설정을 표시하는 것이지, 서버가 fast로 처리했다는 증거는 아닙니다. 응답마다 실제 속도는 API 응답의 usage.speed에 "fast" 또는 "standard"로 돌아오고, Claude Code는 이 값을 세션 기록에 남깁니다. 그래서 확인은 다음 순서로 합니다.

1. 터미널에서 /fast를 다시 실행해 ON인지 봅니다. 아이콘 ↯가 회색이면 레이트 리밋 쿨다운 중이라 표준 속도로 돌고 있는 상태입니다.
2. 프로젝트의 세션 기록 폴더(~/.claude/projects/<프로젝트 폴더>/)에서 방금 쓴 세션의 .jsonl 파일을 찾아 아래 명령으로 speed 값을 셉니다.
3. fast mode를 켠 뒤의 턴이 "speed":"fast"로 세어지면 적용된 것이고, "speed":"standard"만 있다면 화면 표시와 상관없이 표준 속도로 처리된 것입니다.
4. 비용 쪽에서도 확인하려면 /status로 로그인 방식을 봅니다. API 키(Console)라면 Console의 Usage·Cost 페이지에서 Group by 메뉴에서 Speed (research preview) 항목을 고르면 fast 사용분이 따로 보이고, Pro·Max·Ultra는 claude.ai Settings > Usage의 사용 크레딧 월 합계에 fast가 섞여 나오며, Team·Enterprise는 /usage로 자기 사용 크레딧 지출을 봅니다.

cd ~/.claude/projects/<프로젝트 폴더>
grep -o '"speed":"[a-z]*"' <세션 ID>.jsonl | sort | uniq -c

2026년 11월 12일 한 Mac에서 최근 세션 기록 5개에 이 명령을 실행했더니 "speed":"standard"가 각각 283, 475, 259, 170, 275건이었고 "fast"는 0건이었습니다. 이 세션들은 fast mode를 쓰지 않았으므로, fast가 적용되지 않은 세션은 이렇게 보입니다. 이 기록에는 fast 항목이 없어서 fast가 찍히는 모습은 문서로 확인해야 하는데, 필드 이름이 Claude API 문서의 usage.speed와 같고 아래 이슈의 보고자들도 같은 값으로 문제를 찾아냈습니다.

이 확인이 필요한 이유는 GitHub 이슈 #100998에 있습니다. 데스크톱 앱 Code 탭에서 "Opus 5.5 Fast"와 켜진 스위치가 보이는데 세션은 실제로 fast mode가 꺼져 있었다는 보고로, 한 사용자는 10월 19일 이후 1만 307건의 요청이 모두 standard였고 그 계정은 사용 크레딧이 꺼져 있었다고 적었습니다. 2026년 11월 12일 기준 이 이슈는 열려 있고 마지막 댓글은 11월 5일입니다.

"Fast mode …" 메시지별 원인과 해결

/fast가 거부되거나 도중에 꺼질 때 나오는 문구는 2026년 11월 12일 Claude Code 2.1.322 실행 파일에서 직접 뽑은 원문 기준입니다. -p 실행에서는 앞에 "Fast mode unavailable: "가 붙어 "Fast mode unavailable: Fast mode has been disabled by your organization"처럼 나옵니다. 공식 문서에 설명이 없는 네 개는 원인을 문구에서 추정한 것이라 표에 (추정)으로 표시했습니다.

Fast mode has been disabled by your organization이 뜰 때

이 메시지는 원인이 가장 많습니다. Team·Enterprise 조직에서 Owner가 fast mode를 켜지 않았거나, 관리 설정이 fastMode: false를 배포했거나, 관리 설정의 fastModePerSessionOptIn: true 때문에 대화형 터미널이 아닌 곳(VS Code, -p, 클라우드 세션)에서 /fast on을 한 경우입니다. Team·Enterprise라면 Owner가 Organization settings > Claude Code에서, Console 조직이라면 관리자가 Console의 Claude Code preferences에서 켜야 합니다.

조직에서 이미 켜져 있는데도 이 메시지가 나온다면 게이트웨이 설정을 의심합니다. ANTHROPIC_AUTH_TOKEN만으로 인증하고 claude.ai 로그인이나 API 키가 없으면 Claude Code는 확인 요청을 보내지 않고 조직에서 꺼진 것으로 처리하며, TLS 검사 프록시가 확인 요청에 자체 차단 페이지(HTTP 200)를 돌려줘도 같은 결과가 됩니다. 두 경우 모두 CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1을 설정합니다. 이 변수는 Claude Code 쪽 확인만 건너뛰므로, 조직에서 정말로 꺼져 있다면 API가 fast 요청을 거부하고 Claude Code는 표준 속도로 재시도합니다.

/fast를 켤 때 거부되는 메시지

/fast에 on·off가 아닌 값을 넣으면 Unknown argument "maybe". Use: /fast [on|off]처럼 나오며, 인자 오타일 뿐 설정에는 영향이 없습니다.

쓰는 도중 표준 속도로 돌아갈 때 나오는 메시지

fast mode는 표준 속도와 별도의 레이트 리밋을 쓰고, 한도에 걸리면 표준 속도·표준 가격으로 자동 전환됐다가 쿨다운이 끝나면 다시 켜집니다. 사용 크레딧이 바닥나면 쿨다운 없이 표준 속도로 재시도하고 그 세션에서 fast mode를 끕니다.

-p에서 --output-format stream-json을 쓰거나 Agent SDK로 돌릴 때는 크레딧 소진 알림이 system 메시지(subtype notification)로 턴마다 한 번씩 오고, 이 경우 fast mode는 꺼지지 않은 채 남습니다.

게이트웨이·중계로 쓸 때: speed 값이 Anthropic까지 가야 빨라진다

게이트웨이를 거쳐도 Claude Code는 fast mode 요청을 보낼 수 있지만, 실제로 빨라지려면 게이트웨이가 speed 값을 Anthropic에 그대로 넘기고 응답의 usage.speed를 돌려줘야 합니다. 또 Claude Code는 fast mode를 제공하기 전에 조직의 사용 가능 여부를 api.anthropic.com에 직접 묻는데, 이 확인은 ANTHROPIC_BASE_URL을 따르지 않고 HTTP 프록시 설정만 따릅니다. 그래서 api.anthropic.com으로 직접 나가는 길이 막힌 회사 네트워크에서는 추론은 되는데 fast mode만 안 되는 일이 생깁니다. 게이트웨이 연결 전반은 Claude Code API 설정: 키, settings.json, 모델, 게이트웨이 확인 순서에 있습니다.

2026년 11월 12일 Claude Code 2.1.322를 로컬 가짜 Anthropic 엔드포인트(ANTHROPIC_BASE_URL을 로컬 주소로 지정)에 연결하고 -p --settings '{"fastMode": true}'로 실행해 보낸 요청을 기록했습니다. fast mode가 켜진 요청에는 본문에 "speed": "fast"와 모델 claude-opus-5-5가, anthropic-beta 헤더에 fast-mode-2026-02-01이 들어 있었습니다.

결과는 인증 방식에 따라 갈렸습니다. Anthropic 형식이 아닌 게이트웨이용 ANTHROPIC_API_KEY를 쓰면 /fast on이 "↯ Fast mode ON · $8/$40 per Mtok (this session only)"를 출력했고, 건너뛰기 변수 없이도 speed: "fast"를 보냈습니다. 공식 문서는 이 구성에서 "Fast mode is currently unavailable"이 뜬다고 적고 있으므로, 이 결과는 -p 시험에서 본 동작이며 대화형 모드나 이전 확인 결과가 캐시된 상태에서는 다를 수 있습니다. 반면 ANTHROPIC_AUTH_TOKEN만 쓰면 /fast가 "Fast mode has been disabled by your organization"을 표시했고, 이후 요청에는 speed가 빠져 있어 아무 경고 없이 표준 속도로 나갔습니다. 같은 구성에 CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1을 더하자 speed: "fast"가 다시 실렸습니다.

같은 날 서드파티 중계 한 곳인 LaoZhang API(api.laozhang.ai의 /v1/messages)에 speed: "fast"와 베타 헤더를 붙여 claude-opus-5-5를 호출했더니 HTTP 200이 돌아왔지만, 응답 usage에 speed 필드가 없었고 service_tier는 standard였습니다. fast mode가 없는 claude-sonnet-5-5·claude-haiku-5-5에 speed: "fast"를 보내거나 Opus에 있지도 않은 speed: "turbo"를 보내도 모두 200이었는데, Anthropic API는 지원하지 않는 모델의 fast 요청에 오류를 돌려주므로 이 중계는 speed 값을 상위로 넘기기 전에 버리는 것으로 보입니다. 비스트리밍, max_tokens 2000, thinking 끔 조건으로 표준과 fast를 번갈아 4회씩 잰 결과도 초당 출력 토큰 중앙값이 표준 118.1(108.9~119.4), fast 117.2(114.5~119.8)로 차이가 없었습니다.

안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.

이 결과는 중계 한 곳의 동작이고, 다른 중계가 같은지는 따로 확인해야 합니다. 쓰는 게이트웨이가 fast mode를 지원하는지 직접 확인하려면 두 가지를 보면 됩니다. fast 요청의 응답 usage에 "speed": "fast"가 돌아오는지, 그리고 fast mode가 없는 Haiku에 speed: "fast"를 보냈을 때 Anthropic처럼 오류가 나는지입니다. 둘 다 아니라면 Claude Code의 ↯ 표시와 상관없이 표준 속도로 처리되고 있다고 보면 됩니다.

Claude Code fast mode 자주 묻는 질문

fast mode가 메시지 없이 꺼져 있습니다. 왜 그런가요?

먼저 사용 크레딧 소진과 레이트 리밋 쿨다운을 의심하세요. 2026년 11월 4일 올라온 Claude Code GitHub 이슈 #107249는 settings.json에 "fastMode": true가 그대로인데 실행 중인 CLI 세션에서 fast mode가 계속 꺼진다는 보고였고, 원인이 사용 크레딧 소진으로 밝혀져 버그가 아닌 것으로 닫혔습니다. 크레딧이 떨어지면 그 세션의 fast mode만 꺼지고 저장된 설정은 남기 때문에 이렇게 보입니다. claude.ai Settings > Usage에서 잔액과 한도를 확인하세요.

fast mode를 아예 못 켜게 막을 수 있나요?

환경 변수 CLAUDE_CODE_DISABLE_FAST_MODE=1을 설정하면 Claude Code에서 fast mode가 완전히 꺼집니다. 조직 단위로 막으려면 관리 설정에 fastMode: false를 배포하면 되고, 이때 사용자가 /fast를 실행하면 "Fast mode has been disabled by your organization"이 표시됩니다(2026년 11월 12일 기준 Claude Code 공식 fast mode 문서).

Claude API의 Batch API나 Priority Tier에서도 fast mode를 쓸 수 있나요?

쓸 수 없습니다. 2026년 11월 12일 기준 Claude API fast mode 문서는 fast mode가 Batch API와 함께 쓸 수 없고, Priority Tier 약정에서도 제공되지 않는다고 적고 있습니다. 대량 처리 비용을 줄이려면 표준 속도의 Batch API를, 응답 속도가 필요하면 일반 요청에 speed: "fast"를 쓰는 식으로 나눠야 합니다.

Claude Code 요금제 자체를 고르는 중이라면 Claude Code 가격 2026: Pro, Max, Team, API, extra usage 선택법을, Opus 5.5와 Fable 5.2 중 어느 모델에 fast mode를 걸지 고민한다면 Claude Fable 5.2 vs Opus 5.5 비교: 실측 비용 1.86배와 effort 고르는 법을 함께 보세요.