Molayo

© 2026 Molayo

Zenn헤드라인2026. 05. 25. 11:51

cf CLI와 Local Explorer 사용해 보기 — Cloudflare 개발도 AI 친화적으로

요약

Cloudflare가 차세대 통합 CLI인 'cf'와 로컬 개발 환경을 시각화하는 'Local Explorer'의 기술 프리뷰를 공개했습니다. 'cf'는 기존 Wrangler를 넘어 Cloudflare의 광범위한 제품군과 AI 에이전트를 위한 컨텍스트를 통합 관리하는 것을 목표로 합니다.

핵심 포인트

  • cf CLI는 Cloudflare 전체 제품군을 아우르는 차세대 통합 도구입니다.
  • Local Explorer를 통해 로컬 KV, R2, D1 등을 브라우저에서 확인 가능합니다.
  • agent-context 명령어를 통해 AI 에이전트 친화적인 환경을 지원합니다.
  • 현재는 Wrangler를 대체하는 것이 아닌, 제품군 확장을 위한 프리뷰 단계입니다.

Cloudflare가 2026년 4월에 Cloudflare 전체를 다루는 새로운 CLI (Command Line Interface)의 기술 프리뷰(Technical Preview)로서 cf를 공개했습니다. 같은 발표에서 로컬 개발 중인 KV / R2 / D1 / Durable Objects / Workflows를 브라우저에서 볼 수 있는 Local Explorer도 소개되었습니다.

먼저 위치를 정리하자면, cf는 지금 당장 Wrangler를 대체할 완성품이 아닙니다. Cloudflare 공식 블로그에서도 "Wrangler의 차기 버전 기술 프리뷰", "현 시점에서는 Cloudflare 제품의 작은 서브셋(Subset)"이라고 설명하고 있습니다.

따라서 이 기사에서는 다음과 같이 나누어 다룹니다.

  • cf CLI: Cloudflare 전체를 조작하는 미래의 통합 CLI 프리뷰
  • Wrangler: Workers의 생성·개발·배포에 계속 사용하는 주력 CLI
  • Local Explorer: Wrangler / Cloudflare Vite plugin의 로컬 개발 서버 위에서 사용할 수 있는 브라우저 UI

Wrangler와의 차이점

Wrangler는 Workers를 중심으로 Cloudflare Developer Platform을 다루기 위한 CLI입니다. 공식 문서에서도 Workers의 생성·개발·배포에 사용하는 명령어로 wrangler dev나 wrangler deploy가 안내되어 있습니다.

반면 cf는 Workers뿐만 아니라 Cloudflare의 더 넓은 제품군을 하나의 CLI로 다루는 방향을 제시한 것입니다. 공식 블로그에서는 CLI commands / Workers Bindings / SDKs / configuration file / Terraform / API docs / Agent Skills 등, Cloudflare의 접점 전체를 일관되게 만들고 싶다는 맥락에서 설명되었습니다.

현 시점에서의 체감으로는 다음과 같이 이해하는 것이 안전합니다.

하고 싶은 것사용하는 것
Workers를 로컬에서 실행Wrangler
...

cf CLI로 무엇을 할 수 있는가

cf를 실행하면 현재 기술 프리뷰에서는 다음과 같은 명령어가 표시됩니다.

npx cf --help

예시:

> npx cf --help
cf
Available commands:
...

wrangler가 Workers 개발의 실무 CLI라면, cf는 Cloudflare의 계정(Account), Zone, DNS, API 스키마(Schema), AI 에이전트용 컨텍스트(Context)에 치중된 입구입니다.

특히 흥미로운 것은 agent-context와 schema입니다.

npx cf agent-context --list
npx cf agent-context dns
npx cf schema --list

agent-context는 Cloudflare 제품별 문맥(Context)이나 도구 정의를 출력하기 위한 명령어입니다. Cloudflare가 "인간뿐만 아니라 AI 에이전트도 다루기 쉬운 CLI"를 의식하고 있음을 알 수 있습니다.

cf CLI 설치 방법

테스트만 해보려면 글로벌 설치는 필요 없습니다.

npx cf

매번 npx로 호출하는 것이 번거롭다면 글로벌로 설치합니다.

npm install -g cf
cf --help

로그인은 다음 명령어입니다.

cf auth login
cf auth whoami

API 토큰을 사용하는 경우에는 --token 또는 --api-token을 지정할 수 있습니다.

cf auth login --token <CLOUDFLARE_API_TOKEN>
cf auth whoami --api-token <CLOUDFLARE_API_TOKEN>

기본 계정이나 Zone을 고정하고 싶다면 context를 사용합니다.

cf context show
cf context set account-id <ACCOUNT_ID>
cf context set zone <ZONE_ID_OR_DOMAIN>

Cloudflare 계정에 대한 작업이므로, 우선은 read 계열의 명령부터 시도하는 것이 안전합니다.

cf accounts list
cf zones list
cf dns records list --zone <ZONE_ID_OR_DOMAIN>

Local Explorer 실행 방법

