CLI: create-next-app

CLI: create-next-app | Next.js

소스 URL: https://nextjs.org/docs/app/api-reference/cli/create-next-app

create-next-app

마지막 업데이트 2026년 2월 20일

create-next-app CLI를 사용하면 기본 템플릿이나 공개 GitHub 리포지토리의 예제를 통해 새로운 Next.js 애플리케이션을 만들 수 있습니다. Next.js를 시작하는 가장 쉬운 방법입니다.

기본 사용법:

pnpmnpmyarnbun

Terminal

    pnpm create next-app [project-name] [options]

Reference

다음 옵션을 사용할 수 있습니다:

Options	Description
-h 또는 --help	사용 가능한 모든 옵션 표시
-v 또는 --version	버전 번호 출력
--no-*	기본 옵션을 무시합니다. 예: --no-ts
--ts 또는 --typescript	TypeScript 프로젝트로 초기화(기본값)
--js 또는 --javascript	JavaScript 프로젝트로 초기화
--tailwind	Tailwind CSS 구성으로 초기화(기본값)
--react-compiler	React Compiler를 활성화한 상태로 초기화
--eslint	ESLint 구성으로 초기화
--biome	Biome 구성으로 초기화
--no-linter	린터 구성을 건너뜀
--app	App Router 프로젝트로 초기화
--api	라우트 핸들러만 있는 프로젝트로 초기화
--src-dir	src/ 디렉터리 안에 초기화
--turbopack	생성된 package.json에서 Turbopack을 강제로 활성화(기본 활성화)
--webpack	생성된 package.json에서 Webpack을 강제로 활성화
--import-alias <alias-to-configure>	사용할 import 별칭 지정(기본값 ”@/*“)
--empty	빈 프로젝트로 초기화
--use-npm	npm으로 애플리케이션을 부트스트랩하도록 명시
--use-pnpm	pnpm으로 애플리케이션을 부트스트랩하도록 명시
--use-yarn	Yarn으로 애플리케이션을 부트스트랩하도록 명시
--use-bun	Bun으로 애플리케이션을 부트스트랩하도록 명시
-e 또는 --example [name] [github-url]	앱을 부트스트랩할 예제 지정
--example-path <path-to-example>	예제 경로를 별도로 지정
--reset-preferences	저장된 모든 환경설정을 초기화하도록 명시
--skip-install	패키지 설치를 건너뛰도록 명시
--disable-git	git 초기화를 비활성화하도록 명시
--yes	모든 옵션에 기존 환경설정 또는 기본값 사용

Examples

기본 템플릿 사용

기본 템플릿으로 새 앱을 생성하려면 터미널에서 다음 명령을 실행합니다:

pnpmnpmyarnbun

Terminal

    pnpm create next-app

설치 과정에서 다음과 같은 프롬프트가 표시됩니다:

Terminal

    What is your project named? my-app
    Would you like to use the recommended Next.js defaults?
        Yes, use recommended defaults - TypeScript, ESLint, Tailwind CSS, App Router, Turbopack
        No, reuse previous settings
        No, customize settings - Choose your own preferences

customize settings를 선택하면 다음 프롬프트가 이어집니다:

Terminal

    Would you like to use TypeScript? No / Yes
    Which linter would you like to use? ESLint / Biome / None
    Would you like to use React Compiler? No / Yes
    Would you like to use Tailwind CSS? No / Yes
    Would you like your code inside a `src/` directory? No / Yes
    Would you like to use App Router? (recommended) No / Yes
    Would you like to customize the import alias (`@/*` by default)? No / Yes
    What import alias would you like configured? @/*

프롬프트가 끝나면 create-next-app이 프로젝트 이름으로 폴더를 생성하고 필요한 의존성을 설치합니다.

Linter Options

ESLint : 전통적이면서 가장 널리 쓰이는 JavaScript 린터입니다. @next/eslint-plugin-next에서 제공하는 Next.js 전용 규칙을 포함합니다.

Biome : ESLint와 Prettier 기능을 결합한 빠르고 현대적인 린터 겸 포매터입니다. 최적의 성능을 위해 Next.js와 React 도메인을 기본 지원합니다.

None : 린터 구성을 완전히 건너뜁니다. 나중에 언제든 린터를 추가할 수 있습니다.

모든 프롬프트에 답하면 선택한 구성으로 새 프로젝트가 생성됩니다.

공식 Next.js 예제 사용

공식 Next.js 예제를 사용해 새 앱을 만들려면 --example 플래그를 사용합니다. 예:

pnpmnpmyarnbun

Terminal

    pnpm create next-app --example [example-name] [your-project-name]

사용 가능한 모든 예제와 설정 방법은 Next.js 저장소에서 확인할 수 있습니다.

임의의 공개 GitHub 예제 사용

공개 GitHub 예제를 사용해 새 앱을 만들려면 GitHub 리포지토리 URL과 함께 --example 옵션을 사용합니다. 예:

pnpmnpmyarnbun

Terminal

    pnpm create next-app --example "https://github.com/.../" [your-project-name]

supported.

Send