terminal

KO | EN

gitlite — search

#python #hacktoberfest #typescript #llm #android #rust #deep-learning #docker #windows #awesome #cli #awesome-list #security #open-source

(★ 104,622)

새로운 Windows Terminal과 기존 Windows 콘솔 호스트가 모두 한곳에 모여 있습니다!

terminal 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Windows Terminal project logos and branding image](https://github.com/microsoft/terminal/assets/91625426/333ddc76-8ab2-4eb4-a8c0-4d7b953b1179)

[![Terminal Build Status](https://dev.azure.com/shine-oss/terminal/_apis/build/status%2FTerminal%20CI?branchName=main)](https://dev.azure.com/shine-oss/terminal/_build/latest?definitionId=1&branchName=main)

# Windows Terminal, Console 및 Command-Line 저장소에 오신 것을 환영합니다

- [Windows Terminal 설치 및 실행](#installing-and-running-windows-terminal)
  - [Microsoft Store [권장]](#microsoft-store-recommended)
  - [기타 설치 방법](#other-install-methods)
    - [GitHub를 통해](#via-github)
    - [Windows Package Manager CLI (일명 winget)를 통해](#via-windows-package-manager-cli-aka-winget)
    - [Chocolatey를 통해 (비공식)](#via-chocolatey-unofficial)
    - [Scoop을 통해 (비공식)](#via-scoop-unofficial)
- [Windows Terminal Canary 설치](#installing-windows-terminal-canary)
- [Terminal 및 Console 개요](#terminal--console-overview)
  - [Windows Terminal](#windows-terminal)
  - [The Windows Console Host](#the-windows-console-host)
  - [공유 구성 요소](#shared-components)
  - [새로운 Windows Terminal 만들기](#creating-the-new-windows-terminal)
- [리소스](#resources)
- [FAQ](#faq)
  - [새 Terminal을 빌드하고 실행했는데 예전 콘솔과 똑같이 생겼습니다](#i-built-and-ran-the-new-terminal-but-it-looks-just-like-the-old-console)
- [문서](#documentation)
- [기여하기](#contributing)
- [팀과 소통하기](#communicating-with-the-team)
- [개발자 지침](#developer-guidance)
- [필수 조건](#prerequisites)
- [코드 빌드하기](#building-the-code)
  - [PowerShell에서 빌드하기](#building-in-powershell)
  - [Cmd에서 빌드하기](#building-in-cmd)
- [실행 및 디버깅](#running--debugging)
  - [코딩 지침](#coding-guidance)
- [행동 강령](#code-of-conduct)

</details>

<br />

이 저장소에는 다음 항목에 대한 소스 코드가 포함되어 있습니다:

* [Windows Terminal](https://aka.ms/terminal)
* [Windows Terminal Preview](https://aka.ms/terminal-preview)
* Windows 콘솔 호스트 (`conhost.exe`)
* 두 프로젝트 간에 공유되는 구성 요소
* [ColorTool](./src/tools/ColorTool)
* Windows 콘솔 API를 사용하는 방법을 보여주는 [샘플 프로젝트들](./samples)

관련 저장소는 다음과 같습니다:

* [Windows Terminal Documentation](https://docs.microsoft.com/windows/terminal)
  ([저장소: 문서 기여하기](https://github.com/MicrosoftDocs/terminal))
* [Console API Documentation](https://github.com/MicrosoftDocs/Console-Docs)
* [Cascadia Code Font](https://github.com/Microsoft/Cascadia-Code)

## Windows Terminal 설치 및 실행

> [!NOTE]
> Windows Terminal을 사용하려면 Windows 10 2004(빌드 19041) 이상이 필요합니다.

### Microsoft Store [권장]

[Microsoft Store에서 Windows Terminal][store-install-link]을 설치하세요.
자동 업그레이드를 통해 새로운 빌드가 릴리스될 때 항상 최신 버전을 유지할 수 있습니다.

이 방법이 권장되는 방식입니다.

### 기타 설치 방법

#### GitHub를 통해

Microsoft Store에서 Windows Terminal을 설치할 수 없는 사용자의 경우, 릴리스된 빌드를 이 저장소의 [Releases 페이지](https://github.com/microsoft/terminal/releases)에서 수동으로 다운로드할 수 있습니다.

**Assets** 섹션에서 `Microsoft.WindowsTerminal_<versionNumber>.msixbundle` 파일을 다운로드하세요. 앱을 설치하려면 `.msixbundle` 파일을 두 번 클릭하기만 하면 앱 설치 프로그램이 자동으로 실행됩니다. 어떤 이유로 실패하는 경우, PowerShell 프롬프트에서 다음 명령어를 시도해 볼 수 있습니다:

```powershell
# NOTE: If you are using PowerShell 7+, please run
# Import-Module Appx -UseWindowsPowerShell
# before using Add-AppxPackage.

Add-AppxPackage Microsoft.WindowsTerminal_<versionNumber>.msixbundle
```

> [!NOTE]
> Terminal을 수동으로 설치하는 경우:
>
> * [VC++ v14 Desktop Framework Package](https://docs.microsoft.com/troubleshoot/cpp/c-runtime-packages-desktop-bridge#how-to-install-and-update-desktop-framework-packages)를 설치해야 할 수 있습니다.
>   이는 구버전의 Windows 10 빌드에서 누락된 프레임워크 패키지 관련 오류가 발생하는 경우에만 필요합니다.
> * 새 빌드가 릴리스되어도 Terminal이 자동으로 업데이트되지 않으므로, 모든 최신 수정 사항과 개선 사항을 적용하려면 최신 Terminal 릴리스를 정기적으로 설치해야 합니다!

#### Windows Package Manager CLI (일명 winget)를 통해

[winget](https://github.com/microsoft/winget-cli) 사용자는 `Microsoft.WindowsTerminal` 패키지를 설치하여 최신 Terminal 릴리스를 다운로드하고 설치할 수 있습니다:

```powershell
winget install --id Microsoft.WindowsTerminal -e
```

> [!NOTE]
> 종속성 지원은 WinGet 버전 [1.6.2631 이상](https://github.com/microsoft/winget-cli/releases)에서 사용할 수 있습니다. Terminal 안정 버전 1.18 이상을 설치하려면 WinGet 클라이언트의 업데이트된 버전을 사용하고 있는지 확인하세요.

#### Chocolatey를 통해 (비공식)

[Chocolatey](https://chocolatey.org) 사용자는 `microsoft-windows-terminal` 패키지를 설치하여 최신 Terminal 릴리스를 다운로드하고 설치할 수 있습니다:

```powershell
choco install microsoft-windows-terminal
```

Chocolatey를 사용하여 Windows Terminal을 업그레이드하려면 다음을 실행하세요:

```powershell
choco upgrade microsoft-windows-terminal
```

패키지를 설치/업그레이드하는 동안 문제가 발생하면 [Windows Terminal 패키지 페이지](https://chocolatey.org/packages/microsoft-windows-terminal)로 이동하여 [Chocolatey 분류 프로세스(triage process)](https://chocolatey.org/docs/package-triage-process)를 따르세요.

#### Scoop을 통해 (비공식)

[Scoop](https://scoop.sh) 사용자는 `windows-terminal` 패키지를 설치하여 최신 Terminal 릴리스를 다운로드하고 설치할 수 있습니다:

```powershell
scoop bucket add extras
scoop install windows-terminal
```

Scoop을 사용하여 Windows Terminal을 업데이트하려면 다음을 실행하세요:

```powershell
scoop update windows-terminal
```

패키지를 설치/업데이트하는 동안 문제가 발생하면 Scoop Extras 버킷 저장소의 [이슈 페이지](https://github.com/lukesampson/scoop-extras/issues)에서 동일한 문제를 검색하거나 보고해 주세요.

---

## Windows Terminal Canary 설치
Windows Terminal Canary는 Windows Terminal의 매일 빌드되는 야간 빌드(nightly build) 버전입니다. 이 빌드에는 `main` 브랜치의 최신 코드가 포함되어 있어, Windows Terminal Preview에 반영되기 전에 기능을 먼저 체험해 볼 수 있습니다.

Windows Terminal Canary는 가장 안정성이 낮은 제품이므로, 아직 발견하지 못한 버그를 마주할 수도 있습니다.

Windows Terminal Canary는 앱 설치 프로그램(App Installer) 배포판과 포터블 ZIP 배포판으로 제공됩니다.

앱 설치 프로그램 배포판은 자동 업데이트를 지원합니다. 플랫폼 제한으로 인해 이 설치 프로그램은 Windows 11에서만 작동합니다.

포터블 ZIP 배포판은 무설치(포터블) 응용 프로그램입니다. 자동으로 업데이트되지 않으며 업데이트를 자동으로 확인하지도 않습니다. 이 포터블 ZIP 배포판은 Windows 10(19041+) 및 Windows 11에서 작동합니다.

| 배포판 | 아키텍처 | 링크 |
|---|:---:|---|
| App Installer | x64, arm64, x86 | [다운로드](https://aka.ms/terminal-canary-installer) |
| Portable ZIP | x64 | [다운로드](https://aka.ms/terminal-canary-zip-x64) |
| Portable ZIP | ARM64 | [다운로드](https://aka.ms/terminal-canary-zip-arm64) |
| Portable ZIP | x86 | [다운로드](https://aka.ms/terminal-canary-zip-x86) |

_Windows Terminal 배포 유형에 대해 [자세히 알아보세요](https://learn.microsoft.com/windows/terminal/distributions)._

---

## Terminal 및 Console 개요

코드를 살펴보기 전에 아래 개요를 잠시 읽어보시는 것을 권장합니다:

### Windows Terminal

Windows Terminal은 명령줄 사용자를 위한 새롭고 현대적이며 기능이 풍부한 생산적인 터미널 응용 프로그램입니다. 탭 지원, 서식 있는 텍스트(rich text), 세계화, 구성 가능성, 테마 및 스타일 지정 등 Windows 명령줄 커뮤니티에서 가장 자주 요청하는 많은 기능이 포함되어 있습니다.

또한 Terminal은 빠르고 효율적으로 유지되며 방대한 양의 메모리나 전력을 소비하지 않도록 목표와 측정 기준을 충족해야 합니다.

### The Windows Console Host

Windows 콘솔 호스트인 `conhost.exe`는 Windows의 원래 명령줄 사용자 경험입니다. 또한 Windows의 명령줄 인프라와 Windows 콘솔 API 서버, 입력 엔진, 렌더링 엔진, 사용자 기본 설정 등을 호스팅합니다. 이 저장소의 콘솔 호스트 코드는 Windows 자체의 `conhost.exe`가 빌드되는 실제 소스입니다.

2014년에 Windows 명령줄의 소유권을 인수한 이래로, 팀은 배경 투명도, 줄 단위 선택, [ANSI / 가상 터미널 시퀀스](https://en.wikipedia.org/wiki/ANSI_escape_code) 지원, [24비트 색상](https://devblogs.microsoft.com/commandline/24-bit-color-in-the-windows-console/), [의사 콘솔("ConPTY")](https://devblogs.microsoft.com/commandline/windows-command-line-introducing-the-windows-pseudo-console-conpty/) 등을 포함한 여러 새로운 기능을 콘솔에 추가했습니다.

그러나 Windows Console의 주된 목표는 하위 호환성 유지를 유지하는 것이므로, 지난 몇 년 동안 커뮤니티(그리고 팀)가 원했던 탭, 유니코드 텍스트, 이모지와 같은 많은 기능을 추가할 수 없었습니다.

이러한 제약으로 인해 새로운 Windows Terminal을 만들게 되었습니다.

> 명령줄의 일반적인 진화 과정과 특히 Windows 명령줄의 진화에 대해 더 알아보려면 명령줄 팀 블로그의 [관련 블로그 게시물 시리즈](https://devblogs.microsoft.com/commandline/windows-command-line-backgrounder/)를 참고하세요.

### 공유 구성 요소

Windows Console을 개편하는 동안 코드베이스를 대폭 현대화하고, 논리적 개체를 모듈과 클래스로 깔끔하게 분리하고, 몇 가지 핵심 확장성 포인트를 도입했으며, 오래된 자체 제작 컬렉션 및 컨테이너를 더 안전하고 효율적인 [STL 컨테이너](https://docs.microsoft.com/en-us/cpp/standard-library/stl-containers?view=vs-2022)로 교체했습니다. 또한 Microsoft의 [Windows Implementation Libraries - WIL](https://github.com/Microsoft/wil)을 사용하여 코드를 더 단순하고 안전하게 만들었습니다.

이러한 개편의 결과로 Console의 주요 구성 요소 중 상당수가 Windows의 모든 터미널 구현에서 재사용 가능하게 되었습니다. 이러한 구성 요소에는 새로운 DirectWrite 기반 텍스트 레이아웃 및 렌더링 엔진, UTF-16과 UTF-8을 모두 저장할 수 있는 텍스트 버퍼, VT 파서/이미터 등이 포함됩니다.

### 새로운 Windows Terminal 만들기

새로운 Windows Terminal 응용 프로그램을 계획하기 시작했을 때, 우리는 여러 접근 방식과 기술 스택을 탐색하고 평가했습니다. 궁극적으로 C++ 코드베이스에 대한 투자를 지속하는 것이 우리의 목표를 가장 잘 달성할 수 있는 방법이라고 판단했으며, 이를 통해 기존 Console과 새로운 Terminal 모두에서 앞서 언급한 현대화된 구성 요소 중 여러 개를 재사용할 수 있게 되었습니다. 나아가, 이를 통해 Terminal 코어 자체를 다른 사람들이 자신의 응용 프로그램에 통합할 수 있는 재사용 가능한 UI 제어로 구축할 수 있음을 깨달았습니다.

이 작업의 결과물은 이 저장소 내에 포함되어 있으며, Microsoft Store 또는 [이 저장소의 릴리스 페이지](https://github.com/microsoft/terminal/releases)에서 다운로드할 수 있는 Windows Terminal 응용 프로그램으로 제공됩니다.

---

## 리소스

Windows Terminal에 대한 자세한 정보를 원하신다면 다음 리소스들이 유용하고 흥미로울 것입니다:

* [Command-Line Blog](https://devblogs.microsoft.com/commandline)
* [Command-Line Backgrounder Blog Series](https://devblogs.microsoft.com/commandline/windows-command-line-backgrounder/)
* Windows Terminal 런칭: [Terminal "Sizzle Video"](https://www.youtube.com/watch?v=8gw0rXPMMPE&list=PLEHMQNlPj-Jzh9DkNpqipDGCZZuOwrQwR&index=2&t=0s)
* Windows Terminal 런칭: [Build 2019 Session](https://www.youtube.com/watch?v=KMudkRcwjCw)
* Run As Radio: [Show 645 - Windows Terminal with Richard Turner](https://www.runasradio.com/Shows/Show/645)
* Azure DevOps Podcast: [Episode 54 - Kayla Cinnamon and Rich Turner on DevOps on the Windows Terminal](http://azuredevopspodcast.clear-measure.com/kayla-cinnamon-and-rich-turner-on-devops-on-the-windows-terminal-team-episode-54)
* Microsoft Ignite 2019 Session: [The Modern Windows Command Line: Windows Terminal - BRK3321](https://myignite.techcommunity.microsoft.com/sessions/81329?source=sessions)

---

## FAQ

### 새 Terminal을 빌드하고 실행했는데 예전 콘솔과 똑같이 생겼습니다

원인: Visual Studio에서 잘못된 솔루션을 실행하고 있습니다.

해결책: Visual Studio에서 `CascadiaPackage` 프로젝트를 빌드하고 배포하고 있는지 확인하세요.

> [!NOTE]
> `OpenConsole.exe`는 로컬에서 빌드된 `conhost.exe`, 즉 Windows의 명령줄 인프라를 호스팅하는 클래식 Windows Console일 뿐입니다. OpenConsole은 Windows Terminal이 ([ConPty](https://devblogs.microsoft.com/commandline/windows-command-line-introducing-the-windows-pseudo-console-conpty/)를 통해) 명령줄 응용 프로그램에 연결하고 통신하는 데 사용됩니다.

---

## 문서

모든 프로젝트 문서는 [aka.ms/terminal-docs](https://aka.ms/terminal-docs)에 있습니다. 문서에 기여하고 싶으시다면 [Windows Terminal Documentation 저장소](https://github.com/MicrosoftDocs/terminal)에 풀 리퀘스트를 제출해 주세요.

---

## 기여하기

멋진 커뮤니티 여러분과 함께 Windows Terminal을 구축하고 개선해 나갈 수 있게 되어 기쁩니다!

***기능/수정 작업을 시작하기 전에***, 낭비되거나 중복되는 노력을 방지하기 위해 [기여자 가이드](./CONTRIBUTING.md)를 읽고 따라주세요.

## 팀과 소통하기

팀과 소통하는 가장 쉬운 방법은 GitHub 이슈를 통하는 것입니다.

새로운 이슈, 기능 요청, 제안을 등록해 주시되, **새로운 이슈를 생성하기 전에 기존에 열려 있거나 닫힌 유사한 이슈가 있는지 꼭 검색해 주세요.**

이슈를 생성할 정도는 아니라고 생각되는 질문이 있으신 경우, Twitter를 통해 연락해 주세요:

* Christopher Nguyen, Product Manager: [@nguyen_dows](https://twitter.com/nguyen_dows)
* Dustin Howett, Engineering Lead: [@dhowett](https://twitter.com/DHowett)
* Mike Griese, Senior Developer: [@zadjii@mastodon.social](https://mastodon.social/@zadjii)
* Carlos Zamora, Developer: [@cazamor_msft](https://twitter.com/cazamor_msft)
* Pankaj Bhojwani, Developer
* Leonard Hecker, Developer: [@LeonardHecker](https://twitter.com/LeonardHecker)

## 개발자 지침

## 필수 조건

다음 두 가지 방법 중 하나로 Terminal을 빌드하도록 환경을 구성할 수 있습니다:

### WinGet 구성 파일 사용

저장소를 복제한 후, [WinGet 구성 파일](https://learn.microsoft.com/en-us/windows/package-manager/configuration/#use-a-winget-configuration-file-to-configure-your-machine)을 사용하여 환경을 설정할 수 있습니다. [기본 구성 파일](.config/configuration.winget)은 Visual Studio 2026 Community 및 나머지 필수 도구를 설치합니다. Visual Studio 2026 Enterprise 및 Professional 에디션을 위해 [.config](.config) 디렉터리에 다른 두 가지 변형 구성 파일도 제공됩니다. 기본 구성 파일을 실행하려면 탐색기에서 파일을 두 번 클릭하거나 다음 명령어를 실행하면 됩니다:

```powershell
winget configure .config\configuration.winget
```

### 수동 구성

* Windows Terminal을 실행하려면 Windows 10 2004(빌드 >= 10.0.19041.0) 이상이 실행 중이어야 합니다.
* Windows Terminal을 로컬에 설치하고 실행하려면 [Windows 설정 앱에서 개발자 모드(Developer Mode)를 활성화](https://docs.microsoft.com/en-us/windows/uwp/get-started/enable-your-device-for-development)해야 합니다.
* [PowerShell 7 이상](https://github.com/PowerShell/PowerShell/releases/latest)이 설치되어 있어야 합니다.
* 버전 10.0.26100.8249 이상의 [Windows 11(10.0.26100) SDK](https://developer.microsoft.com/en-us/windows/downloads/windows-sdk/)가 설치되어 있어야 합니다.
* [VS 2026](https://visualstudio.microsoft.com/downloads/) 버전 18.6 이상이 설치되어 있어야 합니다.
* VS 설치 프로그램을 통해 다음 워크로드를 설치해야 합니다. 참고: 솔루션을 열면 [누락된 구성 요소를 자동으로 설치하라는 메시지가 표시됩니다](https://devblogs.microsoft.com/setup/configure-visual-studio-across-your-organization-with-vsconfig/):
  * C++를 사용한 데스크톱 개발
  * WinUI 응용 프로그램 개발
* 테스트 프로젝트를 빌드하려면 [.NET Framework 4.7.2 대상 패키지(Targeting Pack)](https://docs.microsoft.com/dotnet/framework/install/guide-for-developers#to-install-the-net-framework-developer-pack-or-targeting-pack)를 설치해야 합니다.

## 코드 빌드하기

OpenConsole.slnx는 Visual Studio 내에서 빌드하거나 **/tools** 디렉터리에 있는 편리한 스크립트 및 도구 세트를 사용하여 명령줄에서 빌드할 수 있습니다:

### PowerShell에서 빌드하기

```powershell
Import-Module .\tools\OpenConsole.psm1
Set-MsBuildDevEnvironment
Invoke-OpenConsoleBuild
```

### Cmd에서 빌드하기

```shell
.\tools\razzle.cmd
bcz
```

## 실행 및 디버깅

VS에서 Windows Terminal을 디버그하려면 (솔루션 탐색기에서) `CascadiaPackage`를 마우스 우클릭하고 속성으로 이동합니다. 디버그 메뉴에서 "응용 프로그램 프로세스"와 "백그라운드 작업 프로세스"를 "네이티브 전용(Native Only)"으로 변경합니다.

그런 다음 <kbd>F5</kbd>를 눌러 Terminal 프로젝트를 빌드하고 디버그할 수 있습니다. "x64" 또는 "x86" 플랫폼 중 하나를 선택해야 합니다. Terminal은 C#이 아닌 C++ 응용 프로그램이므로 "Any Cpu"로는 빌드되지 않습니다.

> 👉 `WindowsTerminal.exe`를 직접 실행하여 Terminal을 시작할 수는 _없습니다_. 자세한 이유는 [#926](https://github.com/microsoft/terminal/issues/926), [#4043](https://github.com/microsoft/terminal/issues/4043)을 참고하세요.

### 코딩 지침

코딩 관행에 대한 아래의 간략한 문서를 검토해 주세요.

> 👉 이 문서에서 누락된 내용을 발견했다면 저장소 어디에나 있는 문서 파일에 자유롭게 기여해 주세요(또는 새로 작성해 주세요!).

이 내용은 우리 프로젝트의 효과적인 기여자유가 되기 위해 사람들에게 무엇을 제공해야 할지 알아가는 과정에서 진행 중인 작업입니다.

* [코딩 스타일](./doc/STYLE.md)
* [코드 구조](./doc/ORGANIZATION.md)
* [레거시 코드베이스의 예외 처리](./doc/EXCEPTIONS.md)
* [WIL에서 Windows와 인터페이스하기 위한 유용한 스마트 포인터 및 매크로](./doc/WIL.md)

---

## 행동 강령

이 프로젝트는 [Microsoft 오픈 소스 행동 강령][conduct-code]을 채택했습니다. 자세한 내용은 [행동 강령 FAQ][conduct-FAQ]를 참고하시거나 추가 질문이나 의견이 있는 경우 [opencode@microsoft.com][conduct-email]으로 문의해 주세요.

[conduct-code]: https://opensource.microsoft.com/codeofconduct/
[conduct-FAQ]: https://opensource.microsoft.com/codeofconduct/faq/
[conduct-email]: mailto:opencode@microsoft.com
[store-install-link]: https://aka.ms/terminal

terminal

terminal 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

terminal

terminal 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README