Cloudflare, 에이전트 개발 위한 새로운 CLI 'cf' 공개

새로운 CLI 'cf'의 등장과 변화

Cloudflare는 에이전트 기반 소프트웨어 개발을 지원하기 위해 새로운 명령줄 인터페이스(CLI) 도구인 'cf'를 오픈 베타로 출시한다. 'cf'는 기존 'Wrangler' CLI가 약 280개의 작업만 지원했던 것과 달리, 3,000개 이상의 Cloudflare API 전체에 접근할 수 있도록 설계되었다. 이로써 에이전트가 Cloudflare의 모든 제품 기능을 단일 도구로 활용할 수 있게 된다.

'cf'는 차세대 소프트웨어 개발 환경에 맞춰 에이전트 친화적인 기능을 기본으로 제공한다. 기본 출력 형식으로 JSON을 채택하여 에이전트가 데이터를 효율적으로 처리할 수 있도록 하며, TypeScript 기반의 새로운 설정 형식인 `cloudflare.config.ts`를 도입하여 설정의 안전성과 정확성을 높인다. 또한, Vite를 기본 개발 서버로 통합하여 개발자에게 최적화된 로컬 개발 환경을 제공한다.

에이전트 개발 환경의 진화와 배경

Cloudflare는 지난 1년간 'Wrangler' CLI에서 에이전트 사용량이 급증했음을 확인했다. 2026년 3월에는 전체 'Wrangler' 사용량의 25%를 에이전트가 차지했으며, 최근에는 이 수치가 48%에 달했다. 에이전트는 인간 사용자보다 하루에 거의 두 배 많은 명령을 사용하고, 6개 이상의 명령을 사용할 확률이 약 4배 높은 것으로 나타났다.

기존 'Wrangler'는 각 제품 팀이 개별적으로 개발하여 명령어 경험에 일관성이 부족했다. 예를 들어, `d1 info`, `hyperdrive get`, `workflows describe`와 같은 명령어에서 용어의 불일치가 발생했다. Cloudflare는 이러한 문제를 해결하고 API 지원 범위를 대폭 확장하기 위해 새로운 통합 API 생성 파이프라인인 'Forge'를 구축했다. 'Forge'는 OpenAPI 스키마를 기반으로 CLI 명령어를 직접 생성하여, 'cf'가 Cloudflare API 전체를 포괄할 수 있도록 한다.

새로운 CLI인 'cf'를 도입하는 것은 기존 'Wrangler'의 동작 방식이 대규모 언어 모델(LLM) 학습에 이미 반영되어 있어, 'Wrangler'를 크게 변경하는 것보다 에이전트에게 혼란을 줄이는 가장 깔끔한 방법으로 판단되었다. 'cf'는 에이전트 중심의 설계와 `AGENTS.md` 파일과 같은 기능을 통해 에이전트가 새로운 도구에 더 쉽게 적응하도록 돕는다.

'cf'의 핵심 기능 및 구체적 구현

'cf'는 에이전트가 필요한 명령어를 쉽게 찾을 수 있도록 `cf cli search` 기능을 제공한다. 이 명령어는 자연어 질의를 통해 API 설명과 매개변수를 기반으로 적절한 명령어 목록을 제공하며, 에이전트가 `--help`를 처음 실행할 때 이 기능을 자동으로 안내한다. 또한, 'cf'는 기본적으로 JSON 출력을 제공하여 에이전트가 `jq`와 같은 도구로 결과를 쉽게 필터링하고 필요한 정보를 추출할 수 있도록 한다.

새로운 설정 형식인 `cloudflare.config.ts`는 TypeScript 기반으로, 인간과 에이전트 모두에게 파싱하기 쉽고 프로그래밍 방식으로 설정을 정의할 수 있게 한다. 이는 LSP(Language Server Protocol) 플러그인을 사용하는 에이전트(예: Claude Code, Codex)가 설정 파일 형식을 더 정확하게 해석하고 제안하는 데 도움이 된다. Cloudflare 내부에서는 이 새로운 설정 형식을 통해 일부 'Wrangler' 설정 파일의 줄 수가 40% 이상 감소하는 효과를 보았다.

