Cloudflare cf CLI 오픈 베타: 전체 API를 위한 에이전트형 명령줄 인터페이스

cf CLI, 에이전트에게 Cloudflare의 3,000개 이상의 API 작업에 대한 전체 액세스 권한 제공

Cloudflare의 새로운 cf 명령줄 인터페이스는 Wrangler의 약 280개 명령어를 넘어 전체 Cloudflare API 영역으로 커버리지를 확장하여, 에이전트가 단일 도구로 워커 생성, 코드 배포, DNS 관리, 도메인 구매, 보안 구성을 수행할 수 있도록 합니다. 이는 에이전트가 토큰 사용량을 줄이고 임시 --json 플래그나 테이블 파싱의 필요성을 제거하는 일관된 JSON 우선 인터페이스를 갖게 되었음을 의미합니다.

---

JSON 우선 설계로 LLM 기반 자동화의 토큰 비용 절감

이전에 Wrangler를 사용하던 에이전트는 지원되는 몇 안 되는 명령어에 --json을 추가한 다음 jq로 출력을 필터링해야 했습니다. 대부분의 Wrangler 명령어는 사람이 보기 편한 테이블 형식으로 출력되어, 에이전트가 불필요한 서식을 파싱하는 데 추가 토큰을 낭비하게 만들었습니다. cf는 JSON을 기본 출력으로 설정하여 사람이 보기 좋게 예쁘게 출력하면서도 에이전트에게는 간결하게 제공하므로, API 호출 비용을 직접적으로 낮추고 추론 속도를 높입니다.

"에이전트에게는 JSON이 필요할 뿐이며, 만약 에이전트가 이 도구의 미래 주요 사용자라면 JSON이 기본값이 되어야 합니다." – Cloudflare 블로그

---

cf cli search를 통한 에이전트 중심의 명령어 검색

3,000개가 넘는 경로가 존재하므로 에이전트는 컨텍스트를 낭비하지 않고 올바른 작업을 찾을 수 있는 방법이 필요합니다. cf cli search 명령어는 자연어 쿼리를 받아 API 설명과 매개변수를 기반으로 일치하는 명령어의 순위 목록을 반환합니다. 처음 --help를 실행하면 에이전트에게 이 기능이 자동으로 안내됩니다.

---

TypeScript 기반 cloudflare.config.ts로 타입 체크된 구성 가능

새로운 구성 파일은 TypeScript로 작성되어 LSP가 활성화된 에이전트(예: Claude Code, Codex)가 이해하고 자동 완성할 수 있는 스키마를 제공합니다. 타입이 지정된 구성을 통해 에이전트는 환경, 바인딩, 트리거를 안전하게 편집할 수 있으며, Wrangler의 TOML 또는 JSONC 형식보다 오류를 줄일 수 있습니다.

import { bindings, defineConfig } from "cf/config";
import * as entrypoint from "./index.js" with { type: "cf-worker" };

export default defineConfig(({ mode }) => ({
  worker: {
    name: "example-worker",
    entrypoint,
    compatibilityDate: "2026-09-27",
    env: {
      Environment: bindings.text(`This is ${mode} environment`),
    },
  },
}));

이 구성에는 KV, D1, R2, Queues, AI 등을 위한 도우미 함수도 포함되어 있으며, 모두 편집기에서 자동 완성됩니다.

---

Vite 기본 설정으로 현대적인 개발 경험 제공

esbuild와 사용자 정의 개발 서버에 의존하던 Wrangler와 달리, cf는 Vite를 기본 번들러 및 개발 서버로 사용합니다. Vite는 핫 모듈 교체(HMR), 풍부한 플러그인 생태계, Rolldown을 통한 Rust 기반 트리 쉐이킹을 제공합니다. Cloudflare Vite 플러그인과 Vitest 통합은 Workers 런타임을 반영하는 응집력 있는 워크플로우를 제공합니다.

---

Wrangler에서 원활한 마이그레이션

기존 프로젝트는 단일 명령어로 마이그레이션할 수 있습니다:

cf migrate

이미 Vite를 사용하는 Workers는 자동으로 cloudflare.config.ts로 변환됩니다. Wrangler의 esbuild에 의존하는 프로젝트는 빌드를 Wrangler에 계속 위임하여 하위 호환성을 보장합니다. 새 프로젝트는 cf init으로 부트스트랩하거나 정적 사이트의 경우 cf deploy로 직접 배포할 수 있습니다.

---

Hacker News의 커뮤니티 반응

• 긍정적인 반응 – 사용자들은 “요즘 최고의 제품 출시 중 일부는 CLI”라고 언급하며 Wrangler의 대체품을 환영했습니다.
• 에이전트 우선주의에 대한 찬사 – 댓글 작성자들은 JSON 우선 인터페이스와 토큰 사용량을 줄여주는 cf cli search 기능의 이점을 강조했습니다.
• 비판 및 제안 – 일부 사용자는 TypeScript 선택에 의문을 제기하며 CLI를 위한 컴파일 언어를 제안했고, 더 나은 검색 가능성을 위해 OpenCLI 사양 지원을 요청했습니다.
• 운영상의 우려 – 일부는 토큰 생성이 여전히 수동 웹 탐색을 필요로 한다고 지적했으며, 한 사용자는 사전 릴리스 버전에서 CI 실패를 보고했습니다.

"요즘 최고의 제품 출시 중 일부가 CLI라는 것은 놀라운 일입니다." – @emadabdulrahim

"왜 이것이 TypeScript로 작성되었는지 이해할 수 없습니다… 사용자가 CLI의 종속성을 관리하도록 강요하지 마십시오." – @slowin

---

전망: Cloudflare의 주요 운영자로서의 에이전트

Cloudflare는 cf를 떠오르는 에이전트형 개발 워크플로우를 위한 기반 도구로 정의합니다. 명령어 명명 표준화, 검색 가능한 인덱스 제공, 타입 체크된 구성 제공을 통해 이 CLI는 AI 에이전트와 인간 개발자 모두를 위한 기본 인터페이스가 되는 것을 목표로 합니다. 향후 로드맵에는 네이티브 Terraform 내보내기 및 cloudflare.config.ts를 통한 더 광범위한 정책 구성이 포함될 예정입니다.

---

시작하기

오픈 베타 버전을 전역으로 설치하세요:

npm i -g cf

cf --help를 실행하여 검색 힌트를 확인한 다음, cf workers deploy, cf dns create 또는 cf cli search "buy a domain"과 같은 명령어를 탐색해 보세요.

---

cf CLI는 오픈 소스이며, 문제는 GitHub repository에서 보고할 수 있습니다.