<p align="center">
<picture>
<img src="https://raw.githubusercontent.com/microsoft/intelligent-terminal/HEAD/images/intelligent-terminal/-logo.png" alt="Intelligent Terminal logo" width="128">
</picture>
</p>
Intelligent Terminal 저장소에 오신 것을 환영합니다
<details>
<summary><strong id="table-of-contents">목차</strong></summary>
</details>
<br />
Intelligent Terminal이란 무엇인가?
Intelligent Terminal은 네이티브 에이전트 통합 기능을 갖춘 Windows Terminal의 실험적인 포크(fork)입니다.
Intelligent Terminal은 모든 Agent Client Protocol (ACP)-호환 에이전트 CLI와 작동합니다. 필요한 것은 PC에 선호하는 에이전트 CLI를 설치하는 것뿐입니다. 만약 선호하는 에이전트가 없다면, GitHub Copilot CLI로 설정할 수 있도록 도와드립니다.
Intelligent Terminal은 탭(tabs), 프로필(profiles), 테마(themes), 설정(settings), 셸(shells), 키보드 단축키 등 Windows Terminal에서 좋아했던 모든 기능을 가져왔으며, 이 기능들은 기대하는 방식으로 모두 작동합니다.
자세한 내용은 발표 블로그 게시물을 참조하세요.
Intelligent Terminal 설치 및 실행
[!NOTE]
Intelligent Terminal은 Windows 10 2004 (19041) 이상이 필요합니다. 또한 지원되는 에이전트 CLI와 구독이 필요합니다. 기본값은 GitHub Copilot입니다.
Microsoft Store (권장)
Microsoft Store에서 Intelligent Terminal 설치하기를 통해 설치하세요.
이렇게 하면 새로운 빌드가 출시될 때 자동 업그레이드를 통해 항상 최신 버전을 사용할 수 있습니다.
WinGet
winget 사용자는 다음 패키지를 설치하여 최신 Intelligent Terminal 릴리스를 다운로드하고 설치할 수 있습니다:
winget install --id Microsoft.IntelligentTerminal -e
다운로드
| 배포판 | 아키텍처 | 링크 |
|---|
| App Installer | x64, arm64, x86 | 다운로드 |
시작하기
- 첫 실행 시 에이전트를 선택하세요. Intelligent Terminal은 사용자의 장치에 있는 여러 ACP 호환 에이전트 (Copilot/Claude/Codex/Gemini/OpenCode/Antigravity)를 자동으로 감지합니다. Antigravity는 일반적인
agy CLI가 아닌 별도로 설치된 네이티브 ACP 서버를 사용합니다. 아무것도 발견되지 않으면 GitHub Copilot CLI로 기본 설정되며, WinGet을 통해 자동으로 설치됩니다.
- 아직 인증하지 않은 경우, 에이전트 창에서 로그인 절차를 안내받게 됩니다. GitHub Copilot Enterprise의 경우, 로그인 프롬프트에서 <kbd>E</kbd>를 누르고 엔터프라이즈 호스트(예:
your-org.ghe.com)를 입력하세요. 마지막으로 사용한 호스트가 기억됩니다.
- 질문을 시작하고 도움을 받기 위해 에이전트 창을 사용하세요. 이 에이전트는 셸 출력에 대한 컨텍스트를 가지고 있어 복사 및 붙여넣기가 필요하지 않습니다.
에이전트 패널은 사용자의 명시적인 승인 없이는 셸에서 명령을 실행하지 않습니다. 사용자는 제안된 명령을 실행할지, 자체적으로 실행하기 위해 셸에 복사할지, 아니면 무시할지를 선택합니다.
[!TIP]
만약 PowerShell에서 "이 시스템에서는 스크립트 실행이 비활성화되었습니다(running scripts is disabled on this system)" 또는 UnauthorizedAccess 오류를 보았다면, 실행 정책(execution policy)이 프로필을 차단하고 있어 Intelligent Terminal이 셸 통합을 초기화할 수 없습니다. 다음 명령어를 실행하세요:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
다른 문제나 종속성 오류가 발생하면 [installing-dependencies.md](./doc/installing-dependencies.md)를 참조하세요.
키보드 단축키
모든 단축키는 Intelligent Terminal 설정에서 사용자 정의할 수 있습니다.
| 단축키 | 동작 |
|---|
| <kbd>Ctrl+Shift+.</kbd> | 에이전트 패널 토글(Toggle) |
| <kbd>Ctrl+Shift+I</kbd> | 에이전트 패널로/에서 포커스 전환 |
| <kbd>Ctrl+Alt+.</kbd> | 오류 컨텍스트와 함께 에이전트 패널 열기 |
| <kbd>Ctrl+Shift+/</kbd> | 에이전트 관리(agent management) 열기 |
| <kbd>Alt+Shift+/</kbd> | 프롬프트 모드에서 명령 팔레트 열기 |
| <kbd>Alt+Shift+B</kbd> | 시작 프롬프트 없이 대화형 위임 에이전트(delegate-agent) 탭 열기 |
| <kbd>Alt+V</kbd> | 클립보드의 이미지를 에이전트 패널에 붙여넣기 |
구성(설정)
모든 것은 Intelligent Terminal 설정의 '에이전트(Agent)' 설정에서 구성할 수 있습니다.
| 설정 | 옵션 |
|---|
| 에이전트 및 모델 | GitHub Copilot (기본값), 또는 사용자 정의 또는 로컬 에이전트를 포함한 모든 ACP-호환 에이전트 CLI. 에이전트 패널과 명령 팔레트 모두에 대해 구성 가능합니다. 각 에이전트 패널은 /model을 사용하여 모델을 실시간으로 재정의할 수 있습니다. 여기서 전역 설정을 변경하면 모든 패널에 적용됩니다. |
| 사용자 지정 제공업체 (BYOK) | OpenAI와 호환되는 Chat Completions 엔드포인트를 통해 GitHub Copilot 또는 OpenCode를 사용하여 자체 제공업체 자격 증명과 모델을 가져올 수 있습니다. |
에이전트 설정(Agent settings)에서 기본 URL, 모델 ID 및 선택적 API 키를 사용하여 제공업체(provider)를 추가한 다음, /model에서 이를 선택할 수 있습니다. API 키는 Windows Credential Manager에 저장되며, Ollama와 같은 키가 필요 없는 로컬 엔드포인트도 계속 지원됩니다.
| 창 배치 (Pane placement) | 상단(Top), 하단(Bottom)(기본값), 왼쪽(Left), 오른쪽(Right) |
| 오류 감지 (Error detection) | Intelligent Terminal이 명령 실패를 자동으로 감지할 수 있도록 합니다. |
| 오류 제안 (Error suggestions) | Intelligent Terminal이 감지된 오류를 에이전트로 자동 전송하여 수정 제안을 받을 수 있도록 합니다. |
| 에이전트 세션 추적(hooks) | Intelligent Terminal이 활성 에이전트 세션과 해당 상태를 세션 관리 UI에서 추적할 수 있도록 합니다. |
| 토큰 사용 표시 (Token usage display) | 에이전트 상태 표시줄에 토큰 사용량 및 비용을 표시하거나 숨길 수 있습니다. |
특정 에이전트를 프로필에 고정(pin)할 수도 있습니다. 설정에서 프로필(
대화형 위임(interactive delegation) 및 셸 세션 후크를 위해 별도의 agy CLI를 설치합니다.
ACP 대화와 CLI 대화는 각각 자체 소스 및 재개 경로를 유지하며, 상위(upstream) ACP 인터페이스는 CLI의 콜드 스타트 기록을 열거하지 않습니다.
'설정(Settings) > 에이전트(Agents) > 세션(Sessions)'이 꺼져 있을 경우, 세션 관리에는 최적의 경험을 위해 이 기능을 켜라는 미묘한 알림이 제목 아래에 표시됩니다. 기존 후크는 제거되지 않으며 활동 보고를 계속할 수 있습니다. 해당 설정은 후크의 설치 및 업데이트를 제어합니다. '세션(Sessions)'이 활성화되면 알림은 사라지며, 조직 정책으로 인해 활성화가 불가능한 경우에는 표시되지 않습니다.
기능 (Features)
에이전트 상태 표시줄 (Agent Status Bar)
<p align="center">
<img src="https://raw.githubusercontent.com/microsoft/intelligent-terminal/HEAD/images/intelligent-terminal-status-bar.png" alt="터미널 창 하단의 에이전트 상태 표시줄 스크린샷">
</p>
에이전트 상태 표시줄은 창 하단에 위치하며 에이전트 관련 모든 기능에 빠르게 접근할 수 있게 해줍니다. 왼쪽에는 에이전트 패널 토글(바로 가기 키: <kbd>Ctrl+Shift+.</kbd>)과 오류 감지 아이콘(바로 가기 키: <kbd>Ctrl+Alt+.</kbd>)이 있으며, 후자가 수정 가능한 오류를 감지하면 불이 켜집니다. 오른쪽에는 세션 관리 패널을 여는 에이전트 관리 아이콘(바로 가기 키: <kbd>Ctrl+Shift+/`</kbd>)이 있습니다. 이는 지속적이고 최소한의 제어 영역이므로, 사용자는 항상 에이전트로부터 한 번의 클릭 거리에 있게 됩니다. 또한 상태 표시줄은 작업하는 동안 현재 토큰 사용량과 비용을 표시할 수도 있습니다. 이 기능은 에이전트 설정에서 켜거나 끌 수 있습니다.
에이전트 패널 (Agent Pane)
<p align="center">
<img src="https://raw.githubusercontent.com/microsoft/intelligent-terminal/HEAD/images/intelligent-terminal-agent-pane.png" alt="개발 대화가 있는 에이전트 패널 스크린샷">
</p>
선택한 에이전트 CLI가 있는 문맥 인식(context-aware)의 도킹된 패널입니다. 이 패널은 모든 셸(PowerShell, Bash/WSL)에 걸쳐 사용자의 셸 출력에 대한 문맥을 파악합니다.
토글은 <kbd>Ctrl+Shift+.</kbd>로, 포커스 전환은 <kbd>Ctrl+Shift+I</kbd>로 합니다. 에이전트가 여러 개 또는 복잡한 작업을 수행해야 하는 경우, 활성 셸(shell)에 집중할 수 있도록 새 탭에서 백그라운드 작업을 실행합니다. 에이전트가 셸 명령을 제안하면, 해당 창(pane)은 자동으로 실행하는 대신 실행하거나 복사할 수 있는 옵션을 제공합니다. <kbd>Alt+V`</kbd>를 사용하여 클립보드 이미지를 채팅에 바로 붙여넣어 에이전트에게 스크린샷, 다이어그램 또는 목업을 보여줄 수 있습니다(이미지에 대한 작용은 사용자의 에이전트 이미지 지원 여부에 따라 달라집니다).
<p align="center">
<img src="https://raw.githubusercontent.com/microsoft/intelligent-terminal/HEAD/images/intelligent-terminal-agent-focus.png" alt="Screenshot of the agent pane with focus, showing multiple panes">
</p>
여러 개의 창(pane)이 활성화되어 있을 때, 에이전트가 "포커스(focus)"를 두고 있는 창에는 작은 "Agent" 표시기가 나타납니다.
창 내부에서는 마우스로 스크롤하고 드래그하여 선택할 수 있으며, 단어를 더블클릭하거나 줄을 트리플클릭한 후 <kbd>Ctrl+C</kbd>를 눌러 복사할 수 있습니다. 입력창에서 <kbd>Up</kbd> 및 <kbd>Down`</kbd> 키를 눌러 최근 프롬프트를 불러올 수 있습니다.
슬래시 명령어 (Slash Commands)
에이전트 창 내부에서 /를 입력하여 사용 가능한 명령어를 확인합니다. 목록을 보려면 언제든지 /help를 입력하세요.
| 명령어 | 설명 |
|---|
/agent [id] | 이 탭의 에이전트 소스를 선택합니다. WSL 창에서 피커는 Windows와 해당 창의 WSL 배포판에 설치된 에이전트를 포함하며, 다른 배포판은 절대 제공하지 않습니다. |
/clear | 채팅 스크롤백을 지웁니다(현재 세션 유지). |
/config | 사용자가 노출하는 옵션을 사용하여 현재 에이전트 세션을 구성합니다. 예를 들어 GitHub Copilot의 경우, 모드(agent, plan 또는 autopilot), 모델, 추론 노력(reasoning effort) 및 도구 사용 전 승인 요청 여부를 설정할 수 있습니다. |
/fix [hint] | 활성 터미널을 진단하고 수정 사항을 제안합니다. 방향을 잡기 위해 선택적 힌트를 추가할 수 있습니다 (예: |
/fix (경로가 잘못된 것 같음) |
| /help | 명령어 목록 표시 |
| /model [id] | 이 패널에 사용할 모델 선택; /model만 입력하면 구성된 BYOK 모델의 선택기가 열리고, /model <id>는 직접 전환합니다. |
| /move [position] | 전역 설정이나 다른 탭을 변경하지 않고 이 탭의 에이전트 패널 이동; /move left|right|up|down (l/r/u/d의 별칭) |
| /new | 새로운 에이전트 세션 시작 (기록 삭제) |
| /restart | 깨끗한 세션으로 에이전트 재시작 |
| /sessions | 에이전트 관리 열기 ( <kbd>Ctrl+Shift+/</kbd>와 동일) |
| /stop | 진행 중인 프롬프트 취소 |
사용자 지정 제공업체 (BYOK)
사용자의 자체 제공업체 또는 로컬 장치의 모델을 대상으로 에이전트를 실행할 수 있습니다. BYOK는 OpenAI와 호환되는 Chat Completions 엔드포인트를 사용하여 GitHub Copilot 및 OpenCode를 통해 지원됩니다. 에이전트 설정(Agent settings)에서 기본 URL(Base URL), 모델 ID(Model ID), 그리고 선택적 API 키가 포함된 제공업체를 추가하세요.