<p align="center">
          <a href="https://marketplace.visualstudio.com/items?itemName=ZooCodeOrganization.zoo-code"><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/ZooCodeDev"><img src="https://img.shields.io/badge/ZooCode-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/VxfP4Vx3gX"><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/ZooCode/"><img src="https://img.shields.io/badge/Join%20r%2FZooCode-FF4500?style=flat&logo=reddit&logoColor=white" alt="Join r/ZooCode"></a>
          <a href="https://github.com/Zoo-Code-Org/Zoo-Code/issues"><img src="https://img.shields.io/badge/GitHub-Issues-181717?style=flat&logo=github&logoColor=white" alt="GitHub Issues"></a>
        </p>
        <p align="center">
          <em>빠르게 도움받기 → <a href="https://discord.gg/VxfP4Vx3gX">Discord 참여하기</a> • 비동기가 더 좋아요? → <a href="https://www.reddit.com/r/ZooCode/">r/ZooCode 참여하기</a></em>
        </p>

        # Zoo Code

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

        ## 우리는 Zoo Code입니다

> Roo 팀 🦘🦘🦘의 [최근 발표](https://x.com/mattrubens/status/2046636598859559114)를 봤을지도 몰라. 한줄 요약하면, 팀은 [Roomote](https://roomote.dev/)에 집중하면서 Roo Code의 적극적인 개발을 점차 줄여 나가고 있어. 이 소식은 많은 Roo 사용자들에게 힘들었고, 이 플러그인은 이 커뮤니티에 큰 의미가 있어.
>
> 이 플러그인에 쏟아 준 Roo 팀 전체의 노력에 감사하고 싶어. 여기서 한 사람씩 이름을 부르지는 않겠지만, 모두가 그들이 뛰어난 개발자일 뿐 아니라 정말 멋진 사람들이라는 데 동의할 거야. Roo 팀에게 고마워.
>
> Roo 사용자들은 정말 다양합니다. 어떤 사람은 일상적인 업무에서 전문적으로 사용하고, 어떤 사람은 상상하기 어려울 정도로 복잡한 워크플로를 구상하는 데 사용합니다. 어떤 사람은 Roo 자체를 개선하는 데 쓰고, 또 어떤 사람은 Roo가 사용하는 모델 자체를 개선하는 데 씁니다 (정말 메타하죠). 우리가 말하고 싶은 핵심은 커뮤니티가 다양하다는 것입니다. 캥거루 🦘🦘🦘도 충분히 멋지고 고귀한 동물이지만, 여러 종이 함께 있는 "Zoo" 🐘🦡🦒🦓🦛🦧🦭🦦가 이 플러그인 사용자의 다양성을 더 잘 보여준다고 느꼈습니다.
>
> 그래서 **Zoo Code**가 이 중요한 프로젝트의 개발을 이어가겠다고 발표하고자 합니다. 핵심 팀은 이전에 Roo에 기여했고 이 플러그인을 깊이 아끼는 개발자들로 구성되어 있습니다. 우리는 계속해서 모델을 업데이트하고, 버그를 수정하고, 기능을 출시할 것입니다. 하지만 무엇보다도 이 플러그인을 특별하게 만들어 준 커뮤니티 여러분의 목소리에 귀 기울이려 합니다. 그러니 우리의 [Discord](https://discord.gg/VxfP4Vx3gX), [Reddit](https://www.reddit.com/r/ZooCode)에 참여하거나 [PR 또는 issue 를 만들어](https://github.com/Zoo-Code-Org/Zoo-Code) 주세요. 무엇보다도 커뮤니티로서 계속 연결되고, 참여하고, 활발하게 함께해 주시길 부탁드립니다.
>
> _-Zoo Code Team_

## Roo Code에서 Zoo Code로 마이그레이션

Roo Code에서 Zoo Code로 옮겨오는 빠른 가이드는 [Roo→Zoo 마이그레이션 가이드](https://docs.zoocode.dev/roo-to-zoo-migration)에서 확인할 수 있어. 전환하는 동안 사용자들을 최대한 돕고 싶고, 바로 그 지원을 위해 [Reddit](https://www.reddit.com/r/ZooCode)와 [Discord](https://discord.gg/VxfP4Vx3gX)를 운영하고 있어. 문제가 있거나 궁금한 점이 있으면 들어와서 편하게 물어봐.

## v3.55.0의 새로운 기능

**Zoo Code의 첫 기능 릴리스**는 Marketplace handoff를 바탕으로 새 provider, Roo Code의 upstream sunset merge, 그리고 채팅, provider 설정, rendering 전반의 사용자 체감 수정 사항을 담고 있어요.

- Xiaomi MiMo를 first-class API provider로 추가했어요.
- Roo Code의 upstream sunset merge와 관련 platform 업데이트를 반영했어요.
- MCP sign-in 문구, Gemini의 full-tool 요청, 지원하지 않는 모델에 대한 OpenAI temperature 처리 문제를 수정했어요.
- Markdown single-tilde 렌더링과 diagnostics temp-file 이름을 수정했어요.
- Z.AI, GLM, Vertex AI의 provider 기본값과 region 지원 범위를 개선했어요.

<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>

---

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

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

## 모드

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

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

자세히: [모드 사용](https://docs.zoocode.dev/basic-usage/using-modes) • [사용자 지정 모드](https://docs.zoocode.dev/advanced-usage/custom-modes)

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

<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>Zoo 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=HmnNSasv7T8"><img src="https://img.youtube.com/vi/HmnNSasv7T8/maxresdefault.jpg" width="100%"></a><br><b>컨텍스트 관리</b>   |

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

## 리소스

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

---

## 로컬 설정 및 개발

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

```sh
git clone https://github.com/Zoo-Code-Org/Zoo-Code.git
```

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

```sh
pnpm install
```

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

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

### 개발 모드 (F5)

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

VSCode에서 `F5`를 누르거나 **실행** → **디버깅 시작**으로 이동하세요. 그러면 Zoo 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/zoo-code-<version>.vsix`).
3.  VSCode CLI를 사용하여 수동으로 설치합니다:
    ```sh
    code --install-extension bin/zoo-code-<version>.vsix
    ```

---

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

---

## 면책 조항

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

---

## 기여하기

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

---

## 라이선스

[Apache 2.0 © 2025 Zoo Code Org](../../LICENSE)

---

**Zoo Code를 즐겨 보세요!** 짧은 리드줄로 가까이 두든 자율적으로 돌아다니게 하든, 여러분이 무엇을 만들지 기대하고 있습니다. 질문이나 기능 아이디어가 있다면 [issue](https://github.com/Zoo-Code-Org/Zoo-Code/issues)를 열거나 [discussion](https://github.com/Zoo-Code-Org/Zoo-Code/discussions)을 시작해 주세요. 즐거운 코딩 되세요!
