@neurocode-ai/web 1.18.8

package/src/content/docs/ko/tui.mdx

@@ -0,0 +1,425 @@
+---
+title: TUI
+description: OpenCode 터미널 사용자 인터페이스 사용.
+---
+
+import { Tabs, TabItem } from "@astrojs/starlight/components"
+
+OpenCode는 LLM과 함께 프로젝트 작업을 하기 위한 대화형 터미널 인터페이스(TUI)를 제공합니다.
+
+OpenCode를 실행하면 현재 디렉토리에서 TUI가 시작됩니다.
+
+```bash
+opencode
+```
+
+또는 특정 작업 디렉토리에 대해 시작할 수 있습니다.
+
+```bash
+opencode /path/to/project
+```
+
+TUI에 들어가면 메시지를 입력하여 프롬프트할 수 있습니다.
+
+```text
+Give me a quick summary of the codebase.
+```
+
+---
+
+## 파일 참조
+
+`@`를 사용하여 메시지에서 파일을 참조할 수 있습니다. 이것은 현재 작업 디렉토리에서 퍼지(fuzzy) 파일 검색을 수행합니다.
+
+:::tip
+`@`를 사용하여 메시지에서 파일을 참조할 수 있습니다.
+:::
+
+```text "@packages/functions/src/api/index.ts"
+How is auth handled in @packages/functions/src/api/index.ts?
+```
+
+파일의 내용이 자동으로 대화에 추가됩니다.
+
+---
+
+## Bash 명령
+
+`!`로 메시지를 시작하여 셸 명령을 실행합니다.
+
+```bash frame="none"
+!ls -la
+```
+
+명령의 출력은 도구 결과로 대화에 추가됩니다.
+
+---
+
+## 명령
+
+OpenCode TUI를 사용할 때 `/` 뒤에 명령 이름을 입력하여 작업을 빠르게 실행할 수 있습니다. 예를 들어:
+
+```bash frame="none"
+/help
+```
+
+대부분의 명령에는 기본 리더 키인 `ctrl+x`를 사용하는 키바인드도 있습니다. [더 알아보기](/docs/keybinds).
+
+사용 가능한 모든 슬래시 명령은 다음과 같습니다:
+
+---
+
+### connect
+
+OpenCode에 공급자를 추가합니다. 사용 가능한 공급자 중에서 선택하고 API 키를 추가할 수 있습니다.
+
+```bash frame="none"
+/connect
+```
+
+---
+
+### compact
+
+현재 세션을 압축합니다. _별칭_: `/summarize`
+
+```bash frame="none"
+/compact
+```
+
+**키바인드:** `ctrl+x c`
+
+---
+
+### details
+
+도구 실행 세부 정보 토글.
+
+```bash frame="none"
+/details
+```
+
+**키바인드:** `ctrl+x d`
+
+---
+
+### editor
+
+메시지 작성을 위한 외부 편집기를 엽니다. `EDITOR` 환경 변수에 설정된 편집기를 사용합니다. [더 알아보기](#editor-setup).
+
+```bash frame="none"
+/editor
+```
+
+**키바인드:** `ctrl+x e`
+
+---
+
+### exit
+
+OpenCode를 종료합니다. _별칭_: `/quit`, `/q`
+
+```bash frame="none"
+/exit
+```
+
+**키바인드:** `ctrl+x q`
+
+---
+
+### export
+
+현재 대화를 Markdown으로 내보내고 기본 편집기에서 엽니다. `EDITOR` 환경 변수에 설정된 편집기를 사용합니다. [더 알아보기](#editor-setup).
+
+```bash frame="none"
+/export
+```
+
+**키바인드:** `ctrl+x x`
+
+---
+
+### help
+
+도움말 대화 상자를 표시합니다.
+
+```bash frame="none"
+/help
+```
+
+**키바인드:** `ctrl+x h`
+
+---
+
+### init
+
+`AGENTS.md` 파일을 생성하거나 업데이트합니다. [더 알아보기](/docs/rules).
+
+```bash frame="none"
+/init
+```
+
+**키바인드:** `ctrl+x i`
+
+---
+
+### models
+
+사용 가능한 모델 목록을 표시합니다.
+
+```bash frame="none"
+/models
+```
+
+**키바인드:** `ctrl+x m`
+
+---
+
+### new
+
+새 세션을 시작합니다. _별칭_: `/clear`
+
+```bash frame="none"
+/new
+```
+
+**키바인드:** `ctrl+x n`
+
+---
+
+### redo
+
+이전에 실행 취소한 메시지를 다시 실행합니다. `/undo`를 사용한 후에만 사용할 수 있습니다.
+
+:::tip
+모든 파일 변경 사항도 복원됩니다.
+:::
+
+내부적으로 Git을 사용하여 파일 변경 사항을 관리합니다. 따라서 프로젝트가 **Git 저장소**여야 합니다.
+
+```bash frame="none"
+/redo
+```
+
+**키바인드:** `ctrl+x r`
+
+---
+
+### sessions
+
+세션 목록을 표시하고 세션 간을 전환합니다. _별칭_: `/resume`, `/continue`
+
+```bash frame="none"
+/sessions
+```
+
+**키바인드:** `ctrl+x l`
+
+---
+
+### share
+
+현재 세션을 공유합니다. [더 알아보기](/docs/share).
+
+```bash frame="none"
+/share
+```
+
+**키바인드:** `ctrl+x s`
+
+---
+
+### themes
+
+사용 가능한 테마 목록을 표시합니다.
+
+```bash frame="none"
+/themes
+```
+
+**키바인드:** `ctrl+x t`
+
+---
+
+### thinking
+
+대화에서 생각/추론 블록의 가시성을 토글합니다. 활성화하면 확장된 사고를 지원하는 모델의 추론 과정을 볼 수 있습니다.
+
+:::note
+이 명령은 생각 블록이 **표시되는지 여부만 제어**하며 모델의 추론 기능을 활성화하거나 비활성화하지 않습니다. 실제 추론 기능을 토글하려면 `ctrl+t`를 사용하여 모델 변형을 순환하십시오.
+:::
+
+```bash frame="none"
+/thinking
+```
+
+---
+
+### undo
+
+대화의 마지막 메시지를 실행 취소합니다. 가장 최근의 사용자 메시지, 모든 후속 응답 및 모든 파일 변경 사항을 제거합니다.
+
+:::tip
+모든 파일 변경 사항도 되돌려집니다.
+:::
+
+내부적으로 Git을 사용하여 파일 변경 사항을 관리합니다. 따라서 프로젝트가 **Git 저장소**여야 합니다.
+
+```bash frame="none"
+/undo
+```
+
+**키바인드:** `ctrl+x u`
+
+---
+
+### unshare
+
+현재 세션 공유를 취소합니다. [더 알아보기](/docs/share#un-sharing).
+
+```bash frame="none"
+/unshare
+```
+
+---
+
+## Editor setup
+
+`/editor`와 `/export` 명령 모두 `EDITOR` 환경 변수에 지정된 편집기를 사용합니다.
+
+<Tabs>
+  <TabItem label="Linux/macOS">
+    ```bash
+    # Example for nano or vim
+    export EDITOR=nano
+    export EDITOR=vim
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    export EDITOR="code --wait"
+    ```
+
+    영구적으로 설정하려면 셸 프로필(`~/.bashrc`, `~/.zshrc` 등)에 추가하십시오.
+
+  </TabItem>
+
+  <TabItem label="Windows (CMD)">
+    ```bash
+    set EDITOR=notepad
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    set EDITOR=code --wait
+    ```
+
+    영구적으로 설정하려면 **시스템 속성** > **환경 변수**를 사용하십시오.
+
+  </TabItem>
+
+  <TabItem label="Windows (PowerShell)">
+    ```powershell
+    $env:EDITOR = "notepad"
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    $env:EDITOR = "code --wait"
+    ```
+
+    영구적으로 설정하려면 PowerShell 프로필에 추가하십시오.
+
+  </TabItem>
+</Tabs>
+
+인기 있는 편집기 옵션은 다음과 같습니다:
+
+- `code` - Visual Studio Code
+- `cursor` - Cursor
+- `windsurf` - Windsurf
+- `nvim` - Neovim editor
+- `vim` - Vim editor
+- `nano` - Nano editor
+- `notepad` - Windows Notepad
+- `subl` - Sublime Text
+
+:::note
+VS Code와 같은 일부 편집기는 `--wait` 플래그와 함께 시작해야 합니다.
+:::
+
+일부 편집기는 차단 모드에서 실행하려면 명령줄 인수가 필요합니다. `--wait` 플래그는 편집기 프로세스가 닫힐 때까지 차단되도록 합니다.
+
+---
+
+## 구성
+
+`tui.json` (또는 `tui.jsonc`) 파일을 통해 TUI 동작을 사용자 정의할 수 있습니다.
+
+```json title="tui.json"
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "theme": "opencode",
+  "leader_timeout": 2000,
+  "keybinds": {
+    "leader": "ctrl+x",
+    "command_list": "ctrl+p"
+  },
+  "scroll_speed": 3,
+  "scroll_acceleration": {
+    "enabled": false
+  },
+  "diff_style": "auto",
+  "mouse": true,
+  "attention": {
+    "enabled": true,
+    "notifications": true,
+    "sound": true,
+    "volume": 0.4,
+    "sound_pack": "opencode.default",
+    "sounds": {
+      "error": "./sounds/error.mp3"
+    }
+  }
+}
+```
+
+이는 서버/런타임 동작을 구성하는 `opencode.json`과는 별개입니다.
+
+`keybinds`는 내장 기본값과 병합되므로 변경하려는 단축키만 설정하면 됩니다.
+
+### 옵션
+
+- `theme` - UI 테마를 설정합니다. [더 알아보기](/docs/themes).
+- `keybinds` - 키보드 단축키를 사용자 정의합니다. [더 알아보기](/docs/keybinds).
+- `leader_timeout` - leader key를 누른 뒤 OpenCode가 다음 키 입력을 기다리는 시간을 제어합니다. 기본값은 `2000`입니다.
+- `scroll_acceleration.enabled` - 부드럽고 자연스러운 스크롤을 위해 macOS 스타일의 스크롤 가속을 활성화합니다. 활성화하면 빠른 스크롤 제스처로 스크롤 속도가 증가하고 느린 움직임에서는 정밀하게 유지됩니다. **이 설정은 `scroll_speed`보다 우선하며 활성화 시 이를 덮어씁니다.**
+- `scroll_speed` - 스크롤 명령을 사용할 때 TUI 스크롤 속도를 제어합니다 (최소: `0.001`, 소수점 값 지원). 기본값은 `3`입니다. **참고: `scroll_acceleration.enabled`가 `true`로 설정되면 무시됩니다.**
+- `diff_style` - diff 렌더링 방식을 제어합니다. `"auto"`는 터미널 너비에 적응하고, `"stacked"`는 항상 단일 열 레이아웃을 표시합니다.
+- `mouse` - TUI에서 마우스 캡처를 활성화하거나 비활성화합니다(기본값: `true`). 비활성화하면 터미널의 기본 마우스 선택/스크롤 동작이 유지됩니다.
+- `attention` - TUI 데스크톱 알림과 사운드를 구성합니다. 기본적으로 비활성화되어 있습니다.
+
+`OPENCODE_TUI_CONFIG`를 사용하여 사용자 정의 TUI 설정 경로를 로드할 수 있습니다.
+
+### Attention
+
+Attention을 사용하면 OpenCode가 답변을 기다리거나, 권한 승인이 필요하거나, 세션 오류가 발생했거나, 세션이 완료되었을 때 TUI가 사운드와 데스크톱 알림으로 알려줍니다. `attention.enabled`로 활성화합니다. 기본 제공 이벤트는 발생할 때 사운드를 재생합니다. 데스크톱 알림은 터미널 창에 포커스가 없을 때만 전송되며 subagent 이벤트에는 사용되지 않습니다.
+
+- `enabled` - Attention의 모든 알림과 사운드를 활성화합니다. 기본값은 `false`입니다.
+- `notifications` - Attention이 활성화된 경우 TUI가 터미널을 통해 데스크톱 알림을 보낼 수 있도록 허용합니다. 기본값은 `true`입니다.
+- `sound` - Attention이 활성화된 경우 알림음을 재생할 수 있도록 허용합니다. 기본값은 `true`입니다.
+- `volume` - 알림음의 기본 볼륨이며 `0`부터 `1`까지입니다. 기본값은 `0.4`입니다.
+- `sound_pack` - 사용할 sound pack ID입니다. 기본값은 `opencode.default`입니다.
+- `sounds` - `default`, `question`, `permission`, `error`, `done` 또는 `subagent_done`에 사용할 사용자 지정 사운드 파일을 지정합니다. 경로는 절대 경로, `file://` URL 또는 `tui.json` 기준 상대 경로일 수 있습니다.
+
+---
+
+## 사용자 정의
+
+명령 팔레트(`ctrl+x h` 또는 `/help`)를 사용하여 TUI 보기의 다양한 측면을 사용자 정의할 수 있습니다. 설정은 다시 시작해도 유지됩니다.
+
+---
+
+#### 사용자 이름 표시
+
+채팅 메시지에 사용자 이름이 표시되는지 여부를 토글합니다. 다음을 통해 액세스:
+
+- 명령 팔레트: "username" 또는 "hide username" 검색
+- 설정은 자동으로 유지되며 TUI 세션 간에 기억됩니다.

package/src/content/docs/ko/web.mdx

@@ -0,0 +1,142 @@
+---
+title: Web
+description: 브라우저에서 OpenCode 사용하기.
+---
+
+opencode는 브라우저에서 웹 응용 프로그램을 실행할 수 있으며 terminal을 필요로하지 않고 동일한 강력한 AI 코딩 경험을 제공합니다.
+
+![opencode Web - 새로운 세션](../../../assets/web/web-homepage-new-session.png)
+
+## 시작하기
+
+실행하여 웹 인터페이스를 시작:
+
+```bash
+opencode web
+```
+
+`127.0.0.1`의 로컬 서버를 랜덤 사용 가능한 포트로 시작하고 기본 브라우저에서 opencode를 자동으로 엽니다.
+
+:::caution
+`OPENCODE_SERVER_PASSWORD`가 설정되지 않은 경우 서버가 중단되지 않습니다. 이것은 로컬 사용을위한 괜찮지만 네트워크 액세스를 설정해야합니다.
+:::
+
+:::tip[Windows 사용자]
+최고의 경험을 위해서는 PowerShell보다 `opencode web`를 실행하십시오. 적절한 파일 시스템 액세스 및 terminal 통합을 보장합니다.
+:::
+
+---
+
+## 구성
+
+명령줄 플래그 또는 [config file](/docs/config)에서 웹 서버를 구성할 수 있습니다.
+
+## 포트
+
+기본적으로 opencode는 사용할 수 있는 포트를 선택합니다. 포트를 지정할 수 있습니다:
+
+```bash
+opencode web --port 4096
+```
+
+## 호스트 이름
+
+기본적으로 서버는 `127.0.0.1` (localhost only)에 바인딩합니다. 네트워크에서 opencode를 사용할 수 있도록:
+
+```bash
+opencode web --hostname 0.0.0.0
+```
+
+`0.0.0.0`를 사용할 때, opencode는 로컬 및 네트워크 주소를 모두 표시합니다.
+
+```
+  Local access:       http://localhost:4096
+  Network access:     http://192.168.1.100:4096
+```
+
+### mDNS 발견
+
+로컬 네트워크에서 서버를 발견할 수 있는 mDNS:
+
+```bash
+opencode web --mdns
+```
+
+이 자동으로 `0.0.0.0`에 hostname을 설정하고 `opencode.local`로 서버를 광고합니다.
+
+동일한 네트워크에서 여러 인스턴스를 실행하려면 mDNS 도메인 이름을 지정할 수 있습니다.
+
+```bash
+opencode web --mdns --mdns-domain myproject.local
+```
+
+###### CORS
+
+CORS에 대한 추가 도메인을 허용하려면 (사용자 정의 frontends에 적합) :
+
+```bash
+opencode web --cors https://example.com
+```
+
+### 인증
+
+액세스를 보호하려면 `OPENCODE_SERVER_PASSWORD` 환경 변수를 사용하여 암호를 설정하십시오.
+
+```bash
+OPENCODE_SERVER_PASSWORD=secret opencode web
+```
+
+`opencode`에 대한 사용자의 기본값은 `OPENCODE_SERVER_USERNAME`로 변경할 수 있습니다.
+
+---
+
+## 웹 인터페이스 사용
+
+시작되면 웹 인터페이스는 opencode 세션에 액세스 할 수 있습니다.
+
+## 세션
+
+홈페이지에서 세션을 보고 관리합니다. 활성 세션을 볼 수 있으며 새로운 것을 시작합니다.
+
+![opencode Web - Active Session](../../../assets/web/web-homepage-active-session.png)
+
+## 서버 상태
+
+"See Servers"를 클릭하여 연결된 서버와 상태를 볼 수 있습니다.
+
+![opencode Web - Servers 참조](../../../assets/web/web-homepage-see-servers.png)
+
+---
+
+## 터미널 연결
+
+실행 웹 서버에 terminal TUI를 연결할 수 있습니다.
+
+```bash
+# Start the web server
+opencode web --port 4096
+
+# In another terminal, attach the TUI
+opencode attach http://localhost:4096
+```
+
+웹 인터페이스와 terminal을 동시에 사용할 수 있도록, 같은 세션과 상태를 공유합니다.
+
+---
+
+## 구성 파일
+
+`opencode.json` config 파일에서 서버 설정을 구성할 수 있습니다:
+
+```json
+{
+  "server": {
+    "port": 4096,
+    "hostname": "0.0.0.0",
+    "mdns": true,
+    "cors": ["https://example.com"]
+  }
+}
+```
+
+Command line flags는 config 파일 설정에 대한 precedence를 가져옵니다.

package/src/content/docs/ko/windows-wsl.mdx

@@ -0,0 +1,119 @@
+---
+title: Windows (WSL)
+description: WSL로 Windows에서 opencode를 더 편하게 사용하세요.
+---
+
+import { Steps } from "@astrojs/starlight/components"
+
+opencode는 Windows에서 직접 실행할 수 있지만, 가장 좋은 사용 경험을 위해 [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) 사용을 권장합니다. WSL은 opencode 기능과 자연스럽게 동작하는 Linux 환경을 제공합니다.
+
+:::tip[왜 WSL인가요?]
+WSL은 더 나은 파일 시스템 성능, 완전한 terminal 지원, 그리고 opencode가 의존하는 개발 도구와의 호환성을 제공합니다.
+:::
+
+---
+
+## 설정
+
+<Steps>
+
+1. **WSL 설치하기**
+
+   아직 설치하지 않았다면 Microsoft 공식 가이드를 따라 [WSL을 설치](https://learn.microsoft.com/en-us/windows/wsl/install)하세요.
+
+2. **WSL에 opencode 설치하기**
+
+   WSL 설정이 끝나면 WSL terminal을 열고 [설치 방법](/docs/) 중 하나로 opencode를 설치하세요.
+
+   ```bash
+   curl -fsSL https://opencode.ai/install | bash
+   ```
+
+3. **WSL에서 opencode 실행하기**
+
+   프로젝트 디렉터리로 이동한 뒤(opencode에서 Windows 파일은 `/mnt/c/`, `/mnt/d/` 등으로 접근) opencode를 실행하세요.
+
+   ```bash
+   cd /mnt/c/Users/YourName/project
+   opencode
+   ```
+
+</Steps>
+
+---
+
+## 데스크톱 앱 + WSL 서버
+
+opencode 데스크톱 앱을 쓰면서 서버는 WSL에서 실행하고 싶다면 다음처럼 진행하세요.
+
+1. **WSL에서 서버 시작하기**
+
+   외부 연결을 허용하려면 `--hostname 0.0.0.0` 옵션을 사용하세요.
+
+   ```bash
+   opencode serve --hostname 0.0.0.0 --port 4096
+   ```
+
+2. **데스크톱 앱 연결하기**
+
+   `http://localhost:4096`로 연결하세요.
+
+:::note
+환경에 따라 `localhost`가 동작하지 않으면 WSL의 IP 주소를 사용하세요(WSL에서 `hostname -I` 실행). 이후 `http://<wsl-ip>:4096`로 접속하면 됩니다.
+:::
+
+:::caution
+`--hostname 0.0.0.0`을 사용할 때는 `OPENCODE_SERVER_PASSWORD`를 설정해 서버를 보호하세요.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
+```
+
+:::
+
+---
+
+## 웹 클라이언트 + WSL
+
+Windows에서 웹 사용 경험을 가장 좋게 하려면:
+
+1. **PowerShell 대신 WSL terminal에서 `opencode web` 실행하기**
+
+   ```bash
+   opencode web --hostname 0.0.0.0
+   ```
+
+2. **Windows 브라우저에서 접속하기**
+
+   `http://localhost:<port>`로 접속하세요(opencode가 URL을 출력합니다).
+
+WSL에서 `opencode web`를 실행하면 올바른 파일 시스템 접근과 terminal 통합을 유지하면서도 Windows 브라우저에서 바로 사용할 수 있습니다.
+
+---
+
+## Windows 파일 접근
+
+WSL에서는 `/mnt/` 디렉터리를 통해 Windows 파일 전체에 접근할 수 있습니다.
+
+- `C:` drive → `/mnt/c/`
+- `D:` drive → `/mnt/d/`
+- 다른 드라이브도 같은 방식입니다
+
+예시:
+
+```bash
+cd /mnt/c/Users/YourName/Documents/project
+opencode
+```
+
+:::tip
+가장 매끄러운 경험을 원한다면 저장소를 WSL 파일시스템(예: `~/code/`)으로 복제하거나 복사한 뒤 그 위치에서 opencode를 실행해 보세요.
+:::
+
+---
+
+## 팁
+
+- Windows 드라이브에 있는 프로젝트라도 opencode는 WSL에서 실행하면 파일 접근이 더 자연스럽습니다
+- 통합된 개발 워크플로를 위해 opencode와 함께 VS Code의 [WSL 확장](https://code.visualstudio.com/docs/remote/wsl)을 사용해 보세요
+- opencode 설정과 세션은 WSL 환경의 `~/.local/share/opencode/`에 저장됩니다