diff options
Diffstat (limited to 'packages/web/src/content/docs/ko/index.mdx')
| -rw-r--r-- | packages/web/src/content/docs/ko/index.mdx | 170 |
1 files changed, 77 insertions, 93 deletions
diff --git a/packages/web/src/content/docs/ko/index.mdx b/packages/web/src/content/docs/ko/index.mdx index 6f89bef0f..8976005f8 100644 --- a/packages/web/src/content/docs/ko/index.mdx +++ b/packages/web/src/content/docs/ko/index.mdx @@ -7,40 +7,39 @@ import { Tabs, TabItem } from "@astrojs/starlight/components" import config from "../../../../config.mjs" export const console = config.console -[**OpenCode**](/)는 오픈 소스 AI 코딩 에이전트입니다. terminal 기반 인터페이스, 데스크탑 앱 또는 IDE 확장으로 사용할 수 있습니다. +[**OpenCode**](/)는 터미널 기반 인터페이스, 데스크톱 앱, IDE 확장 형태로 사용할 수 있는 오픈 소스 AI 코딩 에이전트입니다.  -시작합시다. +바로 시작해 봅시다. --- -### 필수품 +#### 사전 준비 -당신의 terminal에 있는 OpenCode를 사용하려면, 당신은 필요로 할 것입니다: +터미널에서 OpenCode를 사용하려면 다음이 필요합니다. -1. 현대 terminal 에뮬레이터는 좋아합니다: +1. 최신 터미널 에뮬레이터(예:) + - [WezTerm](https://wezterm.org), 크로스 플랫폼 + - [Alacritty](https://alacritty.org), 크로스 플랫폼 + - [Ghostty](https://ghostty.org), Linux 및 macOS + - [Kitty](https://sw.kovidgoyal.net/kitty/), Linux 및 macOS -- [WezTerm](https://wezterm.org), 크로스 플랫폼 -- [Alacritty](https://alacritty.org), 크로스 플랫폼 -- [Ghostty](https://ghostty.org), 리눅스 및 macOS -- [Kitty](https://sw.kovidgoyal.net/kitty/), 리눅스 및 macOS - -2. 사용하려는 LLM 공급자를 위한 API 키. +2. 사용할 LLM 제공자의 API 키 --- ## 설치 -OpenCode를 설치하는 가장 쉬운 방법은 설치 스크립트를 통해 입니다. +가장 쉬운 설치 방법은 설치 스크립트를 사용하는 것입니다. ```bash curl -fsSL https://opencode.ai/install | bash ``` -다음 명령으로 설치할 수도 있습니다: +아래 명령으로도 설치할 수 있습니다. -- ** Node.js** 사용 +- **Node.js 사용** <Tabs> @@ -74,79 +73,78 @@ curl -fsSL https://opencode.ai/install | bash </Tabs> -- ** macOS 및 Linux에서 Homebrew 사용 ** +- **macOS/Linux에서 Homebrew 사용** ```bash brew install anomalyco/tap/opencode ``` -> 최신 릴리스를 위해 OpenCode 탭을 사용하는 것이 좋습니다. 공식 `brew install opencode` 공식은 Homebrew 팀에 의해 유지되고 더 자주 업데이트됩니다. + > 최신 릴리스는 OpenCode tap 사용을 권장합니다. 공식 `brew install opencode` 포뮬러는 Homebrew 팀이 관리하므로 업데이트 주기가 더 긴 편입니다. -- **Arch Linux에서 Paru를 사용 ** +- **Arch Linux에서 Paru 사용** ```bash paru -S opencode-bin ``` -#### 윈도우 +#### Windows -:::tip[추천: WSL 사용] -Windows에서 최고의 경험을 위해 [Windows Subsystem for Linux (WSL)](/docs/windows-wsl)를 사용하는 것이 좋습니다. OpenCode의 기능으로 더 나은 성능과 전체 호환성을 제공합니다. +:::tip[권장: WSL 사용] +Windows에서는 [Windows Subsystem for Linux (WSL)](/docs/windows-wsl)을 사용하는 것이 가장 좋습니다. OpenCode 기능과의 호환성이 높고 성능도 더 좋습니다. ::: -- ** Chocolatey ** +- **Chocolatey 사용** ```bash choco install opencode ``` -- ** Scoop를 사용 ** +- **Scoop 사용** ```bash scoop install opencode ``` -- ** npm ** +- **NPM 사용** ```bash npm install -g opencode-ai ``` -- **Mise** +- **Mise 사용** ```bash mise use -g github:anomalyco/opencode ``` -- ** Docker 사용** +- **Docker 사용** ```bash docker run -it --rm ghcr.io/anomalyco/opencode ``` -Bun을 사용하여 Windows에서 OpenCode 설치 지원은 현재 진행 중입니다. +Windows에서 Bun을 통한 OpenCode 설치는 아직 지원되지 않으며, 현재 지원을 준비 중입니다. -[Releases](https://github.com/anomalyco/opencode/releases)에서 이진을 할 수도 있습니다. +[Releases](https://github.com/anomalyco/opencode/releases)에서 바이너리를 직접 받아 설치할 수도 있습니다. --- ## 구성 -OpenCode를 사용하면 API 키를 구성하여 LLM 공급자를 사용할 수 있습니다. +OpenCode는 API 키를 설정하면 원하는 LLM 제공자를 사용할 수 있습니다. -LLM 공급자를 사용하는 새로운 경우, [OpenCode Zen](/docs/zen)를 사용하는 것이 좋습니다. -OpenCode에 의해 테스트 및 확인 된 모델의 큐레이터 목록입니다. -팀. +LLM 제공자(LLM Provider)를 처음 사용한다면 [OpenCode Zen](/docs/zen)을 추천합니다. +OpenCode 팀이 테스트하고 검증한 모델 목록입니다. -1. TUI에서 `/connect` 명령을 실행하고, opencode를 선택하고, [opencode.ai/auth](https://opencode.ai/auth)에 머리를 선택합니다. +1. TUI에서 `/connect` 명령을 실행한 뒤 `opencode`를 선택하고 [opencode.ai/auth](https://opencode.ai/auth)로 이동합니다. ```txt /connect ``` -2. 로그인, 청구 세부 정보를 추가하고 API 키를 복사하십시오. +2. 로그인 후 결제 정보를 입력하고 API 키를 복사합니다. -3. API 키를 붙여. +3. API 키를 붙여 넣습니다. ```txt ┌ API key @@ -155,85 +153,79 @@ OpenCode에 의해 테스트 및 확인 된 모델의 큐레이터 목록입니� └ enter ``` -158| 또는 다른 공급자 중 하나를 선택할 수 있습니다. [더 알아보기](/docs/providers#directory). +다른 제공자를 선택해도 됩니다. [더 알아보기](/docs/providers#directory). --- ## 초기화 -이제 공급자를 구성했습니다. 프로젝트로 이동할 수 있습니다. -일하고 싶습니다. +이제 제공자 구성이 끝났으니, 작업할 프로젝트 디렉터리로 이동합니다. ```bash cd /path/to/project ``` -OpenCode를 실행합니다. +그리고 OpenCode를 실행합니다. ```bash opencode ``` -다음, 다음 명령을 실행하여 프로젝트의 OpenCode를 초기화합니다. +다음 명령으로 프로젝트용 OpenCode 초기화를 진행합니다. ```bash frame="none" /init ``` -OpenCode를 사용하여 프로젝트를 분석하고 `AGENTS.md` 파일을 만들 수 있습니다. -프로젝트 루트. +이 명령은 프로젝트를 분석하고 루트에 `AGENTS.md` 파일을 생성합니다. :::tip -프로젝트의 `AGENTS.md` 파일을 Git에 투입해야 합니다. +프로젝트의 `AGENTS.md`는 Git에 커밋해 두는 것을 권장합니다. ::: -이 도움말 OpenCode는 프로젝트 구조와 코딩 패턴을 이해 -사용. +그러면 OpenCode가 프로젝트 구조와 코딩 패턴을 더 잘 이해할 수 있습니다. --- ## 사용법 -OpenCode를 사용하여 프로젝트에 작업할 준비가 되어 있습니다. 자주 묻는 질문 -모두! +이제 OpenCode로 프로젝트 작업을 시작할 준비가 되었습니다. 무엇이든 물어보세요. -AI 코딩 에이전트를 사용하는 새로운 경우, 여기에 할 수있는 몇 가지 예입니다 -도움. +AI 코딩 에이전트를 처음 쓰는 경우 도움이 되는 예시를 소개합니다. --- -## 질문 +### 질문하기 -Codebase를 설명하기 위해 OpenCode를 요청할 수 있습니다. +OpenCode에 코드베이스 설명을 요청할 수 있습니다. :::tip -`@` 키를 사용하여 프로젝트에서 파일을 검색합니다. +프로젝트 파일은 `@` 키로 퍼지 검색할 수 있습니다. ::: ```txt frame="none" "@packages/functions/src/api/index.ts" How is authentication handled in @packages/functions/src/api/index.ts ``` -이것은 당신이 작동하지 않은 코드베이스의 일부가 있다면 도움이된다. +직접 작업하지 않은 코드 영역을 이해할 때 특히 유용합니다. --- -### 추가 기능 +### 기능 추가 -프로젝트에 새로운 기능을 추가하려면 OpenCode를 요청할 수 있습니다. 우리는 먼저 계획을 만들 것을 묻는 것이 좋습니다. +프로젝트에 새 기능을 추가해 달라고 요청할 수 있습니다. 다만 먼저 계획을 만들게 하는 것을 권장합니다. -1. **플랜을 선택 ** +1. **계획 만들기** - OpenCode는 Plan mode 로 변경할 수 있는 능력을 비활성화하고 - 대신 제안 how 그것은 기능을 구현할 것입니다. + OpenCode에는 변경 작업을 비활성화하고 구현 방법을 제안만 하는 _Plan mode_가 있습니다. - **Tab** 키를 사용하여 전환합니다. 오른쪽 하단에 있는 이 지표를 볼 수 있습니다. + **Tab** 키로 전환하면 오른쪽 아래에 모드 표시가 나타납니다. ```bash frame="none" title="Switch to Plan mode" <TAB> ``` - 이제 우리가해야 할 일을 설명합니다. + 이제 원하는 작업을 구체적으로 설명합니다. ```txt frame="none" When a user deletes a note, we'd like to flag it as deleted in the database. @@ -241,17 +233,15 @@ How is authentication handled in @packages/functions/src/api/index.ts From this screen, the user can undelete a note or permanently delete it. ``` - 당신이 원하는 것을 이해하기 위해 OpenCode를 충분히 세부 정보를 제공하려는. 그것은 도움 - 팀의 주니어 개발자에게 이야기하고 싶습니다. + OpenCode가 정확히 이해할 만큼 충분한 맥락을 주는 것이 중요합니다. 팀의 주니어 개발자에게 설명하듯 요청하면 도움이 됩니다. :::tip - OpenCode를 많은 컨텍스트와 예제를 제공하여 당신이 무엇을 이해하는 데 도움이 - 이름 \* + 맥락과 예시를 충분히 제공하면 원하는 결과를 얻기 쉽습니다. ::: -2. **플랜에 대해서 ** +2. **계획 다듬기** - 플랜을 제공하면 피드백을 제공하거나 자세한 내용을 추가 할 수 있습니다. + 계획이 나오면 피드백을 주거나 추가 요구사항을 붙일 수 있습니다. ```txt frame="none" We'd like to design this new screen using a design I've used before. @@ -259,22 +249,20 @@ How is authentication handled in @packages/functions/src/api/index.ts ``` :::tip - 단말에 이미지를 드래그하고 드롭하여 프롬프트에 추가합니다. + 이미지를 터미널에 드래그 앤 드롭하면 프롬프트에 첨부할 수 있습니다. ::: - OpenCode는 어떤 이미지를 스캔할 수 있습니다. 당신은 할 수 - 이 작업을 수행하고 끝으로 이미지를 삭제합니다. + OpenCode는 첨부한 이미지를 분석해 프롬프트에 포함합니다. -3. ** 기능 구축 ** +3. **기능 구현** - 플랜으로 편안하게 느끼면 Build mode by - **Tab** 키를 다시 입력합니다. + 계획이 충분히 만족스러우면 **Tab** 키를 다시 눌러 _Build mode_로 돌아갑니다. ```bash frame="none" <TAB> ``` - 그리고 변경을 요청합니다. + 그리고 실제 변경을 요청합니다. ```bash frame="none" Sounds good! Go ahead and make the changes. @@ -282,10 +270,9 @@ How is authentication handled in @packages/functions/src/api/index.ts --- -### 변경 +### 바로 변경하기 -더 똑바른 변화를 위해, 당신은 OpenCode를 직접 그것을 건설할 수 있습니다 -첫 플랜을 검토하지 않고. +비교적 단순한 변경은 계획 검토 없이 바로 구현하도록 요청해도 됩니다. ```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts" We need to add authentication to the /settings route. Take a look at how this is @@ -293,40 +280,37 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement the same logic in @packages/functions/src/settings.ts ``` -좋은 양의 세부 사항을 제공 하려면 OpenCode가 올바른 -이름 \* +원하는 변경이 정확히 반영되도록, 필요한 맥락을 충분히 제공하세요. --- -### Undo 변경 +### 변경 되돌리기 -OpenCode를 호출하면 변경 사항을 만들 수 있습니다. +예를 들어 OpenCode에 변경을 요청했다고 가정해 보겠습니다. ```txt frame="none" "@packages/functions/src/api/index.ts" Can you refactor the function in @packages/functions/src/api/index.ts? ``` -그러나 당신이 원하는 것은 아닙니다. ** 변경할 수 없습니다 ** -`/undo` 명령을 사용하여. +결과가 기대와 다르면 `/undo` 명령으로 **되돌릴 수** 있습니다. ```bash frame="none" /undo ``` -OpenCode는 이제 당신이 만든 변경을 반전하고 원래 메시지를 표시 -다시. +OpenCode는 방금 적용한 변경을 되돌리고 원래 메시지를 다시 보여줍니다. ```txt frame="none" "@packages/functions/src/api/index.ts" Can you refactor the function in @packages/functions/src/api/index.ts? ``` -여기에서 당신은 신속하고 다시 시도 OpenCode를 요청할 수 있습니다. +이 상태에서 프롬프트를 다듬어 다시 시도하면 됩니다. :::tip -`/undo`를 여러 번 실행할 수 있습니다. +`/undo`는 여러 번 연속으로 실행할 수 있습니다. ::: -또는 \*\* `/redo` 명령을 사용하여 변경할 수 있습니다. +반대로 `/redo` 명령으로 **다시 적용**할 수도 있습니다. ```bash frame="none" /redo @@ -336,24 +320,24 @@ Can you refactor the function in @packages/functions/src/api/index.ts? ## 공유 -opencode와 나눈 대화는 [팀과 공유](/docs/share)할 수 있습니다. +OpenCode와의 대화는 [팀과 공유](/docs/share)할 수 있습니다. ```bash frame="none" /share ``` -현재 대화에 대한 링크를 만들고 클립보드에 복사합니다. +현재 대화 링크를 생성하고 클립보드에 복사합니다. :::note -대화는 기본적으로 공유되지 않습니다. +대화는 기본값으로 공유되지 않습니다. ::: -여기 [example 대화](https://opencode.ai/s/4XP1fce5) 는 opencode 입니다. +아래는 OpenCode [대화 예시](https://opencode.ai/s/4XP1fce5)입니다. --- -## 사용자 정의 +## 커스터마이즈 -그리고 그게 다야! 이제 opencode를 사용하여 프로입니다. +이제 OpenCode 사용의 기본은 끝났습니다. -자신의 것을 만들기 위해, 우리는 [themes](/docs/themes), [keybinds](/docs/keybinds), [configuring code formatters](/docs/formatters), [creating custom commands](/docs/commands), 또는 [opencode config](/docs/config)와 함께 연주하는 것을 추천합니다. +자신의 워크플로우에 맞추려면 [테마 선택](/docs/themes), [키바인드 커스터마이즈](/docs/keybinds), [코드 포매터 설정](/docs/formatters), [커스텀 명령 작성](/docs/commands), [OpenCode config 조정](/docs/config)을 추천합니다. |