@neurocode-ai/web 1.18.8

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

@@ -0,0 +1,223 @@
+---
+title: 모델
+description: LLM 공급자 및 모델 구성.
+---
+
+opencode는 [AI SDK](https://ai-sdk.dev/) 및 [Models.dev](https://models.dev)를 사용하여 **75+ LLM 제공 업체**를 지원하며 로컬 모델을 실행합니다.
+
+---
+
+## 공급자
+
+가장 인기 있는 공급자는 기본적으로 미리 로드되어 있습니다. `/connect` 명령을 통해 공급자를위한 자격 증명을 추가하면 opencode를 시작할 때 사용할 수 있습니다.
+
+자세히 알아보기 [providers](/docs/providers).
+
+---
+
+## 모델 선택
+
+공급자를 구성하면 입력하여 원하는 모델을 선택할 수 있습니다.
+
+```bash frame="none"
+/models
+```
+
+---
+
+## 추천 모델
+
+수많은 모델이 있으며, 매주 새로운 모델이 출시됩니다.
+
+:::tip
+우리가 추천하는 모델 중 하나를 사용하여 고려하십시오.
+:::
+
+하지만 코드 작성과 도구 호출 모두에서 뛰어난 성능을 보이는 모델들이 있습니다.
+
+특별한 순서는 없습니다. (이 목록은 전체 목록이 아니며 최신 상태가 아닐 수 있습니다):
+
+- GPT 5.2
+- GPT 5.1 Codex
+- Claude Opus 4.5
+- Claude Sonnet 4.5
+- M2.1
+- Gemini 3 Pro
+
+---
+
+## 기본값 설정
+
+기본 모델로 설정하려면 `model` 키를 설정할 수 있습니다.
+opencode 설정.
+
+```json title="opencode.json" {3}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "model": "lmstudio/google/gemma-3n-e4b"
+}
+```
+
+전체 ID는 `provider_id/model_id`입니다. 예를 들어, [OpenCode Zen](/docs/zen)을 사용한다면, GPT 5.1 Codex에 `opencode/gpt-5.1-codex`를 사용할 수 있습니다.
+
+[custom Provider](/docs/providers#custom)를 구성하면 `provider_id`는 구성의 `provider` 부분에서 키이며 `model_id`는 `provider.models`에서 키입니다.
+
+---
+
+## 모델 구성
+
+config를 통해 모델의 옵션을 구성할 수 있습니다.
+
+```jsonc title="opencode.jsonc" {7-12,19-24}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "openai": {
+      "models": {
+        "gpt-5": {
+          "options": {
+            "reasoningEffort": "high",
+            "textVerbosity": "low",
+            "reasoningSummary": "auto",
+            "include": ["reasoning.encrypted_content"],
+          },
+        },
+      },
+    },
+    "anthropic": {
+      "models": {
+        "claude-sonnet-4-5-20250929": {
+          "options": {
+            "thinking": {
+              "type": "enabled",
+              "budgetTokens": 16000,
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+여기서는 두 개의 내장 모델에 대한 전역 설정을 구성합니다: `gpt-5`를 통해 액세스 할 때 `openai` 공급자 및 `claude-sonnet-4-20250514`는 `anthropic` 공급자를 통해 액세스 할 때.
+내장 공급자 및 모델 이름은 [Models.dev](https://models.dev)에서 찾을 수 있습니다.
+
+사용중인 에이전트에 이러한 옵션을 구성할 수 있습니다. 에이전트 구성은 여기에 모든 글로벌 옵션을 overrides. [더 알아보기](/docs/agents/#additional).
+
+내장 된 것을 확장하는 사용자 정의 변형을 정의 할 수 있습니다. Variants는 중복 항목 생성 없이 동일한 모델을 위한 다른 설정을 구성할 수 있습니다:
+
+```jsonc title="opencode.jsonc" {6-21}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "opencode": {
+      "models": {
+        "gpt-5": {
+          "variants": {
+            "high": {
+              "reasoningEffort": "high",
+              "textVerbosity": "low",
+              "reasoningSummary": "auto",
+            },
+            "low": {
+              "reasoningEffort": "low",
+              "textVerbosity": "low",
+              "reasoningSummary": "auto",
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+---
+
+## 변형
+
+많은 모델이 다양한 구성의 변형(variant)을 지원합니다. opencode는 인기있는 공급자를위한 기본 변형으로 배송됩니다.
+
+## 내장 변형
+
+opencode는 많은 공급자를 위한 기본 변종으로 발송합니다:
+
+**Anthropic**:
+
+- `high` - 높은 생각(Thinking) 예산 (기본)
+- `max` - 최대 생각 예산
+
+** OpenAI **:
+
+모델에 따라 다릅니다.
+
+- `none` - 추론(Reasoning) 없음
+- `minimal` - 최소 추론 노력
+- `low` - 낮은 이유 노력
+- `medium` - 중간 이유 노력
+- `high` - 높은 이유 노력
+- `xhigh` - 추가 높은 이유 노력
+
+** 구글 **:
+
+- `low` - 더 낮은 노력/토큰 예산
+- `high` - 더 높은 노력 / 토큰 예산
+
+:::tip
+이 목록은 포괄적이지 않습니다. 다른 많은 공급자는 기본적으로 내장되어 있습니다.
+:::
+
+### 사용자 정의 변형
+
+기존의 변형을 과도하게 할 수 있거나 자신에게 추가 할 수 있습니다.
+
+```jsonc title="opencode.jsonc" {7-18}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "openai": {
+      "models": {
+        "gpt-5": {
+          "variants": {
+            "thinking": {
+              "reasoningEffort": "high",
+              "textVerbosity": "low",
+            },
+            "fast": {
+              "disabled": true,
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+## 변형 순환
+
+keybind `variant_cycle`를 사용하여 변형 사이 신속하게 전환합니다. [더 알아보기](/docs/keybinds).
+
+---
+
+## 모델 로딩 순서
+
+opencode가 시작될 때, 다음의 우선순위 순서에 있는 모형을 검사합니다:
+
+1. `--model` 또는 `-m` 명령 선 깃발. 형식은 구성 파일과 동일합니다. `provider_id/model_id`.
+
+2. opencode config의 모델 목록.
+
+   ```json title="opencode.json"
+   {
+     "$schema": "https://opencode.ai/config.json",
+     "model": "anthropic/claude-sonnet-4-20250514"
+   }
+   ```
+
+여기에 형식은 `provider/model`입니다.
+
+3. 마지막 사용된 모형.
+
+4. 내부 우선 순위를 사용하는 첫 번째 모델.

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

@@ -0,0 +1,57 @@
+---
+title: 네트워크
+description: 프록시 및 사용자 정의 인증서 구성.
+---
+
+opencode는 엔터프라이즈 네트워크 환경을 위한 표준 프록시 환경 변수 및 사용자 지정 인증서를 지원합니다.
+
+---
+
+## 프록시
+
+opencode는 표준 프록시 환경 변수를 존중합니다.
+
+```bash
+# HTTPS proxy (recommended)
+export HTTPS_PROXY=https://proxy.example.com:8080
+
+# HTTP proxy (if HTTPS not available)
+export HTTP_PROXY=http://proxy.example.com:8080
+
+# Bypass proxy for local server (required)
+export NO_PROXY=localhost,127.0.0.1
+```
+
+:::caution
+TUI는 로컬 HTTP 서버와 통신합니다. routing 루프를 방지하기 위해이 연결에 대한 프록시를 우회해야합니다.
+:::
+
+[CLI 플래그](/docs/cli#run)을 사용하여 서버 포트와 호스트명을 구성할 수 있습니다.
+
+---
+
+### 인증
+
+프록시가 기본 인증을 필요로 하는 경우 URL에서 자격 증명이 포함되어 있습니다.
+
+```bash
+export HTTPS_PROXY=http://username:password@proxy.example.com:8080
+```
+
+:::caution
+암호를 해독하지 마십시오. 환경 변수를 사용하거나 자격 증명 스토리지를 확보하십시오.
+:::
+
+NTLM 또는 Kerberos와 같은 고급 인증을 요구하는 프록시는 인증 방법을 지원하는 LLM Gateway를 사용하여 고려합니다.
+
+---
+
+## 사용자 정의 인증서
+
+엔터프라이즈가 HTTPS 연결을 위해 사용자 정의 CA를 사용한다면, opencode를 사용하여 신뢰합니다.
+
+```bash
+export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
+```
+
+프록시 연결과 직접 API 액세스를 위한 이 작업.

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

@@ -0,0 +1,235 @@
+---
+title: 권한
+description: 실행 승인이 필요한 작업을 제어합니다.
+---
+
+opencode는 주어진 동작이 자동으로 실행되는지 결정하기 위해 `permission` config를 사용하거나 차단합니다.
+
+`v1.1.1`의 것과 같이, 유산 `tools` 불린 구성은 deprecated이고 `permission`로 합병되었습니다. 오래된 `tools` config는 여전히 뒤쪽 호환성을 위해 지원됩니다.
+
+---
+
+## 동작
+
+각 권한 규칙은 다음과 같습니다:
+
+- `"allow"` - 승인없이 실행
+- `"ask"` - 승인을위한 prompt
+- `"deny"` - 동작 차단
+
+---
+
+## 구성
+
+글로벌 권한(`*` 포함) 및 특정 도구를 부여할 수 있습니다.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "*": "ask",
+    "bash": "allow",
+    "edit": "deny"
+  }
+}
+```
+
+한 번에 모든 권한을 설정할 수 있습니다.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": "allow"
+}
+```
+
+---
+
+## 세부 규칙 (객체 구문)
+
+대부분의 권한을 위해 도구 입력을 기반으로 다른 작업을 적용 할 수 있습니다.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "npm *": "allow",
+      "rm *": "deny",
+      "grep *": "allow"
+    },
+    "edit": {
+      "*": "deny",
+      "packages/web/src/content/docs/*.mdx": "allow"
+    }
+  }
+}
+```
+
+규칙은 패턴 일치에 의해 평가됩니다, ** 마지막 일치 규칙 우승 **. 일반적인 패턴은 catch-all `"*"` 규칙을 먼저 넣는 것입니다, 그리고 그 후에 더 구체적인 규칙.
+
+## 와일드카드
+
+Permission 본 사용 간단한 wildcard 일치:
+
+- `*`는 어떤 성격든지의 0개 이상 일치합니다
+- `?`는 정확히 하나의 문자 일치
+- 다른 모든 문자 일치 말 그대로
+
+## 홈 디렉토리 확장
+
+`~` 또는 `$HOME`를 사용할 수 있습니다 패턴의 시작에 홈 디렉토리를 참조. 이것은 특히 유용합니다 [`external_directory`](#external-directories) 규칙.
+
+- `~/projects/*` -> `/Users/username/projects/*`
+- `$HOME/projects/*` -> `/Users/username/projects/*`
+- `~` -> `/Users/username`
+
+## 외부 디렉터리
+
+`external_directory`를 사용하여 도구가 opencode가 시작된 작업 디렉토리 밖에 터치 경로가 호출되도록합니다. 이것은 입력 (예 : `read`, `edit`, `glob`, `grep` 및 많은 `bash` 명령)로 경로를 수행하는 모든 도구에 적용됩니다.
+
+홈 확장 (`~/...`와 같은) 패턴이 작성된 방법에 영향을 미칩니다. 그것은 현재의 작업 공간의 외부 경로 부분을 만들지 않습니다, 그래서 작업 디렉토리 외부 경로는 여전히 `external_directory`를 통해 허용해야합니다.
+
+예를 들어, 이것은 `~/projects/personal/`의 모든 것에 액세스 할 수 있습니다.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    }
+  }
+}
+```
+
+여기에 허용되는 모든 디렉토리는 현재 작업 공간과 동일한 기본값을 상속합니다. [`read` defaults to `allow`](#defaults)는 `external_directory`에서 `external_directory`의 항목에 대해 읽을 수 있습니다. 도구가 이러한 경로에 제한 될 때 명시적 규칙을 추가하십시오.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    },
+    "edit": {
+      "~/projects/personal/**": "deny"
+    }
+  }
+}
+```
+
+신뢰할 수있는 경로에 초점을 맞춘 목록을 유지하고 다른 도구 (예 : `bash`)에 필요한대로 추가 허용하거나 deny 규칙을 층을 설정합니다.
+
+---
+
+## 사용 가능한 권한
+
+opencode 권한은 도구 이름에 의해 키 입력되며, 두 개의 안전 가드 :
+
+- `read` - 파일 읽기 (파일 경로의 매칭)
+- `edit` - 모든 파일 수정 (covers `edit`, `write`, `patch`)
+- `glob` - 파일 globbing (glob 패턴 매칭)
+- `grep` - 콘텐츠 검색 ( regex 패턴 매칭)
+- `bash` - shell 명령 실행 (`git status --porcelain`와 같은 팟 명령)
+- `task` - 에이전트 실행 (작업 에이전트 유형)
+- `skill` - 기술을 로딩 (기술 이름을 매칭)
+- `lsp` - LSP 쿼리 실행 (현재 비 과립)
+- `webfetch` - URL을 fetching ( URL을 매칭)
+- `websearch` - 웹 검색 (문자 쿼리)
+- `external_directory` - 프로젝트 작업 디렉토리 외부의 도구 접촉 경로 때 트리거
+- `doom_loop` - 동일한 도구 호출이 동일한 입력으로 3 번 반복 할 때 트리거
+
+---
+
+## 기본값
+
+아무것도 지정하지 않는 경우, opencode는 permissive 기본값에서 시작합니다.
+
+- `"allow"`에 기본 권한.
+- `doom_loop` 및 `external_directory` 기본적으로 `"ask"`.
+- `read`는 `"allow"`이고, 그러나 `.env` 파일은 기본적으로 denied:
+
+```json title="opencode.json"
+{
+  "permission": {
+    "read": {
+      "*": "allow",
+      "*.env": "deny",
+      "*.env.*": "deny",
+      "*.env.example": "allow"
+    }
+  }
+}
+```
+
+---
+
+## "Ask"란 무엇입니까?
+
+opencode가 승인되면 UI는 세 가지 결과를 제공합니다.
+
+- `once` - 이 요청을 승인
+- `always` - 제안 된 패턴과 일치하는 미래 요청 (현재 opencode 세션의 나머지)
+- `reject` - 요청을 거부
+
+`always`는 도구 (예를 들면, bash 승인 일반적으로 `git status*`와 같은 안전한 명령 접두사)에 의해 approve가 제공 될 패턴의 집합.
+
+---
+
+## 에이전트
+
+에이전트 당 권한이 부여 될 수 있습니다. 에이전트 권한은 글로벌 구성과 합병되며, 에이전트 규칙은 우선합니다. [Learn more](/docs/agents#permissions) 약 에이전트 권한.
+
+:::note
+[Granular Rules (Object Syntax)](#granular-rules-object-syntax))에 대한 자세한 패턴 매칭 예제를 참조하십시오.
+:::
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "git commit *": "deny",
+      "git push *": "deny",
+      "grep *": "allow"
+    }
+  },
+  "agent": {
+    "build": {
+      "permission": {
+        "bash": {
+          "*": "ask",
+          "git *": "allow",
+          "git commit *": "ask",
+          "git push *": "deny",
+          "grep *": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+Markdown의 에이전트 권한을 구성할 수 있습니다.
+
+```markdown title="~/.config/opencode/agents/review.md"
+---
+description: Code review without edits
+mode: subagent
+permission:
+  edit: deny
+  bash: ask
+  webfetch: deny
+---
+
+Only analyze code and suggest changes.
+```
+
+:::tip
+인자와 명령에 대한 패턴 매칭을 사용합니다. `"grep *"`는 `grep pattern file.txt`를 허용하고, `"grep"`는 혼자 그것을 막을 것입니다. `git status`와 같은 명령은 기본 동작을 위해 작동하지만, 인수가 전달될 때 명시된 권한 (`"git status *"`와 같은)이 필요합니다.
+:::