설정 파일 내에서 Worker 개발을 돕는 `bindings` 및 `triggers` 헬퍼 함수도 제공된다. `bindings`는 환경 변수, 스토리지, 데이터베이스, 큐 등 개발 플랫폼이 제공하는 모든 기능을 에이전트가 쉽게 발견하고 자동 완성할 수 있도록 하며, `triggers`는 Worker의 라우트, 큐, 스케줄, 이메일 트리거를 단일 블록에서 정의할 수 있게 한다. `defineConfig.worker`는 시작점이며, `cloudflare.config.ts`는 향후 전체 Cloudflare 제품(정책, 존, DNS 등)을 타입 안전하게 관리하는 데 사용될 예정이다.

개발 환경 측면에서 'cf'는 Vite를 기본 빌드 도구로 채택한다. Vite는 HMR(Hot Module Replacement)을 지원하는 최상의 개발 서버와 Rust 기반 Rolldown 라이브러리를 사용한 트리 쉐이킹 빌드를 제공한다. Cloudflare Vite Plugin은 Workers를 구축하는 권장 방식으로, Vitest 플러그인과 함께 Workers 런타임에 맞는 응집력 있는 개발 및 테스트 환경을 제공한다.

개발자 및 에이전트에 미치는 영향

'cf'의 도입은 에이전트가 Cloudflare의 광범위한 API를 활용하여 Worker 설정, 배포, 모니터링, Cloudflare Access를 통한 보호, 도메인 구매, Cloudflare WAF 적용 등 복잡한 작업을 단일 도구로 수행할 수 있게 함으로써 에이전트 기반 개발의 가능성을 크게 확장한다. 에이전트의 작업 효율성은 JSON 기본 출력과 자연어 명령 탐색 기능으로 더욱 향상된다.

개발자에게는 TypeScript 기반의 `cloudflare.config.ts`가 설정의 정확성과 유지보수성을 높여준다. 프로그래밍 방식의 설정 정의는 여러 환경을 효율적으로 관리하고, `bindings` 및 `triggers` 헬퍼를 통해 Worker 설정을 간소화한다. Vite의 통합은 HMR과 풍부한 플러그인 생태계를 통해 로컬 개발 경험을 개선하며, Cloudflare Vite Plugin과 Vitest 플러그인은 Workers 개발 및 테스트를 위한 일관된 환경을 제공한다.

적용 조건, 마이그레이션 및 향후 계획

'cf'는 현재 오픈 베타로 제공되며, 전역으로 설치하여 사용할 수 있다. 기존 'Wrangler' 사용자는 `cf migrate` 명령어를 통해 Worker를 새로운 `cloudflare.config.ts` 형식으로 마이그레이션할 수 있다. Vite로 빌드되는 Worker는 자동으로 변환되며, `esbuild`를 사용하는 JavaScript Worker나 Rust 및 Python Worker의 경우 'cf'는 계속해서 'Wrangler'에 빌드 및 배포를 위임한다.

오픈 베타 종료 후 Cloudflare는 'Wrangler'의 최종 주요 버전을 출시하여 사용자에게 'cf' 사용을 안내할 예정이다. 'Wrangler'는 베타 종료 후 18개월 동안 유지보수 지원을 계속 제공하여 사용자가 마이그레이션할 충분한 시간을 확보하도록 한다. 새로운 프로젝트는 `cf init/deploy` 명령어를 통해 Cloudflare Vite Plugin과 설정 파일을 자동으로 구성할 수 있으며, 정적 사이트는 `cf deploy`만으로 배포할 수 있다. 'cf'는 오픈 소스로 제공되며, GitHub 저장소에서 이슈를 보고할 수 있다.