<p align="center">
  <a href="https://marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-cline"><img src="https://img.shields.io/badge/VS_Code_Marketplace-007ACC?style=flat&logo=visualstudiocode&logoColor=white" alt="VS Code Marketplace"></a>
  <a href="https://x.com/roocode"><img src="https://img.shields.io/badge/roocode-000000?style=flat&logo=x&logoColor=white" alt="X"></a>
  <a href="https://youtube.com/@roocodeyt?feature=shared"><img src="https://img.shields.io/badge/YouTube-FF0000?style=flat&logo=youtube&logoColor=white" alt="YouTube"></a>
  <a href="https://discord.gg/roocode"><img src="https://img.shields.io/badge/Join%20Discord-5865F2?style=flat&logo=discord&logoColor=white" alt="Join Discord"></a>
  <a href="https://www.reddit.com/r/RooCode/"><img src="https://img.shields.io/badge/Join%20r%2FRooCode-FF4500?style=flat&logo=reddit&logoColor=white" alt="Join r/RooCode"></a>
</p>
<p align="center">
  <em>빠른 도움 받기 → <a href="https://discord.gg/roocode">Discord 가입하기</a> • 비동기 선호? → <a href="https://www.reddit.com/r/RooCode/">r/RooCode 가입하기</a></em>
</p>

# Roo Code

> AI로 강화된 너의 개발 팀, 네 에디터 안에

<details>
  <summary>🌐 사용 가능한 언어</summary>

- [English](../../README.md)
- [Català](../ca/README.md)
- [Deutsch](../de/README.md)
- [Español](../es/README.md)
- [Français](../fr/README.md)
- [हिंदी](../hi/README.md)
- [Bahasa Indonesia](../id/README.md)
- [Italiano](../it/README.md)
- [日本語](../ja/README.md)
- [한국어](../ko/README.md)
- [Nederlands](../nl/README.md)
- [Polski](../pl/README.md)
- [Português (BR)](../pt-BR/README.md)
- [Русский](../ru/README.md)
- [Türkçe](../tr/README.md)
- [Tiếng Việt](../vi/README.md)
- [简体中文](../zh-CN/README.md)
- [繁體中文](../zh-TW/README.md)
- ...
  </details>

---

## Roo Code가 당신을 위해 무엇을 할 수 있을까요?

- 자연어 설명으로 코드 생성
- 모드로 적응: 코드, 아키텍트, 질문, 디버그 및 사용자 지정 모드
- 기존 코드 리팩터링 및 디버깅
- 문서 작성 및 업데이트
- 코드베이스에 대한 질문에 답변
- 반복적인 작업 자동화
- MCP 서버 활용

## 모드

Roo Code는 당신의 작업 방식에 맞춰 적응합니다.

- 코드 모드: 일상적인 코딩, 편집 및 파일 작업
- 아키텍트 모드: 시스템, 사양 및 마이그레이션 계획
- 질문 모드: 빠른 답변, 설명 및 문서
- 디버그 모드: 문제 추적, 로그 추가, 근본 원인 격리
- 사용자 지정 모드: 팀이나 워크플로우를 위한 특수 모드 구축
- Roomote Control: Roomote Control은 로컬 VS Code 인스턴스에서 실행 중인 작업을 원격으로 제어할 수 있어.

