Cloudflare Developers로 시작하는 웹·AI 앱 개발

Cloudflare Developers는 Cloudflare에서 웹 서비스와 AI 애플리케이션을 만드는 데 필요한 공식 문서와 API 참고 자료를 모은 사이트입니다. 제품별 안내와 예제를 통해 어떤 서비스를 조합하고 어떻게 연결할지 판단할 수 있습니다.

쉽게 설명하면 어떤 일을 돕는 사이트인가요?

클라우드 개발에 쓰는 부품들의 설명서라고 생각하면 됩니다. 코드를 인터넷에 공개하거나 파일을 저장하고, 앱에 AI 기능을 넣고 싶을 때 필요한 제품과 사용 절차를 찾아볼 수 있습니다. 문서를 읽는 것과 실제 자원을 만드는 것은 별개이며, 실행 작업은 계정, 대시보드, 명령줄 또는 API로 진행합니다.

개발자와 기술 창업자, 서비스 운영자에게 적합합니다. 초보자도 작은 예제로 시작할 수 있지만, 실제 서비스에는 코드 작성, 인증, 테스트와 비용 관리가 필요합니다.

모델 실행과 요청 관리, 에이전트의 차이

Workers AI는 Cloudflare의 GPU 인프라에서 모델을 실행합니다. Worker 안에서 호출하거나 기존 백엔드가 REST API로 접근할 수 있습니다. 텍스트 생성, 임베딩, 이미지 관련 작업은 모델마다 입력과 출력 형식이 다릅니다.

AI Gateway는 지원되는 모델 제공업체로 보내는 요청을 관리합니다. 분석, 로그, 캐시, 속도 제한, 재시도와 모델 대체 경로를 통해 오류와 사용량을 살펴볼 수 있습니다. 모델 자체를 실행하는 기능과 운영 제어를 구분해서 선택하면 됩니다.

Agents는 지속되는 상태, 실시간 연결, 예약 작업과 MCP 도구 등을 사용하는 에이전트에 필요한 실행 기반을 제공합니다. 업무 흐름, 도구 권한과 결과 검증은 개발자가 설계해야 합니다.

첫 Worker를 배포하고 API 응답 확인하기

공식 CLI 시작 안내에 따라 Cloudflare 계정과 지원되는 Node.js 환경을 준비합니다.

1. npm create cloudflare@latest -- my-first-worker를 실행하고 간단한 Worker 예제를 선택합니다.
2. 프로젝트 디렉터리에서 npx wrangler dev를 실행한 뒤 표시된 로컬 주소를 엽니다.
3. 소스의 응답 문구를 변경하고 저장한 다음 새로고침하여 변경 결과를 확인합니다.
4. npx wrangler deploy로 필요한 인증을 마치고 반환된 workers.dev 주소에서 배포 결과를 확인합니다.

모델만 먼저 시험하려면 Workers AI REST 안내에서 Account ID와 API 토큰을 준비합니다. 모델 형식에 맞는 인증 요청을 보내고 JSON 결과와 오류 필드를 확인하세요. 토큰은 서버에서 보관하고, 로컬 개발 중에도 추론 요청이 서비스 한도에 포함될 수 있다는 점을 고려해야 합니다.

파일, 업무 데이터와 검색용 벡터 저장

R2는 파일과 객체, D1은 관계형 SQL 데이터, KV는 키와 값 형태의 데이터에 사용합니다. Durable Objects는 상태 조정에, Vectorize는 임베딩 저장과 유사도 검색에 적합합니다.

문서 질의 앱이라면 원본 파일을 R2에, 업무 기록을 D1에, 검색 벡터를 Vectorize에 두는 구성을 생각할 수 있습니다. 업로드만으로 완성되는 기능은 아니며 수집 처리, 접근 권한과 답변 검증을 구현해야 합니다. 저장소 선택 문서에서 제품별 용도를 비교할 수 있습니다.

무료 문서와 클라우드 무료 할당량 구분

문서는 공개되어 있지만 서비스 실행은 제품별로 과금됩니다. 2026년 10월 7일 확인한 Workers AI 가격 문서에는 하루 10,000 Neurons의 무료 할당량이 있으며 UTC 00:00에 초기화됩니다. 초과 사용에는 Workers Paid가 필요하고, 일부 모델은 유료 결제 방식을 요구합니다.

Gateway의 기본 분석, 캐시와 속도 제한은 무료지만 추론, 로그와 다른 기능에는 비용이 발생할 수 있습니다. Gateway 과금 조건은 최초 게이트웨이 생성 날짜에 따른 로그 과금 차이도 설명합니다. 미국 달러로 안내된 금액을 원화 세금 포함 총액이나 모든 제품의 단일 구독료로 해석해서는 안 됩니다.

프롬프트 로그와 모델 사용 조건 확인

Workers AI 데이터 정책은 명시적 동의 없이 고객 콘텐츠를 모델 학습이나 서비스 개선에 사용하지 않는다고 밝힙니다. 함께 사용하는 저장소에는 콘텐츠가 저장될 수 있으며, 외부 제공업체 정책은 별도로 확인해야 합니다.

AI Gateway 로그는 기본적으로 켜져 있고 프롬프트와 응답을 포함할 수 있습니다. 민감한 데이터 처리 전에 수집 설정을 검토하고, 상업적 사용에는 선택한 모델의 개별 라이선스를 확인하세요.

배포 이후 보안과 성능도 관리

사이트에는 DNS, 캐시, TLS, WAF와 Turnstile 문서도 있습니다. Turnstile은 전체 트래픽을 Cloudflare로 보내지 않고도 웹사이트에 넣을 수 있습니다. 필요한 기능을 별도로 설정해야 하며 Worker 배포가 모든 보안 설정을 대신하지는 않습니다.

자주 묻는 질문

무료 할당량으로 모든 모델을 쓸 수 있나요?

모델마다 결제 조건이 다릅니다. 일일 할당량뿐 아니라 모델별 요구 사항과 요청 속도 제한을 함께 확인해야 합니다.

기존 서버에서 AI API를 호출할 수 있나요?

가능합니다. Account ID와 적절한 권한의 토큰을 사용해 모델별 요청 형식으로 REST API를 호출하면 됩니다.

AI Gateway를 쓰면 모델 호출도 무료인가요?

기본 관리 기능과 모델 추론 비용은 별개입니다. 제공업체, 결제 경로와 로그 비용을 확인해야 합니다.

공식 자료와 개발자 커뮤니티

• API 참고 문서: 엔드포인트와 인증.
• 개발자 Discord: 구현 관련 토론.
• 공식 GitHub: 프로젝트와 소스 코드.
• CloudflareDev: 개발자 제품 소식.
• 공식 지원과 서비스 상태: 문제 해결과 장애 확인.