Local Explorer는 cf 명령어로 실행하는 것이 아니라, Wrangler 또는 Cloudflare Vite plugin의 로컬 개발 서버(local development server) 위에서 열리는 UI입니다.

공식 문서에서는 Wrangler 4.82.1 이후, 또는 Cloudflare Vite plugin 1.32.0 이후를 전제로 하고 있습니다.

Wrangler는 프로젝트 로컬에 설치하는 것이 권장됩니다.

npm i -D wrangler@latest
npx wrangler --version

Workers 프로젝트에서 로컬 개발 서버를 실행합니다.

npx wrangler dev

실행 후, 터미널에서 e를 누르면 Local Explorer가 브라우저에서 열립니다. 직접 여는 경우에는 로컬 서버의 /cdn-cgi/explorer에 접속합니다.

Local Explorer는 wrangler.toml / wrangler.jsonc에 정의된 바인딩(bindings)을 자동으로 감지합니다. 대상은 다음과 같습니다.

Binding할 수 있는 일
KVkey / value / metadata 조회, 생성, 업데이트, 삭제
...

개인적으로는 D1의 내용을 확인하기 위해 임시 코드를 작성할 필요가 줄어드는 점이 가장 고마운 포인트입니다.

AI 에이전트와 궁합이 좋은 이유

Local Explorer에는 브라우저 UI뿐만 아니라, 동일한 작업에 접근할 수 있는 API도 마련되어 있습니다.

curl http://localhost:8787/cdn-cgi/explorer/api

공식 문서에서는 이 엔드포인트(endpoint)가 OpenAPI specification을 반환하며, AI 코딩 에이전트(AI coding agent)가 로컬 바인딩을 발견하고 조작할 수 있다고 설명합니다.

즉, 사람은 UI로 확인하고, 에이전트는 API로 동일한 로컬 상태를 확인할 수 있습니다. Workers + D1 + R2와 같은 앱에서는 다음과 같은 사용법이 현실적입니다.

  • 테스트 데이터를 D1에 넣기
  • Worker가 작성한 KV 값 확인하기
  • Durable Object의 SQLite 상태 보기
  • Workflow의 실패 상태를 확인하고 재시도(retry)하기
  • R2에 테스트 파일 두기

Cloudflare는 이와 별도로 Cloudflare Skills도 공개하고 있습니다. 이는 Claude Code / OpenCode / Codex / Cursor 등, 에이전트 스킬(Agent Skills)에 대응하는 에이전트에게 Cloudflare의 방식(作法)을 전달하기 위한 리포지토리(repository)입니다.

Cloudflare가 공개하고 있는 managed MCP servers도 계정 설정이나 각종 서비스를 MCP 클라이언트에서 다루기 위한 입구로서 마련되어 있습니다.

cf CLI, Local Explorer, Skills, MCP는 서로 다른 것이지만, 지향하는 방향은 같습니다. Cloudflare의 조작 측면을 사람과 AI 에이전트 모두 다루기 쉽게 만드는 것입니다.

먼저 시도해 본다면 이 순서로

기존 Workers 프로젝트가 있다면 다음 순서로 시도해 보는 것이 쉽습니다.

# 1. cf CLI의 분위기 파악하기
npx cf --help
npx cf agent-context --list
...

신규 프로젝트라면, 먼저 Workers의 기본 형태를 만든 후 Local Explorer를 만져보는 것이 이해하기 쉽습니다.

# 앱 등을 적당히 입력하여 프로젝트가 생성됩니다.
npm create cloudflare@latest
cd
...

D1 / KV / R2 등의 바인딩 (binding)이 없는 상태라면 Local Explorer의 유용함은 떨어집니다. 우선 하나라도 바인딩을 추가한 뒤에 살펴보는 것을 추천합니다.

요약

cf CLI는 Cloudflare 전체를 다루는 통합 CLI를 향한 기술 프리뷰 (technical preview)입니다. 지금 당장 Wrangler를 대신해서 사용하는 것은 아니지만, 계정 (account), Zone, DNS, 스키마 (schema), 에이전트용 컨텍스트 (agent context)를 CLI에서 다루기 위한 입구로서의 방향성을 보여줍니다.

Local Explorer는 Wrangler / Vite plugin의 로컬 개발을 상당히 편리하게 만들어 주는 기능입니다. 특히 KV / R2 / D1 / Durable Objects / Workflows를 사용하는 Workers 앱에서는 로컬 상태를 브라우저에서 확인할 수 있다는 것만으로도 디버깅 단계가 줄어듭니다.

먼저 접해본다면, npx cf --help로 CLI의 전체상을 살펴본 뒤, 기존 Workers 프로젝트에서 npx wrangler dev를 실행하고 /cdn-cgi/explorer를 여는 것이 좋아 보입니다.

공개 전 확인 사항:

  • npx cf --help의 출력이 기사 내용과 일치하는지
  • Wrangler 버전이 4.82.1 이상인지
  • Local Explorer 스크린샷에 기밀 정보가 포함되어 있지 않은지

Discussion

AI 자동 생성 콘텐츠

본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0