new
ng new [name] [options]ng n [name] [options]초기 애플리케이션이 포함된 새 Angular 작업 공간을 생성하고 초기화합니다.
라우팅 지원 추가 같은 선택적 설정에 대해 대화형 프롬프트를 제공합니다. 모든 프롬프트에서 기본값을 그대로 사용해도 괜찮습니다.
새 작업 공간 폴더에는 지정한 프로젝트 이름을 사용하며, 최상위에 설정 파일이 들어 있습니다.
기본적으로 새 초기 애플리케이션(작업 공간과 같은 이름)의 파일은
src/하위 폴더에 배치됩니다.새 애플리케이션의 설정은 작업 공간 설정 파일
angular.json의projects섹션 아래에 해당 프로젝트 이름으로 나타납니다.이후 작업 공간에 생성하는 애플리케이션은
projects/하위 폴더에 위치합니다.
작업 공간에서 여러 애플리케이션을 사용할 계획이라면 --no-create-application 옵션으로 빈 작업 공간을 생성할 수 있습니다.
그런 다음 ng generate application으로 초기 애플리케이션을 생성하세요.
이렇게 하면 작업 공간 이름과 초기 앱 이름을 다르게 정할 수 있고, 모든 애플리케이션이 설정 파일 구조와 일치하는 /projects 하위 폴더에 위치하게 됩니다.
인자
name새 작업 공간과 초기 프로젝트의 이름입니다. 루트 디렉터리와 프로젝트 전반의 여러 식별자에 사용됩니다.
string옵션
ai-config설정 파일을 생성할 AI 도구를 지정합니다. 이 파일들은 모범 사례를 따르도록 하여 AI 도구의 출력 품질을 개선하는 데 사용됩니다.
array허용되는 값claude-code, cursor, gemini-cli, none, open-ai-codex, vscodecollectionc초기 애플리케이션을 생성하는 데 사용할 스키매틱 컬렉션입니다.
stringcommit새 저장소의 초기 Git 커밋을 설정합니다.
boolean기본값truecreate-application새 작업 공간에 초기 애플리케이션 프로젝트를 생성합니다. false이면 초기 애플리케이션이 없는 빈 작업 공간을 생성합니다. 이후 ng generate application 명령으로 projects 디렉터리에 애플리케이션을 생성할 수 있습니다.
boolean기본값truedefaults기본값이 있는 옵션의 대화형 입력 프롬프트를 비활성화합니다.
boolean기본값falsedirectory새 작업 공간과 프로젝트를 생성할 디렉터리입니다. 지정하지 않으면 현재 디렉터리 아래에 작업 공간 이름을 사용한 하위 폴더를 생성합니다.
stringdry-rund결과를 기록하지 않고 작업을 실행하며 수행 내용을 보고합니다.
boolean기본값falsefile-name-style-guide생성할 파일의 이름 규칙입니다. '2025' 스타일 가이드(기본값)는 간결한 형식(예: 루트 컴포넌트의 app.ts)을 사용하고, '2016' 스타일 가이드는 파일 이름에 유형(예: app.component.ts)을 포함합니다. 자세한 내용은 Angular 스타일 가이드(https://angular.dev/style-guide)를 참고하세요.
string허용되는 값2016, 2025기본값2025force기존 파일을 강제로 덮어씁니다.
boolean기본값falsehelp이 명령의 도움말을 콘솔에 표시합니다.
booleaninline-styles초기 애플리케이션의 루트 컴포넌트 스타일을 app.ts 파일에 직접 포함합니다. 기본적으로 별도 스타일시트 파일(예: app.css)이 생성됩니다.
booleaninline-templatet초기 애플리케이션의 루트 컴포넌트 HTML 템플릿을 app.ts 파일에 직접 포함합니다. 기본적으로 별도 템플릿 파일(예: app.html)이 생성됩니다.
booleaninteractive대화형 입력 프롬프트를 활성화합니다.
boolean기본값trueminimal테스트 프레임워크 없이 최소한의 Angular 작업 공간을 생성합니다. 프로덕션 애플리케이션이 아니라 학습과 간단한 실험을 위한 옵션입니다.
boolean기본값falsenew-project-root작업 공간에서 새 프로젝트를 생성할 경로이며 작업 공간 루트 기준 상대 경로입니다. 기본적으로 새 프로젝트는 projects 디렉터리에 생성됩니다.
string기본값projectspackage-manager의존성 설치에 사용할 패키지 관리자입니다.
string허용되는 값bun, npm, pnpm, yarnprefixp초기 프로젝트의 생성된 선택자에 적용할 접두사입니다. 예를 들어 접두사가 my-app이고 my-component라는 컴포넌트를 생성하면 선택자는 my-app-my-component가 됩니다.
string기본값approuting초기 애플리케이션 프로젝트에서 라우팅을 활성화합니다. 애플리케이션의 여러 뷰 사이에서 이동을 관리하는 데 필요한 파일과 모듈을 구성합니다.
booleanskip-gitg새 작업 공간에서 Git 저장소를 초기화하지 않습니다. 기본적으로는 프로젝트 변경 사항을 추적할 수 있도록 Git 저장소를 초기화합니다.
boolean기본값falseskip-install패키지 자동 설치를 건너뜁니다. 나중에 의존성을 직접 설치해야 합니다.
boolean기본값falseskip-testsS단위 테스트 파일 spec.ts 생성을 건너뜁니다.
boolean기본값falsessr초기 애플리케이션에 서버 사이드 렌더링(SSR)과 정적 사이트 생성(SSG/사전 렌더링)을 설정합니다.
booleanstandaloneNgModule 없이 독립형 API를 기반으로 하는 애플리케이션을 생성합니다.
boolean기본값truestrict더 엄격한 타입 검사와 번들 크기 예산 설정을 활성화합니다. 이 설정은 유지보수성을 개선하고 버그를 미리 발견하는 데 도움이 됩니다. 자세한 내용은 https://angular.dev/tools/cli/template-typecheck#strict-mode 를 참고하세요.
boolean기본값truestyle초기 프로젝트의 컴포넌트에 생성할 스타일시트 파일 유형입니다.
string허용되는 값css, less, sass, scss, tailwindtest-runner사용할 단위 테스트 실행기입니다.
string허용되는 값karma, vitest기본값vitestview-encapsulation초기 프로젝트 컴포넌트의 뷰 캡슐화 모드를 설정합니다. 컴포넌트 스타일의 적용 범위와 적용 방식을 결정합니다. 옵션은 Emulated(기본값, 스타일을 컴포넌트로 제한), None(전역 스타일), ShadowDom(Shadow DOM을 사용해 스타일 캡슐화)입니다.
string허용되는 값Emulated, None, ShadowDomzonelesszone.js를 사용하지 않는 초기 애플리케이션을 생성합니다.
boolean