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

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

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 키와 같은 민감한 데이터를 별도의 파일에 유지할 때.
- 구성을 어지럽히지 않고 큰 지침 파일을 포함할 때.
- 여러 구성 파일에서 공통 구성 스니펫 공유할 때.