ToothFairyAI_Public/tf_code
1
0
Fork 0
mirror of https://gitea.toothfairyai.com/ToothFairyAI/tf_code.git synced 2026-04-07 09:18:41 +00:00
Code Issues Packages Projects Releases Wiki Activity

fix(docs): locale translations for nav elements and headings

Browse Source
This commit is contained in:
Adam
2026-02-11 18:51:27 -06:00
parent 8eea53a41e
commit aea68c386a
484 changed files with 12718 additions and 11212 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
packages/web/src/content/docs/ko/acp.mdx
View File

@@ -1,6 +1,6 @@
---
title: ACP Support
description: Use opencode in any ACP-compatible editor.
title: ACP 지원
description: ACP 호환 편집기에서 opencode를 사용하세요.
---
opencode는 [Agent Client Protocol](https://agentclientprotocol.com) 또는 (ACP)을 지원하며, 호환 편집기 및 IDE에서 직접 사용할 수 있습니다.
@@ -23,7 +23,7 @@ ACP를 통해 opencode를 사용하려면 `opencode acp` 명령을 실행하려
---
##### Zed를
##### Zed
[Zed](https://zed.dev) 구성 (`~/.config/zed/settings.json`)에 추가 :
@@ -67,7 +67,7 @@ ACP를 통해 opencode를 사용하려면 `opencode acp` 명령을 실행하려
---
#### JetBrains IDEs의 특징
#### JetBrains IDEs
[JetBrains IDE]에 추가하십시오 (https://www.jetbrains.com/) [documentation]에 따라 acp.json (https://www.jetbrains.com/help/ai-assistant/acp.html):
@@ -86,7 +86,7 @@ ACP를 통해 opencode를 사용하려면 `opencode acp` 명령을 실행하려
---
#### Avante.nvim의
#### Avante.nvim
[Avante.nvim](https://github.com/yetone/avante.nvim) 구성에 추가하십시오:
@@ -140,9 +140,9 @@ require("codecompanion").setup({
환경 변수 (`OPENCODE_API_KEY`와 같은)를 전달해야하는 경우, CodeCompanion.nvim 문서에서 [Configuring Adapters: Environment variables](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key)를 참조하십시오.
## 지원
## 지원 기능
opencode는 terminal에서 같은 ACP를 통해 작동합니다. 모든 기능은 지원됩니다:
opencode는 터미널과 동일하게 ACP를 통해 작동합니다. 모든 기능은 지원됩니다:
:::note
`/undo` 및 `/redo`와 같은 일부 내장 슬래시 명령은 현재 지원되지 않습니다.

220
packages/web/src/content/docs/ko/agents.mdx
View File

@@ -1,136 +1,135 @@
---
title: Agents
description: Configure and use specialized agents.
title: 에이전트
description: 전문 에이전트를 구성하고 사용하세요.
---
에이전트는 특정 작업과 워크플로우를 구성할 수 있는 AI 보조를 전문으로 합니다. 사용자 정의 프롬프트, 모델 및 도구 액세스와 초점을 맞춘 도구를 만들 수 있습니다.
에이전트는 특정 작업과 워크플로우를 전문으로 하는 구성 가능한 AI 보조자입니다. 사용자 정의 프롬프트, 모델, 도구 액세스로 집중된 도구를 만들 수 있습니다.
:::tip
코드를 분석하고 코드 변경없이 제안을 검토 할 계획 에이전트를 사용합니다.
코드 변경 없이 제안을 검토할 때는 Plan 에이전트를 사용하세요.
:::
세션 중에 에이전트를 전환하거나 `@` 언급으로 호출 할 수 있습니다.
세션 중에 에이전트를 전환하거나 `@` 멘션으로 호출할 수 있습니다.
---
## 유형
OpenCode의 두 가지 유형이 있습니다; 기본 에이전트와 subagents.
OpenCode에는 두 가지 유형의 에이전트가 있습니다: 기본 에이전트(Primary Agent)와 서브 에이전트(Subagent).
---
### 주요 에이전트
### 기본 에이전트
주요 에이전트은 당신이 직접 상호 작용하는 주요 조수입니다. **Tab** 키 또는 설정된 `switch_agent` keybind를 사용하여 주기 할 수 있습니다. 이 에이전트은 당신의 주요 대화를 취급합니다. 도구 액세스는 권한을 통해 구성된다 — 예를 들어, Build는 Plan이 제한되는 동안 모든 도구를 사용할 수 있습니다.
기본 에이전트는 사용자가 직접 상호 작용하는 주요 보조자입니다. **Tab** 키 또는 설정된 `switch_agent` 키바인드를 사용하여 순환할 수 있습니다. 이 에이전트는 주요 대화를 처리합니다. 도구 액세스는 권한을 통해 구성됩니다 — 예를 들어, Build는 모든 도구를 사용할 수 있지만 Plan은 제한됩니다.
:::tip
세션 중에 기본 에이전트를 전환하는 **Tab** 키를 사용할 수 있습니다.
세션 중에 **Tab** 키를 사용하여 기본 에이전트를 전환할 수 있습니다.
:::
OpenCode는 두 개의 내장 기본 에이전트, **Build** 및 **Plan**와 함께 제공됩니다. 우리는
아래에서 보기.
OpenCode는 두 가지 내장 기본 에이전트, **Build** 및 **Plan**을 제공합니다. 아래에서 자세히 살펴봅니다.
---
### Subagents
### 서브 에이전트
Subagents는 기본 에이전트가 특정 작업을 위해 호출 할 수있는 전문 보조입니다. 또한 수동으로 그들을 호출 할 수 있습니다 ** @ 언급 ** 메시지에서 그들.
서브 에이전트는 기본 에이전트가 특정 작업을 위해 호출할 수 있는 전문 보조자입니다. 또한 메시지에서 **@멘션**을 통해 수동으로 호출할 수도 있습니다.
OpenCode는 두 개의 내장 subagents, **General** 및 **Explore**. 아래에서 볼 수 있습니다.
OpenCode는 두 가지 내장 서브 에이전트, **General** 및 **Explore**를 제공합니다. 아래에서 자세히 살펴봅니다.
---
## 내장
## 기본 제공
OpenCode는 기본 에이전트와 두 개의 내장 subagents로 제공됩니다.
OpenCode는 기본 에이전트와 두 개의 내장 서브 에이전트를 제공합니다.
---
### 사용 Build
### Build
_모드_: `primary`
Build는 **default** 모든 도구가 활성화된 기본 에이전트입니다. 이것은 당신이 파일 가동 및 체계 명령에 가득 차있는 접근을 필요로 하는 발달 일을 위한 표준 에이전트입니다.
Build는 모든 도구가 활성화된 **기본** 에이전트입니다. 파일 조작 및 시스템 명령에 대한 전체 액세스가 필요한 개발 작업을 위한 표준 에이전트입니다.
---
### 사용 Plan
### Plan
_모드_: `primary`
계획 및 분석을 위해 설계된 제한된 에이전트. 우리는 더 많은 통제를 주고 무인화한 변화를 방지하기 위하여 허가 체계를 이용합니다.
기본적으로, 뒤에 오는 전부는 `ask`로 놓입니다:
계획 및 분석을 위해 설계된 제한된 에이전트입니다. 더 많은 제어권을 부여하고 의도하지 않은 변경을 방지하기 위해 권한 시스템을 사용합니다.
기본적으로 다음은 모두 `ask`로 설정됩니다:
- `file edits`: 모든 쓰기, 패치 및 편집
- `bash`: 모든 bash 명령
이 에이전트는 코드를 분석 할 LLM을 원할 때 유용합니다, 변경을 제안하거나 코드베이스에 실제 수정없이 계획을 만들 수 있습니다.
이 에이전트는 코드를 분석하거나 변경을 제안받고 싶지만, 코드베이스에 실제 수정 없이 계획만 만들고 싶을 때 유용합니다.
---
### 사용 General
### General
_모드_: `subagent`
복잡한 질문을 연구하고 다중 단계 작업을 실행하기위한 범용 에이전트. 전체 도구 액세스 (todo 제외), 그래서 필요할 때 파일 변경을 만들 수 있습니다. 평행한에 있는 일의 다수 단위를 달리기 위하여 이것을 사용하십시오.
복잡한 질문을 연구하고 다단계 작업을 실행하기 위한 범용 에이전트입니다. 전체 도구 액세스(todo 제외)를 가지므로 필요할 때 파일 변경을 수행할 수 있습니다. 여러 단위의 작업을 병렬로 실행할 때 사용하세요.
---
### 사용 Explore
### Explore
_모드_: `subagent`
Codebases를 탐구하는 빠르고, 읽기 전용 에이전트. 파일을 수정할 수 없습니다. 이 작업을 사용하면 패턴, 키워드 검색 코드, 또는 codebase에 대한 질문에 신속하게 파일을 찾을 수 있습니다.
코드베이스를 탐색하는 빠르고 읽기 전용인 에이전트입니다. 파일을 수정할 수 없습니다. 패턴, 키워드로 코드를 검색하거나 코드베이스에 대한 질문에 답하기 위해 파일을 빠르게 찾아야 할 때 사용하세요.
---
### 사용 Compaction
### Compaction
_모드_: `primary`
더 작은 요약으로 긴 맥락을 압축하는 숨겨진 시스템 에이전트. 필요한 경우 자동으로 실행되며 UI에서 선택할 수 없습니다.
긴 컨텍스트를 작은 요약으로 압축하는 숨겨진 시스템 에이전트입니다. 필요한 경우 자동으로 실행되며 UI에서 선택할 수 없습니다.
---
### 사용 Title
### Title
_모드_: `primary`
짧은 세션 타이틀을 생성하는 숨겨진 시스템 에이전트. 그것은 자동으로 실행하고 UI에서 선택할 수 없습니다.
짧은 세션 제목을 생성하는 숨겨진 시스템 에이전트입니다. 자동으로 실행되며 UI에서 선택할 수 없습니다.
---
### 사용 Summary
### Summary
_모드_: `primary`
세션 summaries를 만드는 숨겨진 시스템 에이전트. 그것은 자동으로 실행하고 UI에서 선택할 수 없습니다.
세션 요약을 만드는 숨겨진 시스템 에이전트입니다. 자동으로 실행되며 UI에서 선택할 수 없습니다.
---
## 사용법
1. 주요 에이전트을 위해, **Tab ** 열쇠를 사용하여 세션 도중 주기. 구성 된 `switch_agent` keybind도 사용할 수 있습니다.
1. 기본 에이전트의 경우, 세션 중에 **Tab** 키를 사용하여 순환합니다. 구성된 `switch_agent` 키바인드도 사용할 수 있습니다.
2. Subagents은 invoked 일 수 있습니다:
- **Automatically** 그들의 설명에 근거를 둔 특화된 업무를 위한 주요 에이전트에 의하여.
- 메시지에 대한 subagents\*\*. 예를 들어.
2. 서브 에이전트는 다음과 같이 호출할 수 있습니다:
- 설명에 근거하여 전문적인 작업을 위해 기본 에이전트에 의해 **자동으로** 호출됨.
- 메시지에서 서브 에이전트를 **@멘션**. 예를 들어:
```txt frame="none"
@general help me search for this function
```
3. ** 세션 간의 편차 **: subagents는 자신의 자녀 세션을 만들 때, 부모 세션과 모든 어린이 세션을 사용하여 탐색 할 수 있습니다.
- **\<Leader>+Right** (또는 부모 → Child1 → Child2 →를 통해 전달하기 위해 설정된 `session_child_cycle` keybind)
- **\<Leader>+Left** (또는 `session_child_cycle_reverse` keybind) 부모를 통해 돌아 가기 위해 ← child1 ← child2 ← ... ← 부모
3. **세션 간 이동**: 서브 에이전트가 자체 자식 세션을 만들 때, 부모 세션과 자식 세션 간을 탐색할 수 있습니다.
- **\<Leader>+Right** (또는 부모 → 자식1 → 자식2 순으로 이동하기 위해 설정된 `session_child_cycle` 키바인드)
- **\<Leader>+Left** (또는 `session_child_cycle_reverse` 키바인드) 부모 방향으로 되돌아가기: 자식2 → 자식1 → 부모
이로 인해 주요 대화와 특이한 subagent 작업을 원활하게 전환할 수 있습니다.
이를 통해 주요 대화와 전문적인 서브 에이전트 작업 간을 원활하게 전환할 수 있습니다.
---
## 구성
내장 에이전트를 사용자 정의하거나 구성을 통해 자신의 만들 수 있습니다. 에이전트는 두 가지 방법으로 구성 될 수 있습니다:
내장 에이전트를 사용자 정의하거나 구성을 통해 자신만의 에이전트를 만들 수 있습니다. 에이전트는 두 가지 방법으로 구성될 수 있습니다:
---
@@ -212,13 +211,13 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
## 옵션
이 구성 옵션을 자세히 살펴봅시다.
이 구성 옵션들을 자세히 살펴봅시다.
---
### 묘사
### 설명
`description` 옵션을 사용하여 에이전트가 작동하고 사용할 때의 간단한 설명을 제공합니다.
`description` 옵션을 사용하여 에이전트가 무엇을 하고 언제 사용해야 하는지에 대한 간단한 설명을 제공합니다.
```json title="opencode.json"
{
@@ -230,15 +229,15 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
}
```
\*\* config 옵션이 필요합니다.
\*\* 필수 구성 옵션입니다.
---
### 온도
`temperature` config와 LLM의 응답의 임의성과 창의성을 제어합니다.
`temperature` 구성으로 LLM 응답의 무작위성과 창의성을 제어합니다.
더 낮은 값은 더 집중하고 세심한 응답을 만듭니다. 더 높은 값은 창의력과 가변성을 증가하면서.
값이 낮을수록 더 집중되고 결정적인 응답을 생성하며, 값이 높을수록 창의성과 가변성이 증가합니다.
```json title="opencode.json"
{
@@ -253,10 +252,11 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
}
```
온도 값은 일반적으로 0.0에서 1.0에 배열합니다:
온도 값은 일반적으로 0.0에서 1.0 사이입니다:
- **0.0-0.2**: 매우 집중하고 신중한 응답, 코드 분석 및 계획에 이상 -**0.3-0.5**: 일부 창의력과 균형 잡힌 응답, 일반 개발 작업에 좋은
- **0.6-1.0**: 더 창조적이고 다양한 응답, 뇌하수 및 탐험에 유용한
- **0.0-0.2**: 매우 집중되고 신중한 응답, 코드 분석 및 계획에 이상적
- **0.3-0.5**: 창의성과 정확성의 균형, 일반 개발 작업에 좋음
- **0.6-1.0**: 더 창의적이고 다양한 응답, 브레인스토밍 및 탐색에 유용함
```json title="opencode.json"
{
@@ -276,15 +276,15 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
}
```
온도가 지정되지 않은 경우, opencode는 모델 별 기본을 사용합니다. 일반적으로 대부분의 모델의 경우 0, Qwen 모델의 경우 0.55.
온도가 지정되지 않은 경우, OpenCode는 모델별 기본값을 사용합니다. 일반적으로 대부분의 모델은 0, Qwen 모델의 경우 0.55입니다.
---
## 최대 단계
에이전트의 최대 수를 통제하는 에이전트은 원본과 반응하기 전에 실행할 수 있습니다. 이 사용자는 에이전트 행동에 제한을 설정하는 비용을 제어 할 수 있습니다.
에이전트가 중지하고 사용자와 다시 상호 작용하기 전에 실행할 수 있는 최대 단계 수를 제어합니다. 이를 통해 에이전트의 행동과 비용을 제어할 수 있습니다.
이 설정되지 않은 경우, 에이전트는 모델이 중지하거나 사용자가 세션을 중단하도록 선택할 때까지 계속됩니다.
설정되지 않은 경우, 에이전트는 모델이 중지하거나 사용자가 세션을 중단할 때까지 계속됩니다.
```json title="opencode.json"
{
@@ -298,17 +298,17 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
}
```
제한이 도달되면, 에이전트는 특별한 시스템을 신속하게 작업의 요약과 권장되는 나머지 작업에 응답하도록 지시합니다.
제한에 도달하면, 에이전트는 작업 요약과 권장되는 남은 작업을 신속하게 응답하도록 지시받습니다.
:::caution
레거시 `maxSteps` 필드는 deprecated. 대신 `steps`를 사용하십시오.
레거시 `maxSteps` 필드는 더 이상 사용되지 않습니다. 대신 `steps`를 사용하십시오.
:::
---
#### 비활성화
`true`로 에이전트를 비활성화합니다.
`true`로 설정하여 에이전트를 비활성화합니다.
```json title="opencode.json"
{
@@ -324,7 +324,7 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
#### 프롬프트
`prompt` config를 가진 이 에이전트을 위한 주문 체계 prompt 파일을 지정하십시오. prompt 파일은 에이전트의 목적에 따라 지시를 포함해야합니다.
`prompt` 구성으로 이 에이전트를 위한 사용자 정의 시스템 프롬프트 파일을 지정하십시오. 프롬프트 파일은 에이전트의 목적에 따른 지시를 포함해야 합니다.
```json title="opencode.json"
{
@@ -336,16 +336,16 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
}
```
이 경로는 config 파일이 있는 곳에 관계됩니다. 그래서 이것은 글로벌 opencode 구성과 프로젝트 특정 구성 모두를 위해 작동합니다.
이 경로는 구성 파일이 있는 위치를 기준으로 합니다. 따라서 글로벌 OpenCode 구성과 프로젝트별 구성 모두에서 작동합니다.
---
### 모형
### 모델
`model` config를 사용하여이 에이전트에 대한 모델을 삭제합니다. 다른 작업에 최적화 된 다른 모델을 사용하는 데 유용합니다. 예를 들어, 계획을위한 빠른 모델, 구현을위한 더 많은 모델.
`model` 구성을 사용하여 이 에이전트에 대한 모델을 재정의합니다. 다른 작업에 최적화된 다른 모델을 사용하는 데 유용합니다. 예를 들어, 계획을 위한 빠른 모델, 구현을 위한 더 강력한 모델 등입니다.
:::tip
모델을 지정하지 않는 경우, 기본 에이전트는 [model globallyconfig](/docs/config#models)를 사용하며, subagents는 subagent를 호출하는 1차 에이전트의 모델을 사용합니다.
모델을 지정하지 않는 경우, 기본 에이전트는 [전역 구성 모델](/docs/config#models)을 사용하며, 서브 에이전트는 자신을 호출한 기본 에이전트의 모델을 사용합니다.
:::
```json title="opencode.json"
@@ -358,13 +358,13 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
}
```
opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다. 예를 들어, [OpenCode Zen](/docs/zen)을 사용한다면, GPT 5.1 Codex에 `opencode/gpt-5.1-codex`를 사용할 수 있습니다.
OpenCode 구성의 모델 ID는 `provider/model-id` 형식을 사용합니다. 예를 들어, [OpenCode Zen](/docs/zen)을 사용한다면, GPT 5.1 Codex에 `opencode/gpt-5.1-codex`를 사용할 수 있습니다.
---
## 도구
`tools` config로 이 에이전트에서 사용할 수있는 제어. `true` 또는 `false`로 설정하여 특정 도구를 활성화하거나 비활성화 할 수 있습니다.
`tools` 구성으로 이 에이전트가 사용할 수 있는 도구를 제어합니다. `true` 또는 `false`로 설정하여 특정 도구를 활성화하거나 비활성화할 수 있습니다.
```json title="opencode.json" {3-6,9-12}
{
@@ -385,10 +385,10 @@ opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다.
```
:::note
에이전트 별 구성 overrides 글로벌 구성.
에이전트별 구성은 글로벌 구성을 덮어씁니다.
:::
한 번에 여러 도구를 제어 할 와일드 카드를 사용할 수 있습니다. 예를 들어, MCP 서버에서 모든 도구를 비활성화하려면:
한 번에 여러 도구를 제어하기 위해 와일드카드를 사용할 수 있습니다. 예를 들어, MCP 서버에서 모든 도구를 비활성화하려면:
```json title="opencode.json"
{
@@ -405,16 +405,16 @@ opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다.
}
```
[공구에 대해 더 알아보기](/docs/tools).
[도구에 대해 더 알아보기](/docs/tools).
---
## # 권한
## 권한
에이전트가 수행 할 수있는 작업을 관리 할 수있는 권한을 구성 할 수 있습니다. 현재 `edit`, `bash` 및 `webfetch` 도구에 대한 권한은 다음과 같습니다.
에이전트가 수행할 수 있는 작업을 관리할 수 있는 권한을 구성할 수 있습니다. 현재 `edit`, `bash` 및 `webfetch` 도구에 대한 권한은 다음과 같습니다.
- `"ask"` - 도구 실행하기 전에 승인을위한 Prompt
- `"allow"` - 승인없이 모든 작업을 허용
- `"ask"` - 도구를 실행하기 전에 승인 요청
- `"allow"` - 승인 없이 모든 작업 허용
- `"deny"` - 도구 비활성화
```json title="opencode.json"
@@ -426,7 +426,7 @@ opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다.
}
```
당신은 에이전트 당이 허가를 override 할 수 있습니다.
에이전트별로 이 권한을 재정의(override)할 수 있습니다.
```json title="opencode.json" {3-5,8-10}
{
@@ -444,7 +444,7 @@ opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다.
}
```
Markdown 에이전트에서 권한을 설정할 수 있습니다.
Markdown 에이전트에서도 권한을 설정할 수 있습니다.
```markdown title="~/.config/opencode/agents/review.md"
---
@@ -481,7 +481,7 @@ Only analyze code and suggest changes.
}
```
이것은 glob 본을 가지고 갈 수 있습니다.
이것은 glob 패턴을 사용할 수 있습니다.
```json title="opencode.json" {7}
{
@@ -498,8 +498,8 @@ Only analyze code and suggest changes.
}
```
또한 `*` 와일드 카드를 사용하여 모든 명령에 대한 권한을 관리 할 수 있습니다.
마지막 일치 규칙이 우선적으로 걸리기 때문에, `*` 와일드카드를 첫번째로 두고 특정 규칙을 후에 두십시오.
또한 `*` 와일드카드를 사용하여 모든 명령에 대한 권한을 관리할 수 있습니다.
마지막 일치 규칙이 우선하므로, `*` 와일드카드를 먼저 두고 특정 규칙을 나중에 두십시오.
```json title="opencode.json" {8}
{
@@ -517,13 +517,13 @@ Only analyze code and suggest changes.
}
```
[허가에 대해 더 알아보기](/docs/permissions).
[권한에 대해 더 알아보기](/docs/permissions).
---
### 형태
### 모드
`mode` config로 에이전트 모드를 제어합니다. `mode` 선택권은 에이전트이 사용될 수 있는 방법을 결정하기 위하여 이용됩니다.
`mode` 구성으로 에이전트 모드를 제어합니다. `mode` 옵션은 에이전트가 어떻게 사용될 수 있는지 결정하는 데 사용됩니다.
```json title="opencode.json"
{
@@ -535,13 +535,13 @@ Only analyze code and suggest changes.
}
```
`mode` 선택권은 `primary`, `subagent`, 또는 `all`에 놓일 수 있습니다. `mode`가 지정되지 않은 경우 `all`로 기본값입니다.
`mode` 옵션은 `primary`, `subagent`, 또는 `all`로 설정할 수 있습니다. `mode`가 지정되지 않은 경우 `all`이 기본값입니다.
---
## #숨겨진
## 숨김
`@`를 사용해 `hidden: true` 자동 완성 메뉴에서 시약을 숨깁니다. 작업 도구를 통해 다른 에이전트에 의해 invoked programmatically 있어야하는 내부 시약에 유용합니다.
`hidden: true`를 사용하여 `@` 자동 완성 메뉴에서 에이전트를 숨깁니다. 작업 도구를 통해 다른 에이전트에 의해 프로그래밍 방식으로 호출되어야 하는 내부 에이전트에 유용합니다.
```json title="opencode.json"
{
@@ -554,17 +554,17 @@ Only analyze code and suggest changes.
}
```
자동 완성 메뉴의 사용자 가시에만 영향을 미칩니다. 숨겨진 에이전트는 여전히 작업 도구를 통해 모델에 의해 호출 될 수 있습니다 권한 허용.
자동 완성 메뉴의 사용자 가시성에만 영향을 미칩니다. 숨겨진 에이전트는 권한이 허용된다면 여전히 작업 도구를 통해 모델에 의해 호출될 수 있습니다.
:::note
`mode: subagent` 에이전트에서만 적용합니다.
`mode: subagent` 에이전트에만 적용됩니다.
:::
---
## 작업 권한
에이전트가 `permission.task`와 작업 도구를 통해 호출 할 수있는 제어. 유연한 일치를 위한 glob 본을 사용합니다.
`permission.task`와 작업 도구를 통해 에이전트가 호출할 수 있는 서브 에이전트를 제어합니다. 유연한 일치를 위한 glob 패턴을 사용합니다.
```json title="opencode.json"
{
@@ -583,23 +583,23 @@ Only analyze code and suggest changes.
}
```
`deny`로 설정할 때, Subagent는 작업 도구 설명에서 완전히 제거됩니다. 그래서 모델은 그것을 호출하려고하지 않습니다.
`deny`로 설정할 때, 서브 에이전트는 작업 도구 설명에서 완전히 제거됩니다. 따라서 모델은 그것을 호출하려고 시도하지 않습니다.
:::tip
규칙은 순서로 평가되고, **마지막 일치 규칙은**를 이깁니다. 위의 예에서 `orchestrator-planner`는 `*` (deny)와 `orchestrator-*` (allow) 모두 일치하지만 `orchestrator-*`가 `*` 후 제공되므로 결과는 `allow`입니다.
규칙은 순서대로 평가되며, **마지막 일치 규칙**이 우선합니다. 위의 예에서 `orchestrator-planner`는 `*` (deny)와 `orchestrator-*` (allow) 모두 일치하지만 `orchestrator-*`가 `*` 뒤에 오므로 결과는 `allow`입니다.
:::
:::tip
사용자는 `@` 자동 완성 메뉴를 통해 직접 어떤 subagent를 호출 할 수 있습니다. 에이전트의 작업 허가가 거부 할 경우에도.
사용자는 에이전트의 작업 권한이 거부되더라도 `@` 자동 완성 메뉴를 통해 직접 어떤 서브 에이전트든 호출할 수 있습니다.
:::
---
### 색깔
### 색상
`color` 옵션과 UI에서 에이전트의 시각적 외관을 사용자 정의합니다. 이것은 어떻게 에이전트가 인터페이스에 나타납니다.
`color` 옵션으로 UI에서 에이전트의 시각적 모양을 사용자 정의합니다.
유효한 hex 색깔을 사용하십시오 (예를들면, `#FF5733`) 또는 주제 색깔: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`.
유효한 hex 색상(예: `#FF5733`) 또는 테마 색상을 사용하십시오: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`.
```json title="opencode.json"
{
@@ -616,9 +616,9 @@ Only analyze code and suggest changes.
---
### 정상 P
### Top P
`top_p` 선택권을 가진 응답 다양성을 통제하십시오. 무작위 통제를 위한 온도에 대안.
`top_p` 옵션으로 응답의 다양성을 제어합니다. 무작위성 제어를 위한 온도의 대안입니다.
```json title="opencode.json"
{
@@ -630,15 +630,15 @@ Only analyze code and suggest changes.
}
```
가치는 0.0에서 1.0에 배열합니다. 더 낮은 가치는 더 집중되고, 더 높은 가치는 더 다양합니다.
값은 0.0에서 1.0 사이입니다. 낮은 값은 더 집중되고, 높은 값은 더 다양합니다.
---
### 추가
### 추가 옵션
에이전트 구성에 지정하는 다른 옵션은 ** 직접 통과 ** 모델 옵션으로 공급자. 이 공급자 별 기능 및 매개 변수를 사용할 수 있습니다.
에이전트 구성에 지정하는 다른 옵션은 모델 옵션으로 공급자에게 **직접 전달**됩니다. 이를 통해 공급자별 기능 및 매개변수를 사용할 수 있습니다.
예를 들어, OpenAI의 이유 모델과 함께, 당신은 이유를 제어 할 수 있습니다 노력:
예를 들어, OpenAI의 추론 모델과 함께, 추론 노력을 제어할 수 있습니다:
```json title="opencode.json" {6,7}
{
@@ -653,7 +653,7 @@ Only analyze code and suggest changes.
}
```
이 추가 옵션은 모델과 공급자 별입니다. 공급자의 문서 확인 가능 매개 변수.
이 추가 옵션은 모델과 공급자별로 다릅니다. 사용 가능한 매개변수는 공급자의 문서를 확인하십시오.
:::tip
`opencode models`를 실행하여 사용 가능한 모델 목록을 볼 수 있습니다.
@@ -669,25 +669,25 @@ Only analyze code and suggest changes.
opencode agent create
```
이 대화 형 명령은:
이 대화형 명령은:
1. 에이전트을 저장하는 곳에게; 세계적인 프로젝트 별.
2. 에이전트이 해야 하는 무슨의 묘사.
3. 적절한 시스템 프롬프트 및 식별자를 생성한다.
4. 당신은 에이전트이 접근할 수 있는 어떤 공구를 선정하자.
5. 마지막으로, 에이전트 구성을 가진 markdown 파일을 창조하십시오.
1. 에이전트를 저장할 위치를 묻습니다 (전역 또는 프로젝트별).
2. 에이전트가 해야 할 일에 대한 설명을 묻습니다.
3. 적절한 시스템 프롬프트 및 식별자를 생성합니다.
4. 에이전트가 접근할 수 있는 도구를 선택하게 합니다.
5. 마지막으로, 에이전트 구성을 가진 markdown 파일을 생성합니다.
---
## 사용 사례
다른 에이전트을 위한 몇몇 일반적인 사용 사례는 여기 있습니다.
다른 에이전트를 위한 몇 가지 일반적인 사용 사례는 다음과 같습니다.
- **빌딩 에이전트**: 모든 도구와 함께 전체 개발 작업
- ** 플랜 에이전트**: 변화없이 분석 및 계획
- **리뷰 에이전트**: Code review with read-only access plus 문서 도구
- ** 디버그 에이전트**: bash 및 읽기 도구와 함께 조사에 집중
- **Docs 에이전트 **: 파일 작업과 문서 작성하지만 시스템 명령 없음
- **Build Agent**: 모든 도구와 함께 전체 개발 작업
- **Plan Agent**: 변경 없이 분석 및 계획
- **Review Agent**: 읽기 전용 액세스 및 문서 도구와 함께 코드 리뷰
- **Debug Agent**: bash 및 읽기 도구와 함께 조사에 집중
- **Docs Agent**: 파일 작업과 문서 작성을 하지만 시스템 명령 없음
---
@@ -696,7 +696,7 @@ opencode agent create
여기에 유용 할 수있는 몇 가지 예 에이전트가 있습니다.
:::tip
당신은 공유하고 싶은 에이전트이 있습니까? [PR](https://github.com/anomalyco/opencode).
공유하고 싶은 에이전트가 있습니까? [PR](https://github.com/anomalyco/opencode).
:::
---

32
packages/web/src/content/docs/ko/cli.mdx
View File

@@ -27,7 +27,7 @@ OpenCode 터미널 사용자 인터페이스를 시작합니다.
opencode [project]
```
#### Flags
#### 플래그
| 플래그 | 축약 | 설명 |
| ------------ | ---- | ---------------------------------------------------------------------- |
@@ -42,7 +42,7 @@ opencode [project]
---
## Commands
## 명령어
opencode CLI는 아래 명령들도 제공합니다.
@@ -76,7 +76,7 @@ opencode web --port 4096 --hostname 0.0.0.0
opencode attach http://10.20.30.40:4096
```
#### Flags
#### 플래그
| 플래그 | 축약 | 설명 |
| ----------- | ---- | -------------------------- |
@@ -185,7 +185,7 @@ GitHub 에이전트를 실행합니다. 보통 GitHub Actions에서 사용합니
opencode github run
```
##### Flags
##### 플래그
| 플래그 | 설명 |
| --------- | ------------------------- |
@@ -294,7 +294,7 @@ opencode models [provider]
opencode models anthropic
```
#### Flags
#### 플래그
| 플래그 | 설명 |
| ----------- | ------------------------------------------------- |
@@ -333,7 +333,7 @@ opencode serve
opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"
```
#### Flags
#### 플래그
| 플래그 | 축약 | 설명 |
| ------------ | ---- | ---------------------------------------------------------------------- |
@@ -362,7 +362,7 @@ opencode serve
이 명령은 TUI 없이 opencode 기능에 접근할 수 있는 HTTP 서버를 시작합니다. `OPENCODE_SERVER_PASSWORD`를 설정하면 HTTP basic auth가 활성화됩니다(기본 사용자명: `opencode`).
#### Flags
#### 플래그
| 플래그 | 설명 |
| ------------ | --------------------------------- |
@@ -391,7 +391,7 @@ OpenCode 세션 목록을 표시합니다.
opencode session list
```
##### Flags
##### 플래그
| 플래그 | 축약 | 설명 |
| ------------- | ---- | -------------------------------------- |
@@ -408,7 +408,7 @@ OpenCode 세션의 토큰 사용량과 비용 통계를 표시합니다.
opencode stats
```
#### Flags
#### 플래그
| 플래그 | 설명 |
| ----------- | ------------------------------------------------------------ |
@@ -458,7 +458,7 @@ opencode web
이 명령은 HTTP 서버를 시작하고 웹 브라우저를 열어 웹 인터페이스로 OpenCode에 접속합니다. `OPENCODE_SERVER_PASSWORD`를 설정하면 HTTP basic auth가 활성화됩니다(기본 사용자명: `opencode`).
#### Flags
#### 플래그
| 플래그 | 설명 |
| ------------ | --------------------------------- |
@@ -479,7 +479,7 @@ opencode acp
이 명령은 nd-JSON 형식으로 stdin/stdout을 통해 통신하는 ACP 서버를 시작합니다.
#### Flags
#### 플래그
| 플래그 | 설명 |
| ------------ | ------------- |
@@ -497,7 +497,7 @@ OpenCode를 제거하고 관련 파일을 삭제합니다.
opencode uninstall
```
#### Flags
#### 플래그
| 플래그 | 축약 | 설명 |
| --------------- | ---- | ------------------------------- |
@@ -528,7 +528,7 @@ opencode upgrade
opencode upgrade v0.1.48
```
#### Flags
#### 플래그
| 플래그 | 축약 | 설명 |
| ---------- | ---- | ------------------------------------------ |
@@ -536,7 +536,7 @@ opencode upgrade v0.1.48
---
## Global Flags
## 전역 플래그
opencode CLI는 아래 전역 플래그를 지원합니다.
@@ -549,7 +549,7 @@ opencode CLI는 아래 전역 플래그를 지원합니다.
---
## Environment variables
## 환경 변수
OpenCode는 환경 변수로도 구성할 수 있습니다.
@@ -582,7 +582,7 @@ OpenCode는 환경 변수로도 구성할 수 있습니다.
---
### Experimental
### 실험적 기능
아래 환경 변수는 변경되거나 제거될 수 있는 실험 기능을 활성화합니다.

18
packages/web/src/content/docs/ko/commands.mdx
View File

@@ -1,6 +1,6 @@
---
title: Commands
description: Create custom commands for repetitive tasks.
title: 명령어
description: 반복적인 작업을 위한 커스텀 명령을 만드세요.
---
커스텀 명령을 사용하면 TUI에서 해당 명령이 실행될 때 사용할 프롬프트를 미리 정의할 수 있습니다.
@@ -109,7 +109,7 @@ Markdown 파일명이 명령 이름이 됩니다. 예를 들어 `test.md`라면
---
### 인수(Arguments)
### 인수
`$ARGUMENTS` 플레이스홀더로 명령 인수를 전달할 수 있습니다.
@@ -219,7 +219,7 @@ Check for performance issues and suggest improvements.
---
### Template
### 템플릿
`template` 옵션은 명령 실행 시 LLM에 전달할 프롬프트를 정의합니다.
@@ -237,7 +237,7 @@ Check for performance issues and suggest improvements.
---
### Description
### 설명
`description` 옵션으로 명령의 짧은 설명을 추가할 수 있습니다.
@@ -255,7 +255,7 @@ Check for performance issues and suggest improvements.
---
### Agent
### 에이전트
`agent` 설정으로 이 명령을 실행할 [agent](/docs/agents)를 지정할 수 있습니다.
지정한 값이 [subagent](/docs/agents/#subagents)면 기본적으로 subagent 호출이 실행됩니다.
@@ -275,7 +275,7 @@ Check for performance issues and suggest improvements.
---
### Subtask
### 서브태스크
`subtask` 불리언(boolean)을 사용하면 명령이 [subagent](/docs/agents/#subagents) 호출을 강제로 트리거합니다.
주 컨텍스트를 오염시키고 싶지 않을 때 유용하며, [agent](/docs/agents) 설정의 `mode`가 `primary`여도 subagent로 실행합니다.
@@ -294,7 +294,7 @@ Check for performance issues and suggest improvements.
---
### Model
### 모델
`model` 설정으로 이 명령의 기본 모델을 오버라이드할 수 있습니다.
@@ -312,7 +312,7 @@ Check for performance issues and suggest improvements.
---
## Built-in
## 내장 명령
OpenCode는 `/init`, `/undo`, `/redo`, `/share`, `/help` 등 여러 내장 명령을 제공합니다. [더 알아보기](/docs/tui#commands).

258
packages/web/src/content/docs/ko/config.mdx
View File

@@ -1,15 +1,15 @@
---
title: Config
description: Using the opencode JSON config.
title: 구성
description: OpenCode JSON 구성을 사용합니다.
---
JSON config 파일을 사용하여 opencode를 구성할 수 있습니다.
JSON 구성 파일을 사용하여 OpenCode를 구성할 수 있습니다.
---
## 형식
opencode는 **JSON** 및 **JSONC** (JSON with Comments) 형식을 지원합니다.
OpenCode는 **JSON** 및 **JSONC** (주석이 있는 JSON) 형식을 지원합니다.
```jsonc title="opencode.jsonc"
{
@@ -25,44 +25,44 @@ opencode는 **JSON** 및 **JSONC** (JSON with Comments) 형식을 지원합니
## 위치
다른 위치의 몇 개에 구성을 배치 할 수 있으며 그들은
precedence의 다른 순서.
구성을 여러 위치에 배치할 수 있으며, 이들은 서로 다른 우선 순위(precedence)를 가집니다.
:::note
구성 파일은 \*\* 함께, 대체되지 않습니다.
구성 파일은 **병합**되며, 대체되지 않습니다.
:::
구성 파일은 함께 결합되어 대체되지 않습니다. 다음 구성 위치에서 설정이 결합됩니다. 나중에 configs override 이전 하나만 충돌 키. 모든 구성에서 설정이 보존됩니다.
구성 파일은 함께 병합되며 대체되지 않습니다. 다음 구성 위치의 설정이 결합됩니다. 나중의 구성은 충돌하는 키에 대해 이전 구성을 덮어씁니다. 모든 구성의 설정이 보존됩니다.
예를 들어, 글로벌 구성 세트 `theme: "opencode"` 및 `autoupdate: true` 및 프로젝트 구성 세트 `model: "anthropic/claude-sonnet-4-5"`를 설정하면 최종 구성은 모든 세 가지 설정을 포함합니다.
예를 들어, 전역 구성이 `theme: "opencode"` 및 `autoupdate: true`를 설정하고 프로젝트 구성이 `model: "anthropic/claude-sonnet-4-5"`를 설정하면 최종 구성에는 세 가지 설정이 모두 포함됩니다.
---
### 임신 순서
### 우선 순위
Config 소스는 이 순서에서 적재됩니다 (더 많은 소스는 더 이른 것 삭제합니다):
구성 소스는 다음 순서로 로드됩니다 (나중 소스가 이전 소스를 덮어씀):
1. ** 원격 설정** (`.well-known/opencode`에서) - 조직 기본 2.**Global config** (`~/.config/opencode/opencode.json`) - 사용자 선호도
2. ** 사용자 정의 설정** (`OPENCODE_CONFIG` env var) - 사용자 정의 overrides
3. ** 프로젝트 별 설정** (`opencode.json`) - 프로젝트 별 설정
4. **`.opencode` 디렉토리 ** - 에이전트, 명령, 플러그인
5. ** 인라인 설정** (`OPENCODE_CONFIG_CONTENT` env var) - 런타임 오버라이드
1. **원격 구성** (`.well-known/opencode`에서) - 조직 기본값
2. **전역 구성** (`~/.config/opencode/opencode.json`) - 사용자 환경설정
3. **사용자 정의 구성** (`OPENCODE_CONFIG` 환경 변수) - 사용자 정의 재정의
4. **프로젝트별 구성** (`opencode.json`) - 프로젝트별 설정
5. **`.opencode` 디렉토리** - 에이전트, 명령, 플러그인
6. **인라인 구성** (`OPENCODE_CONFIG_CONTENT` 환경 변수) - 런타임 재정의
이것은 프로젝트 구성은 글로벌 디폴트를 override 할 수 있으며, 글로벌 구성은 원격 조직 디폴트를 override 할 수 있습니다.
이것은 프로젝트 구성이 전역 기본값을 덮어쓸 수 있고, 전역 구성이 원격 조직 기본값을 덮어쓸 수 있음을 의미합니다.
:::note
`.opencode`와 `~/.config/opencode` 감독 사용 **plural 이름** 하위 디렉토리에 대 한: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/`, 그리고 `themes/`. Singular 이름 (예를들면, `agent/`)는 또한 뒤쪽 겸용성을 위해 지원됩니다.
`.opencode`와 `~/.config/opencode` 디렉토리는 하위 디렉토리에 대해 **복수형 이름**을 사용합니다: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/`, 그리고 `themes/`. 단수형 이름(예: `agent/`)도 하위 호환성을 위해 지원됩니다.
:::
---
### 리모트
### 원격
조직은 `.well-known/opencode` 엔드포인트를 통해 기본 구성을 제공 할 수 있습니다. 이것은 당신이 그것을 지원하는 공급자로 정통할 때 자동적으로 fetched.
조직은 `.well-known/opencode` 엔드포인트를 통해 기본 구성을 제공할 수 있습니다. 이를 지원하는 공급자로 인증할 때 자동으로 가져옵니다.
원격 설정은 기본 레이어로 제공된 첫 번째입니다. 다른 구성 소스 (글로벌, 프로젝트)는 이러한 기본값을 무시할 수 있습니다.
원격 구성은 기본 레이어로 가장 먼저 로드됩니다. 다른 구성 소스(전역, 프로젝트)는 이러한 기본값을 무시(override)할 수 있습니다.
예를 들어, 조직이 기본으로 비활성화 된 MCP 서버를 제공한다면:
예를 들어, 조직이 기본적으로 비활성화된 MCP 서버를 제공하는 경우:
```json title="Remote config from .well-known/opencode"
{
@@ -76,7 +76,7 @@ Config 소스는 이 순서에서 적재됩니다 (더 많은 소스는 더 이
}
```
로컬 설정에서 특정 서버를 사용할 수 있습니다:
로컬 설정에서 특정 서버를 활성화할 수 있습니다:
```json title="opencode.json"
{
@@ -92,68 +92,65 @@ Config 소스는 이 순서에서 적재됩니다 (더 많은 소스는 더 이
---
## 글로벌
## 전역
`~/.config/opencode/opencode.json`에서 글로벌 opencode 구성을 배치합니다. 테마, 공급자, keybinds와 같은 사용자 전체 선호도에 대한 글로벌 구성을 사용합니다.
`~/.config/opencode/opencode.json`에 전역 OpenCode 구성을 배치합니다. 테마, 공급자, 키바인드와 같은 사용자 전체 기본 설정에 전역 구성을 사용하십시오.
글로벌 구성 overrides 원격 조직 기본.
전역 구성은 원격 조직 기본값을 덮어씁니다.
---
## 프로젝트 당
## 프로젝트별
프로젝트 루트에 `opencode.json`를 추가합니다. Project config는 표준 구성 파일 중 가장 높은 우선순위가 있습니다. 이는 글로벌 및 원격 구성 모두 overrides합니다.
프로젝트 루트에 `opencode.json`을 추가합니다. 프로젝트 구성은 표준 구성 파일 중 가장 높은 우선순위를 가집니다. 이는 전역 및 원격 구성을 모두 덮어씁니다.
:::tip
프로젝트의 루트에 특정 설정.
프로젝트의 루트에 특정 설정을 둡니다.
:::
opencode가 시작될 때, 현재 디렉토리의 설정 파일이나 가장 가까운 Git 디렉토리로 이동합니다.
OpenCode가 시작될 때, 현재 디렉토리의 설정 파일이나 가장 가까운 Git 디렉토리를 찾습니다.
이것은 Git로 검사되고 글로벌 하나로 동일한 schema를 사용합니다.
이것은 Git으로 관리되며 전역 구성과 동일한 스키마를 사용합니다.
---
### 사용자 정의 경로
`OPENCODE_CONFIG` 환경 변수를 사용하여 사용자 정의 구성 파일 경로 지정.
`OPENCODE_CONFIG` 환경 변수를 사용하여 사용자 정의 구성 파일 경로를 지정합니다.
```bash
export OPENCODE_CONFIG=/path/to/my/custom-config.json
opencode run "Hello world"
```
Custom config는 precedence 순서에 있는 세계적인 프로젝트 구성 사이에서 적재됩니다.
사용자 정의 구성은 우선 순위에서 전역 구성과 프로젝트 구성 사이에 로드됩니다.
---
## 사용자 정의 디렉토리
`OPENCODE_CONFIG_DIR`를 사용하여 사용자 정의 구성 디렉토리 지정
환경 변수. 이 디렉토리는 에이전트, 명령을 검색합니다,
모드 및 플러그인은 표준 `.opencode` 디렉토리와 같은, 그리고 해야
동일한 구조를 따르십시오.
`OPENCODE_CONFIG_DIR` 환경 변수를 사용하여 사용자 정의 구성 디렉토리를 지정할 수 있습니다. 이 디렉토리는 표준 `.opencode` 디렉토리와 마찬가지로 에이전트, 명령, 모드 및 플러그인을 검색하며 동일한 구조를 따라야 합니다.
```bash
export OPENCODE_CONFIG_DIR=/path/to/my/config-directory
opencode run "Hello world"
```
사용자 정의 디렉토리는 글로벌 구성 및 `.opencode` 디렉토리 후로드됩니다. \*\* 설정할 수 있습니다.
사용자 정의 디렉토리는 전역 구성 이후 및 `.opencode` 디렉토리 이전에 로드됩니다.
---
## 여성
## 스키마
구성 파일에는 [**`opencode.ai/config.json`**](https://opencode.ai/config.json)에서 정의된 스키마가 있습니다.
구성 파일에는 [**`opencode.ai/config.json`**](https://opencode.ai/config.json)에 정의된 스키마가 있습니다.
당신의 편집자는 schema에 근거를 둔 검증하고 자동 완성될 수 있어야 합니다.
편집기는 스키마에 따라 유효성 검사 및 자동 완성을 제공해야 합니다.
---
#### TUI
`tui` 옵션을 통해 TUI-specific 설정을 구성할 수 있습니다.
`tui` 옵션을 통해 TUI 관련 설정을 구성할 수 있습니다.
```json title="opencode.json"
{
@@ -168,13 +165,13 @@ opencode run "Hello world"
}
```
유효한 선택권:
유효한 옵션:
- `scroll_acceleration.enabled` - macOS 스타일 스크롤 가속을 가능하게합니다. ** `scroll_speed`에 대한 준비. **
- `scroll_speed` - 사용자 정의 스크롤 속도 승수 (기본: `3`, 최소: `1`). `scroll_acceleration.enabled`가 `true`인 경우에 Ignored.
- `diff_style` - 제어 디프 렌더링. `"auto"`는 terminal 폭에, `"stacked"` 항상 단 하나 란을 보여줍니다 적응시킵니다.
- `scroll_acceleration.enabled` - macOS 스타일 스크롤 가속을 활성화합니다. **`scroll_speed`보다 우선합니다.**
- `scroll_speed` - 사용자 정의 스크롤 속도 배수 (기본값: `3`, 최소값: `1`). `scroll_acceleration.enabled`가 `true`이면 무시됩니다.
- `diff_style` - diff 렌더링을 제어합니다. `"auto"`는 터미널 너비에 맞추고, `"stacked"`는 항상 단일 열을 보여줍니다.
[TUI를 사용하여 더 자세히 알아보기](/docs/tui).
[TUI 사용법에 대해 더 알아보기](/docs/tui).
---
@@ -195,21 +192,21 @@ opencode run "Hello world"
}
```
유효한 선택권:
유효한 옵션:
- `port` - 듣는 항구.
- `hostname` - 듣는 호스트 이름. `mdns`가 활성화되고 hostname이 설정되지 않으면 `0.0.0.0`로 기본값이 됩니다.
- `mdns` - 사용 가능한 mDNS 서비스 발견. 이 네트워크에서 다른 장치가 opencode 서버를 발견 할 수 있습니다.
- `mdnsDomain` - mDNS 서비스에 대한 사용자 정의 도메인 이름. 기본 `opencode.local`. 동일한 네트워크에서 여러 인스턴스를 실행하는 데 유용합니다.
- `cors` - 브라우저 기반 클라이언트에서 HTTP 서버를 사용할 때 CORS를 허용하는 추가 기원. 가치는 가득 차있는 근원이어야 합니다 (scheme + 주인 + 선택적인 항구), 예를들면 `https://app.example.com`.
- `port` - 리스닝 포트.
- `hostname` - 리스닝 호스트 이름. `mdns`가 활성화되고 hostname이 설정되지 않으면 `0.0.0.0`이 기본값이 됩니다.
- `mdns` - mDNS 서비스 발견 활성화. 로컬 네트워크의 다른 장치가 OpenCode 서버를 찾을 수 있습니다.
- `mdnsDomain` - mDNS 서비스를 위한 사용자 정의 도메인 이름. 기본값은 `opencode.local`입니다. 동일한 네트워크에서 여러 인스턴스를 실행할 때 유용합니다.
- `cors` - 브라우저 기반 클라이언트에서 HTTP 서버를 사용할 때 CORS를 허용할 추가 출처(Origin). 값은 전체 출처(스킴 + 호스트 + 선택적 포트)여야 합니다. 예: `https://app.example.com`.
[서버에 대해 자세히 알아보기](/docs/server).
[서버에 대해 더 알아보기](/docs/server).
---
## 도구
LLM은 `tools` 옵션을 통해 사용할 수 있습니다.
`tools` 옵션을 통해 LLM이 사용할 수 있는 도구를 구성할 수 있습니다.
```json title="opencode.json"
{
@@ -221,13 +218,13 @@ LLM은 `tools` 옵션을 통해 사용할 수 있습니다.
}
```
[이 도구에 대해 자세히 알아보기](/docs/tools).
[도구에 대해 더 알아보기](/docs/tools).
---
## 모델
`provider`, `model` 및 `small_model` 옵션을 통해 opencode config에서 사용하려는 공급자와 모델을 구성할 수 있습니다.
`provider`, `model`, `small_model` 옵션을 통해 OpenCode 구성에서 사용할 공급자와 모델을 구성할 수 있습니다.
```json title="opencode.json"
{
@@ -238,9 +235,9 @@ LLM은 `tools` 옵션을 통해 사용할 수 있습니다.
}
```
`small_model` 옵션은 제목 생성과 같은 경량 작업을 위한 별도의 모델을 구성합니다. 기본적으로, opencode는 당신의 공급자에게서 1개가 유효하다면 더 싼 모형을 이용하는 것을 시도합니다, 그렇지 않으면 당신의 주요 모형에 돌려보냅니다.
`small_model` 옵션은 제목 생성과 같은 가벼운 작업을 위한 별도의 모델을 구성합니다. 기본적으로, OpenCode는 공급자에게서 사용 가능한 더 저렴한 모델이 있다면 그것을 사용하고, 그렇지 않으면 주 모델로 돌아갑니다.
공급자 선택권은 `timeout`와 `setCacheKey`를 포함할 수 있습니다:
공급자 옵션은 `timeout`과 `setCacheKey`를 포함할 수 있습니다:
```json title="opencode.json"
{
@@ -256,20 +253,20 @@ LLM은 `tools` 옵션을 통해 사용할 수 있습니다.
}
```
- `timeout` - 밀리 초 (기본: 300000)에서 타임 아웃 요청. `false`로 분리할 수 있습니다.
- `setCacheKey` - 캐시 키가 항상 지정된 공급자를 위해 설정됩니다.
- `timeout` - 요청 타임아웃(밀리초) (기본값: 300000). `false`로 설정하여 비활성화할 수 있습니다.
- `setCacheKey` - 지정된 공급자에 대해 캐시 키가 항상 설정되도록 강제합니다.
[local model](/docs/models#local)을 구성할 수 있습니다. [더 알아보기](/docs/models).
[로컬 모델](/docs/models#local)을 구성할 수도 있습니다. [더 알아보기](/docs/models).
---
### 공급자 특정 선택권
### 공급자별 옵션
몇몇 공급자는 일반적인 `timeout` 및 `apiKey` 조정을 넘어서 추가 구성 선택권을 지원합니다.
일반적인 `timeout` 및 `apiKey` 외에도 일부 공급자는 추가 구성 옵션을 지원합니다.
##### 아마존 베드록
##### Amazon Bedrock
Amazon Bedrock는 AWS 별 구성을 지원합니다:
Amazon Bedrock는 AWS 관련 구성을 지원합니다:
```json title="opencode.json"
{
@@ -286,21 +283,21 @@ Amazon Bedrock는 AWS 별 구성을 지원합니다:
}
```
- `region` - Bedrock를 위한 AWS 지역 (`AWS_REGION` env var 또는 `us-east-1`에 기본)
- `profile` - AWS는 `~/.aws/credentials` (`AWS_PROFILE` env var에 기본)에서 단면도 지명했습니다
- `endpoint` - VPC 엔드 포인트에 대한 사용자 정의 엔드 포인트 URL. 이것은 AWS 별 용어를 사용하여 일반적인 `baseURL` 옵션에 대한 별명입니다. 둘 다 지정되는 경우에, `endpoint`는 전진합니다.
- `region` - Bedrock를 위한 AWS 리전 (`AWS_REGION` 환경 변수 또는 `us-east-1`이 기본값)
- `profile` - `~/.aws/credentials`의 AWS 프로필 이름 (`AWS_PROFILE` 환경 변수가 기본값)
- `endpoint` - VPC 엔드포인트 등을 위한 사용자 정의 엔드포인트 URL. 이는 AWS 관련 용어를 사용한 일반적인 `baseURL` 옵션의 별칭입니다. 둘 다 지정된 경우 `endpoint`가 우선합니다.
:::note
Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기반 인증을 통해 우선 순위를 부여합니다. 자세한 내용은 [authentication precedence](/docs/providers#authentication-precedence)를 참조하십시오.
Bearer 토큰(`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로필 기반 인증보다 우선합니다. 자세한 내용은 [인증 우선 순위](/docs/providers#authentication-precedence)를 참조하십시오.
:::
[Amazon-bedrock에 대해 자세히 알아보기](/docs/providers#amazon-bedrock).
[Amazon Bedrock에 대해 더 알아보기](/docs/providers#amazon-bedrock).
---
## 테마
`theme` 옵션을 통해 opencode config에서 사용하려는 테마를 구성할 수 있습니다.
`theme` 옵션을 통해 OpenCode 구성에서 사용할 테마를 설정할 수 있습니다.
```json title="opencode.json"
{
@@ -315,7 +312,7 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기
## 에이전트
`agent` 옵션을 통해 특정 작업을 전문 에이전트를 구성할 수 있습니다.
`agent` 옵션을 통해 특정 작업을 전문으로 하는 에이전트를 구성할 수 있습니다.
```jsonc title="opencode.jsonc"
{
@@ -335,13 +332,13 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기
}
```
`~/.config/opencode/agents/` 또는 `.opencode/agents/`에서 Markdown 파일을 사용하여 에이전트를 정의 할 수 있습니다. [더 알아보기](/docs/시약).
`~/.config/opencode/agents/` 또는 `.opencode/agents/`에서 Markdown 파일을 사용하여 에이전트를 정의할 수도 있습니다. [더 알아보기](/docs/agents).
---
### 기본 에이전트
`default_agent` 옵션을 사용하여 기본 에이전트를 설정할 수 있습니다. 아무도 명시적으로 지정되지 않을 때 에이전트가 사용되는 결정.
`default_agent` 옵션을 사용하여 기본 에이전트를 설정할 수 있습니다. 명시적으로 지정되지 않았을 때 어떤 에이전트가 사용될지 결정합니다.
```json title="opencode.json"
{
@@ -350,15 +347,15 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기
}
```
기본 에이전트은 주요 에이전트이어야 합니다 (미약 아닙니다). 이것은 `"build"` 또는 `"plan"`, 또는 정의된 [custom 에이전트](./agents) 같이 붙박이 에이전트일 수 있습니다. 지정된 에이전트가 존재하지 않는 경우, opencode는 경고로 `"build"`로 돌아갑니다.
기본 에이전트는 기본(primary) 에이전트여야 합니다(서브 에이전트 불가). `"build"` 또는 `"plan"`과 같은 내장 에이전트이거나 정의된 [사용자 정의 에이전트](./agents)일 수 있습니다. 지정된 에이전트가 존재하지 않는 경우, OpenCode는 경고와 함께 `"build"`로 돌아갑니다.
이 설정은 모든 인터페이스에서 적용됩니다: TUI, CLI (`opencode run`), 데스크탑 앱 및 GitHub Action.
이 설정은 모든 인터페이스에 적용됩니다: TUI, CLI (`opencode run`), 데스크톱 앱 및 GitHub Action.
---
## 공유
`share` 옵션을 통해 [share](/docs/share) 기능을 구성할 수 있습니다.
`share` 옵션을 통해 [공유](/docs/share) 기능을 구성할 수 있습니다.
```json title="opencode.json"
{
@@ -367,19 +364,19 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기
}
```
이 소요:
값은 다음과 같습니다:
- `"manual"` - 명령을 통해 수동 공유 허용 (기본값)
- `"auto"` - 자동 공유 새로운 대화
- `"disabled"` - 완전하게 공유할 수 있는
- `"manual"` - 명령을 통한 수동 공유 허용 (기본값)
- `"auto"` - 새로운 대화를 자동으로 공유
- `"disabled"` - 공유 기능 완전히 비활성화
기본적으로 `/share` 명령을 사용하여 대화를 명시적으로 공유해야 할 수동 모드로 설정됩니다.
기본적으로 `/share` 명령을 사용하여 대화를 명시적으로 공유해야 하는 수동 모드로 설정됩니다.
---
## 명령
`command` 옵션을 통해 반복 작업을 위한 사용자 지정 명령을 구성할 수 있습니다.
`command` 옵션을 통해 반복 작업을 위한 사용자 정의 명령을 구성할 수 있습니다.
```jsonc title="opencode.jsonc"
{
@@ -390,6 +387,8 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기
"description": "Run tests with coverage",
"agent": "build",
"model": "anthropic/claude-haiku-4-5",
"agent": "build",
"model": "anthropic/claude-haiku-4-5",
},
"component": {
"template": "Create a new React component named $ARGUMENTS with TypeScript support.\nInclude proper typing and basic structure.",
@@ -399,13 +398,13 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기
}
```
`~/.config/opencode/commands/` 또는 `.opencode/commands/`에서 Markdown 파일을 사용하여 명령을 정의 할 수 있습니다. [더 이상](/docs/commands).
`~/.config/opencode/commands/` 또는 `.opencode/commands/`에서 Markdown 파일을 사용하여 명령을 정의할 수도 있습니다. [더 알아보기](/docs/commands).
---
## 키빈드
## 키바인드
`keybinds` 옵션을 통해 keybinds를 사용자 정의 할 수 있습니다.
`keybinds` 옵션을 통해 키바인드를 사용자 정의할 수 있습니다.
```json title="opencode.json"
{
@@ -420,7 +419,7 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기
## 자동 업데이트
opencode는 자동으로 시작될 때 새로운 업데이트를 다운로드합니다. `autoupdate` 옵션으로 이것을 비활성화 할 수 있습니다.
OpenCode는 시작될 때 자동으로 새로운 업데이트를 다운로드합니다. `autoupdate` 옵션으로 이를 비활성화할 수 있습니다.
```json title="opencode.json"
{
@@ -429,14 +428,14 @@ opencode는 자동으로 시작될 때 새로운 업데이트를 다운로드합
}
```
업데이트를 원하지 않으면 새로운 버전이 사용할 수있을 때 알림을하고 `autoupdate`를 `"notify"`로 설정하십시오.
업데이트를 원하지 않지만 새 버전을 알림받고 싶다면 `autoupdate`를 `"notify"`로 설정하십시오.
Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경우에만 작동합니다.
---
## 형식
## 포매터
`formatter` 옵션을 통해 코드 형식기를 구성할 수 있습니다.
`formatter` 옵션을 통해 코드 포매터를 구성할 수 있습니다.
```json title="opencode.json"
{
@@ -456,15 +455,15 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경
}
```
[출판자에 대해 자세히 알아보기](/docs/formatters).
[포매터에 대해 더 알아보기](/docs/formatters).
---
## # 권한
## 권한
기본적으로, opencode ** 명시된 승인 없이 모든 작업**을 허용한다. `permission` 옵션을 사용하여 이것을 변경할 수 있습니다.
기본적으로, OpenCode는 **명시적 승인 없이 모든 작업을 허용**합니다. `permission` 옵션을 사용하여 이를 변경할 수 있습니다.
예를 들어, `edit` 및 `bash` 도구가 사용자 승인을 요구합니다.
예를 들어, `edit` 및 `bash` 도구가 사용자 승인을 요구하도록 설정하려면:
```json title="opencode.json"
{
@@ -476,7 +475,7 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경
}
```
[이 권한에 대해 더 알아보기](/docs/permissions).
[권한에 대해 더 알아보기](/docs/permissions).
---
@@ -494,14 +493,14 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경
}
```
- `auto` - 컨텍스트가 풀 때 자동으로 세션을 압축합니다 (기본: `true`).
- `prune` - 토큰을 저장하기 위해 오래된 도구 출력을 제거 (기본: `true`).
- `auto` - 컨텍스트가 꽉 차면 자동으로 세션을 압축합니다 (기본값: `true`).
- `prune` - 토큰을 절약하기 위해 오래된 도구 출력을 제거합니다 (기본값: `true`).
---
### 시계
### 파일 감시자
`watcher` 옵션을 통해 파일워커가 패턴을 무시할 수 있습니다.
`watcher` 옵션을 통해 파일 감시자가 무시할 패턴을 설정할 수 있습니다.
```json title="opencode.json"
{
@@ -512,7 +511,7 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경
}
```
패턴은 glob 구문을 따릅니다. 이 파일을 보시려면 noisy 디렉토리를 제외하십시오.
패턴은 glob 구문을 따릅니다. 잡음이 많은 디렉토리를 제외하는 데 사용하십시오.
---
@@ -527,15 +526,15 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경
}
```
[더 이상](/docs/mcp-servers).
[더 알아보기](/docs/mcp-servers).
---
### 플러그인
[Plugins](/docs/plugins)는 사용자 정의 도구, 후크 및 통합으로 opencode를 확장합니다.
[플러그인](/docs/plugins)은 사용자 정의 도구, 훅(hook), 통합으로 OpenCode를 확장합니다.
`.opencode/plugins/` 또는 `~/.config/opencode/plugins/`에서 플러그인 파일을 배치하십시오. `plugin` 옵션을 통해 npm에서 플러그인을로드 할 수 있습니다.
`.opencode/plugins/` 또는 `~/.config/opencode/plugins/`에 플러그인 파일을 배치하십시오. `plugin` 옵션을 통해 npm에서 플러그인을 로드할 수 있습니다.
```json title="opencode.json"
{
@@ -544,13 +543,13 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경
}
```
[더 이상](/docs/plugins).
[더 알아보기](/docs/plugins).
---
### 지시
### 지침
`instructions` 옵션을 통해 사용할 모델에 대한 지침을 구성할 수 있습니다.
`instructions` 옵션을 통해 모델에 대한 지침(Rules)을 구성할 수 있습니다.
```json title="opencode.json"
{
@@ -559,14 +558,13 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경
}
```
이 경로와 glob 패턴의 배열을 사용하여 명령 파일. [더 알아보기
여기 규칙에 관하여](./rules).
지침 파일에 대한 경로와 glob 패턴의 배열을 사용합니다. [규칙에 대해 더 알아보기](/docs/rules).
---
## Disabled 공급자
## 비활성화된 공급자
`disabled_providers` 옵션을 통해 자동으로 로드된 공급자를 비활성화할 수 있습니다. 이것은 당신이 그들의 credentials가 유효하다하더라도 적재되는에서 특정 공급자를 방지할 때 유용합니다.
`disabled_providers` 옵션을 통해 자동으로 로드되는 공급자를 비활성화할 수 있습니다. 자격 증명이 유효하더라도 특정 공급자가 로드되는 것을 방지할 때 유용합니다.
```json title="opencode.json"
{
@@ -576,20 +574,20 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경
```
:::note
`disabled_providers`는 `enabled_providers`에 우선권을 가지고 있습니다.
`disabled_providers`는 `enabled_providers`보다 우선합니다.
:::
`disabled_providers` 옵션은 공급자 ID의 배열을 허용합니다. 공급자가 비활성화되면:
- 환경 변수가 설정된 경우에도 로드되지 않습니다.
- API 키가 `/connect` 명령을 통해 구성되는 경우에도로드되지 않습니다.
- API 키가 `/connect` 명령을 통해 구성되는 경우에도 로드되지 않습니다.
- 공급자의 모델은 모델 선택 목록에 표시되지 않습니다.
---
### Enabled 공급자
### 활성화된 공급자
`enabled_providers` 옵션을 통해 공급자의 수당을 지정할 수 있습니다. 설정할 때 지정된 공급자만이 활성화되고 다른 모든 사람들이 무시됩니다.
`enabled_providers` 옵션을 통해 허용할 공급자를 지정할 수 있습니다. 설정하면 지정된 공급자만 활성화되고 다른 모든 공급자는 무시됩니다.
```json title="opencode.json"
{
@@ -598,19 +596,19 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경
}
```
opencode를 제한 할 때 유용합니다. 특정 공급자를 사용하지 않도록하십시오.
OpenCode를 제한하여 특정 공급자만 사용하도록 할 때 유용합니다.
:::note
`disabled_providers`는 `enabled_providers`에 우선권을 가지고 있습니다.
`disabled_providers`는 `enabled_providers`보다 우선합니다.
:::
공급자가 `enabled_providers`와 `disabled_providers` 둘 다에서 나타나면, `disabled_providers`는 뒤에 오는 겸용성을 위한 우선권을 가지고 갑니다.
공급자가 `enabled_providers`와 `disabled_providers` 둘 다에 나타나면, 하위 호환성을 위해 `disabled_providers`가 우선합니다.
---
### 실험
### 실험적 기능
`experimental` 열쇠는 활동적인 발달의 밑에 있는 선택권을 포함합니다.
`experimental` 키는 활발히 개발 중인 옵션을 포함합니다.
```json title="opencode.json"
{
@@ -620,20 +618,20 @@ opencode를 제한 할 때 유용합니다. 특정 공급자를 사용하지 않
```
:::caution
실험 옵션은 안정되지 않습니다. 그들은 예고없이 변경하거나 제거 할 수 있습니다.
실험적 옵션은 안정적이지 않습니다. 예고 없이 변경되거나 제거될 수 있습니다.
:::
---
## 변수
config 파일에서 참조 환경 변수 및 파일 내용에 대한 변수 대변을 사용할 수 있습니다.
구성 파일에서 환경 변수를 참조하고 파일 내용에 대한 변수 대체를 사용할 수 있습니다.
---
##### Env 바
##### 환경 변수
`{env:VARIABLE_NAME}`를 사용하여 환경 변수를 대체합니다.
`{env:VARIABLE_NAME}`을 사용하여 환경 변수를 대체합니다.
```json title="opencode.json"
{
@@ -674,11 +672,11 @@ config 파일에서 참조 환경 변수 및 파일 내용에 대한 변수 대
파일 경로는:
- config 파일 디렉토리에 관계
- 또는 `/` 또는 `~`로 시작하는 절대 경로
- 구성 파일 디렉토리에 상대적이거나
- `/` 또는 `~`로 시작하는 절대 경로여야 합니다.
이것들은 유용하다:
이것은 다음에 유용합니다:
- 별도의 파일에서 API 키와 같은 민감한 데이터를 유지.
- config를 cluttering하지 않고 큰 명령어 파일을 포함합니다.
- 여러 구성 파일에서 공통 구성 스니펫 공유.
- API 키와 같은 민감한 데이터를 별도의 파일에 유지할 때.
- 구성을 어지럽히지 않고 큰 지침 파일을 포함할 때.
- 여러 구성 파일에서 공통 구성 스니펫을 공유할 때.

10
packages/web/src/content/docs/ko/custom-tools.mdx
View File

@@ -1,6 +1,6 @@
---
title: Custom Tools
description: Create tools the LLM can call in opencode.
title: 사용자 정의 도구
description: OpenCode에서 LLM이 호출할 수 있는 도구를 만듭니다.
---
사용자 정의 도구는 LLM이 대화 중에 호출 할 수있는 기능을 만듭니다. 그들은 `read`, `write` 및 `bash`와 같은 opencode의 [붙박이 도구](./tools)와 함께 작동합니다.
@@ -45,7 +45,7 @@ export default tool({
---
### 파일 당 다수 공구
### 파일당 여러 도구
단일 파일에서 여러 도구를 수출할 수 있습니다. 각 수출은 ** 별도의 도구 ** 이름 ** `<filename>_<exportname>`**:
@@ -79,7 +79,7 @@ export const multiply = tool({
---
#### 가격
#### 스키마
`tool.schema`를 사용할 수 있습니다, 그냥 [Zod](https://zod.dev), 인수 유형을 정의합니다.
@@ -108,7 +108,7 @@ export default {
---
### 텍스트
### 컨텍스트
도구는 현재 세션에 대한 컨텍스트를받습니다.

4
packages/web/src/content/docs/ko/ecosystem.mdx
View File

@@ -1,6 +1,6 @@
---
title: Ecosystem
description: Projects and integrations built with opencode.
title: 생태계
description: OpenCode로 구축된 프로젝트 및 통합.
---
opencode에 내장 된 커뮤니티 프로젝트의 컬렉션.

16
packages/web/src/content/docs/ko/enterprise.mdx
View File

@@ -1,6 +1,6 @@
---
title: Enterprise
description: Using opencode securely in your organization.
title: 엔터프라이즈
description: 조직에서 OpenCode를 안전하게 사용하세요.
---
import config from "../../../../config.mjs"
@@ -75,7 +75,7 @@ opencode Enterprise의 per-seat 모델을 사용합니다. LLM 게이트웨이
---
### 중앙 Config
### 중앙 구성
opencode를 설정하여 전체 조직의 단일 중앙 구성을 사용할 수 있습니다.
@@ -111,14 +111,14 @@ opencode는 기존 ID 관리 시스템을 통해 내부 AI 게이트웨이에
## 자주 묻는 질문
<details>
<summary>What is opencode Enterprise?</summary>
<summary>opencode Enterprise란 무엇입니까?</summary>
opencode Enterprise는 코드와 데이터가 인프라를 결코 나타낸다는 것을 보증하는 단체입니다. SSO 및 내부 AI 게이트웨이와 통합하는 중앙화 된 구성을 사용하여 이것을 할 수 있습니다.
</details>
<details>
<summary>How do I get started with opencode Enterprise?</summary>
<summary>opencode Enterprise를 어떻게 시작하나요?</summary>
단순히 팀과 내부 평가판을 시작합니다. 기본값으로 opencode는 코드를 저장하지 않거나 context data, 시작하기 쉬운 만들기.
@@ -127,21 +127,21 @@ opencode Enterprise는 코드와 데이터가 인프라를 결코 나타낸다
</details>
<details>
<summary>How does enterprise pricing work?</summary>
<summary>엔터프라이즈 가격 정책은 어떻게 되나요?</summary>
우리는 per-seat 기업 가격을 제안합니다. LLM 게이트웨이를 가지고 있다면 토큰을 사용할 수 없습니다. 더 자세한 내용은 **<a href={email}>contact us</a>** 를 통해 조직의 요구에 따라 맞춤형 견적을 제공합니다.
</details>
<details>
<summary>Is my data secure with opencode Enterprise?</summary>
<summary>opencode Enterprise에서 내 데이터는 안전한가요?</summary>
예. opencode는 코드 또는 컨텍스트 데이터를 저장하지 않습니다. 모든 처리는 로컬 또는 직접 API 호출을 통해 AI 공급자. 중앙 설정 및 SSO 통합으로 데이터는 조직의 인프라 내에서 안전하게 유지됩니다.
</details>
<details>
<summary>Can we use our own private npm registry?</summary>
<summary>자체 비공개 npm 레지스트리를 사용할 수 있나요?</summary>
opencode는 Bun's native `.npmrc` 파일 지원을 통해 개인 npm 등록을 지원합니다. 조직이 JFrog Artifactory, Nexus 또는 이와 같은 개인 레지스트리를 사용한다면, 개발자가 opencode를 실행하기 전에 인증됩니다.

78
packages/web/src/content/docs/ko/formatters.mdx
View File

@@ -1,6 +1,6 @@
---
title: Formatters
description: opencode uses language specific formatters.
title: 포매터
description: opencode는 언어별 포매터를 사용합니다.
---
opencode는 언어 별 형식을 사용하여 작성 또는 편집 한 후 자동으로 파일을 포맷합니다. 이 생성 된 코드는 프로젝트의 코드 스타일을 따릅니다.
@@ -11,39 +11,37 @@ opencode는 언어 별 형식을 사용하여 작성 또는 편집 한 후 자
opencode는 인기있는 언어 및 프레임 워크에 대한 몇 가지 내장 형식자와 함께 제공됩니다. 아래는 formatters, 지원된 파일 확장 및 명령 또는 구성 옵션의 목록입니다.
| 형식 | 연장 | 요구 사항 |
| ----- | ------------------------------------------- | ----------------- |
| gofmt | .go | `gofmt` 명령 가능 |
| 믹스 | .ex, .ex, .eex, .heex, .leex, .neex, .sface | `mix` 명령 가능 |
인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션
| 바이오메 | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, [기타](https://biomejs.dev/) | `biome.json(c)` 구성 파일 |
| 지그 | .zig, .zon | `zig` 명령 가능 |
| clang-format | .c, .cpp, .h, .hpp, .ino, [기타](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` 구성 파일 |
| ktlint | .kt, .kts | `ktlint` 명령 가능 |
| ruff | .py, .pyi | 구성 가능한 `ruff` 명령 |
| rustfmt | .rs | `rustfmt` 명령 가능 |
| 화물fmt | .rs | `cargo fmt` 명령 가능 |
| uv | .py, .pyi | `uv` 명령 가능 |
| rubocop | .rb, .rake, .gemspec, .ru | `rubocop` 명령 사용 가능 |
| 표준 | .rb, .rake, .gemspec, .ru | `standardrb` 명령 사용 가능 |
| htmlbeautifier | .erb, .html.erb | `htmlbeautifier` 명령 가능 |
| 공기 | .R | `air` 명령 가능 |
| 다트 | 다트 | `dart` 명령 |
| ocamlformat | .ml, .mli | `ocamlformat` 명령 가능·`.ocamlformat` 설정 파일 |
| 지형 | .tf, .tfvars | `terraform` 명령 가능 |
| gleam | .gleam | `gleam` 명령 가능 |
| nixfmt | .nix | `nixfmt` 명령 가능 |
| shfmt | .sh, .bash | `shfmt` 명령 가능 |
| 핀 | .php | `laravel/pint` 의존도 `composer.json` |
| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `oxfmt` Dependency in `package.json`, [experimental env 변수 플래그](/docs/cli/#experimental) |
| ormolu | .hs | `ormolu` 명령 가능 |
| 포매터 | 확장자 | 요구 사항 |
| -------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| gofmt | .go | `gofmt` 명령 사용 가능 |
| Mix | .ex, .ex, .eex, .heex, .leex, .neex, .sface | `mix` 명령 사용 가능 |
| Biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, [기타](https://biomejs.dev/) | `biome.json(c)` 구성 파일 |
| Zig | .zig, .zon | `zig` 명령 사용 가능 |
| clang-format | .c, .cpp, .h, .hpp, .ino, [기타](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` 구성 파일 |
| ktlint | .kt, .kts | `ktlint` 명령 사용 가능 |
| ruff | .py, .pyi | 구성 가능한 `ruff` 명령 |
| rustfmt | .rs | `rustfmt` 명령 사용 가능 |
| cargo fmt | .rs | `cargo fmt` 명령 사용 가능 |
| uv | .py, .pyi | `uv` 명령 사용 가능 |
| rubocop | .rb, .rake, .gemspec, .ru | `rubocop` 명령 사용 가능 |
| StandardRB | .rb, .rake, .gemspec, .ru | `standardrb` 명령 사용 가능 |
| htmlbeautifier | .erb, .html.erb | `htmlbeautifier` 명령 사용 가능 |
| Air | .R | `air` 명령 사용 가능 |
| Dart | 다트 | `dart` 명령 |
| ocamlformat | .ml, .mli | `ocamlformat` 명령 사용 가능·`.ocamlformat` 설정 파일 |
| Terraform | .tf, .tfvars | `terraform` 명령 사용 가능 |
| gleam | .gleam | `gleam` 명령 사용 가능 |
| nixfmt | .nix | `nixfmt` 명령 사용 가능 |
| shfmt | .sh, .bash | `shfmt` 명령 사용 가능 |
| Pint | .php | `laravel/pint` 의존도 `composer.json` |
| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `oxfmt` Dependency in `package.json`, [experimental env 변수 플래그](/docs/cli/#experimental) |
| ormolu | .hs | `ormolu` 명령 사용 가능 |
그래서 프로젝트가 `prettier`를 `package.json`에 가지고 있다면, opencode는 자동으로 그것을 사용합니다.
---
## 어떻게 작동합니까?
## 작동 방식
opencode가 파일을 작성하거나 편집할 때:
@@ -68,20 +66,20 @@ opencode config의 `formatter` 섹션을 통해 형식기를 사용자 정의
각 formatter 구성은 다음을 지원합니다:
| 재산 | 유형 | 묘사 |
| ------------- | -------- | ---------------------------------- |
| `disabled` | 불린 | 이 세트를 `true`로 포맷터 비활성화 |
| `command` | 문자열[] | 형식을 실행하는 명령 |
| `environment` | 객체 | 형식의 실행시 설정하는 환경 변수 |
| `extensions` | string[] | 이 형식의 파일 확장자 취급 |
| 속성 | 타입 | 설명 |
| ------------- | -------- | --------------------------------- |
| `disabled` | boolean | `true`로 설정하여 포매터 비활성화 |
| `command` | 문자열[] | 형식을 실행하는 명령 |
| `environment` | 객체 | 형식의 실행시 설정하는 환경 변수 |
| `extensions` | string[] | 이 형식의 파일 확장자 취급 |
몇 가지 예제를 살펴 보자.
---
## Disabling 형식자
## 포매터 비활성화
`false`에 `formatter`를 세계로 바꾸기 위하여 **all** formatters:
모든 포매터를 비활성화하려면 `formatter`를 `false`로 설정하십시오:
```json title="opencode.json" {3}
{
@@ -90,7 +88,7 @@ opencode config의 `formatter` 섹션을 통해 형식기를 사용자 정의
}
```
** 특정** 형식, `disabled`를 `true`로 설정:
**특정** 포매터의 경우, `disabled`를 `true`로 설정하십시오:
```json title="opencode.json" {5}
{
@@ -105,7 +103,7 @@ opencode config의 `formatter` 섹션을 통해 형식기를 사용자 정의
---
### 사용자 정의 형식
### 사용자 정의 포매터
내장 형식자를 무시하거나 명령, 환경 변수 및 파일 확장을 지정하여 새로운 것을 추가 할 수 있습니다.

53
packages/web/src/content/docs/ko/github.mdx
View File

@@ -1,16 +1,17 @@
---
title: GitHub
description: Use opencode in GitHub issues and pull-requests.
description: GitHub 이슈 및 풀 리퀘스트에서 opencode를 사용하세요.
---
opencode는 GitHub 워크플로우와 통합됩니다. Mention `/opencode` 또는 `/oc` 당신의 의견에, 그리고 opencode는 당신의 GitHub 활동 주자 안에 작업을 실행할 것입니다.
---
## 특징
## 기능
- **문제**: opencode가 문제점을 보고 당신을 설명합니다.
- **Fix 및 구현 **: 이슈를 수정하거나 기능을 구현하려면 opencode에 문의하십시오. 그리고 새로운 지점에서 일하고 모든 변경으로 PR을 제출합니다. -**Secure**: opencode는 GitHub의 런너 내부에서 실행됩니다.
- **이슈**: opencode가 이슈를 보고 설명해 줍니다.
- **수정 및 구현**: 이슈를 수정하거나 기능을 구현하도록 opencode에 요청하세요. 새로운 브랜치에서 작업하고 변경 사항으로 PR을 제출합니다.
- **보안**: opencode는 GitHub 러너 내부에서 실행됩니다.
---
@@ -30,11 +31,11 @@ GitHub 앱을 설치하고 워크플로를 만들고 비밀을 설정할 수 있
또는 수동으로 설정할 수 있습니다.
1. ** GitHub 앱 설치 **
1. **GitHub 앱 설치**
[**github.com/apps/opencode-agent**](https://github.com/apps/opencode-agent)에 머리가 붙습니다. 대상 저장소에 설치되어 있는지 확인하십시오.
[**github.com/apps/opencode-agent**](https://github.com/apps/opencode-agent)로 이동합니다. 대상 저장소에 설치되어 있는지 확인하십시오.
2. ** 워크플로우 추가 **
2. **워크플로우 추가**
저장소에 `.github/workflows/opencode.yml`에 다음 작업 흐름 파일을 추가합니다. 적절한 `model`를 설정하고 `env`의 API 키가 필요합니다.
@@ -72,9 +73,9 @@ GitHub 앱을 설치하고 워크플로를 만들고 비밀을 설정할 수 있
# github_token: xxxx
```
3. ** 비밀의 API 키 저장 **
3. **API 키를 Secret으로 저장**
조직 또는 프로젝트 ** 설정**, 확장 ** 축소 및 변수 ** 왼쪽 및 선택 **Actions**. 그리고 필요한 API 키를 추가합니다.
조직 또는 프로젝트 **Settings**에서, 왼쪽의 **Secrets and variables**를 확장하고 **Actions**를 선택합니다. 그리고 필요한 API 키를 추가합니다.
---
@@ -100,20 +101,20 @@ permissions:
---
## 지원된 사건
## 지원되는 이벤트
opencode는 다음 GitHub 이벤트에 의해 트리거 될 수 있습니다:
| 이벤트 타입 | Triggered by | 상세 |
| ----------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `issue_comment` | 발행 또는 PR에 대한 의견 | 멘션 `/opencode` 또는 `/oc` 당신의 의견. opencode는 컨텍스트를 읽고, 지점을 만들 수 있습니다, 열린 PR, 또는 대답. · |
| `pull_request_review_comment` | PR의 특정 코드 라인에 대한 의견 | Mention `/opencode` 또는 `/oc` 코드 검토 중. opencode는 파일 경로, 줄 번호 및 diff 컨텍스트를 수신합니다. · |
| `issues` | 이슈가 열리고 편집되었습니다 | 이슈가 생성되거나 수정될 때 자동으로 opencode를 트리거합니다. `prompt` 입력이 필요합니다. |
| `pull_request` | PR 오픈 또는 업데이트 | PR이 열릴 때 자동 트리거 opencode 자동 리뷰에 대한 유용한 정보 |
| `schedule` | 크론 기반 일정 | 일정에 opencode를 실행합니다. `prompt` 입력을 요구합니다. 출력 로그 및 PR에 간다 (댓글이 없습니다). |
| `workflow_dispatch` | GitHub UI에서 수동 트리거 | 액션 탭을 통해 까다로운 Trigger opencode. `prompt` 입력을 요구합니다. 출력 로그 및 PR에 간다. |
| 이벤트 타입 | Triggered by | 상세 |
| ----------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `issue_comment` | 이슈 또는 PR 댓글 | 멘션 `/opencode` 또는 `/oc` 당신의 의견. opencode는 컨텍스트를 읽고, 지점을 만들 수 있습니다, 열린 PR, 또는 대답. · |
| `pull_request_review_comment` | PR의 특정 코드 라인 댓글 | Mention `/opencode` 또는 `/oc` 코드 검토 중. opencode는 파일 경로, 줄 번호 및 diff 컨텍스트를 수신합니다. · |
| `issues` | 이슈가 열리거나 편집됨 | 이슈가 생성되거나 수정될 때 자동으로 opencode를 트리거합니다. `prompt` 입력이 필요합니다. |
| `pull_request` | PR 오픈 또는 업데이트 | PR이 열릴 때 자동 트리거 opencode 자동 리뷰에 대한 유용한 정보 |
| `schedule` | 크론 기반 일정 | 일정에 opencode를 실행합니다. `prompt` 입력을 요구합니다. 출력 로그 및 PR에 간다 (댓글이 없습니다). |
| `workflow_dispatch` | GitHub UI에서 수동 트리거 | 액션 탭을 통해 까다로운 Trigger opencode. `prompt` 입력을 요구합니다. 출력 로그 및 PR에 간다. |
### 일정 예
### 일정 예제
자동화된 작업을 수행하는 일정에 opencode를 실행:
@@ -149,11 +150,11 @@ jobs:
If you find issues worth addressing, open an issue to track them.
```
예정된 이벤트의 경우, `prompt` 입력은 **필요 ** 이후의 지시를 추출할 수 없습니다. 사용자 컨텍스트 없이 실행되는 워크플로우는 권한 확인을 위해, 워크플로우는 `contents: write`와 `pull-requests: write`를 부여해야 하며, opencode가 지점이나 PR을 만들게 됩니다.
스케줄된 이벤트의 경우, `prompt` 입력은 **필요 ** 이후의 지시를 추출할 수 없습니다. 사용자 컨텍스트 없이 실행되는 워크플로우는 권한 확인을 위해, 워크플로우는 `contents: write`와 `pull-requests: write`를 부여해야 하며, opencode가 지점이나 PR을 만들게 됩니다.
---
## Pull 요청 예제
## Pull Request 예제
자동 검토 PR 때 그들은 열려있거나 업데이트 :
@@ -194,7 +195,7 @@ jobs:
---
### 문제 부족 예제
### 이슈 분류 예제
자동으로 새로운 문제를 삼는다. 이 예제는 스팸을 줄이기 위해 30 일 이상 계정 필터 :
@@ -272,7 +273,7 @@ opencode의 작업 흐름을 사용자 정의하는 기본 프롬프트를 부
GitHub에서 opencode를 사용할 수있는 몇 가지 예입니다.
- **문제 설명**
- **이슈 설명**
GitHub 문제에서 이 의견 추가.
@@ -282,7 +283,7 @@ GitHub 문제에서 이 의견 추가.
opencode는 모든 코멘트를 포함하여 전체 스레드를 읽고, 명확한 설명과 대답.
- **문제**
- **이슈 해결**
GitHub 문제에서:
@@ -292,7 +293,7 @@ GitHub 문제에서:
opencode는 새로운 지점을 만들 것이며 변경 사항을 실행하고 PR을 변경합니다.
-**Review PR 및 변경 사항**
- **PR 및 변경 사항 검토**
GitHub PR에 다음 댓글을 남겨주세요.
@@ -302,7 +303,7 @@ GitHub PR에 다음 댓글을 남겨주세요.
opencode는 요청한 변경을 구현하고 동일한 PR에 커밋합니다.
- ** 특정 코드 라인**
- **특정 코드 라인**
PR의 "Files" 탭의 코드 라인에 직접 댓글을 남겨주세요. opencode는 파일, 줄 번호 및 diff 컨텍스트를 자동으로 감지하여 정확한 응답을 제공합니다.

26
packages/web/src/content/docs/ko/gitlab.mdx
View File

@@ -1,6 +1,6 @@
---
title: GitLab
description: Use opencode in GitLab issues and merge requests.
description: GitLab 이슈 및 머지 리퀘스트에서 opencode를 사용하세요.
---
opencode는 GitLab CI/CD 파이프라인 또는 GitLab Duo를 통해 GitLab 워크플로우와 통합됩니다.
@@ -9,17 +9,17 @@ opencode는 GitLab CI/CD 파이프라인 또는 GitLab Duo를 통해 GitLab 워
---
#GitLab CI 소개
# GitLab CI 소개
opencode는 일반 GitLab 파이프라인에서 작동합니다. [CI 구성품](https://docs.gitlab.com/ee/ci/components/)로 파이프라인에 구축할 수 있습니다.
opencode는 일반 GitLab 파이프라인에서 작동합니다. [CI 컴포넌트](https://docs.gitlab.com/ee/ci/components/)로 파이프라인에 구축할 수 있습니다.
여기에서 우리는 opencode에 대한 커뮤니티 생성 CI / CD 구성품을 사용하고 있습니다. [nagyv/gitlab-opencode](https://gitlab.com/nagyv/gitlab-opencode).
---
### 특징
### 기능
- **일당 사용자 지정 구성 사용**: 사용자 정의 구성 디렉토리와 opencode 구성, 예를 들어 `./config/#custom-directory`는 opencode invocation 당 활성화하거나 비활성화 할 수 있습니다.
- **실행별 사용자 지정 구성 사용**: 사용자 정의 구성 디렉토리와 opencode 구성, 예를 들어 `./config/#custom-directory`는 opencode 실행마다 활성화하거나 비활성화 할 수 있습니다.
- ** 최소 설정**: CI 구성 요소는 opencode를 배경으로 설정하면 opencode 구성과 초기 프롬프트를 만들 필요가 있습니다.
- **Flexible**: CI 구성 요소는 여러 입력을 지원합니다.
@@ -44,19 +44,19 @@ opencode는 일반 GitLab 파이프라인에서 작동합니다. [CI 구성품](
---
## GitLab 듀오
## GitLab Duo
opencode는 GitLab 워크플로우와 통합됩니다.
코멘트에 Mention `@opencode`, opencode는 GitLab CI 파이프라인 내에서 작업을 실행합니다.
---
### 특징
### 기능
- **문제**: opencode가 문제점을 보고 당신을 설명합니다.
- **Fix 및 구현 **: 이슈를 수정하거나 기능을 구현하려면 opencode에 문의하십시오.
- **이슈**: opencode가 문제점을 보고 당신을 설명합니다.
- **수정 및 구현**: 이슈를 수정하거나 기능을 구현하려면 opencode에 문의하십시오.
새로운 지점을 만들고 변화를 병합 요청을 제기합니다.
- **Secure**: opencode는 GitLab runners에서 실행됩니다.
- **보안**: opencode는 GitLab runners에서 실행됩니다.
---
@@ -164,7 +164,7 @@ opencode는 GitLab CI/CD 파이프라인에서 실행되며, 여기서 설정해
`@opencode`보다 다른 트리거 구문을 사용할 수 있습니다.
:::
- **문제 설명**
- **이슈 설명**
GitLab 문제에서이 코멘트를 추가하십시오.
@@ -174,7 +174,7 @@ GitLab 문제에서이 코멘트를 추가하십시오.
opencode는 문제와 대답을 명확하게 설명합니다.
- **문제**
- **이슈 해결**
GitLab 문제에서, 말한다:
@@ -184,7 +184,7 @@ GitLab 문제에서, 말한다:
opencode는 새로운 지점을 만들 것이며 변경 사항을 구현하고 변경 사항을 병합 요청을 엽니다.
- **Review 병합 요청**
- **머지 리퀘스트 검토**
GitLab 병합 요청에 대한 다음 의견을 남겨주세요.

10
packages/web/src/content/docs/ko/ide.mdx
View File

@@ -1,17 +1,17 @@
---
title: IDE
description: The opencode extension for VS Code, Cursor, and other IDEs
description: VS Code, Cursor 및 기타 IDE용 opencode 확장 프로그램.
---
opencode는 VS Code, Cursor, 또는 terminal을 지원하는 IDE와 통합합니다. 시작하려면 terminal에서 `opencode`를 실행하십시오.
opencode는 VS Code, Cursor, 또는 터미널을 지원하는 IDE와 통합됩니다. 시작하려면 terminal에서 `opencode`를 실행하십시오.
---
## 사용법
-**Quick Launch**: `Cmd+Esc` (Mac) 또는 `Ctrl+Esc` (Windows/Linux)를 사용하여 균열 단자 전망에 opencode를 열거나 기존 terminal 세션을 이미 실행하면 됩니다. -**New Session**: `Cmd+Shift+Esc` (Mac) 또는 `Ctrl+Shift+Esc` (Windows/Linux)를 사용하여 새로운 opencode terminal 세션을 시작하려면 이미 열리면 됩니다. UI에서 opencode 버튼을 클릭합니다. -**Context Awareness**: opencode로 현재 선택 또는 탭을 자동으로 공유합니다.
-**Quick Launch**: `Cmd+Esc` (Mac) 또는 `Ctrl+Esc` (Windows/Linux)를 사용하여 통합 터미널 뷰에 opencode를 열거나 기존 terminal 세션을 이미 실행하면 됩니다. -**New Session**: `Cmd+Shift+Esc` (Mac) 또는 `Ctrl+Shift+Esc` (Windows/Linux)를 사용하여 새로운 opencode terminal 세션을 시작하려면 이미 열리면 됩니다. UI에서 opencode 버튼을 클릭합니다. -**Context Awareness**: opencode로 현재 선택 또는 탭을 자동으로 공유합니다.
- ** 파일 참조 단축키 ** : 파일 참조를 삽입하려면 `Cmd+Option+K` (Mac) 또는 `Alt+Ctrl+K` (Linux / Windows)를 사용하십시오. 예를 들어, `@File#L37-42`.
- **파일 참조 단축키** : 파일 참조를 삽입하려면 `Cmd+Option+K` (Mac) 또는 `Alt+Ctrl+K` (Linux / Windows)를 사용하십시오. 예를 들어, `@File#L37-42`.
---
@@ -23,7 +23,7 @@ VS Code에 opencode를 설치하고 Cursor, Windsurf, VSCodium과 같은 인기
2. 통합 terminal을 여십시오
3. 실행 `opencode` - 확장 자동으로 설치
당신이 TUI에서 `/editor` 또는 `/export`를 실행할 때 다른 한편에, 당신은 `export EDITOR="code --wait"`를 설정할 필요가 있을 것입니다. [Learn more](/docs/tui/#editor-setup).
반면에 TUI에서 `/editor` 또는 `/export`를 실행할 때, 당신은 `export EDITOR="code --wait"`를 설정할 필요가 있을 것입니다. [Learn more](/docs/tui/#editor-setup).
---

12
packages/web/src/content/docs/ko/index.mdx
View File

@@ -1,6 +1,6 @@
---
title: Intro
description: Get started with opencode.
title: 소개
description: OpenCode를 시작해 보세요.
---
import { Tabs, TabItem } from "@astrojs/starlight/components"
@@ -15,11 +15,11 @@ export const console = config.console
---
#### 사전 준비
## 사전 준비
터미널에서 OpenCode를 사용하려면 다음이 필요합니다.
1. 최신 터미널 에뮬레이터(예:)
1. 최신 터미널 에뮬레이터 (예:)
- [WezTerm](https://wezterm.org), 크로스 플랫폼
- [Alacritty](https://alacritty.org), 크로스 플랫폼
- [Ghostty](https://ghostty.org), Linux 및 macOS
@@ -336,8 +336,8 @@ OpenCode와의 대화는 [팀과 공유](/docs/share)할 수 있습니다.
---
## 커스터마이즈
## 사용자 지정
이제 OpenCode 사용의 기본은 끝났습니다.
자신의 워크플로우에 맞추려면 [테마 선택](/docs/themes), [키바인드 커스터마이즈](/docs/keybinds), [코드 포매터 설정](/docs/formatters), [커스텀 명령 작성](/docs/commands), [OpenCode config 조정](/docs/config)을 추천합니다.
자신의 워크플로우에 맞추려면 [테마 선택](/docs/themes), [키바인드 사용자 지정](/docs/keybinds), [코드 포매터 설정](/docs/formatters), [커스텀 명령 작성](/docs/commands), [OpenCode 구성 조정](/docs/config)을 추천합니다.

18
packages/web/src/content/docs/ko/keybinds.mdx
View File

@@ -1,6 +1,6 @@
---
title: Keybinds
description: Customize your keybinds.
title: 키바인드
description: 키바인드를 사용자 지정하세요.
---
opencode는 opencode config를 통해 사용자 정의 할 수있는 keybinds 목록을 가지고 있습니다.
@@ -111,11 +111,11 @@ opencode는 대부분의 keybinds에 대한 `leader` 키를 사용합니다. 이
기본적으로 `ctrl+x`는 리더 키이며 대부분의 작업은 리더 키를 먼저 누르고 단축키를 누릅니다. 예를 들어, 새 세션을 시작하려면 먼저 `ctrl+x`를 누르고 `n`를 누릅니다.
당신은 당신의 keybinds를 위한 지도자 열쇠를 사용할 필요가 없습니다 그러나 우리는 이렇게 추천합니다.
키바인드에 리더 키를 사용할 필요는 없지만, 사용하는 것을 권장합니다.
---
## 비활성화 keybind
## 키바인드 비활성화
"none"의 값으로 구성에 키를 추가하여 keybind를 비활성화 할 수 있습니다.
@@ -134,7 +134,7 @@ opencode는 대부분의 keybinds에 대한 `leader` 키를 사용합니다. 이
opencode 데스크톱 앱 프롬프트 입력은 텍스트 편집을 위한 일반적인 Readline/Emacs-style 단축키를 지원합니다. 이들은 내장되어 있으며 현재 `opencode.json`를 통해 구성할 수 없습니다.
| 단축 | 액션 |
| 단축키 | 동작 |
| -------- | -------------------------- |
| `ctrl+a` | 현재 행 시작으로 이동 |
| `ctrl+e` | 현재선 끝으로 이동 |
@@ -152,11 +152,11 @@ opencode 데스크톱 앱 프롬프트 입력은 텍스트 편집을 위한 일
---
## 시프트+ 이름 \*
## Shift+Enter
몇몇 terminal은 기본적으로 입력한 modifier 열쇠를 보내지 않습니다. `Shift+Enter`를 탈출 순서로 보낼 terminal을 구성해야 할 수 있습니다.
몇몇 terminal은 기본적으로 입력한 보조 키를 보내지 않습니다. `Shift+Enter`를 이스케이프 시퀀스로 보낼 terminal을 구성해야 할 수 있습니다.
### 윈도우 terminal
### Windows Terminal
`settings.json`를 엽니다:
@@ -189,4 +189,4 @@ opencode 데스크톱 앱 프롬프트 입력은 텍스트 편집을 위한 일
]
```
파일을 저장하고 Windows terminal을 다시 시작하거나 새 탭을 엽니 다.
파일을 저장하고 Windows Terminal을 다시 시작하거나 새 탭을 엽니 다.

124
packages/web/src/content/docs/ko/lsp.mdx
View File

@@ -1,52 +1,52 @@
---
title: LSP Servers
description: opencode integrates with your LSP servers.
title: LSP 서버
description: OpenCode는 LSP 서버와 통합되어 작동합니다.
---
opencode는 언어 서버 프로토콜 (LSP)과 통합하여 LLM은 코드베이스와 상호 작용합니다. 그것은 LLM에 피드백을 제공하기 위해 진단을 사용합니다.
OpenCode는 언어 서버 프로토콜(LSP)과 통합되어 LLM이 코드베이스와 상호 작용할 수 있게 돕습니다. 이를 통해 진단 정보를 사용하여 LLM에 피드백을 제공합니다.
---
## 내장
## 기본 제공 (Built-in)
opencode는 인기있는 언어로 여러 내장 LSP 서버와 함께 제공됩니다.
OpenCode는 인기 있는 언어들에 대해 여러 내장 LSP 서버를 제공합니다.
| LSP 서버 | 연장 | 요구사항 |
| ----------------- | ------------------------------------------------------------------ | ----------------------------------------------- |
| astro | .astro | Astro 프로젝트 자동 설치 |
| bash | .sh, .bash, .zsh, .ksh | 자동 설치 bash-language-server |
| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | C/C++ 프로젝트용 자동 설치 |
| csharp | .cs | `.NET SDK` 설치 |
| clojure-lsp | .clj, .cljs, .cljc, .edn | `clojure-lsp` 명령 가능 |
| 다트 | 다트 | `dart` 명령 |
| deno | .ts, .tsx, .js, .jsx, .mjs | `deno` 명령 가능(자동검출 deno.json/deno.jsonc) |
| elixir-ls | .ex, .exs | `elixir` 명령 가능 |
| eslint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue | 프로젝트의 `eslint` 의존성 |
| fsharp | .fs, .fsi, .fsx, .fsscript | `.NET SDK` 설치 |
| gleam | .gleam | `gleam` 명령 가능 |
| gopls | .go | `go` 명령 가능 |
| hls | .hs, .lhs | `haskell-language-server-wrapper` 명령 가능 |
| jdtls | .java | `Java SDK (version 21+)` 설치 |
| kotlin-ls | .kt, .kts | Kotlin 프로젝트용 자동 설치 |
| lua-ls | .lua | 루아 사업용 자동설치 |
| nixd | .nix | `nixd` 명령 가능 |
| ocaml-lsp | .ml, .mli | `ocamllsp` 명령 가능 |
| oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .ct, .vue, .astro, .svelte | 프로젝트의 `oxlint` 신뢰성 |
| PHP intelephense | .php | PHP 프로젝트 자동 설치 |
| 프리즘 | .prisma | `prisma` 명령 가능 |
| pyright | .py, .pyi | `pyright` 의존성 설치 |
| 루비-lsp(rubocop) | .rb, .rake, .gemspec, .ru | `ruby` 및 `gem` 명령 사용 가능 |
| 녹 | .rs | `rust-analyzer` 명령 가능 |
| sourcekit-lsp | .swift, .objc, .objcpp | `swift` 설치 (MacOS의 `xcode`) |
| svelte | .svelte | Svelte 프로젝트 자동 설치 |
| 지형 | .tf, .tfvars | GitHub 릴리스의 자동 설치 |
| 작문 | .typ, .typc | GitHub 릴리스의 자동 설치 |
| 인가정보 | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | 프로젝트의 `typescript` 의존성 |
| vue | .vue | Vue 프로젝트 자동 설치 |
| yaml-ls | .yaml, .yml | 자동 설치 Red Hat yaml-language-server |
| zls | .zig, .zon | `zig` 명령 가능 |
| LSP 서버 | 확장자 | 요구사항 |
| ------------------ | ------------------------------------------------------------------ | ----------------------------------------------------- |
| astro | .astro | Astro 프로젝트 자동 설치 |
| bash | .sh, .bash, .zsh, .ksh | bash-language-server 자동 설치 |
| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | C/C++ 프로젝트용 자동 설치 |
| csharp | .cs | `.NET SDK` 설치 |
| clojure-lsp | .clj, .cljs, .cljc, .edn | `clojure-lsp` 명령 사용 가능 |
| dart | .dart | `dart` 명령 사용 가능 |
| deno | .ts, .tsx, .js, .jsx, .mjs | `deno` 명령 사용 가능(deno.json/deno.jsonc 자동 감지) |
| elixir-ls | .ex, .exs | `elixir` 명령 사용 가능 |
| eslint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue | 프로젝트의 `eslint` 의존성 |
| fsharp | .fs, .fsi, .fsx, .fsscript | `.NET SDK` 설치 |
| gleam | .gleam | `gleam` 명령 사용 가능 |
| gopls | .go | `go` 명령 사용 가능 |
| hls | .hs, .lhs | `haskell-language-server-wrapper` 명령 사용 가능 |
| jdtls | .java | `Java SDK (version 21+)` 설치 |
| kotlin-ls | .kt, .kts | Kotlin 프로젝트용 자동 설치 |
| lua-ls | .lua | Lua 프로젝트용 자동 설치 |
| nixd | .nix | `nixd` 명령 사용 가능 |
| ocaml-lsp | .ml, .mli | `ocamllsp` 명령 사용 가능 |
| oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .ct, .vue, .astro, .svelte | 프로젝트의 `oxlint` 의존성 |
| PHP intelephense | .php | PHP 프로젝트 자동 설치 |
| prisma | .prisma | `prisma` 명령 사용 가능 |
| pyright | .py, .pyi | `pyright` 의존성 설치 |
| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru | `ruby` 및 `gem` 명령 사용 가능 |
| rust | .rs | `rust-analyzer` 명령 사용 가능 |
| sourcekit-lsp | .swift, .objc, .objcpp | `swift` 설치 (macOS의 `xcode`) |
| svelte | .svelte | Svelte 프로젝트 자동 설치 |
| terraform | .tf, .tfvars | GitHub 릴리스에서 자동 설치 |
| typst | .typ, .typc | GitHub 릴리스에서 자동 설치 |
| typescript | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | 프로젝트의 `typescript` 의존성 |
| vue | .vue | Vue 프로젝트 자동 설치 |
| yaml-ls | .yaml, .yml | Red Hat yaml-language-server 자동 설치 |
| zls | .zig, .zon | `zig` 명령 사용 가능 |
LSP 서버는 위의 파일 확장자 중 하나가 감지되고 요구 사항은 자동으로 활성화됩니다.
LSP 서버는 위 파일 확장자 중 하나가 감지되고 요구 사항이 충족되면 자동으로 활성화됩니다.
:::note
`OPENCODE_DISABLE_LSP_DOWNLOAD` 환경 변수를 `true`로 설정하여 자동 LSP 서버 다운로드를 비활성화 할 수 있습니다.
@@ -54,18 +54,18 @@ LSP 서버는 위의 파일 확장자 중 하나가 감지되고 요구 사항
---
## 그것이 작동하는 방법
## 작동 방식
opencode가 파일을 열 때, 그것은:
OpenCode가 파일을 열 때, 다음과 같이 작동합니다:
1. 모든 활성화된 LSP 서버에 대한 파일 확장을 확인합니다.
2. 이미 실행되지 않은 경우 적절한 LSP 서버를 시작합니다.
1. 활성화된 모든 LSP 서버에 대해 파일 확장자를 확인합니다.
2. 적절한 LSP 서버가 아직 실행 중이지 않다면 시작합니다.
---
## 구성
opencode 설정에서 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할 수 있습니다.
OpenCode 설정의 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할 수 있습니다.
```json title="opencode.json"
{
@@ -76,21 +76,21 @@ opencode 설정에서 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할
각 LSP 서버는 다음을 지원합니다:
| 재산 | 유형 | 묘사 |
| 속성 | 유형 | 설명 |
| ---------------- | -------- | --------------------------------------- |
| `disabled` | 불린 | LSP 서버를 비활성화하려면 `true`로 설정 |
| `command` | 문자열[] | LSP 서버를 시작하는 명령 |
| `extensions` | string[] | 이 LSP 서버 확장 |
| `env` | 객체 | 서버 시작시 설정할 환경 변수 |
| `initialization` | 객체 | LSP 서버에 보내는 초기화 옵션 |
| `disabled` | boolean | LSP 서버를 비활성화하려면 `true`로 설정 |
| `command` | string[] | LSP 서버를 시작하는 명령 |
| `extensions` | string[] | 이 LSP 서버의 확장자 |
| `env` | object | 서버 시작 시 설정할 환경 변수 |
| `initialization` | object | LSP 서버에 보내는 초기화 옵션 |
몇 가지 예제를 살펴 보자.
몇 가지 예제를 살펴봅시다.
---
## 환경 변수
`env` 속성을 사용하여 LSP 서버를 시작할 때 환경 변수를 설정하십시오.
`env` 속성을 사용하여 LSP 서버를 시작할 때 환경 변수를 설정합니다.
```json title="opencode.json" {5-7}
{
@@ -132,9 +132,9 @@ opencode 설정에서 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할
---
### LSP 서버를 해제
### LSP 서버 비활성화
전 세계적으로 ** 모든** LSP 서버를 비활성화하려면 `lsp`를 `false`로 설정하십시오.
전역적으로 **모든** LSP 서버를 비활성화하려면 `lsp`를 `false`로 설정하십시오.
```json title="opencode.json" {3}
{
@@ -143,7 +143,7 @@ opencode 설정에서 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할
}
```
** 특정** LSP 서버를 비활성화하려면 `disabled`를 `true`로 설정하십시오.
**특정** LSP 서버를 비활성화하려면 `disabled`를 `true`로 설정하십시오.
```json title="opencode.json" {5}
{
@@ -160,7 +160,7 @@ opencode 설정에서 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할
## 사용자 정의 LSP 서버
명령 및 파일 확장명을 지정하여 사용자 정의 LSP 서버를 추가할 수 있습니다.
명령어와 파일 확장자를 지정하여 사용자 정의 LSP 서버를 추가할 수 있습니다.
```json title="opencode.json" {4-7}
{
@@ -178,11 +178,11 @@ opencode 설정에서 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할
## 추가 정보
### PHP 인텔
### PHP Intelephense
PHP를 Intelephense는 라이센스 키를 통해 프리미엄 기능을 제공합니다. 텍스트 파일에서 키 (만)를 배치하여 라이센스 키를 제공 할 수 있습니다.
PHP Intelephense는 라이선스 키를 통해 프리미엄 기능을 제공합니다. 텍스트 파일에 키(만)를 저장하여 라이선스 키를 제공할 수 있습니다.
- macOS/리눅스에서: `$HOME/intelephense/license.txt`
- Windows에서: `%USERPROFILE%/intelephense/license.txt`
- macOS/Linux: `$HOME/intelephense/license.txt`
- Windows: `%USERPROFILE%/intelephense/license.txt`
파일에는 추가 내용이 없습니다.
파일에는 다른 내용이 없어야 합니다.

42
packages/web/src/content/docs/ko/mcp-servers.mdx
View File

@@ -1,6 +1,6 @@
---
title: MCP servers
description: Add local and remote MCP tools.
title: MCP 서버
description: 로컬 및 원격 MCP 도구를 추가하세요.
---
Model Context Protocol , 또는 MCP를 사용하여 opencode에 외부 도구를 추가할 수 있습니다. opencode는 로컬 및 원격 서버를 모두 지원합니다.
@@ -11,7 +11,7 @@ Model Context Protocol , 또는 MCP를 사용하여 opencode에 외부 도구를
#### 주의사항
MCP 서버를 사용할 때 상황에 추가합니다. 도구가 많이 있으면 신속하게 추가 할 수 있습니다. 그래서 우리는 당신이 사용하는 MCP 서버와 주의를 기울여야 합니다.
MCP 서버를 사용할 때 컨텍스트에 추가됩니다. 도구가 많으면 컨텍스트가 빠르게 채워질 수 있습니다. 그래서 우리는 당신이 사용하는 MCP 서버와 주의를 기울여야 합니다.
:::tip
MCP 서버는 귀하의 컨텍스트에 추가하므로, 활성화할 수 있는 것을 주의해야 합니다.
@@ -21,7 +21,7 @@ GitHub MCP 서버와 같은 특정 MCP 서버는 많은 토큰을 추가하고
---
## 사용 가능
## 구성
`mcp`에서 MCP 서버를 정의할 수 있습니다. 각 MCP를 고유 이름으로 추가합니다. LLM을 프롬프트할 때 MCP를 참조할 수 있습니다.
@@ -44,7 +44,7 @@ GitHub MCP 서버와 같은 특정 MCP 서버는 많은 토큰을 추가하고
---
### 원격 디폴트 overriding
### 원격 기본값 재정의
조직은 `.well-known/opencode` 엔드포인트를 통해 기본 MCP 서버를 제공 할 수 있습니다. 이 서버는 기본적으로 비활성화 될 수 있으며 사용자가 필요한 것들에 대해 선택 할 수 있습니다.
@@ -67,7 +67,7 @@ GitHub MCP 서버와 같은 특정 MCP 서버는 많은 토큰을 추가하고
---
## 지역
## 로컬
MCP 객체 내에서 `type`를 `"local"`로 사용하는 로컬 MCP 서버를 추가하십시오.
@@ -116,17 +116,17 @@ use the mcp_everything tool to add the number 3 and 4
로컬 MCP 서버를 구성하는 모든 옵션이 있습니다.
| 옵션 | 유형 | 필수 | 설명 |
| 옵션 | 타입 | 필수 | 설명 |
| ------------- | ------- | ---- | ----------------------------------------------------- |
| `type` | 문자열 | Y | MCP 서버 연결 유형은 `"local"`. |
| `command` | Array | Y | MCP 서버를 실행하는 명령과 인수. |
| `environment` | 개체 | | 서버 실행시 설정하는 환경 변수 |
| `enabled` | Boolean | | 시동에서 MCP 서버 사용 가능 |
| `timeout` | Number | | MCP 서버에서 태핑툴을 위한 타임아웃 기본 5000 (5 초). |
| `enabled` | boolean | | 시동에서 MCP 서버 사용 가능 |
| `timeout` | number | | MCP 서버에서 태핑툴을 위한 타임아웃 기본 5000 (5 초). |
---
## 리모트
## 원격
`type`를 `"remote"`로 설정하여 원격 MCP 서버를 추가하십시오.
@@ -152,14 +152,14 @@ use the mcp_everything tool to add the number 3 and 4
#### 옵션
| 옵션 | 유형 | 필수 | 설명 |
| 옵션 | 타입 | 필수 | 설명 |
| --------- | ------- | ---- | ----------------------------------------------------------- |
| `type` | 문자열 | Y | MCP 서버 연결 유형은 `"remote"`. |
| `url` | 문자열 | Y | 원격 MCP 서버의 URL. |
| `enabled` | Boolean | | 시동에서 MCP 서버 사용 가능 |
| `enabled` | boolean | | 시동에서 MCP 서버 사용 가능 |
| `headers` | 개체 | | 헤드러는 요청으로 보내드립니다. |
| `oauth` | 개체 | | OAuth 인증 구성 [OAuth](#oauth) 아래의 섹션을 참조하십시오. |
| `timeout` | Number | | MCP 서버에서 태핑툴을 위한 타임아웃 기본 5000 (5 초). |
| `timeout` | number | | MCP 서버에서 태핑툴을 위한 타임아웃 기본 5000 (5 초). |
---
@@ -173,7 +173,7 @@ opencode는 원격 MCP 서버에 대한 OAuth 인증을 자동으로 처리합
---
## 자동
## 자동 설정
대부분의 OAuth-enabled MCP 서버를 위해, 특별한 구성은 필요하지 않습니다. 원격 서버를 구성:
@@ -189,7 +189,7 @@ opencode는 원격 MCP 서버에 대한 OAuth 인증을 자동으로 처리합
}
```
서버가 인증이 필요한 경우, opencode는 먼저 사용하려고 할 때 인증됩니다. 그렇지 않다면, `opencode mcp auth <server-name>`를 사용하여 [manually 방아쇠](#authenticating)을 유발할 수 있습니다.
서버가 인증이 필요한 경우, opencode는 먼저 사용하려고 할 때 인증됩니다. 그렇지 않다면, `opencode mcp auth <server-name>`를 사용하여 [수동으로 트리거](#authenticating)할 수 있습니다.
---
@@ -295,9 +295,9 @@ MCP는 opencode의 도구로 사용할 수 있으며 내장 도구와 함께 사
---
## 글로벌
## 전역
이것은 당신이 활성화하거나 전 세계적으로 비활성화 할 수 있다는 것을 의미합니다.
이는 전역적으로 활성화하거나 비활성화할 수 있음을 의미합니다.
```json title="opencode.json" {14}
{
@@ -318,7 +318,7 @@ MCP는 opencode의 도구로 사용할 수 있으며 내장 도구와 함께 사
}
```
우리는 또한 모든 일치 MCPs를 비활성화하는 glob 패턴을 사용할 수 있습니다.
또한 glob 패턴을 사용하여 일치하는 모든 MCP를 비활성화할 수 있습니다.
```json title="opencode.json" {14}
{
@@ -343,9 +343,9 @@ MCP는 opencode의 도구로 사용할 수 있으며 내장 도구와 함께 사
---
## 에이전트 당
## 에이전트별
MCP 서버의 많은 수를 가지고 있다면 에이전트 당만 활성화하고 전 세계적으로 비활성화 할 수 있습니다. 이 작업을 수행:
많은 MCP 서버가 있다면 전역적으로는 비활성화하고 에이전트별로만 활성화할 수 있습니다. 이 작업을 수행:
1. 글로벌 도구로 사용 가능.
2. [agent config](/docs/agents#tools)에서 MCP 서버를 도구로 사용할 수 있습니다.
@@ -375,7 +375,7 @@ MCP 서버의 많은 수를 가지고 있다면 에이전트 당만 활성화하
---
### 글로브 패턴
### Glob 패턴
glob 패턴은 간단한 regex globbing 패턴을 사용합니다 :

40
packages/web/src/content/docs/ko/models.mdx
View File

@@ -1,6 +1,6 @@
---
title: Models
description: Configuring an LLM provider and model.
title: 모델
description: LLM 공급자 및 모델 구성.
---
opencode는 [AI SDK](https://ai-sdk.dev/) 및 [Models.dev](https://models.dev)를 사용하여 **75+ LLM 제공 업체**를 지원하며 로컬 모델을 실행합니다.
@@ -9,7 +9,7 @@ opencode는 [AI SDK](https://ai-sdk.dev/) 및 [Models.dev](https://models.dev)
## 공급자
가장 인기 있는 공급자는 기본적으로 preloaded. `/connect` 명령을 통해 공급자를위한 자격 증명을 추가하면 opencode를 시작할 때 사용할 수 있습니다.
가장 인기 있는 공급자는 기본적으로 미리 로드되어 있습니다. `/connect` 명령을 통해 공급자를위한 자격 증명을 추가하면 opencode를 시작할 때 사용할 수 있습니다.
자세히 알아보기 [providers](/docs/providers).
@@ -27,22 +27,22 @@ opencode는 [AI SDK](https://ai-sdk.dev/) 및 [Models.dev](https://models.dev)
## 추천 모델
거기에 많은 모델이 있습니다, 새로운 모델이 매주 온다.
수많은 모델이 있으며, 매주 새로운 모델이 출시됩니다.
:::tip
우리가 추천하는 모델 중 하나를 사용하여 고려하십시오.
:::
그러나 코드와 도구 호출 모두에서 좋은 그들 중 몇 가지가있다.
하지만 코드 작성과 도구 호출 모두에서 뛰어난 성능을 보이는 모델들이 있습니다.
다음은 opencode와 잘 작동하는 몇 가지 모델입니다. 특히 주문이 없습니다. (이것은 철저한 목록이 아니며 반드시 날짜까지입니다) :
특별한 순서는 없습니다. (이 목록은 전체 목록이 아니며 최신 상태가 아닐 수 있습니다):
- GPT의 5.2
- GPT 5.1 코덱
- 클로드 오푸스 4.5
- 클로드 Sonnet 4.5
- 소형 M2.1
- Gemini 3 프로
- GPT 5.2
- GPT 5.1 Codex
- Claude Opus 4.5
- Claude Sonnet 4.5
- M2.1
- Gemini 3 Pro
---
@@ -100,7 +100,7 @@ config를 통해 모델의 옵션을 구성할 수 있습니다.
}
```
여기에 우리는 두 개의 내장 모델에 대한 글로벌 설정을 구성 : `gpt-5`를 통해 액세스 할 때 `openai` 공급자 및 `claude-sonnet-4-20250514`는 `anthropic` 공급자를 통해 액세스 할 때.
여기서는 두 개의 내장 모델에 대한 전역 설정을 구성합니다: `gpt-5`를 통해 액세스 할 때 `openai` 공급자 및 `claude-sonnet-4-20250514`는 `anthropic` 공급자를 통해 액세스 할 때.
내장 공급자 및 모델 이름은 [Models.dev](https://models.dev)에서 찾을 수 있습니다.
사용중인 에이전트에 이러한 옵션을 구성할 수 있습니다. 에이전트 구성은 여기에 모든 글로벌 옵션을 overrides. [더 알아보기](/docs/agents/#additional).
@@ -135,9 +135,9 @@ config를 통해 모델의 옵션을 구성할 수 있습니다.
---
## 참배
## 변형
다른 구성을 가진 많은 모형 지원 다수 변종. opencode는 인기있는 공급자를위한 기본 변형으로 배송됩니다.
많은 모델이 다양한 구성의 변형(variant)을 지원합니다. opencode는 인기있는 공급자를위한 기본 변형으로 배송됩니다.
## 내장 변형
@@ -145,15 +145,15 @@ opencode는 많은 공급자를 위한 기본 변종으로 발송합니다:
**Anthropic**:
- `high` - 높은 생각 예산 (기본)
- `high` - 높은 생각(Thinking) 예산 (기본)
- `max` - 최대 생각 예산
** OpenAI **:
모델에 따라 다릅니다.
- `none` - 이유 없음
- `minimal` - 미니멀 이유 노력
- `none` - 추론(Reasoning) 없음
- `minimal` - 최소 추론 노력
- `low` - 낮은 이유 노력
- `medium` - 중간 이유 노력
- `high` - 높은 이유 노력
@@ -195,13 +195,13 @@ opencode는 많은 공급자를 위한 기본 변종으로 발송합니다:
}
```
## 사이클 변형
## 변형 순환
keybind `variant_cycle`를 사용하여 변형 사이 신속하게 전환합니다. [더 알아보기](/docs/keybinds).
---
## 로딩 모델
## 모델 로딩 순서
opencode가 시작될 때, 다음의 우선순위 순서에 있는 모형을 검사합니다:

44
packages/web/src/content/docs/ko/modes.mdx
View File

@@ -1,11 +1,11 @@
---
title: Modes
description: Different modes for different use cases.
title: 모드
description: 다양한 사용 사례를 위한 다양한 모드.
---
:::caution
모드는 opencode 설정에서 `agent` 옵션을 통해 구성되어 있습니다. 더 보기
`mode` 옵션이 이제 비활성화되었습니다. [더 알아보기](/docs/시약).
`mode` 옵션이 이제 비활성화되었습니다. [더 알아보기](/docs/agents).
:::
opencode의 모드는 다른 사용 사례에 대한 행동, 도구 및 프롬프트를 사용자 정의 할 수 있습니다.
@@ -116,7 +116,7 @@ Markdown 파일 이름은 모드 이름 (예 : `review.md`는 `review` 모드를
---
### 모형
### 모델
`model` config를 사용하여 이 모드의 기본 모델을 무시합니다. 다른 작업에 최적화 된 다른 모델을 사용하는 데 유용합니다. 예를 들어, 계획을위한 빠른 모델, 구현을위한 더 많은 모델.
@@ -152,7 +152,7 @@ Markdown 파일 이름은 모드 이름 (예 : `review.md`는 `review` 모드를
온도 값은 일반적으로 0.0에서 1.0에 배열합니다:
- **0.0-0.2**: 매우 집중하고 신중한 응답, 코드 분석 및 계획에 이상 -**0.3-0.5**: 일부 창의력과 균형 잡힌 응답, 일반 개발 작업에 좋은
- **0.6-1.0**: 더 창조적이고 다양한 응답, 뇌하수 및 탐험에 유용한
- **0.6-1.0**: 더 창조적이고 다양한 응답, 브레인스토밍 및 탐험에 유용한
```json title="opencode.json"
{
@@ -220,23 +220,23 @@ Markdown 파일 이름은 모드 이름 (예 : `review.md`는 `review` 모드를
---
### 유효한 공구
### 유효한 도구
여기에 모든 도구는 모드 구성을 통해 제어 할 수 있습니다.
| 도구 | 설명 |
| ----------- | ------------------ |
| `bash` | shell 명령 실행 |
| `edit` | 기존 파일 수정 |
| `write` | 새 파일 만들기 |
| `read` | 읽는 파일 내용 |
| `grep` | 파일 검색 |
| `glob` | 패턴으로 찾기 |
| `list` | 디렉토리 내용 보기 |
| `patch` | 파일에 패치 적용 |
| `todowrite` | 도도 목록 관리 |
| `todoread` | 읽는 도 목록 |
| `webfetch` | 사이트 맵 |
| 도구 | 설명 |
| ----------- | --------------------- |
| `bash` | shell 명령 실행 |
| `edit` | 기존 파일 수정 |
| `write` | 새 파일 만들기 |
| `read` | 읽는 파일 내용 |
| `grep` | 파일 검색 |
| `glob` | 패턴으로 찾기 |
| `list` | 디렉토리 내용 보기 |
| `patch` | 파일에 패치 적용 |
| `todowrite` | 할 일(Todo) 목록 관리 |
| `todoread` | 할 일(Todo) 목록 읽기 |
| `webfetch` | 웹사이트 가져오기 |
---
@@ -321,9 +321,9 @@ Priorities:
다음은 다른 모드에 대한 일반적인 사용 사례입니다.
- **빌딩 모드**: 모든 도구와 함께 전체 개발 작업
- **플랜 모드**: 변화없이 분석 및 계획 -**Review 모드**: Code review with read-only access plus 문서 도구
- ** 디버그 모드**: bash 및 읽기 도구와 함께 조사에 집중
- **Build 모드**: 모든 도구와 함께 전체 개발 작업
- **Plan 모드**: 변화없이 분석 및 계획 -**Review 모드**: Code review with read-only access plus 문서 도구
- **Debug 모드**: bash 및 읽기 도구와 함께 조사에 집중
- **Docs 모드**: 파일 작업과 문서 작성하지만 시스템 명령 없음
다른 모델을 찾을 수 있습니다 다른 사용 케이스에 대 한 좋은.

4
packages/web/src/content/docs/ko/network.mdx
View File

@@ -1,6 +1,6 @@
---
title: Network
description: Configure proxies and custom certificates.
title: 네트워크
description: 프록시 및 사용자 정의 인증서 구성.
---
opencode는 엔터프라이즈 네트워크 환경을 위한 표준 프록시 환경 변수 및 사용자 지정 인증서를 지원합니다.

16
packages/web/src/content/docs/ko/permissions.mdx
View File

@@ -1,6 +1,6 @@
---
title: Permissions
description: Control which actions require approval to run.
title: 권한
description: 실행 승인이 필요한 작업을 제어합니다.
---
opencode는 주어진 동작이 자동으로 실행되는지 결정하기 위해 `permission` config를 사용하거나 차단합니다.
@@ -9,7 +9,7 @@ opencode는 주어진 동작이 자동으로 실행되는지 결정하기 위해
---
## 활동
## 동작
각 권한 규칙은 다음과 같습니다:
@@ -45,7 +45,7 @@ opencode는 주어진 동작이 자동으로 실행되는지 결정하기 위해
---
## 과립 규칙 (Object Syntax)
## 세부 규칙 (객체 구문)
대부분의 권한을 위해 도구 입력을 기반으로 다른 작업을 적용 할 수 있습니다.
@@ -86,7 +86,7 @@ Permission 본 사용 간단한 wildcard 일치:
- `$HOME/projects/*` -> `/Users/username/projects/*`
- `~` -> `/Users/username`
## 외부 감독
## 외부 디렉터리
`external_directory`를 사용하여 도구가 opencode가 시작된 작업 디렉토리 밖에 터치 경로가 호출되도록합니다. 이것은 입력 (예 : `read`, `edit`, `list`, `glob`, `glob`, `grep` 및 많은 `bash` 명령)로 경로를 수행하는 모든 도구에 적용됩니다.
@@ -135,7 +135,7 @@ opencode 권한은 도구 이름에 의해 키 입력되며, 두 개의 안전
- `grep` - 콘텐츠 검색 ( regex 패턴 매칭)
- `list` - 디렉토리의 목록 파일 (폴더 경로 매칭)
- `bash` - shell 명령 실행 (`git status --porcelain`와 같은 팟 명령)
- `task` - 시약 출시 (미시 시약 유형)
- `task` - 에이전트 실행 (작업 에이전트 유형)
- `skill` - 기술을 로딩 (기술 이름을 매칭)
- `lsp` - LSP 쿼리 실행 (현재 비 과립)
- `todoread`, `todowrite` - 토도 목록의 읽기 / 업데이트
@@ -146,7 +146,7 @@ opencode 권한은 도구 이름에 의해 키 입력되며, 두 개의 안전
---
## 기본
## 기본값
아무것도 지정하지 않는 경우, opencode는 permissive 기본값에서 시작합니다.
@@ -169,7 +169,7 @@ opencode 권한은 도구 이름에 의해 키 입력되며, 두 개의 안전
---
## "Ask"는 무엇입니까?
## "Ask"란 무엇입니까?
opencode가 승인되면 UI는 세 가지 결과를 제공합니다.

26
packages/web/src/content/docs/ko/plugins.mdx
View File

@@ -1,6 +1,6 @@
---
title: Plugins
description: Write your own plugins to extend opencode.
title: 플러그인
description: OpenCode를 확장하기 위해 자신만의 플러그인을 작성하세요.
---
플러그인은 다양한 이벤트와 사용자 정의 행동으로 후킹하여 opencode를 확장 할 수 있습니다. 플러그인을 만들 수 있습니다 새로운 기능을 추가, 외부 서비스와 통합, 또는 opencode의 기본 동작을 수정.
@@ -15,7 +15,7 @@ description: Write your own plugins to extend opencode.
---
## 현지 파일에서
## 로컬 파일에서
플러그인 디렉토리에 JavaScript 또는 TypeScript 파일을 배치합니다.
@@ -26,7 +26,7 @@ description: Write your own plugins to extend opencode.
---
### 부터 npm
### npm에서
config 파일에 npm 패키지를 지정합니다.
@@ -45,22 +45,22 @@ config 파일에 npm 패키지를 지정합니다.
## 플러그인이 설치되는 방법
**npm 플러그인**는 시작시 Bun을 사용하여 자동으로 설치됩니다. 패키지와 그들의 의존성은 `~/.cache/opencode/node_modules/`에서 캐시됩니다.
**npm 플러그인**은 시작시 Bun을 사용하여 자동으로 설치됩니다. 패키지와 그들의 의존성은 `~/.cache/opencode/node_modules/`에서 캐시됩니다.
**Local 플러그인 ** 플러그인 디렉토리에서 직접로드됩니다. 외부 패키지를 사용하려면 구성 디렉토리 내 `package.json`를 작성해야 합니다 ([Dependencies](#dependencies)), 또는 플러그인을 npm에 게시하고 [config에 추가](/docs/config#plugins).
**로컬 플러그인**은 플러그인 디렉토리에서 직접로드됩니다. 외부 패키지를 사용하려면 구성 디렉토리 내 `package.json`를 작성해야 합니다 ([Dependencies](#dependencies)), 또는 플러그인을 npm에 게시하고 [config에 추가](/docs/config#plugins).
---
## 짐 순서
## 로드 순서
플러그인은 모든 소스에서로드되며 모든 후크는 순서대로 실행됩니다. 짐 순서는:
플러그인은 모든 소스에서로드되며 모든 후크는 순서대로 실행됩니다. 로드 순서는 다음과 같습니다:
1. 글로벌 구성 (`~/.config/opencode/opencode.json`)
2. 프로젝트 구성 (`opencode.json`)
3. 글로벌 플러그인 디렉토리 (`~/.config/opencode/plugins/`)
4. 프로젝트 플러그인 디렉토리 (`.opencode/plugins/`)
동일한 이름과 버전을 가진 중복 npm 포장은 한 번 적재됩니다. 하지만, 로컬 플러그인과 같은 이름과 npm 플러그인은 모두 별도로로드됩니다.
중복 npm 패키지는 한 번만 로드됩니다. 하지만, 로컬 플러그인과 같은 이름과 npm 플러그인은 모두 별도로로드됩니다.
---
@@ -71,7 +71,7 @@ config 파일에 npm 패키지를 지정합니다.
---
### 종점
### 의존성
로컬 플러그인 및 사용자 정의 도구는 외부 npm 패키지를 사용할 수 있습니다. `package.json`를 config 디렉토리에 추가하면 필요한 의존도가 있습니다.
@@ -192,7 +192,7 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree
- `todo.updated`
#### Shell 이벤트
#### 셸 이벤트
- `shell.env`
@@ -331,7 +331,7 @@ export const MyPlugin = async ({ client }) => {
---
## Compaction 걸이
## Compaction 훅
세션이 압축 될 때 포함 된 컨텍스트를 사용자 지정:
@@ -355,7 +355,7 @@ Include any state that should persist across compaction:
}
```
LLM의 앞에 `experimental.session.compacting` 걸이 불은 오염 요약을 생성합니다. 기본 압축 프롬프트가 놓을 수 있도록 도메인 별 컨텍스트를 주입합니다.
LLM이 압축 요약을 생성하기 전에 `experimental.session.compacting` 훅이 실행됩니다. 기본 압축 프롬프트를 대체할 수 있도록 도메인 별 컨텍스트를 주입합니다.
당신은 또한 `output.prompt`를 조정해서 조밀함을 전적으로 대체할 수 있습니다:

365
packages/web/src/content/docs/ko/providers.mdx
View File

@@ -1,37 +1,36 @@
---
title: Providers
description: Using any LLM provider in opencode.
title: 공급자
description: OpenCode에서 LLM 공급자를 사용합니다.
---
import config from "../../../../config.mjs"
export const console = config.console
opencode는 [AI SDK](https://ai-sdk.dev/) 및 [Models.dev](https://models.dev)를 사용하여 **75+ LLM 제공 업체**를 지원하며 로컬 모델을 실행합니다.
OpenCode는 [AI SDK](https://ai-sdk.dev/) 및 [Models.dev](https://models.dev)를 사용하여 **75개 이상의 LLM 공급자**를 지원하며 로컬 모델도 실행할 수 있습니다.
필요한 공급자를 추가하려면:
1. `/connect` 명령을 사용하여 공급자를 위한 API 열쇠를 추가하십시오.
2. opencode config에 있는 공급자를 구성하십시오.
1. `/connect` 명령을 사용하여 공급자의 API 키를 추가하십시오.
2. OpenCode 구성에서 공급자를 구성하십시오.
---
### 등급
### 자격 증명
공급자의 API 키를 `/connect` 명령으로 추가하면 저장됩니다.
`~/.local/share/opencode/auth.json`에서.
`/connect` 명령으로 공급자의 API 키를 추가하면 다음 위치에 저장됩니다:
`~/.local/share/opencode/auth.json`
---
#### 콘피그
#### 구성
opencode의 `provider` 섹션을 통해 공급자를 사용자 정의 할 수 있습니다.
설정.
OpenCode 설정의 `provider` 섹션을 통해 공급자를 사용자 정의할 수 있습니다.
---
### 기본 URL
`baseURL` 옵션을 설정하여 모든 공급자를위한 기본 URL을 사용자 정의 할 수 있습니다. 프록시 서비스 또는 사용자 정의 엔드포인트를 사용할 때 유용합니다.
`baseURL` 옵션을 설정하여 모든 공급자를 위한 기본 URL을 사용자 정의할 수 있습니다. 프록시 서비스 또는 사용자 정의 엔드포인트를 사용할 때 유용합니다.
```json title="opencode.json" {6}
{
@@ -48,24 +47,23 @@ opencode의 `provider` 섹션을 통해 공급자를 사용자 정의 할 수
---
## opencode 젠
## OpenCode Zen
OpenCode Zen은 opencode 팀이 제공하는 모델 목록입니다.
opencode와 잘 작동하도록 테스트 및 검증. [더 알아보기](/docs/zen).
OpenCode Zen은 OpenCode 팀이 OpenCode와 잘 작동하도록 테스트하고 검증한 모델 목록입니다. [더 알아보기](/docs/zen).
:::tip
새로운 경우, OpenCode Zen로 시작하는 것이 좋습니다.
처음이라면 OpenCode Zen으로 시작하는 것이 좋습니다.
:::
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
@@ -74,30 +72,29 @@ opencode와 잘 작동하도록 테스트 및 검증. [더 알아보기](/docs/z
└ enter
```
4. TUI의 `/models`를 실행하여 우리가 추천하는 모델 목록을 볼 수 있습니다.
4. TUI에서 `/models`를 실행하여 추천 모델 목록을 볼 수 있습니다.
```txt
/models
```
opencode의 다른 공급자와 같이 작동하고 사용하기에 완전히 선택적입니다.
OpenCode의 다른 공급자처럼 작동하며 사용은 완전히 선택 사항입니다.
---
## 디렉토리
세부사항에 있는 공급자의 몇몇을 보십시오. 공급자를 추가하려는 경우
목록, PR을 무료로 엽니 다.
공급자 세부 정보를 확인하세요. 목록에 공급자를 추가하려면 PR을 열어주세요.
:::note
여기에서 공급자를 볼 수 없습니다? PR 제출
원하는 공급자가 없나요? PR을 제출해 주세요.
:::
---
### 302.AI
1. [302.AI 콘솔](https://302.ai/)에 머리, 계정을 만들고 API 키를 생성합니다.
1. [302.AI 콘솔](https://302.ai/)로 이동하여 계정을 만들고 API 키를 생성합니다.
2. `/connect` 명령을 실행하고 **302.AI**를 검색하십시오.
@@ -122,22 +119,21 @@ opencode의 다른 공급자와 같이 작동하고 사용하기에 완전히
---
### 아마존 베드록
### Amazon Bedrock
opencode로 Amazon Bedrock을 사용하려면:
OpenCode로 Amazon Bedrock을 사용하려면:
1. Amazon Bedrock 콘솔 및 요청에서 ** 모델 카탈로그**에 머리
원하는 모델에 액세스.
1. Amazon Bedrock 콘솔의 **Model catalog**로 이동하여 원하는 모델에 대한 액세스를 요청합니다.
:::tip
Amazon Bedrock에서 원하는 모델에 액세스해야합니다.
Amazon Bedrock에서 원하는 모델에 대한 액세스 권한이 있어야 합니다.
:::
2. ** 설정** 다음 방법 중 하나를 사용하여:
2. 다음 방법 중 하나를 사용하여 **설정**합니다:
### 환경 변수 (빠른 시작)
opencode를 실행하는 동안 이러한 환경 변수 중 하나를 설정:
OpenCode를 실행하는 동안 다음 환경 변수 중 하나를 설정합니다:
```bash
# Option 1: Using AWS access keys
@@ -150,16 +146,16 @@ opencode를 실행하는 동안 이러한 환경 변수 중 하나를 설정:
AWS_BEARER_TOKEN_BEDROCK=XXX opencode
```
또는 bash 프로필에 추가:
또는 bash 프로필에 추가합니다:
```bash title="~/.bash_profile"
export AWS_PROFILE=my-dev-profile
export AWS_REGION=us-east-1
```
#### 설정 파일 (추천)
#### 설정 파일 (권장)
프로젝트 별 또는 지속적 구성의 경우 `opencode.json`를 사용하십시오.
프로젝트별 또는 영구 구성을 위해 `opencode.json`을 사용하십시오.
```json title="opencode.json"
{
@@ -175,14 +171,14 @@ opencode를 실행하는 동안 이러한 환경 변수 중 하나를 설정:
}
```
** 유효한 옵션:**
**유효한 옵션:**
- `region` - AWS 지역 (예: `us-east-1`, `eu-west-1`)
- `profile` - AWS는 `~/.aws/credentials`에서 단면도를 지명했습니다
- `endpoint` - VPC 엔드 포인트에 대한 사용자 정의 엔드 포인트 URL (일반 `baseURL` 옵션 별)
- `region` - AWS 리전 (예: `us-east-1`, `eu-west-1`)
- `profile` - `~/.aws/credentials`의 AWS 프로필 이름
- `endpoint` - VPC 엔드포인트 등을 위한 사용자 정의 엔드포인트 URL (일반 `baseURL` 옵션의 별칭)
:::tip
구성 파일 옵션은 환경 변수에 대한 precedence를 가져옵니다.
구성 파일 옵션은 환경 변수보다 우선 순위가 높습니다.
:::
#### 고급: VPC 엔드포인트
@@ -205,36 +201,35 @@ Bedrock의 VPC 엔드포인트를 사용하는 경우:
```
:::note
`endpoint` 옵션은 일반적인 `baseURL` 옵션의 별칭입니다. `endpoint`와 `baseURL` 둘 다 지정되는 경우에, `endpoint`는 전진합니다.
`endpoint` 옵션은 일반적인 `baseURL` 옵션의 별칭입니다. `endpoint`와 `baseURL` 둘 다 지정된 경우 `endpoint`가 우선합니다.
:::
#### 인증 방법
-**`AWS_ACCESS_KEY_ID`/`AWS_SECRET_ACCESS_KEY`**: IAM 사용자 생성 및 AWS 콘솔에서 액세스 키를 생성
- **`AWS_ACCESS_KEY_ID`/`AWS_SECRET_ACCESS_KEY`**: IAM 사용자 및 AWS 콘솔에서 액세스 키 생성
- **`AWS_PROFILE`**: `~/.aws/credentials`의 프로필 이름을 사용합니다. `aws configure --profile my-profile` 또는 `aws sso login`으로 먼저 구성하십시오.
- **`AWS_BEARER_TOKEN_BEDROCK`**: Amazon Bedrock 콘솔에서 임시 API 키 생성
- **`AWS_WEB_IDENTITY_TOKEN_FILE` / `AWS_ROLE_ARN`**: EKS IRSA (서비스 계정용 IAM 역할) 또는 다른 Kubernetes 환경의 OIDC 연동. 이 환경 변수는 서비스 계정을 사용할 때 Kubernetes에 의해 자동으로 주입됩니다.
- **`AWS_PROFILE`**: `~/.aws/credentials`의 프로필 이름을 사용합니다. `aws configure --profile my-profile` 또는 `aws sso login`로 첫번째 구성
- **`AWS_BEARER_TOKEN_BEDROCK`**: Amazon Bedrock 콘솔에서 장기적인 API 키 생성
- **`AWS_WEB_IDENTITY_TOKEN_FILE` / `AWS_ROLE_ARN`**: EKS IRSA (서비스 계정을위한IAM 역할) 또는 OIDC federation과 다른 쿠버네티스 환경. 이 환경 변수는 서비스 계정 할당을 사용할 때 쿠버네티스에 의해 자동으로 주사됩니다.
#### 인증
#### 인증 우선 순위
Amazon Bedrock은 다음과 같은 인증 우선 순위를 사용합니다.
1. ** 브라우저 토큰 ** - `AWS_BEARER_TOKEN_BEDROCK` 환경 변수 또는 `/connect` 명령에서 토큰
2. **AWS Credential Chain ** - 프로필, 액세스 키, 공유 자격 증명, IAM 역할, 웹 ID 토큰 (EKS IRSA), 인스턴스 메타 데이터
1. **Bearer Token** - `AWS_BEARER_TOKEN_BEDROCK` 환경 변수 또는 `/connect` 명령의 토큰
2. **AWS Credential Chain** - 프로필, 액세스 키, 공유 자격 증명, IAM 역할, 웹 ID 토큰 (EKS IRSA), 인스턴스 메타데이터
:::note
Bearer 토큰을 설정할 때 (`/connect` 또는 `AWS_BEARER_TOKEN_BEDROCK`를 통해), 구성 된 프로파일을 포함한 모든 AWS 자격 방법을 통해 우선 순위가됩니다.
Bearer 토큰을 설정할 때 (`/connect` 또는 `AWS_BEARER_TOKEN_BEDROCK`를 통해), 구성된 프로필을 포함한 모든 AWS 자격 증명 방법보다 우선 순위가 높습니다.
:::
3. 당신이 원하는 모형을 선정하기 위하여 `/models` 명령을 실행하십시오.
3. `/models` 명령을 실행하여 원하는 모델을 선택하십시오.
```txt
/models
```
:::note
custom inference profiles를 위해, 열쇠에 있는 모형 그리고 공급자 이름을 사용하고 arn에 `id` 재산을 놓습니다. 이것은 정확한 캐싱을 지킵니다:
사용자 정의 추론 프로필(custom inference profiles)의 경우, 키에 모델과 공급자 이름을 사용하고 `id` 속성에 ARN을 설정하십시오. 이렇게 하면 올바른 캐싱이 보장됩니다:
```json title="opencode.json"
{
@@ -256,16 +251,15 @@ custom inference profiles를 위해, 열쇠에 있는 모형 그리고 공급자
---
#### 안토픽
#### Anthropic
1. 가입하면 `/connect` 명령을 실행하고 Anthropic을 선택합니다.
1. 가입 후 `/connect` 명령을 실행하고 **Anthropic**을 선택합니다.
```txt
/connect
```
2. **Claude Pro/Max** 옵션을 선택하고 브라우저를 열 수 있습니다.
자주 묻는 질문
2. **Claude Pro/Max** 옵션을 선택하면 브라우저가 열립니다.
```txt
┌ Select auth method
@@ -276,39 +270,38 @@ custom inference profiles를 위해, 열쇠에 있는 모형 그리고 공급자
└
```
3. 이제 모든 Anthropic 모델은 `/models` 명령을 사용할 때 사용할 수 있어야합니다.
3. 이제 `/models` 명령을 사용할 때 모든 Anthropic 모델을 사용할 수 있습니다.
```txt
/models
```
:::info
opencode의 Claude Pro/Max 구독을 사용하여 [Anthropic](https://anthropic.com)에서 공식적으로 지원되지 않습니다.
OpenCode에서 Claude Pro/Max 구독을 사용하는 것은 [Anthropic](https://anthropic.com)에서 공식적으로 지원하지 않습니다.
:::
##### API 키 사용
Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니다. 브라우저를 열고 Anthropic에 로그인하고 terminal에서 붙여넣을 수있는 코드를 제공합니다.
Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니다. 브라우저가 열리고 Anthropic에 로그인한 후 터미널에 붙여넣을 수 있는 코드를 제공합니다.
또는 이미 API 키가 있다면, ** 수동으로 API Key**를 입력하고 terminal에서 붙여넣을 수 있습니다.
또는 이미 API 키가 있다면, **Manually enter API Key**를 선택하고 터미널에 붙여넣을 수 있습니다.
---
### Azure OpenAI
:::note
"나는 미안 해요, 하지만 나는 그 요청을 지원할 수 없습니다" 오류, 에서 콘텐츠 필터를 변경 시도 **DefaultV2**에서 **Default**로 당신의 Azure 자원에.
"I'm sorry, but I can't support that request" 오류가 발생하면, Azure 리소스의 콘텐츠 필터를 **DefaultV2**에서 **Default**로 변경해 보세요.
:::
1. [Azure 포털](https://portal.azure.com/) 이상으로 머리와 **Azure OpenAI** 리소스를 만듭니다. 당신은 필요로 할 것이다:
- **소스 이름**: 이것은 API 엔드 포인트의 일부가됩니다 (`https://RESOURCE_NAME.openai.azure.com/`)
- ** API 키**: `KEY 1` 또는 당신의 자원에서 `KEY 2`
1. [Azure 포털](https://portal.azure.com/)로 이동하여 **Azure OpenAI** 리소스를 만듭니다. 다음이 필요합니다:
- **리소스 이름**: API 엔드포인트의 일부가 됩니다 (`https://RESOURCE_NAME.openai.azure.com/`)
- **API 키**: 리소스의 `KEY 1` 또는 `KEY 2`
2. [Azure AI Foundry](https://ai.azure.com/)로 이동하여 모델을 배포합니다.
:::note
배포 이름은 제대로 작동하려면 opencode의 모델 이름을 일치해야합니다.
배포 이름은 제대로 작동하려면 OpenCode의 모델 이름과 일치해야 합니다.
:::
3. `/connect` 명령을 실행하고 **Azure**를 검색하십시오.
@@ -326,19 +319,19 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니
└ enter
```
5. 환경 변수로 리소스 이름을 설정:
5. 리소스 이름을 환경 변수로 설정:
```bash
AZURE_RESOURCE_NAME=XXX opencode
```
또는 bash 프로파일에 추가:
또는 bash 프로필에 추가:
```bash title="~/.bash_profile"
```bash title="~/.bash_profile"
export AZURE_RESOURCE_NAME=XXX
```
```
6. `/models` 명령을 실행하여 배포 된 모델을 선택하십시오.
6. `/models` 명령을 실행하여 배포된 모델을 선택하십시오.
```txt
/models
@@ -346,17 +339,16 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니
---
### Azure Cognitive 서비스
### Azure Cognitive Services
1. [Azure 포털](https://portal.azure.com/) 이상으로 머리와 **Azure OpenAI** 리소스를 만듭니다. 당신은 필요로 할 것이다:
- **소스 이름**: 이것은 API 엔드 포인트의 일부가됩니다 (`https://AZURE_COGNITIVE_SERVICES_RESOURCE_NAME.cognitiveservices.azure.com/`)
- ** API 키**: `KEY 1` 또는 당신의 자원에서 `KEY 2`
1. [Azure 포털](https://portal.azure.com/)로 이동하여 **Azure OpenAI** 리소스를 만듭니다. 다음이 필요합니다:
- **리소스 이름**: API 엔드포인트의 일부가 됩니다 (`https://AZURE_COGNITIVE_SERVICES_RESOURCE_NAME.cognitiveservices.azure.com/`)
- **API 키**: 리소스의 `KEY 1` 또는 `KEY 2`
2. [Azure AI Foundry](https://ai.azure.com/)로 이동하여 모델을 배포합니다.
:::note
배포 이름은 제대로 작동하려면 opencode의 모델 이름을 일치해야합니다.
배포 이름은 제대로 작동하려면 OpenCode의 모델 이름과 일치해야 합니다.
:::
3. `/connect` 명령을 실행하고 **Azure Cognitive Services**를 검색하십시오.
@@ -374,19 +366,19 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니
└ enter
```
5. 환경 변수로 리소스 이름을 설정:
5. 리소스 이름을 환경 변수로 설정:
```bash
AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX opencode
```
또는 bash 프로파일에 추가:
또는 bash 프로필에 추가:
```bash title="~/.bash_profile"
```bash title="~/.bash_profile"
export AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX
```
```
6. `/models` 명령을 실행하여 배포 된 모델을 선택하십시오.
6. `/models` 명령을 실행하여 배포된 모델을 선택하십시오.
```txt
/models
@@ -394,11 +386,11 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니
---
#### 기본
#### Baseten
1. [Baseten](https://app.baseten.co/)에 머리는, 계정을 만들고, API 열쇠를 생성합니다.
1. [Baseten](https://app.baseten.co/)으로 이동하여 계정을 만들고 API 키를 생성합니다.
2. `/connect` 명령을 실행하고 **Baseten**를 검색하십시오.
2. `/connect` 명령을 실행하고 **Baseten**을 검색하십시오.
```txt
/connect
@@ -421,9 +413,9 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니
---
#### Cerebras의
#### Cerebras
1. [Cerebras 콘솔](https://inference.cerebras.ai/)에 머리, 계정을 만들고 API 키를 생성합니다.
1. [Cerebras 콘솔](https://inference.cerebras.ai/)로 이동하여 계정을 만들고 API 키를 생성합니다.
2. `/connect` 명령을 실행하고 **Cerebras**를 검색하십시오.
@@ -440,7 +432,7 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니
└ enter
```
4. `/models` 명령을 실행하여 같은 모델을 선택하십시오 Qwen 3 Coder 480B .
4. `/models` 명령을 실행하여 모델(예: Qwen 3 Coder 480B)을 선택하십시오.
```txt
/models
@@ -448,11 +440,11 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니
---
## Cloudflare AI 게이트웨이
## Cloudflare AI Gateway
Cloudflare AI 게이트웨이는 OpenAI, Anthropic, Workers AI 등의 모델에 액세스할 수 있으며, 통합된 엔드포인트를 통해 더 많은 기능을 제공합니다. [Unified Billing](https://developers.cloudflare.com/ai-gateway/features/unified-billing/)를 사용하면 각 공급자의 별도의 API 키가 필요하지 않습니다.
Cloudflare AI Gateway는 OpenAI, Anthropic, Workers AI 등의 모델에 액세스할 수 있으며, 통합된 엔드포인트를 통해 더 많은 기능을 제공합니다. [Unified Billing](https://developers.cloudflare.com/ai-gateway/features/unified-billing/)을 사용하면 각 공급자의 별도 API 키가 필요하지 않습니다.
1. [Cloudflare 대시보드](https://dash.cloudflare.com/)에 머리, **AI** > **AI Gateway**로 이동하고 새로운 게이트웨이를 만듭니다.
1. [Cloudflare 대시보드](https://dash.cloudflare.com/)로 이동하여, **AI** > **AI Gateway**로 가서 새로운 게이트웨이를 만듭니다.
2. 계정 ID 및 Gateway ID를 환경 변수로 설정하십시오.
@@ -461,7 +453,7 @@ Cloudflare AI 게이트웨이는 OpenAI, Anthropic, Workers AI 등의 모델에
export CLOUDFLARE_GATEWAY_ID=your-gateway-id
```
3. `/connect` 명령을 실행하고 ** Cloudflare AI Gateway**를 검색하십시오.
3. `/connect` 명령을 실행하고 **Cloudflare AI Gateway**를 검색하십시오.
```txt
/connect
@@ -476,11 +468,11 @@ Cloudflare AI 게이트웨이는 OpenAI, Anthropic, Workers AI 등의 모델에
└ enter
```
또는 환경 변수로 설정한다.
또는 환경 변수로 설정합니다.
```bash title="~/.bash_profile"
```bash title="~/.bash_profile"
export CLOUDFLARE_API_TOKEN=your-api-token
```
```
5. 모델을 선택하려면 `/models` 명령을 실행하십시오.
@@ -488,27 +480,27 @@ Cloudflare AI 게이트웨이는 OpenAI, Anthropic, Workers AI 등의 모델에
/models
```
opencode config를 통해 모델을 추가할 수 있습니다.
OpenCode 구성을 통해 모델을 추가할 수 있습니다.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"cloudflare-ai-gateway": {
"models": {
"openai/gpt-4o": {},
"anthropic/claude-sonnet-4": {}
}
}
}
}
```
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"cloudflare-ai-gateway": {
"models": {
"openai/gpt-4o": {},
"anthropic/claude-sonnet-4": {}
}
}
}
}
```
---
#### 코텍
#### Cortecs
1. [Cortecs 콘솔](https://cortecs.ai/)에 머리, 계정을 만들고 API 키를 생성합니다.
1. [Cortecs 콘솔](https://cortecs.ai/)로 이동하여 계정을 만들고 API 키를 생성합니다.
2. `/connect` 명령을 실행하고 **Cortecs**를 검색하십시오.
@@ -525,7 +517,7 @@ opencode config를 통해 모델을 추가할 수 있습니다.
└ enter
```
4. `/models` 명령을 실행하여 같은 모델을 선택하십시오 Kimi K2 Instruct .
4. `/models` 명령을 실행하여 모델(예: Kimi K2 Instruct)을 선택하십시오.
```txt
/models
@@ -533,9 +525,9 @@ opencode config를 통해 모델을 추가할 수 있습니다.
---
## 딥스카이
## DeepSeek
1. [DeepSeek 콘솔](https://platform.deepseek.com/)에 머리, 계정을 만들고, ** 새로운 API 키**를 클릭합니다.
1. [DeepSeek 콘솔](https://platform.deepseek.com/)로 이동하여 계정을 만들고 **API Keys**를 클릭하여 키를 생성합니다.
2. `/connect` 명령을 실행하고 **DeepSeek**를 검색하십시오.
@@ -552,7 +544,7 @@ opencode config를 통해 모델을 추가할 수 있습니다.
└ enter
```
4. `/models` 명령을 실행하여 DeepSeek 모델을 선택하십시오. DeepSeek Reasoner .
4. `/models` 명령을 실행하여 DeepSeek 모델(예: DeepSeek Reasoner)을 선택하십시오.
```txt
/models
@@ -560,9 +552,9 @@ opencode config를 통해 모델을 추가할 수 있습니다.
---
## 딥 인프라
## Deep Infra
1. [Deep Infra 대시보드](https://deepinfra.com/dash)에 머리로, 계정을 만들고 API 키를 생성합니다.
1. [Deep Infra 대시보드](https://deepinfra.com/dash)로 이동하여 계정을 만들고 API 키를 생성합니다.
2. `/connect` 명령을 실행하고 **Deep Infra**를 검색하십시오.
@@ -570,7 +562,7 @@ opencode config를 통해 모델을 추가할 수 있습니다.
/connect
```
3. 딥 인프라 API 키 입력.
3. Deep Infra API 키를 입력하십시오.
```txt
┌ API key
@@ -587,9 +579,9 @@ opencode config를 통해 모델을 추가할 수 있습니다.
---
## 펌웨어
## Firmware
1. [Firmware 대시보드](https://app.firmware.ai/signup)에 머리, 계정을 만들고 API 키를 생성합니다.
1. [Firmware 대시보드](https://app.firmware.ai/signup)로 이동하여 계정을 만들고 API 키를 생성합니다.
2. `/connect` 명령을 실행하고 **Firmware**를 검색하십시오.
@@ -597,7 +589,7 @@ opencode config를 통해 모델을 추가할 수 있습니다.
/connect
```
3. Firmware API 키 입력.
3. Firmware API 키를 입력하십시오.
```txt
┌ API key
@@ -614,17 +606,17 @@ opencode config를 통해 모델을 추가할 수 있습니다.
---
## 불꽃 놀이 AI
## Fireworks AI
1. [Fireworks AI 콘솔](https://app.fireworks.ai/)에 머리, 계정을 만들고 ** API 키**를 클릭합니다.
1. [Fireworks AI 콘솔](https://app.fireworks.ai/)로 이동하여 계정을 만들고 **API Keys**를 클릭합니다.
2. `/connect` 명령을 실행하고 ** 불꽃 놀이 AI **를 검색하십시오.
2. `/connect` 명령을 실행하고 **Fireworks AI**를 검색하십시오.
```txt
/connect
```
3. 불꽃 놀이 AI API 열쇠를 입력하십시오.
3. Fireworks AI API 키를 입력하십시오.
```txt
┌ API key
@@ -633,7 +625,7 @@ opencode config를 통해 모델을 추가할 수 있습니다.
└ enter
```
4. `/models` 명령을 실행하여 같은 모델을 선택하십시오 Kimi K2 Instruct .
4. `/models` 명령을 실행하여 모델(예: Kimi K2 Instruct)을 선택하십시오.
```txt
/models
@@ -641,9 +633,9 @@ opencode config를 통해 모델을 추가할 수 있습니다.
---
### GitLab 듀오
### GitLab Duo
프로젝트 Duo는 GitLab의 Anthropic 프록시를 통해 기본 툴 호출 기능을 갖춘 AI-powered Agentic 채팅을 제공합니다.
GitLab Duo는 GitLab의 Anthropic 프록시를 통해 기본 도구 호출 기능을 갖춘 AI 기반 에이전트 채팅을 제공합니다.
1. `/connect` 명령을 실행하고 GitLab을 선택합니다.
@@ -661,38 +653,42 @@ opencode config를 통해 모델을 추가할 수 있습니다.
└
```
#### OAuth 사용 (추천)
#### OAuth 사용 (권장)
Select**OAuth**와 브라우저는 권한이 없습니다.
**OAuth**를 선택하면 브라우저에서 권한 부여를 요청합니다.
### 개인 액세스 토큰 사용
1. [GitLab User Settings > Access Tokens](https://gitlab.com/-/user settings/personal access tokens)로 이동
2. 새 토큰 추가 \*\*
3. 이름: `OpenCode`의 범위: `api`
4. 토큰 복사 (`glpat-`와 함께 시작)
5. terminal에서 그것을 입력하십시오
1. [GitLab User Settings > Access Tokens](https://gitlab.com/-/user_settings/personal_access_tokens)로 이동
2. 새 토큰 추가
3. 이름: `OpenCode`, 범위: `api`
4. 토큰 복사 (`glpat-`로 시작)
5. 터미널에 입력하십시오.
6. 유효한 모형을 보기 위하여 `/models` 명령을 실행하십시오.
6. 사용 가능한 모델을 보려면 `/models` 명령을 실행하십시오.
```txt
/models
```
세 개의 클로드 기반 모델은 다음과 같습니다. -**duo-chat-haiku-4-5** (기본값) - 빠른 작업에 대한 빠른 응답 -**duo-chat-sonnet-4-5** - 대부분의 워크플로우의 밸런스 성능 -**duo-chat-opus-4-5** - 복잡한 분석 가능
세 가지 Claude 기반 모델을 사용할 수 있습니다:
- **duo-chat-haiku-4-5** (기본값) - 빠른 작업을 위한 빠른 응답
- **duo-chat-sonnet-4-5** - 대부분의 워크플로우에 균형 잡힌 성능
- **duo-chat-opus-4-5** - 복잡한 분석 가능
:::note
'GITLAB TOKEN' 환경 변수를 지정할 수도 있습니다.
opencode auth 저장소에 토큰을 저장합니다.
`GITLAB_TOKEN` 환경 변수를 지정할 수도 있습니다.
OpenCode는 인증 저장소에 토큰을 저장합니다.
:::
#### 셀프 호스팅 GitLab
#### 셀프 호스팅 GitLab (Self-Hosted)
:::note[compliance note]
opencode는 세션 제목을 생성하고 같은 일부 AI 작업을 위해 작은 모델을 사용합니다.
기본적으로 gpt-5-nano를 사용하도록 구성되며 Zen에서 호스팅됩니다. opencode를 잠금
자신의 GitLab-hosted 인스턴스를 사용하여 다음을 추가하십시오.
`opencode.json` 파일. 세션 공유를 비활성화하는 것이 좋습니다.
:::note[규정 준수 참고 사항]
OpenCode는 세션 제목 생성과 같은 일부 AI 작업을 위해 작은 모델을 사용합니다.
기본적으로 Zen에서 호스팅되는 gpt-5-nano를 사용하도록 구성됩니다.
OpenCode를 자체 호스팅 GitLab 인스턴스만 사용하도록 제한하려면 `opencode.json` 파일에 다음을 추가하십시오.
세션 공유를 비활성화하는 것도 권장합니다.
```json
{
@@ -711,13 +707,13 @@ export GITLAB_INSTANCE_URL=https://gitlab.company.com
export GITLAB_TOKEN=glpat-...
```
인스턴스가 사용자 정의 AI Gateway를 실행하면:
인스턴스가 사용자 정의 AI Gateway를 실행하는 경우:
```bash
GITLAB_AI_GATEWAY_URL=https://ai-gateway.company.com
export GITLAB_AI_GATEWAY_URL=https://ai-gateway.company.com
```
또는 bash 프로파일에 추가:
또는 bash 프로필에 추가:
```bash title="~/.bash_profile"
export GITLAB_INSTANCE_URL=https://gitlab.company.com
@@ -726,36 +722,35 @@ export GITLAB_TOKEN=glpat-...
```
:::note
GitLab 관리자는 다음을 활성화해야합니다.
GitLab 관리자는 다음을 활성화해야 합니다:
1. [Duo Agent Platform](https://docs.gitlab.com/user/gitlab duo/turn on off/) 사용자, 그룹 또는 인스턴스
2. 특징 깃발 (철도 콘솔을 통해):
1. [Duo Agent Platform](https://docs.gitlab.com/user/gitlab_duo/turn_on_off/) (사용자, 그룹 또는 인스턴스)
2. 기능 플래그 (Rails 콘솔을 통해):
- `agent_platform_claude_code`
- `third_party_agents_enabled`
:::
####OAuth for Self-Hosted 인스턴스
#### 셀프 호스팅 인스턴스용 OAuth
자체 호스팅 된 인스턴스를 위해 Oauth 작업을 만들기 위해, 당신은 만들 필요가
새로운 응용 프로그램 (설정 → 응용 프로그램)
콜백 URL `http://127.0.0.1:8080/callback` 및 다음 범위:
자체 호스팅 인스턴스에 대해 OAuth를 작동시키려면 새로운 애플리케이션(Settings → Applications)을 만들어야 합니다.
콜백 URL `http://127.0.0.1:8080/callback` 및 다음 범위가 필요합니다:
- api (당신의 대신에 API에 액세스)
- read user (개인 정보 읽기)
- read repository (Repository에 읽은 전용 접근)
- `api` (사용자 대신 API 액세스)
- `read_user` (개인 정보 읽기)
- `read_repository` (리포지토리 읽기 전용 액세스)
그런 다음 환경 변수로 애플리케이션 ID를 노출:
그런 다음 애플리케이션 ID를 환경 변수로 노출하십시오:
```bash
export GITLAB_OAUTH_CLIENT_ID=your_application_id_here
```
[opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth) 홈페이지에 대한 추가 문서.
[opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth) 홈페이지에 추가 문서가 있습니다.
##### 구성
`opencode.json`를 통해 주문을 받아서 만드십시오:
`opencode.json`을 통해 사용자 정의:
```json title="opencode.json"
{
@@ -774,9 +769,9 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here
}
```
##### GitLab API 도구 (선택, 그러나 높게 추천되는)
##### GitLab API 도구 (선택 사항이지만 강력 권장)
GitLab 도구에 액세스하려면 (merge 요청, 문제, 파이프라인, CI/CD 등):
GitLab 도구(병합 요청, 이슈, 파이프라인, CI/CD 등)에 액세스하려면:
```json title="opencode.json"
{
@@ -785,11 +780,11 @@ GitLab 도구에 액세스하려면 (merge 요청, 문제, 파이프라인, CI/C
}
```
이 플러그인은 MR 리뷰, 문제 추적, 파이프라인 모니터링 등을 포함한 종합 GitLab 저장소 관리 기능을 제공합니다.
이 플러그인은 MR 리뷰, 이슈 추적, 파이프라인 모니터링 등을 포함한 포괄적인 GitLab 리포지토리 관리 기능을 제공합니다.
---
프로젝트
### GitHub Copilot
GitHub Copilot 구독을 사용하여 opencode:
@@ -898,7 +893,7 @@ opencode를 실행하면서 설정한다.
---
###Hugging 얼굴
### Hugging Face
[Hugging Face Inference Provider](https://huggingface.co/docs/inference-providers)는 17+ 공급자가 지원하는 오픈 모델에 대한 액세스를 제공합니다.
@@ -927,7 +922,7 @@ opencode를 실행하면서 설정한다.
---
### 헬리콘
### Helicone
[Helicone](https://helicone.ai)는 AI 애플리케이션에 대한 로깅, 모니터링 및 분석 기능을 제공하는 LLM Observability 플랫폼입니다. Helicone AI Gateway는 모델을 기반으로 적절한 공급자에게 요청을 자동으로 전달합니다.
@@ -1027,7 +1022,7 @@ npm install -g opencode-helicone-session
플러그인은 `Helicone-Session-Id` 및 `Helicone-Session-Name` 헤더를 귀하의 요청에 주사합니다. Helicone의 세션 페이지에서는 별도의 세션으로 나열된 각 opencode 대화를 볼 수 있습니다.
###### 공통 헬리콥터
###### 공통 Helicone 헤더
| 헤드러 | Description |
| -------------------------- | ---------------------------------------------------------- |
@@ -1040,7 +1035,7 @@ npm install -g opencode-helicone-session
---
#### llama.cpp를
#### llama.cpp
[llama.cpp's](https://github.com/ggml-org/llama.cpp) llama-server 유틸리티를 통해 로컬 모델을 사용할 수 있습니다.
@@ -1107,7 +1102,7 @@ IO.NET은 다양한 사용 사례에 최적화된 17개의 모델을 제공합
---
### LM 스튜디오
### LM Studio
LM Studio를 통해 로컬 모델을 사용할 수 있습니다.
@@ -1141,7 +1136,7 @@ LM Studio를 통해 로컬 모델을 사용할 수 있습니다.
---
## 문샷 AI
## Moonshot AI
Moonshot AI에서 Kimi K2 사용 :
@@ -1170,7 +1165,7 @@ Moonshot AI에서 Kimi K2 사용 :
---
## 미니 맥스
## MiniMax
1. [MiniMax API 콘솔](https://platform.minimax.io/login)에 머리, 계정을 만들고 API 키를 생성합니다.
@@ -1197,7 +1192,7 @@ Moonshot AI에서 Kimi K2 사용 :
---
## Nebius 토큰 공장
## Nebius Token Factory
1. [Nebius Token Factory 콘솔](https://tokenfactory.nebius.com/)에 머리, 계정을 만들고, ** 키 추가 **.
@@ -1224,7 +1219,7 @@ Moonshot AI에서 Kimi K2 사용 :
---
#### 오라마
#### Ollama
Ollama를 통해 로컬 모델을 사용할 수 있습니다.
@@ -1266,7 +1261,7 @@ Ollama는 opencode를 자동으로 구성할 수 있습니다. 자세한 내용
---
##Ollama 클라우드
## Ollama Cloud
opencode로 Ollama Cloud를 사용하려면:
@@ -1305,7 +1300,7 @@ opencode로 Ollama Cloud를 사용하려면:
---
### 오픈아이
### OpenAI
[ChatGPT Plus 또는 Pro](https://chatgpt.com/pricing)에 가입하는 것이 좋습니다.
@@ -1338,7 +1333,7 @@ API 키가 이미 있다면 ** 수동으로 API 키**를 입력하고 terminal
---
## opencode 젠
## OpenCode Zen
OpenCode Zen은 opencode 팀에서 제공하는 테스트 및 검증된 모델 목록입니다. [더 알아보기](/docs/zen).
@@ -1367,7 +1362,7 @@ OpenCode Zen은 opencode 팀에서 제공하는 테스트 및 검증된 모델
---
## 오픈로자
## OpenRouter
1. [OpenRouter 대시보드](https://openrouter.ai/settings/keys)에 머리, click ** API Key**를 클릭하고 키를 복사합니다.
@@ -1431,7 +1426,7 @@ opencode config를 통해 추가 모델을 추가할 수 있습니다.
---
### SAP AI 핵심
### SAP AI Core
SAP AI Core는 OpenAI, Anthropic, Google, Amazon, Meta, Mistral 및 AI21의 40+ 모델에 대한 액세스를 제공합니다.
@@ -1513,7 +1508,7 @@ SAP AI Core는 OpenAI, Anthropic, Google, Amazon, Meta, Mistral 및 AI21의 40+
---
### 스케일웨이
### Scaleway
opencode를 사용하여 [Scaleway Generative APIs](https://www.scaleway.com/en/docs/generative-apis/)를 사용하려면:
@@ -1542,7 +1537,7 @@ opencode를 사용하여 [Scaleway Generative APIs](https://www.scaleway.com/en/
---
## 함께 AI
## Together AI
1. [Together AI 콘솔](https://api.together.ai)에 머리, 계정을 만들고 ** 키 추가 **를 클릭합니다.
@@ -1569,7 +1564,7 @@ opencode를 사용하여 [Scaleway Generative APIs](https://www.scaleway.com/en/
---
## 베니스 AI
## Venice AI
1. [Venice AI 콘솔](https://venice.ai)에 머리, 계정을 만들고 API 키를 생성합니다.
@@ -1652,7 +1647,7 @@ opencode config를 통해 모델을 사용자 정의 할 수 있습니다. 공
---
#
### xAI
1. [xAI 콘솔](https://console.x.ai/)에 머리, 계정을 만들고 API 키를 생성합니다.
@@ -1679,7 +1674,7 @@ opencode config를 통해 모델을 사용자 정의 할 수 있습니다. 공
---
#### Z.AI
### Z.AI
1. [Z.AI API 콘솔](https://z.ai/manage-apikey/apikey-list)에 머리, 계정을 만들고, **새로운 API 키**를 클릭합니다.
@@ -1708,7 +1703,7 @@ opencode config를 통해 모델을 사용자 정의 할 수 있습니다. 공
---
## ZenMux를
## ZenMux
1. [ZenMux 대쉬보드](https://zenmux.ai/settings/keys)에 머리, click **Create API Key**, 키 복사.

12
packages/web/src/content/docs/ko/rules.mdx
View File

@@ -1,6 +1,6 @@
---
title: Rules
description: Set custom instructions for opencode.
title: 규칙
description: OpenCode에 대한 사용자 정의 지침 설정.
---
`AGENTS.md` 파일을 만들 수 있도록 opencode에 사용자 정의 지침을 제공 할 수 있습니다. Cursor의 규칙과 유사합니다. LLM의 컨텍스트에 포함된 지침을 통해 특정 프로젝트에 대한 행동을 사용자 정의합니다.
@@ -60,7 +60,7 @@ opencode는 또한 다수 위치에서 `AGENTS.md` 파일을 읽습니다. 그
프로젝트 별 규칙에 대한 프로젝트 루트에 `AGENTS.md`를 배치합니다. 이 디렉토리 또는 하위 디렉토리에서 작업 할 때만 적용됩니다.
## 글로벌
## 전역
또한 `~/.config/opencode/AGENTS.md` 파일에서 글로벌 규칙을 가질 수 있습니다. 이 모든 opencode 세션에서 적용됩니다.
@@ -83,7 +83,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills
---
## 전신
## 우선순위
opencode가 시작될 때, 이 순서에 있는 규칙 파일을 찾습니다:
@@ -123,7 +123,7 @@ opencode가 시작될 때, 이 순서에 있는 규칙 파일을 찾습니다:
---
## 외부 파일을 Referencing
## 외부 파일 참조
opencode가 `AGENTS.md`에 있는 자동적으로 파스 파일 참조를 하지 않는 동안, 당신은 두 가지 방법으로 유사한 기능을 달성할 수 있습니다:
@@ -138,7 +138,7 @@ opencode가 `AGENTS.md`에 있는 자동적으로 파스 파일 참조를 하지
}
```
## # AGENTS.md의 수동 지침
### AGENTS.md의 수동 지침
`AGENTS.md`에 명시된 지침을 제공함으로써 외부 파일을 읽을 수 있습니다. 여기에 실용적인 예:

60
packages/web/src/content/docs/ko/sdk.mdx
View File

@@ -1,6 +1,6 @@
---
title: SDK
description: Type-safe JS client for opencode server.
description: opencode 서버를 위한 타입 안전한 JS 클라이언트.
---
import config from "../../../../config.mjs"
@@ -47,7 +47,7 @@ const { client } = await createOpencode()
---
## 콘피그
## 구성
구성 객체를 전달할 수 있습니다. 인스턴스는 여전히 `opencode.json`를 선택하지만 구성 인라인을 추가 할 수 있습니다.
@@ -91,7 +91,7 @@ const client = createOpencodeClient({
---
## 유형
## 타입
SDK에는 모든 API 유형의 TypeScript 정의가 포함되어 있습니다. 직접 가져 오기 :
@@ -125,7 +125,7 @@ SDK는 type-safe 클라이언트를 통해 모든 서버 API를 노출합니다.
## 글로벌
| 방법 | 설명 | 응답 |
| 메서드 | 설명 | 응답 |
| ----------------- | ---------------------- | ------------------------------------ |
| `global.health()` | 서버 건강 및 버전 확인 | `{ healthy: true, version: string }` |
@@ -205,7 +205,7 @@ const pathInfo = await client.path.get()
---
#### 콘피그
#### 구성
| 방법 | 설명 | 응답 |
| -------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------- |
@@ -226,27 +226,27 @@ const { providers, default: defaults } = await client.config.providers()
## 세션
| 방법 | 묘사 | 주 |
| ---------------------------------------------------------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `session.list()` | 세션 일람 | <a href={typesUrl}><code>Session[]</code></a> |
| `session.get({ path })` | 세션 가져 오기 | <a href={typesUrl}><code>Session</code></a> |
| `session.children({ path })` | 목록 어린이 세션 | 반품 <a href={typesUrl}><code>Session</code></a> |
| `session.create({ body })` | 세션 만들기 | 리턴 <a href={typesUrl}><code>Session</code></a> |
| `session.delete({ path })` | 세션 삭제 | `boolean` 반품 |
| `session.update({ path, body })` | 업데이트 세션 속성 | 반품 <a href={typesUrl}><code>Session</code></a> |
| `session.init({ path, body })` | Analyze 앱을 만들고 `AGENTS.md` | `boolean`를 반환 |
| `session.abort({ path })` | 운영 중인 세션 | 반품 `boolean` |
| `session.share({ path })` | 공유 세션 | 반품 <a href={typesUrl}><code>Session</code></a> |
| `session.unshare({ path })` | 공유 세션 | 반품 <a href={typesUrl}><code>Session</code></a> |
| `session.summarize({ path, body })` | 세션 요약 | 반품 `boolean` |
| `session.messages({ path })` | 세션의 메시지 목록 | `{ info: `<a href={typesUrl}><code>Message</code></a>`, parts: `<a href={typesUrl}><code>Part</code></a>`}[]` |
| `session.message({ path })` | 메시지 상세정보 | 반품 `{ info: `<a href={typesUrl}><code>Message</code></a>`, parts: `<a href={typesUrl}><code>Part[]</code></a>`}` |
| `session.prompt({ path, body })` | prompt 메시지 보내기 | `body.noReply: true` 반환 UserMessage (콘텍스트 전용). 기본 반환 <a href={typesUrl}><code>AssistantMessage</code></a> 에 AI 응답 |
| `session.command({ path, body })` | 세션으로 명령을 전송 | `{ info: `<a href={typesUrl}><code>AssistantMessage</code></a>`, parts: `<a href={typesUrl}><code>Part[]</code></a>`}` |
| `session.shell({ path, body })` | shell 명령을 실행 | <a href={typesUrl}><code>AssistantMessage</code></a> |
| `session.revert({ path, body })` | 메시지 다시 변환 | <a href={typesUrl}><code>Session</code></a> |
| `session.unrevert({ path })` | 통일된 메시지 | 반품 <a href={typesUrl}><code>Session</code></a> |
| `postSessionByIdPermissionsByPermissionId({ path, body })` | 허가 요청 대응 | 반품 `boolean` |
| 메서드 | 설명 | 비고 |
| ---------------------------------------------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `session.list()` | 세션 일람 | <a href={typesUrl}><code>Session[]</code></a> |
| `session.get({ path })` | 세션 가져 오기 | <a href={typesUrl}><code>Session</code></a> |
| `session.children({ path })` | 하위 세션 목록 | 반품 <a href={typesUrl}><code>Session</code></a> |
| `session.create({ body })` | 세션 만들기 | 리턴 <a href={typesUrl}><code>Session</code></a> |
| `session.delete({ path })` | 세션 삭제 | `boolean` 반품 |
| `session.update({ path, body })` | 업데이트 세션 속성 | 반품 <a href={typesUrl}><code>Session</code></a> |
| `session.init({ path, body })` | 앱 초기화 및 `AGENTS.md` 분석 | `boolean`를 반환 |
| `session.abort({ path })` | 운영 중인 세션 | 반품 `boolean` |
| `session.share({ path })` | 공유 세션 | 반품 <a href={typesUrl}><code>Session</code></a> |
| `session.unshare({ path })` | 공유 세션 | 반품 <a href={typesUrl}><code>Session</code></a> |
| `session.summarize({ path, body })` | 세션 요약 | 반품 `boolean` |
| `session.messages({ path })` | 세션의 메시지 목록 | `{ info: `<a href={typesUrl}><code>Message</code></a>`, parts: `<a href={typesUrl}><code>Part</code></a>`}[]` |
| `session.message({ path })` | 메시지 상세정보 | 반품 `{ info: `<a href={typesUrl}><code>Message</code></a>`, parts: `<a href={typesUrl}><code>Part[]</code></a>`}` |
| `session.prompt({ path, body })` | prompt 메시지 보내기 | `body.noReply: true` 반환 UserMessage (콘텍스트 전용). 기본 반환 <a href={typesUrl}><code>AssistantMessage</code></a> 에 AI 응답 |
| `session.command({ path, body })` | 세션으로 명령을 전송 | `{ info: `<a href={typesUrl}><code>AssistantMessage</code></a>`, parts: `<a href={typesUrl}><code>Part[]</code></a>`}` |
| `session.shell({ path, body })` | shell 명령을 실행 | <a href={typesUrl}><code>AssistantMessage</code></a> |
| `session.revert({ path, body })` | 메시지 다시 변환 | <a href={typesUrl}><code>Session</code></a> |
| `session.unrevert({ path })` | 메시지 되돌리기 취소 | 반품 <a href={typesUrl}><code>Session</code></a> |
| `postSessionByIdPermissionsByPermissionId({ path, body })` | 허가 요청 대응 | 반품 `boolean` |
---
@@ -287,7 +287,7 @@ await client.session.prompt({
| ------------------------- | ---------------------------- | -------------------------------------------------------------------------------------- |
| `find.text({ query })` | 파일에서 텍스트 검색 | `path`, `lines`, `line_number`, `absolute_offset`, `submatches`와 일치하는 개체의 배열 |
| `find.files({ query })` | 이름의 파일 및 디렉토리 찾기 | `string[]` (경로) |
| `find.symbols({ query })` | 업무 공간 기호 찾기 | <a href={typesUrl}><code>Symbol[]</code></a> |
| `find.symbols({ query })` | 작업 공간 심볼 찾기 | <a href={typesUrl}><code>Symbol[]</code></a> |
| `file.read({ query })` | 파일 보기 | `{ type: "raw" \| "patch", content: string }` |
| `file.status({ query? })` | 트랙 된 파일 상태를 확인 | <a href={typesUrl}><code>File[]</code></a> |
@@ -329,12 +329,12 @@ const content = await client.file.read({
| `tui.appendPrompt({ body })` | 프롬프트에 텍스트를 부여 | `boolean` |
| `tui.openHelp()` | 도움말 열기 | `boolean` |
| `tui.openSessions()` | 세션 선택 안내 | `boolean` |
| `tui.openThemes()` | 테마 선택 해제 | `boolean` |
| `tui.openThemes()` | 테마 선택 열기 | `boolean` |
| `tui.openModels()` | 모델 선택 안내 | `boolean` |
| `tui.submitPrompt()` | 현재 프롬프트 제출 | `boolean` |
| `tui.clearPrompt()` | 프롬프트 클리어 | `boolean` |
| `tui.executeCommand({ body })` | 명령어 실행 | `boolean` |
| `tui.showToast({ body })` | 쇼 토스트 알림 | `boolean` |
| `tui.showToast({ body })` | 토스트 알림 표시 | `boolean` |
---
@@ -353,7 +353,7 @@ await client.tui.showToast({
---
##### 가을
##### 인증
| 방법 | 설명 | 응답 |
| ------------------- | -------------- | --------- |

24
packages/web/src/content/docs/ko/server.mdx
View File

@@ -1,6 +1,6 @@
---
title: Server
description: Interact with opencode server over HTTP.
title: 서버
description: HTTP를 통해 OpenCode 서버와 상호 작용합니다.
---
import config from "../../../../config.mjs"
@@ -44,7 +44,7 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve
---
### 어떻게 작동합니까?
### 작동 방식
`opencode`를 실행하면 TUI와 서버를 시작합니다. TUI는 어디에 있습니까?
서버와 대화하는 클라이언트. 서버는 OpenAPI 3.1 spec을 노출
@@ -122,7 +122,7 @@ opencode 서버는 다음과 같은 API를 노출합니다.
---
### 콘피그
### 구성
| 방법 | 경로 | 설명 | 응답 |
| ------- | ------------------- | -------------------------- | ---------------------------------------------------------------------------------------- |
@@ -145,7 +145,7 @@ opencode 서버는 다음과 같은 API를 노출합니다.
## 세션
| 방법 | 경로 | 설명 | 주 |
| 메서드 | 경로 | 설명 | 비고 |
| -------- | ---------------------------------------- | ---------------------------------- | ----------------------------------------------------------------------------- |
| `GET` | `/session` | 모든 세션 일람표 | 반환 <a href={typesUrl}><code>Session[]</code></a> |
| `POST` | `/session` | 새 세션 만들기 | 몸: `{ parentID?, title? }`, 반환 <a href={typesUrl}><code>Session</code></a> |
@@ -153,9 +153,9 @@ opencode 서버는 다음과 같은 API를 노출합니다.
| `GET` | `/session/:id` | 세션 상세보기 | 반품 <a href={typesUrl}><code>Session</code></a> |
| `DELETE` | `/session/:id` | 세션 삭제 및 모든 데이터 | `boolean` |
| `PATCH` | `/session/:id` | 업데이트 세션 속성 | 본체: `{ title? }`, 반환 <a href={typesUrl}><code>Session</code></a> |
| `GET` | `/session/:id/children` | 세션의 어린이 세션 | 리턴 <a href={typesUrl}><code>Session[]</code></a> |
| `GET` | `/session/:id/todo` | 세션별 도우미 목록 받기 | <a href={typesUrl}><code>Todo[]</code></a> |
| `POST` | `/session/:id/init` | 분석 응용 프로그램 및 `AGENTS.md` | 몸: `{ messageID, providerID, modelID }`, 반환 `boolean` |
| `GET` | `/session/:id/children` | 세션의 하위 세션 | 리턴 <a href={typesUrl}><code>Session[]</code></a> |
| `GET` | `/session/:id/todo` | 세션의 할 일(Todo) 목록 받기 | <a href={typesUrl}><code>Todo[]</code></a> |
| `POST` | `/session/:id/init` | 앱 초기화 및 `AGENTS.md` 분석 | 몸: `{ messageID, providerID, modelID }`, 반환 `boolean` |
| `POST` | `/session/:id/fork` | 메시지의 기존 세션 | 몸: `{ messageID? }`, 반환 <a href={typesUrl}><code>Session</code></a> |
| `POST` | `/session/:id/abort` | 운영 중인 세션 | 반품 `boolean` |
| `POST` | `/session/:id/share` | 세션 공유 | <a href={typesUrl}><code>Session</code></a> |
@@ -163,7 +163,7 @@ opencode 서버는 다음과 같은 API를 노출합니다.
| `GET` | `/session/:id/diff` | `/session/:id/diff` | `messageID?`, 반환 <a href={typesUrl}><code>FileDiff[]</code></a> |
| `POST` | `/session/:id/summarize` | 세션을 요약 | 본체: `{ providerID, modelID }`, `boolean` 반환 |
| `POST` | `/session/:id/revert` | 메시지 재생 | 몸: `{ messageID, partID? }`, 반환 `boolean` |
| `POST` | `/session/:id/unrevert` | 통일된 모든 메시지 | 반품 `boolean` |
| `POST` | `/session/:id/unrevert` | 메시지 되돌리기 취소 | 반품 `boolean` |
| `POST` | `/session/:id/permissions/:permissionID` | 허가 요청 대응 | 본체: `{ response, remember? }`, `boolean` |
---
@@ -210,7 +210,7 @@ opencode 서버는 다음과 같은 API를 노출합니다.
---
## 도구 (실험)
## 도구 (실험적)
| 방법 | 경로 | 설명 | 응답 |
| ----- | ------------------------------------------- | ----------------------- | --------------------------------------------- |
@@ -219,7 +219,7 @@ opencode 서버는 다음과 같은 API를 노출합니다.
---
### LSP의 체재자 & MCP
### LSP, 포매터 & MCP
| 방법 | 경로 | 설명 | 응답 |
| ------ | ------------ | ---------------------- | -------------------------------------------------------- |
@@ -276,7 +276,7 @@ opencode 서버는 다음과 같은 API를 노출합니다.
| 방법 | 경로 | 설명 | 응답 |
| ----- | -------- | ------------------------------------------------------------------------------- | ------------------------ |
| `GET` | `/event` | 서버 침묵 이벤트 스트림. 첫 번째 이벤트는 `server.connected`, 그 후 버스 이벤트 | Server-sent event stream |
| `GET` | `/event` | 서버 전송 이벤트 스트림. 첫 번째 이벤트는 `server.connected`, 그 후 버스 이벤트 | Server-sent event stream |
---

10
packages/web/src/content/docs/ko/share.mdx
View File

@@ -1,6 +1,6 @@
---
title: Share
description: Share your opencode conversations.
title: 공유
description: OpenCode 대화를 공유하세요.
---
opencode의 공유 기능은 opencode 대화에 대한 공개 링크를 만들 수 있으므로 Teammates와 협업하거나 다른 곳에서 도움을받을 수 있습니다.
@@ -11,7 +11,7 @@ opencode의 공유 기능은 opencode 대화에 대한 공개 링크를 만들
---
## 어떻게 작동합니까?
## 작동 방식
대화를 공유할 때, opencode:
@@ -48,7 +48,7 @@ opencode는 대화가 공유되는 방법을 제어하는 세 가지 공유 모
---
## 자동차 공유
## 자동 공유
`share` 옵션을 설정하여 모든 새로운 대화에 대한 자동 공유를 활성화 할 수 있습니다 `"auto"` 당신의 [config 파일](/docs/config):
@@ -78,7 +78,7 @@ opencode는 대화가 공유되는 방법을 제어하는 세 가지 공유 모
---
## 비 쉐링
## 공유 취소
대화를 중지하고 공공 액세스에서 제거 :

24
packages/web/src/content/docs/ko/skills.mdx
View File

@@ -1,6 +1,6 @@
---
title: "Agent Skills"
description: "Define reusable behavior via SKILL.md definitions"
title: "에이전트 스킬"
description: "SKILL.md 정의를 통해 재사용 가능한 동작을 정의합니다."
---
Agent Skill let opencode discover reusable instruction from your repo 또는 홈 디렉토리.
@@ -8,7 +8,7 @@ Skills are loaded on-demand via native `skill` tool-agents see available skills
---
## 파일 장소
## 파일 위치
기술 이름 당 하나의 폴더를 만들고 내부 `SKILL.md`를 넣어.
opencode 이 위치를 검색:
@@ -22,7 +22,7 @@ opencode 이 위치를 검색:
---
## 발견의 이해
## 검색 이해
Project-local paths의 경우, opencode는 git worktree에 도달 할 때까지 현재 작업 디렉토리에서 걷습니다.
그것은 `skills/*/SKILL.md`에 있는 어떤 어울리는 `.opencode/` 및 어떤 어울리는 `.claude/skills/*/SKILL.md` 또는 `.agents/skills/*/SKILL.md`를 방법 적재합니다.
@@ -31,7 +31,7 @@ Project-local paths의 경우, opencode는 git worktree에 도달 할 때까지
---
## 쓰기 frontmatter
## Frontmatter 작성
각 `SKILL.md`는 YAML frontmatter로 시작해야 합니다.
이 필드는 인식됩니다:
@@ -46,7 +46,7 @@ Project-local paths의 경우, opencode는 git worktree에 도달 할 때까지
---
## 유효 이름
## 유효한 이름
`name`는 해야 합니다:
@@ -64,14 +64,14 @@ Project-local paths의 경우, opencode는 git worktree에 도달 할 때까지
---
## 길이 규칙을 따르십시오
## 길이 규칙 준수
`description`는 1-1024 특성이어야 합니다.
제대로 선택하기 위해 에이전트에 대해 충분히 유지하십시오.
---
## 예제 사용
## 사용 예제
이처럼 `.opencode/skills/git-release/SKILL.md` 만들기:
@@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear.
---
## 인식 도구 설명
## 도구 설명 인식
opencode는 `skill` 도구 설명에서 사용할 수있는 기술을 나열합니다.
각 항목에는 기술 이름 및 설명이 포함됩니다.
@@ -149,7 +149,7 @@ skill({ name: "git-release" })
---
## 에이전트 당 override
## 에이전트별 재정의
글로벌 디폴트보다 특정 에이전트 다른 권한을 부여합니다.
@@ -181,7 +181,7 @@ permission:
---
## 기술 도구 비활성화
## 스킬 도구 비활성화
그들을 사용하지 않는 에이전트을위한 완전히 비활성화 된 기술 :
@@ -212,7 +212,7 @@ tools:
---
## 문제 해결 선적
## 로딩 문제 해결
기술이 나타나지 않는 경우:

12
packages/web/src/content/docs/ko/themes.mdx
View File

@@ -1,6 +1,6 @@
---
title: Themes
description: Select a built-in theme or define your own.
title: 테마
description: 내장 테마를 선택하거나 자신만의 테마를 정의하세요.
---
opencode를 사용하면 여러 내장 테마 중 하나에서 선택할 수 있으며 terminal 테마에 적응하는 테마를 사용하거나 사용자 정의 테마를 정의 할 수 있습니다.
@@ -9,7 +9,7 @@ opencode를 사용하면 여러 내장 테마 중 하나에서 선택할 수 있
---
## 끝 필요조건
## 터미널 요구 사항
자신의 풀 컬러 팔레트로 올바르게 표시하려면 terminal을 지원해야합니다 ** truecolor** (24 비트 색상). 대부분의 현대 terminal은 기본적으로 이것을 지원합니다, 그러나 당신은 그것을 가능하게 할 필요가 있을지도 모릅니다:
@@ -48,7 +48,7 @@ opencode는 여러 내장 테마와 함께 제공됩니다.
`system` 테마는 terminal의 색깔 계획에 자동적으로 적응시키기 위하여 디자인됩니다. 고정 색상을 사용하는 전통적인 테마와 달리, system 테마:
- ** 회색 가늠자 **: terminal의 배경 색상을 기반으로 사용자 정의 회색 가늠자를 만들고 최적의 대조를 보장합니다.
- **그레이스케일**: terminal의 배경 색상을 기반으로 사용자 정의 회색 가늠자를 만들고 최적의 대조를 보장합니다.
- ** ANSI 색상 사용 ** : terminal의 색상 팔레트를 존중하는 구문 강조 및 UI 요소에 대한 표준 ANSI 색상 (0-15).
- ** terminal 기본 사항**: `none` 텍스트 및 배경 색상을 사용하여 terminal의 네이티브 외관을 유지합니다.
@@ -79,7 +79,7 @@ opencode는 사용자가 쉽게 테마를 만들 수 있도록 유연한 JSON
---
##### Hierarchy의
##### 계층 구조
테마는 다음과 같은 순서에서 여러 디렉토리에서로드됩니다. 나중에 감독은 이전 것을 무시합니다.
@@ -128,7 +128,7 @@ vim .opencode/themes/my-theme.json
---
## terminal 기본값
## 터미널 기본값
특별한 가치 `"none"`는 terminal의 기본 색깔을 상속하기 위하여 어떤 색깔든지를 위해 사용될 수 있습니다. 이것은 특히 당신의 terminal의 색깔 계획과 이음새가 없는 혼합 테마 창조를 위해 유용합니다:

28
packages/web/src/content/docs/ko/tools.mdx
View File

@@ -1,6 +1,6 @@
---
title: Tools
description: Manage the tools an LLM can use.
title: 도구
description: LLM이 사용할 수 있는 도구를 관리합니다.
---
도구는 LLM을 사용하여 코드베이스에서 작업을 수행 할 수 있습니다. opencode는 내장 도구 세트로 제공되지만, [custom tools](/docs/custom-tools) 또는 [MCP 서버](/docs/mcp-servers)로 확장할 수 있습니다.
@@ -62,7 +62,7 @@ description: Manage the tools an LLM can use.
---
### 편집
### edit
정확한 문자열 교체를 사용하여 기존 파일을 수정합니다.
@@ -79,7 +79,7 @@ description: Manage the tools an LLM can use.
---
### 쓰기
### write
새로운 파일을 만들거나 기존의 것을 덮어쓰기.
@@ -100,7 +100,7 @@ LLM을 사용하여 새 파일을 만듭니다. 이미 존재하는 경우 기
---
### 읽기
### read
codebase에서 파일 내용을 읽으십시오.
@@ -117,7 +117,7 @@ codebase에서 파일 내용을 읽으십시오.
---
#### 그라프
#### grep
정규 표현식을 사용하여 파일 내용을 검색합니다.
@@ -151,7 +151,7 @@ Codebase에서 빠른 콘텐츠 검색. 전체 regex 문법 및 파일 패턴
---
### 리스트
### list
주어진 경로의 파일 및 디렉토리 목록.
@@ -168,7 +168,7 @@ Codebase에서 빠른 콘텐츠 검색. 전체 regex 문법 및 파일 패턴
---
### lsp (실험)
### lsp (실험적)
정의, 참고, hover info 및 호출 hierarchy와 같은 코드 인텔리전스 기능을 얻기 위해 구성 된 LSP 서버와 인터랙트.
@@ -191,7 +191,7 @@ LSP 서버가 프로젝트에 사용할 수 있는 구성하려면 [LSP Servers]
---
## 패치
## patch
파일에 패치를 적용합니다.
@@ -212,7 +212,7 @@ LSP 서버가 프로젝트에 사용할 수 있는 구성하려면 [LSP Servers]
---
### 기술
### skill
[skill](/docs/skills) (`SKILL.md` 파일)을로드하고 대화의 내용을 반환합니다.
@@ -227,7 +227,7 @@ LSP 서버가 프로젝트에 사용할 수 있는 구성하려면 [LSP Servers]
---
## todowrite에
## todowrite
코딩 세션 중에 todo 목록을 관리합니다.
@@ -269,7 +269,7 @@ LSP 서버가 프로젝트에 사용할 수 있는 구성하려면 [LSP Servers]
---
#### 웹 사이트
#### webfetch
Fetch 웹 콘텐츠.
@@ -286,7 +286,7 @@ LLM을 fetch 및 웹 페이지를 읽을 수 있습니다. 온라인 리소스
---
#### 웹 검색
#### websearch
웹 검색
@@ -320,7 +320,7 @@ API 키가 필요하지 않습니다 - 도구는 인증없이 Exa AI의 호스
---
### 질문
### question
실행 중에 사용자의 질문 요청.

38
packages/web/src/content/docs/ko/troubleshooting.mdx
View File

@@ -1,13 +1,13 @@
---
title: Troubleshooting
description: Common issues and how to resolve them.
title: 문제 해결
description: 일반적인 문제와 해결 방법.
---
opencode와 문제를 디버그하려면 로그와 로컬 데이터를 확인하여 디스크에 저장합니다.
---
## 로그인
## 로깅
로그 파일은 다음과 같습니다:
@@ -21,7 +21,7 @@ opencode와 문제를 디버그하려면 로그와 로컬 데이터를 확인하
---
## 저장
## 저장소
opencode 저장 세션 데이터 및 디스크에 다른 응용 데이터:
@@ -39,11 +39,11 @@ opencode 저장 세션 데이터 및 디스크에 다른 응용 데이터:
---
## 데스크탑 앱
## 데스크톱 앱
opencode 데스크톱은 배경에서 로컬 opencode 서버 (`opencode-cli` sidecar)를 실행합니다. 대부분의 문제는 misbehaving 플러그인, 손상된 캐시, 또는 나쁜 서버 설정에 의해 발생합니다.
## 빠른 체크
## 빠른 확인
- 완전히 종료하고 앱을 다시 시작.
- 앱이 오류 화면을 보여 주면 ** Restart**를 클릭하고 오류 세부 정보를 복사합니다.
@@ -51,11 +51,11 @@ opencode 데스크톱은 배경에서 로컬 opencode 서버 (`opencode-cli` sid
---
## Disable 플러그인
## 플러그인 비활성화
데스크톱 앱이 출시, 거는, 또는 이상한 것에서 충돌하면 플러그인을 비활성화하여 시작합니다.
### 글로벌 설정 확인
### 전역 설정 확인
글로벌 설정 파일을 열고 `plugin` 키를 찾습니다.
@@ -101,17 +101,17 @@ opencode는 디스크에서 로컬 플러그인을로드 할 수 있습니다. T
---
## 수정 서버 연결 문제
## 서버 연결 문제 수정
opencode 데스크톱은 자체 로컬 서버(기본)를 시작하거나 구성된 서버 URL에 연결할 수 있습니다.
**"Connection Failed"** 대화 상자 (또는 앱이 스패시 화면을 지나지 않습니다), 사용자 정의 서버 URL을 확인합니다.
### 바탕 화면 기본 서버 URL 삭제
### 데스크톱 기본 서버 URL 삭제
Home 화면에서 Server Picker를 열려면 서버 이름(상태 점)을 클릭하십시오. **기본 서버** 섹션에서 **Clear**를 클릭합니다.
####는 `server.port`/`server.hostname`를 당신의 설정에서 제거합니다
#### 설정에서 server.port/server.hostname 제거
`opencode.json(c)`가 `server` 섹션을 포함하면 일시적으로 제거하고 데스크톱 앱을 다시 시작합니다.
@@ -123,7 +123,7 @@ Home 화면에서 Server Picker를 열려면 서버 이름(상태 점)을 클릭
---
## Linux: 웨이랜드 / X11 문제
## Linux: Wayland / X11 문제
Linux에서 일부 Wayland 설정은 공백 창이나 compositor 오류를 일으킬 수 있습니다.
@@ -132,7 +132,7 @@ Linux에서 일부 Wayland 설정은 공백 창이나 compositor 오류를 일
---
## Windows: WebView2 실행 시간
## Windows: WebView2 런타임
Windows에서 opencode 데스크톱은 Microsoft Edge ** WebView2 실행 시간 **를 요구합니다. 앱이 공백 창에 열거나 시작하지 않을 경우, install/update WebView2를 설치하고 다시 시도하십시오.
@@ -144,7 +144,7 @@ Windows에서 opencode 데스크톱은 Microsoft Edge ** WebView2 실행 시간
---
## 알림 표시되지 않음
## 알림이 표시되지 않음
opencode 데스크톱은 시스템 알림을 보여줍니다 :
@@ -153,7 +153,7 @@ opencode 데스크톱은 시스템 알림을 보여줍니다 :
---
## 재설정 데스크톱 앱 스토리지 (마지막 리조트)
## 데스크톱 앱 저장소 재설정 (최후의 수단)
앱이 시작되지 않은 경우 UI 내부에서 설정을 취소할 수 없습니다. 데스크탑 앱의 저장된 상태를 재설정하십시오.
@@ -214,7 +214,7 @@ opencode와 문제가 발생하면:
---
#### 모델 사용할 수 없습니다
#### 모델을 사용할 수 없음
1. 공급자와 정통한 확인
2. config의 모델명을 수정한다.
@@ -234,7 +234,7 @@ opencode와 문제가 발생하면:
---
## 공급자InitError
## ProviderInitError
ProviderInitError가 발생하면 잘못된 구성이나 손상된 구성이 있습니다.
@@ -253,7 +253,7 @@ Windows에서, `WIN+R`를 누르고 삭제하십시오: `%USERPROFILE%\.local\sh
---
### AI APICallError와 공급자 포장 문제점
### AI_APICallError 및 공급자 패키지 문제
API 호출 오류가 발생하면, 이 공급 업체 패키지로 인해 발생할 수 있습니다. opencode 동적 설치 공급자 패키지 (OpenAI, Anthropic, Google 등) 필요 하 고 로컬로 캐시.
@@ -273,7 +273,7 @@ Windows에서, `WIN+R`를 누르고 삭제하십시오: `%USERPROFILE%\.cache\op
---
#### 복사 / Linux에서 작동하지 않음
#### Linux에서 복사/붙여넣기 작동 안 함
Linux 사용자는 다음과 같은 클립 보드 유틸리티 중 하나가 복사 / 붙여 넣기 기능에 설치해야합니다.

38
packages/web/src/content/docs/ko/tui.mdx
View File

@@ -1,6 +1,6 @@
---
title: TUI
description: Using the opencode terminal user interface.
description: OpenCode 터미널 사용자 인터페이스 사용.
---
import { Tabs, TabItem } from "@astrojs/starlight/components"
@@ -69,7 +69,7 @@ opencode TUI를 사용할 때, `/`를 입력하여 명령 이름을 따라 작
---
### 연결
### /connect
opencode에 대한 공급자를 추가합니다. 사용 가능한 공급자에서 선택하고 API 키를 추가 할 수 있습니다.
@@ -79,7 +79,7 @@ opencode에 대한 공급자를 추가합니다. 사용 가능한 공급자에
---
### 콤팩트
### /compact
현재 세션을 압축합니다. 앨리스 : `/summarize`
@@ -91,7 +91,7 @@ opencode에 대한 공급자를 추가합니다. 사용 가능한 공급자에
---
### 세부사항
### /details
토글 툴 실행 세부 사항.
@@ -103,7 +103,7 @@ opencode에 대한 공급자를 추가합니다. 사용 가능한 공급자에
---
### 편집기
### /editor
메시지를 작성하기 위한 외부 편집기를 엽니다. `EDITOR` 환경에서 설정된 편집기를 사용합니다. [더 알아보기](#editor-setup).
@@ -115,7 +115,7 @@ opencode에 대한 공급자를 추가합니다. 사용 가능한 공급자에
---
### 출구
### /exit
opencode를 종료합니다. Aliases : `/quit`, `/q`
@@ -127,7 +127,7 @@ opencode를 종료합니다. Aliases : `/quit`, `/q`
---
### 수출
### /export
Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립니다. `EDITOR` 환경에서 설정된 편집기를 사용합니다. [더 알아보기](#editor-setup).
@@ -139,7 +139,7 @@ Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립
---
### 도움
### /help
도움말 대화 상자를 표시합니다.
@@ -151,7 +151,7 @@ Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립
---
###### 인
###### /init
`AGENTS.md` 파일을 만들거나 업데이트하십시오. [더 알아보기](/docs/rules).
@@ -163,7 +163,7 @@ Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립
---
## 모델
## /models
사용 가능한 모델 목록.
@@ -175,7 +175,7 @@ Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립
---
## 새로운
## /new
새로운 세션을 시작합니다. 앨리스 : `/clear`
@@ -187,7 +187,7 @@ Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립
---
##### 재도
##### /redo
이전 undone 메시지 Redo. `/undo`를 사용하는 후에만 유효한.
@@ -206,7 +206,7 @@ Git 저장소**입니다.
---
## 세션
## /sessions
세션 간 목록 및 전환. Aliases : `/resume`, `/continue`
@@ -230,7 +230,7 @@ Git 저장소**입니다.
---
## 테마
## /theme
사용할 수 있는 테마 목록.
@@ -242,7 +242,7 @@ Git 저장소**입니다.
---
### 생각
### /thinking
대화의 사고/거주 블록의 가시성을 토합니다. 사용할 때, 확장 된 생각을 지원하는 모델의 이유 프로세스를 볼 수 있습니다.
@@ -256,7 +256,7 @@ Git 저장소**입니다.
---
##### 취소
##### /undo
대화에서 마지막 메시지. 가장 최근의 사용자 메시지, 모든 후속 응답 및 모든 파일 변경 제거.
@@ -275,7 +275,7 @@ Git 저장소**입니다.
---
#### 공유
#### /unshare
Unshare 현재 세션. [더 알아보기](/docs/share#un-sharing).
@@ -285,7 +285,7 @@ Unshare 현재 세션. [더 알아보기](/docs/share#un-sharing).
---
## 에디터 설정
## 편집기 설정
`/editor`와 `/export` 명령 모두는 `EDITOR` 환경변수에서 지정된 편집기를 사용합니다.
@@ -382,7 +382,7 @@ opencode config 파일을 통해 TUI 동작을 사용자 정의할 수 있습니
---
#### 사용자 이름 전시
#### 사용자 이름 표시
사용자 이름이 채팅 메시지에 나타나는지 여부를 수정합니다. 이것을 통해 접근:

6
packages/web/src/content/docs/ko/web.mdx
View File

@@ -1,6 +1,6 @@
---
title: Web
description: Using opencode in your browser.
description: 브라우저에서 OpenCode 사용하기.
---
opencode는 브라우저에서 웹 응용 프로그램을 실행할 수 있으며 terminal을 필요로하지 않고 동일한 강력한 AI 코딩 경험을 제공합니다.
@@ -108,7 +108,7 @@ OPENCODE_SERVER_PASSWORD=secret opencode web
---
## terminal 부착
## 터미널 연결
실행 웹 서버에 terminal TUI를 연결할 수 있습니다.
@@ -124,7 +124,7 @@ opencode attach http://localhost:4096
---
## Config 파일
## 구성 파일
`opencode.json` config 파일에서 서버 설정을 구성할 수 있습니다:

4
packages/web/src/content/docs/ko/zen.mdx
View File

@@ -1,6 +1,6 @@
---
title: Zen
description: Curated list of models provided by opencode.
description: OpenCode가 제공하는 엄선된 모델 목록.
---
import config from "../../../../config.mjs"
@@ -233,7 +233,7 @@ Admins는 또한 통제의 밑에 비용을 지키는 각 일원을 위한 매
---
## 자신의 열쇠를 가져옵니다
## BYOK (Bring Your Own Key)
OpenAI 또는 Anthropic API 키를 사용하여 Zen에서 다른 모델에 액세스 할 수 있습니다.