자세히: [모드 사용](https://docs.roocode.com/basic-usage/using-modes) • [사용자 지정 모드](https://docs.roocode.com/advanced-usage/custom-modes) • [Roomote Control](https://docs.roocode.com/roo-code-cloud/roomote-control)

## 튜토리얼 및 기능 비디오

<div align="center">

|                                                                                                                                                                         |                                                                                                                                                                       |                                                                                                                                                                         |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| <a href="https://www.youtube.com/watch?v=Mcq3r1EPZ-4"><img src="https://img.youtube.com/vi/Mcq3r1EPZ-4/maxresdefault.jpg" width="100%"></a><br><b>Roo Code 설치하기</b> | <a href="https://www.youtube.com/watch?v=ZBML8h5cCgo"><img src="https://img.youtube.com/vi/ZBML8h5cCgo/maxresdefault.jpg" width="100%"></a><br><b>프로필 구성하기</b> | <a href="https://www.youtube.com/watch?v=r1bpod1VWhg"><img src="https://img.youtube.com/vi/r1bpod1VWhg/maxresdefault.jpg" width="100%"></a><br><b>코드베이스 인덱싱</b> |
| <a href="https://www.youtube.com/watch?v=iiAv1eKOaxk"><img src="https://img.youtube.com/vi/iiAv1eKOaxk/maxresdefault.jpg" width="100%"></a><br><b>사용자 지정 모드</b>  |   <a href="https://www.youtube.com/watch?v=Ho30nyY332E"><img src="https://img.youtube.com/vi/Ho30nyY332E/maxresdefault.jpg" width="100%"></a><br><b>체크포인트</b>    |    <a href="https://www.youtube.com/watch?v=6h5vB9PpoPk"><img src="https://img.youtube.com/vi/6h5vB9PpoPk/maxresdefault.jpg" width="100%"></a><br><b>할 일 목록</b>     |

</div>
<p align="center">
<a href="https://docs.roocode.com/tutorial-videos">더 많은 빠른 튜토리얼 및 기능 비디오...</a>
</p>

## 리소스

- **[문서](https://docs.roocode.com):** Roo Code 설치, 구성 및 마스터하기 위한 공식 가이드.
- **[YouTube 채널](https://youtube.com/@roocodeyt?feature=shared):** 튜토리얼을 시청하고 실제 기능을 확인하세요.
- **[Discord 서버](https://discord.gg/roocode):** 커뮤니티에 가입하여 실시간 도움과 토론에 참여하세요.
- **[Reddit 커뮤니티](https://www.reddit.com/r/RooCode):** 경험을 공유하고 다른 사람들이 무엇을 만들고 있는지 확인하세요.
- **[GitHub 문제](https://github.com/RooCodeInc/Roo-Code/issues):** 버그를 보고하고 개발을 추적하세요.
- **[기능 요청](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop):** 아이디어가 있으신가요? 개발자들과 공유하세요.

---

## 로컬 설정 및 개발

1. **리포지토리 복제**:

```sh
git clone https://github.com/RooCodeInc/Roo-Code.git
```

2. **의존성 설치**:

```sh
pnpm install
```

3. **확장 프로그램 실행**:

Roo Code 확장 프로그램을 실행하는 방법에는 여러 가지가 있습니다:

### 개발 모드 (F5)

활성 개발을 위해 VSCode의 내장 디버깅을 사용하세요:

VSCode에서 `F5`를 누르거나 **실행** → **디버깅 시작**으로 이동하세요. 그러면 Roo Code 확장 프로그램이 실행되는 새 VSCode 창이 열립니다.

- 웹뷰 변경 사항은 즉시 나타납니다.
- 핵심 확장 프로그램 변경 사항도 자동으로 핫 리로드됩니다.

### 자동 VSIX 설치

확장 프로그램을 VSIX 패키지로 빌드하여 VSCode에 직접 설치하려면:

```sh
pnpm install:vsix [-y] [--editor=<command>]
```

이 명령은 다음을 수행합니다:

- 사용할 편집기 명령을 묻습니다(code/cursor/code-insiders) - 기본값은 'code'입니다.
- 기존 확장 프로그램 버전을 제거합니다.
- 최신 VSIX 패키지를 빌드합니다.
- 새로 빌드된 VSIX를 설치합니다.
- 변경 사항을 적용하려면 VS Code를 다시 시작하라는 메시지를 표시합니다.

옵션:

- `-y`: 모든 확인 프롬프트를 건너뛰고 기본값을 사용합니다.
- `--editor=<command>`: 편집기 명령을 지정합니다(예: `--editor=cursor` 또는 `--editor=code-insiders`).

### 수동 VSIX 설치

VSIX 패키지를 수동으로 설치하려면:

1.  먼저 VSIX 패키지를 빌드합니다:
    ```sh
    pnpm vsix
    ```
2.  `.vsix` 파일이 `bin/` 디렉터리에 생성됩니다(예: `bin/roo-cline-<version>.vsix`).
3.  VSCode CLI를 사용하여 수동으로 설치합니다:
    ```sh
    code --install-extension bin/roo-cline-<version>.vsix
    ```

---

버전 관리 및 게시는 [changesets](https://github.com/changesets/changesets)를 사용합니다. 릴리스 노트는 `CHANGELOG.md`를 확인하세요.

---

## 면책 조항

**참고:** Roo Code, Inc.는 Roo Code, 관련 타사 도구 또는 그 결과물과 관련하여 제공되거나 사용 가능하게 된 어떠한 코드, 모델 또는 기타 도구에 대해서도 어떠한 진술이나 보증을 하지 **않습니다**. 귀하는 그러한 도구나 결과물의 사용과 관련된 **모든 위험**을 부담합니다. 해당 도구는 **"있는 그대로"** 및 **"사용 가능한 대로"** 제공됩니다. 그러한 위험에는 지적 재산권 침해, 사이버 취약성 또는 공격, 편견, 부정확성, 오류, 결함, 바이러스, 다운타임, 재산 손실 또는 손상 및/또는 개인 상해가 포함될 수 있으며 이에 국한되지 않습니다. 귀하는 그러한 도구 또는 결과물의 사용(합법성, 적절성 및 그 결과를 포함하되 이에 국한되지 않음)에 대해 전적으로 책임을 집니다.

---

## 기여하기

우리는 커뮤니티의 기여를 사랑합니다! [CONTRIBUTING.md](CONTRIBUTING.md)를 읽고 시작하세요.

---

## 라이선스

[Apache 2.0 © 2025 Roo Code, Inc.](../../LICENSE)

---

**Roo Code를 즐기세요!** 짧은 줄에 묶어두든 자율적으로 돌아다니게 하든, 여러분이 무엇을 만들지 기대됩니다. 질문이나 기능 아이디어가 있으면 저희 [Reddit 커뮤니티](https://www.reddit.com/r/RooCode/)나 [Discord](https://discord.gg/roocode)에 들러주세요. 즐거운 코딩 되세요!
