fix(docs): locale translations

This commit is contained in:
Adam
2026-02-10 13:59:14 -06:00
committed by opencode
parent fbc41475b4
commit fd5531316f
282 changed files with 4973 additions and 5314 deletions

View File

@@ -30,7 +30,7 @@ ACP를 통해 opencode를 사용하려면 `opencode acp` 명령을 실행하려
```json title="~/.config/zed/settings.json"
{
"agent_servers": {
"opencode": {
"OpenCode": {
"command": "opencode",
"args": ["acp"]
}
@@ -51,7 +51,7 @@ ACP를 통해 opencode를 사용하려면 `opencode acp` 명령을 실행하려
{
"agent": {
"custom": {
"name": "opencode",
"name": "OpenCode",
"command": {
"command": "opencode",
"args": ["acp"]
@@ -74,7 +74,7 @@ ACP를 통해 opencode를 사용하려면 `opencode acp` 명령을 실행하려
```json title="acp.json"
{
"agent_servers": {
"opencode": {
"OpenCode": {
"command": "/absolute/path/bin/opencode",
"args": ["acp"]
}

View File

@@ -15,48 +15,48 @@ description: Configure and use specialized agents.
## 유형
opencode의 두 가지 유형이 있습니다; 기본 에이전트와 시약.
OpenCode의 두 가지 유형이 있습니다; 기본 에이전트와 subagents.
---
### 주요 에이전트
주요 에이전트은 당신이 직접 상호 작용하는 주요 조수입니다. **Tab** 키 또는 설정된 `switch_agent` keybind를 사용하여 주기 할 수 있습니다. 이 에이전트은 당신의 주요 대화를 취급합니다. 도구 액세스는 권한을 통해 구성된다 — 예를 들어, 빌드는 계획이 제한되는 동안 모든 도구를 사용할 수 있습니다.
주요 에이전트은 당신이 직접 상호 작용하는 주요 조수입니다. **Tab** 키 또는 설정된 `switch_agent` keybind를 사용하여 주기 할 수 있습니다. 이 에이전트은 당신의 주요 대화를 취급합니다. 도구 액세스는 권한을 통해 구성된다 — 예를 들어, Build는 Plan이 제한되는 동안 모든 도구를 사용할 수 있습니다.
:::tip
세션 중에 기본 에이전트를 전환하는 **Tab** 키를 사용할 수 있습니다.
:::
opencode는 두 개의 내장 기본 에이전트, **Build** 및 **Plan**와 함께 제공됩니다. 우리는
OpenCode는 두 개의 내장 기본 에이전트, **Build** 및 **Plan**와 함께 제공됩니다. 우리는
아래에서 보기.
---
## # 시약
### Subagents
Subagents는 기본 에이전트가 특정 작업을 위해 호출 할 수있는 전문 보조입니다. 또한 수동으로 그들을 호출 할 수 있습니다 ** @ 언급 ** 메시지에서 그들.
opencode는 두 개의 내장 하위 시약, ** 일반 ** 및 ** 익스플로러 **. 아래에서 볼 수 있습니다.
OpenCode는 두 개의 내장 subagents, **General** 및 **Explore**. 아래에서 볼 수 있습니다.
---
## 내장
opencode는 기본 에이전트와 두 개의 내장 하위 시약으로 제공됩니다.
OpenCode는 기본 에이전트와 두 개의 내장 subagents로 제공됩니다.
---
### 사용 빌드
### 사용 Build
모드 : `primary`
_모드_: `primary`
Build는 **default** 모든 도구가 활성화된 기본 에이전트입니다. 이것은 당신이 파일 가동 및 체계 명령에 가득 차있는 접근을 필요로 하는 발달 일을 위한 표준 에이전트입니다.
---
### 사용 계획
### 사용 Plan
모드 : `primary`
_모드_: `primary`
계획 및 분석을 위해 설계된 제한된 에이전트. 우리는 더 많은 통제를 주고 무인화한 변화를 방지하기 위하여 허가 체계를 이용합니다.
기본적으로, 뒤에 오는 전부는 `ask`로 놓입니다:
@@ -68,41 +68,41 @@ Build는 **default** 모든 도구가 활성화된 기본 에이전트입니다.
---
### 사용 일반
### 사용 General
모드 : `subagent`
_모드_: `subagent`
복잡한 질문을 연구하고 다중 단계 작업을 실행하기위한 범용 에이전트. 전체 도구 액세스 (todo 제외), 그래서 필요할 때 파일 변경을 만들 수 있습니다. 평행한에 있는 일의 다수 단위를 달리기 위하여 이것을 사용하십시오.
---
### 사용 탐구
### 사용 Explore
모드 : `subagent`
_모드_: `subagent`
Codebases를 탐구하는 빠르고, 읽기 전용 에이전트. 파일을 수정할 수 없습니다. 이 작업을 사용하면 패턴, 키워드 검색 코드, 또는 codebase에 대한 질문에 신속하게 파일을 찾을 수 있습니다.
---
### 사용 컴팩트
### 사용 Compaction
모드 : `primary`
_모드_: `primary`
더 작은 요약으로 긴 맥락을 압축하는 숨겨진 시스템 에이전트. 필요한 경우 자동으로 실행되며 UI에서 선택할 수 없습니다.
---
### 사용 제목
### 사용 Title
모드 : `primary`
_모드_: `primary`
짧은 세션 타이틀을 생성하는 숨겨진 시스템 에이전트. 그것은 자동으로 실행하고 UI에서 선택할 수 없습니다.
---
### 사용 요약
### 사용 Summary
모드 : `primary`
_모드_: `primary`
세션 summaries를 만드는 숨겨진 시스템 에이전트. 그것은 자동으로 실행하고 UI에서 선택할 수 없습니다.
@@ -112,20 +112,19 @@ Codebases를 탐구하는 빠르고, 읽기 전용 에이전트. 파일을 수
1. 주요 에이전트을 위해, **Tab ** 열쇠를 사용하여 세션 도중 주기. 구성 된 `switch_agent` keybind도 사용할 수 있습니다.
2. 시약은 invoked 일 수 있습니다: -**Automatically** 그들의 설명에 근거를 둔 특화된 업무를 위한 주요 에이전트에 의하여.
2. Subagents은 invoked 일 수 있습니다:
- **Automatically** 그들의 설명에 근거를 둔 특화된 업무를 위한 주요 에이전트에 의하여.
- 메시지에 대한 subagents\*\*. 예를 들어.
- 메시지에 대한 하위 시약\*\*. 예를 들어.
```txt frame="none"
@general help me search for this function
```
```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** (또는 부모 → Child1 → Child2 →를 통해 전달하기 위해 설정된 `session_child_cycle` keybind)
- **\<Leader>+Left** (또는 `session_child_cycle_reverse` keybind) 부모를 통해 돌아 가기 위해 ← child1 ← child2 ← ... ← 부모
이로 인해 주요 대화와 특이한 시약 작업을 원활하게 전환할 수 있습니다.
이로 인해 주요 대화와 특이한 subagent 작업을 원활하게 전환할 수 있습니다.
---
@@ -135,7 +134,7 @@ Codebases를 탐구하는 빠르고, 읽기 전용 에이전트. 파일을 수
---
### JSON 태그
### JSON
`opencode.json` config 파일에 에이전트 구성:
@@ -178,7 +177,7 @@ Codebases를 탐구하는 빠르고, 읽기 전용 에이전트. 파일을 수
---
### 마크다운
### Markdown
Markdown 파일을 사용하여 에이전트를 정의 할 수 있습니다. 그들에 게:
@@ -542,7 +541,7 @@ Only analyze code and suggest changes.
## #숨겨진
`hidden: true`를 사용해 `@` 자동 완성 메뉴에서 시약을 숨깁니다. 작업 도구를 통해 다른 에이전트에 의해 invoked programmatically 있어야하는 내부 시약에 유용합니다.
`@`를 사용해 `hidden: true` 자동 완성 메뉴에서 시약을 숨깁니다. 작업 도구를 통해 다른 에이전트에 의해 invoked programmatically 있어야하는 내부 시약에 유용합니다.
```json title="opencode.json"
{

View File

@@ -75,7 +75,7 @@ opencode [config](/docs/config)에서 `command` 옵션을 사용하십시오:
---
### 마크다운
### Markdown
Markdown 파일을 사용하여 명령을 정의할 수 있습니다. 그들에 게:

View File

@@ -167,4 +167,4 @@ export default tool({
})
```
여기에 우리는 [`Bun.$`](https://bun.com/docs/runtime/shell) 유틸리티를 사용하여 파이썬 스크립트를 실행합니다.
여기에 우리는 [`Bun.$`](https://bun.com/docs/runtime/shell) 유틸리티를 사용하여 Python 스크립트를 실행합니다.

View File

@@ -39,38 +39,38 @@ GitHub 앱을 설치하고 워크플로를 만들고 비밀을 설정할 수 있
저장소에 `.github/workflows/opencode.yml`에 다음 작업 흐름 파일을 추가합니다. 적절한 `model`를 설정하고 `env`의 API 키가 필요합니다.
```yml title=".github/workflows/opencode.yml" {24,26}
name: opencode
name: opencode
on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
jobs:
opencode:
if: |
contains(github.event.comment.body, '/oc') ||
contains(github.event.comment.body, '/opencode')
runs-on: ubuntu-latest
permissions:
id-token: write
steps:
- name: Checkout repository
uses: actions/checkout@v6
with:
fetch-depth: 1
persist-credentials: false
jobs:
opencode:
if: |
contains(github.event.comment.body, '/oc') ||
contains(github.event.comment.body, '/opencode')
runs-on: ubuntu-latest
permissions:
id-token: write
steps:
- name: Checkout repository
uses: actions/checkout@v6
with:
fetch-depth: 1
persist-credentials: false
- name: Run opencode
uses: anomalyco/opencode/github@latest
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
with:
model: anthropic/claude-sonnet-4-20250514
# share: true
# github_token: xxxx
```
- name: Run OpenCode
uses: anomalyco/opencode/github@latest
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
with:
model: anthropic/claude-sonnet-4-20250514
# share: true
# github_token: xxxx
```
3. ** 비밀의 API 키 저장 **
@@ -89,12 +89,12 @@ jobs:
대안으로, GitHub Action runner의 [붙박이 `GITHUB_TOKEN`](https://docs.github.com/en/actions/tutorials/authenticate-with-github token)을 사용하여 opencode GitHub 앱을 설치하지 않고 사용할 수 있습니다. 워크플로우에서 필요한 권한을 부여하는 것을 확인하십시오.
```yaml
permissions:
id-token: write
contents: write
pull-requests: write
issues: write
```
permissions:
id-token: write
contents: write
pull-requests: write
issues: write
```
또한 [개인 액세스 토큰](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)(PAT)를 사용할 수 있습니다.
@@ -118,7 +118,7 @@ opencode는 다음 GitHub 이벤트에 의해 트리거 될 수 있습니다:
자동화된 작업을 수행하는 일정에 opencode를 실행:
```yaml title=".github/workflows/opencode-scheduled.yml"
name: Scheduled opencode Task
name: Scheduled OpenCode Task
on:
schedule:
@@ -138,7 +138,7 @@ jobs:
with:
persist-credentials: false
- name: Run opencode
- name: Run OpenCode
uses: anomalyco/opencode/github@latest
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
@@ -277,8 +277,8 @@ GitHub에서 opencode를 사용할 수있는 몇 가지 예입니다.
GitHub 문제에서 이 의견 추가.
```
/opencode explain this issue
```
/opencode explain this issue
```
opencode는 모든 코멘트를 포함하여 전체 스레드를 읽고, 명확한 설명과 대답.
@@ -287,8 +287,8 @@ opencode는 모든 코멘트를 포함하여 전체 스레드를 읽고, 명확
GitHub 문제에서:
```
/opencode fix this
```
/opencode fix this
```
opencode는 새로운 지점을 만들 것이며 변경 사항을 실행하고 PR을 변경합니다.
@@ -297,8 +297,8 @@ opencode는 새로운 지점을 만들 것이며 변경 사항을 실행하고 P
GitHub PR에 다음 댓글을 남겨주세요.
```
Delete the attachment from S3 when the note is removed /oc
```
Delete the attachment from S3 when the note is removed /oc
```
opencode는 요청한 변경을 구현하고 동일한 PR에 커밋합니다.
@@ -307,9 +307,9 @@ opencode는 요청한 변경을 구현하고 동일한 PR에 커밋합니다.
PR의 "Files" 탭의 코드 라인에 직접 댓글을 남겨주세요. opencode는 파일, 줄 번호 및 diff 컨텍스트를 자동으로 감지하여 정확한 응답을 제공합니다.
```
[Comment on specific lines in Files tab]
/oc add error handling here
```
[Comment on specific lines in Files tab]
/oc add error handling here
```
특정 라인에 대한 의견이 있을 때, opencode는 다음과 같습니다.

View File

@@ -35,7 +35,7 @@ opencode는 일반 GitLab 파이프라인에서 작동합니다. [CI 구성품](
- component: $CI_SERVER_FQDN/nagyv/gitlab-opencode/opencode@2
inputs:
config_dir: ${CI_PROJECT_DIR}/opencode-config
auth_json: $OPENCODE_AUTH_JSON # The variable name for your opencode authentication JSON
auth_json: $OPENCODE_AUTH_JSON # The variable name for your OpenCode authentication JSON
command: optional-custom-command
message: "Your prompt here"
```
@@ -91,7 +91,7 @@ opencode는 GitLab CI/CD 파이프라인에서 실행되며, 여기서 설정해
- apt-get install --yes glab
- echo "Configuring glab"
- echo $GITLAB_HOST
- echo "Creating opencode auth configuration"
- echo "Creating OpenCode auth configuration"
- mkdir --parents ~/.local/share/opencode
- |
cat > ~/.local/share/opencode/auth.json << EOF
@@ -104,10 +104,10 @@ opencode는 GitLab CI/CD 파이프라인에서 실행되며, 여기서 설정해
EOF
- echo "Configuring git"
- git config --global user.email "opencode@gitlab.com"
- git config --global user.name "opencode"
- git config --global user.name "OpenCode"
- echo "Testing glab"
- glab issue list
- echo "Running opencode"
- echo "Running OpenCode"
- |
opencode run "
You are an AI assistant helping with GitLab operations.
@@ -169,8 +169,8 @@ opencode는 GitLab CI/CD 파이프라인에서 실행되며, 여기서 설정해
GitLab 문제에서이 코멘트를 추가하십시오.
```
@opencode explain this issue
```
@opencode explain this issue
```
opencode는 문제와 대답을 명확하게 설명합니다.
@@ -179,8 +179,8 @@ opencode는 문제와 대답을 명확하게 설명합니다.
GitLab 문제에서, 말한다:
```
@opencode fix this
```
@opencode fix this
```
opencode는 새로운 지점을 만들 것이며 변경 사항을 구현하고 변경 사항을 병합 요청을 엽니다.
@@ -189,7 +189,7 @@ opencode는 새로운 지점을 만들 것이며 변경 사항을 구현하고
GitLab 병합 요청에 대한 다음 의견을 남겨주세요.
```
@opencode review this merge request
```
@opencode review this merge request
```
opencode는 병합 요청을 검토하고 피드백을 제공합니다.

View File

@@ -7,7 +7,7 @@ import { Tabs, TabItem } from "@astrojs/starlight/components"
import config from "../../../../config.mjs"
export const console = config.console
[**opencode**](/)는 오픈 소스 AI 코딩 에이전트입니다. terminal 기반 인터페이스, 데스크탑 앱 또는 IDE 확장으로 사용할 수 있습니다.
[**OpenCode**](/)는 오픈 소스 AI 코딩 에이전트입니다. terminal 기반 인터페이스, 데스크탑 앱 또는 IDE 확장으로 사용할 수 있습니다.
![opencode TUI with the opencode theme](../../../assets/lander/screenshot.png)
@@ -17,7 +17,7 @@ export const console = config.console
### 필수품
당신의 terminal에 있는 opencode를 사용하려면, 당신은 필요로 할 것입니다:
당신의 terminal에 있는 OpenCode를 사용하려면, 당신은 필요로 할 것입니다:
1. 현대 terminal 에뮬레이터는 좋아합니다:
@@ -26,13 +26,13 @@ export const console = config.console
- [Ghostty](https://ghostty.org), 리눅스 및 macOS
- [Kitty](https://sw.kovidgoyal.net/kitty/), 리눅스 및 macOS
2. 사용하려는 LLM 공급자를 위한 API 열쇠.
2. 사용하려는 LLM 공급자를 위한 API .
---
## 설치
opencode를 설치하는 가장 쉬운 방법은 설치 스크립트를 통해 입니다.
OpenCode를 설치하는 가장 쉬운 방법은 설치 스크립트를 통해 입니다.
```bash
curl -fsSL https://opencode.ai/install | bash
@@ -74,13 +74,13 @@ curl -fsSL https://opencode.ai/install | bash
</Tabs>
- ** macOS 및 Linux에서 홈 Brew 사용 **
- ** macOS 및 Linux에서 Homebrew 사용 **
```bash
brew install anomalyco/tap/opencode
```
> 최신 릴리스를 위해 opencode 탭을 사용하는 것이 좋습니다. 공식 `brew install opencode` 공식은 Homebrew 팀에 의해 유지되고 더 자주 업데이트됩니다.
> 최신 릴리스를 위해 OpenCode 탭을 사용하는 것이 좋습니다. 공식 `brew install opencode` 공식은 Homebrew 팀에 의해 유지되고 더 자주 업데이트됩니다.
- **Ar Linux에서 Paru를 사용 **
@@ -91,10 +91,10 @@ curl -fsSL https://opencode.ai/install | bash
#### 윈도우
:::tip[추천: WSL 사용]
Windows에서 최고의 경험을 위해 [Windows Subsystem for Linux (WSL)](/docs/windows-wsl)를 사용하는 것이 좋습니다. opencode의 기능으로 더 나은 성능과 전체 호환성을 제공합니다.
Windows에서 최고의 경험을 위해 [Windows Subsystem for Linux (WSL)](/docs/windows-wsl)를 사용하는 것이 좋습니다. OpenCode의 기능으로 더 나은 성능과 전체 호환성을 제공합니다.
:::
- ** 초콜릿 **
- ** Chocolatey **
```bash
choco install opencode
@@ -112,7 +112,7 @@ Windows에서 최고의 경험을 위해 [Windows Subsystem for Linux (WSL)](/do
npm install -g opencode-ai
```
- **mise**
- **Mise**
```bash
mise use -g github:anomalyco/opencode
@@ -124,7 +124,7 @@ Windows에서 최고의 경험을 위해 [Windows Subsystem for Linux (WSL)](/do
docker run -it --rm ghcr.io/anomalyco/opencode
```
Bun을 사용하여 Windows에서 opencode 설치 지원은 현재 진행 중입니다.
Bun을 사용하여 Windows에서 OpenCode 설치 지원은 현재 진행 중입니다.
[Releases](https://github.com/anomalyco/opencode/releases)에서 이진을 할 수도 있습니다.
@@ -132,10 +132,10 @@ Bun을 사용하여 Windows에서 opencode 설치 지원은 현재 진행 중입
## 구성
opencode를 사용하면 API 키를 구성하여 LLM 공급자를 사용할 수 있습니다.
OpenCode를 사용하면 API 키를 구성하여 LLM 공급자를 사용할 수 있습니다.
LLM 공급자를 사용하는 새로운 경우, [OpenCode Zen](/docs/zen)를 사용하는 것이 좋습니다.
opencode에 의해 테스트 및 확인 된 모델의 큐레이터 목록입니다.
OpenCode에 의해 테스트 및 확인 된 모델의 큐레이터 목록입니다.
팀.
1. TUI에서 `/connect` 명령을 실행하고, opencode를 선택하고, [opencode.ai/auth](https://opencode.ai/auth)에 머리를 선택합니다.
@@ -155,7 +155,7 @@ opencode에 의해 테스트 및 확인 된 모델의 큐레이터 목록입니
└ enter
```
또는 다른 공급자 중 하나를 선택할 수 있습니다. [더 알아보기](/docs/providers#directory).
158| 또는 다른 공급자 중 하나를 선택할 수 있습니다. [더 알아보기](/docs/providers#directory).
---
@@ -168,33 +168,33 @@ opencode에 의해 테스트 및 확인 된 모델의 큐레이터 목록입니
cd /path/to/project
```
opencode를 실행합니다.
OpenCode를 실행합니다.
```bash
opencode
```
다음, 다음 명령을 실행하여 프로젝트의 opencode를 초기화합니다.
다음, 다음 명령을 실행하여 프로젝트의 OpenCode를 초기화합니다.
```bash frame="none"
/init
```
opencode를 사용하여 프로젝트를 분석하고 `AGENTS.md` 파일을 만들 수 있습니다.
OpenCode를 사용하여 프로젝트를 분석하고 `AGENTS.md` 파일을 만들 수 있습니다.
프로젝트 루트.
:::tip
프로젝트의 `AGENTS.md` 파일을 Git에 투입해야 합니다.
:::
이 도움말 opencode는 프로젝트 구조와 코딩 패턴을 이해
이 도움말 OpenCode는 프로젝트 구조와 코딩 패턴을 이해
사용.
---
## 사용법
opencode를 사용하여 프로젝트에 작업할 준비가 되어 있습니다. 자주 묻는 질문
OpenCode를 사용하여 프로젝트에 작업할 준비가 되어 있습니다. 자주 묻는 질문
모두!
AI 코딩 에이전트를 사용하는 새로운 경우, 여기에 할 수있는 몇 가지 예입니다
@@ -204,7 +204,7 @@ AI 코딩 에이전트를 사용하는 새로운 경우, 여기에 할 수있는
## 질문
Codebase를 설명하기 위해 opencode를 요청할 수 있습니다.
Codebase를 설명하기 위해 OpenCode를 요청할 수 있습니다.
:::tip
`@` 키를 사용하여 프로젝트에서 파일을 검색합니다.
@@ -220,71 +220,71 @@ How is authentication handled in @packages/functions/src/api/index.ts
### 추가 기능
프로젝트에 새로운 기능을 추가하려면 opencode를 요청할 수 있습니다. 우리는 먼저 계획을 만들 것을 묻는 것이 좋습니다.
프로젝트에 새로운 기능을 추가하려면 OpenCode를 요청할 수 있습니다. 우리는 먼저 계획을 만들 것을 묻는 것이 좋습니다.
1. **플랜을 선택 **
opencode는 Plan mode 로 변경할 수 있는 능력을 비활성화하고
대신 제안 how 그것은 기능을 구현할 것입니다.
OpenCode는 Plan mode 로 변경할 수 있는 능력을 비활성화하고
대신 제안 how 그것은 기능을 구현할 것입니다.
**Tab** 키를 사용하여 전환합니다. 오른쪽 하단에 있는 이 지표를 볼 수 있습니다.
**Tab** 키를 사용하여 전환합니다. 오른쪽 하단에 있는 이 지표를 볼 수 있습니다.
```bash frame="none" title="Switch to Plan mode"
<TAB>
```
```bash frame="none" title="Switch to Plan mode"
<TAB>
```
이제 우리가해야 할 일을 설명합니다.
이제 우리가해야 할 일을 설명합니다.
```txt frame="none"
When a user deletes a note, we'd like to flag it as deleted in the database.
Then create a screen that shows all the recently deleted notes.
From this screen, the user can undelete a note or permanently delete it.
```
```txt frame="none"
When a user deletes a note, we'd like to flag it as deleted in the database.
Then create a screen that shows all the recently deleted notes.
From this screen, the user can undelete a note or permanently delete it.
```
당신이 원하는 것을 이해하기 위해 opencode를 충분히 세부 정보를 제공하려는. 그것은 도움
팀의 주니어 개발자에게 이야기하고 싶습니다.
당신이 원하는 것을 이해하기 위해 OpenCode를 충분히 세부 정보를 제공하려는. 그것은 도움
팀의 주니어 개발자에게 이야기하고 싶습니다.
:::tip
opencode를 많은 컨텍스트와 예제를 제공하여 당신이 무엇을 이해하는 데 도움이
이름 \*
:::
:::tip
OpenCode를 많은 컨텍스트와 예제를 제공하여 당신이 무엇을 이해하는 데 도움이
이름 \*
:::
2. **플랜에 대해서 **
플랜을 제공하면 피드백을 제공하거나 자세한 내용을 추가 할 수 있습니다.
플랜을 제공하면 피드백을 제공하거나 자세한 내용을 추가 할 수 있습니다.
```txt frame="none"
We'd like to design this new screen using a design I've used before.
[Image #1] Take a look at this image and use it as a reference.
```
```txt frame="none"
We'd like to design this new screen using a design I've used before.
[Image #1] Take a look at this image and use it as a reference.
```
:::tip
단말에 이미지를 드래그하고 드롭하여 프롬프트에 추가합니다.
:::
:::tip
단말에 이미지를 드래그하고 드롭하여 프롬프트에 추가합니다.
:::
opencode는 어떤 이미지를 스캔할 수 있습니다. 당신은 할 수
이 작업을 수행하고 끝으로 이미지를 삭제합니다.
OpenCode는 어떤 이미지를 스캔할 수 있습니다. 당신은 할 수
이 작업을 수행하고 끝으로 이미지를 삭제합니다.
3. ** 기능 구축 **
플랜으로 편안하게 느끼면 Build mode by
**Tab** 키를 다시 입력합니다.
플랜으로 편안하게 느끼면 Build mode by
**Tab** 키를 다시 입력합니다.
```bash frame="none"
<TAB>
```
```bash frame="none"
<TAB>
```
그리고 변경을 요청합니다.
그리고 변경을 요청합니다.
```bash frame="none"
Sounds good! Go ahead and make the changes.
```
```bash frame="none"
Sounds good! Go ahead and make the changes.
```
---
### 변경
더 똑바른 변화를 위해, 당신은 opencode를 직접 그것을 건설할 수 있습니다
더 똑바른 변화를 위해, 당신은 OpenCode를 직접 그것을 건설할 수 있습니다
첫 플랜을 검토하지 않고.
```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts"
@@ -293,14 +293,14 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts
```
좋은 양의 세부 사항을 제공 하려면 opencode가 올바른
좋은 양의 세부 사항을 제공 하려면 OpenCode가 올바른
이름 \*
---
### Undo 변경
opencode를 호출하면 변경 사항을 만들 수 있습니다.
OpenCode를 호출하면 변경 사항을 만들 수 있습니다.
```txt frame="none" "@packages/functions/src/api/index.ts"
Can you refactor the function in @packages/functions/src/api/index.ts?
@@ -313,14 +313,14 @@ Can you refactor the function in @packages/functions/src/api/index.ts?
/undo
```
opencode는 이제 당신이 만든 변경을 반전하고 원래 메시지를 표시
OpenCode는 이제 당신이 만든 변경을 반전하고 원래 메시지를 표시
다시.
```txt frame="none" "@packages/functions/src/api/index.ts"
Can you refactor the function in @packages/functions/src/api/index.ts?
```
여기에서 당신은 신속하고 다시 시도 opencode를 요청할 수 있습니다.
여기에서 당신은 신속하고 다시 시도 OpenCode를 요청할 수 있습니다.
:::tip
`/undo`를 여러 번 실행할 수 있습니다.

View File

@@ -182,7 +182,7 @@ opencode 설정에서 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할
PHP를 Intelephense는 라이센스 키를 통해 프리미엄 기능을 제공합니다. 텍스트 파일에서 키 (만)를 배치하여 라이센스 키를 제공 할 수 있습니다.
- macOS/리눅스에서: `$HOME/intelephense/licence.txt`
- Windows에서: `%USERPROFILE%/intelephense/licence.txt`
- macOS/리눅스에서: `$HOME/intelephense/license.txt`
- Windows에서: `%USERPROFILE%/intelephense/license.txt`
파일에는 추가 내용이 없습니다.

View File

@@ -400,9 +400,9 @@ MCP 서버 도구는 서버 이름으로 prefix로 등록되므로 서버의 모
---
#### 센트리
#### Sentry
[Sentry MCP 서버](https://mcp.sentry.dev)를 추가하여 센트리 프로젝트와 문제와 상호 작용합니다.
[Sentry MCP 서버](https://mcp.sentry.dev)를 추가하여 Sentry 프로젝트와 문제와 상호 작용합니다.
```json title="opencode.json" {4-8}
{
@@ -433,7 +433,7 @@ Show me the latest unresolved issues in my project. use sentry
---
### 콘텍스트7
### Context7
[Context7 MCP 서버](https://github.com/upstash/context7)을 추가하여 문서를 검색합니다.
@@ -482,7 +482,7 @@ When you need to search docs, use `context7` tools.
---
## Grep by Vercel에 의해
## Grep by Vercel
[Grep by Vercel](https://grep.app) MCP 서버를 추가하여 GitHub에서 코드 스니펫을 검색합니다.

View File

@@ -36,7 +36,7 @@ opencode는 2개의 붙박이 형태로 옵니다.
- `write` - 새로운 파일을 만들 수 없습니다
- `edit` - `.opencode/plans/*.md`에 위치한 파일을 제외하고 기존 파일을 수정할 수 없습니다.
- `patch` - 패치 적용
- `bash` - 포탄 명령을 실행할 수 없습니다
- `bash` - shell 명령을 실행할 수 없습니다
이 모드는 코드를 분석하기 위해 AI를 원할 때 유용합니다. 변경 사항을 제안하거나 코드베이스에 실제 수정없이 계획을 만들 수 있습니다.
@@ -226,7 +226,7 @@ Markdown 파일 이름은 모드 이름 (예 : `review.md`는 `review` 모드를
| 도구 | 설명 |
| ----------- | ------------------ |
| `bash` | 명령 실행 |
| `bash` | shell 명령 실행 |
| `edit` | 기존 파일 수정 |
| `write` | 새 파일 만들기 |
| `read` | 읽는 파일 내용 |

View File

@@ -134,7 +134,7 @@ opencode 권한은 도구 이름에 의해 키 입력되며, 두 개의 안전
- `glob` - 파일 globbing (glob 패턴 매칭)
- `grep` - 콘텐츠 검색 ( regex 패턴 매칭)
- `list` - 디렉토리의 목록 파일 (폴더 경로 매칭)
- `bash` - 명령 실행 (`git status --porcelain`와 같은 팟 명령)
- `bash` - shell 명령 실행 (`git status --porcelain`와 같은 팟 명령)
- `task` - 시약 출시 (미시 시약 유형)
- `skill` - 기술을 로딩 (기술 이름을 매칭)
- `lsp` - LSP 쿼리 실행 (현재 비 과립)

View File

@@ -192,7 +192,7 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree
- `todo.updated`
#### 포탄 사건
#### Shell 이벤트
- `shell.env`
@@ -260,7 +260,7 @@ export const EnvProtection = async ({ project, client, $, directory, worktree })
### Inject 환경 변수
환경 변수를 모든 실행 (AI 도구 및 사용자 terminal)로 주사하십시오.
환경 변수를 모든 shell 실행 (AI 도구 및 사용자 terminal)로 주사하십시오.
```javascript title=".opencode/plugins/inject-env.js"
export const InjectEnvPlugin = async () => {
@@ -312,7 +312,7 @@ export const CustomToolsPlugin: Plugin = async (ctx) => {
### 로깅
구조화된 로깅을 위한 `console.log` 대신에 `client.app.log()`를 사용하십시오:
구조화된 로깅을 위한 `client.app.log()` 대신에 `console.log`를 사용하십시오:
```ts title=".opencode/plugins/my-plugin.ts"
export const MyPlugin = async ({ client }) => {

View File

@@ -140,40 +140,40 @@ opencode로 Amazon Bedrock을 사용하려면:
opencode를 실행하는 동안 이러한 환경 변수 중 하나를 설정:
```bash
# Option 1: Using AWS access keys
AWS_ACCESS_KEY_ID=XXX AWS_SECRET_ACCESS_KEY=YYY opencode
# Option 1: Using AWS access keys
AWS_ACCESS_KEY_ID=XXX AWS_SECRET_ACCESS_KEY=YYY opencode
# Option 2: Using named AWS profile
AWS_PROFILE=my-profile opencode
# Option 2: Using named AWS profile
AWS_PROFILE=my-profile opencode
# Option 3: Using Bedrock bearer token
AWS_BEARER_TOKEN_BEDROCK=XXX opencode
```
# Option 3: Using Bedrock bearer token
AWS_BEARER_TOKEN_BEDROCK=XXX opencode
```
또는 bash 프로필에 추가:
```bash title="~/.bash_profile"
export AWS_PROFILE=my-dev-profile
export AWS_REGION=us-east-1
```
export AWS_PROFILE=my-dev-profile
export AWS_REGION=us-east-1
```
#### 설정 파일 (추천)
프로젝트 별 또는 지속적 구성의 경우 `opencode.json`를 사용하십시오.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"amazon-bedrock": {
"options": {
"region": "us-east-1",
"profile": "my-aws-profile"
}
}
}
}
```
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"amazon-bedrock": {
"options": {
"region": "us-east-1",
"profile": "my-aws-profile"
}
}
}
}
```
** 유효한 옵션:**
@@ -190,19 +190,19 @@ export AWS_REGION=us-east-1
Bedrock의 VPC 엔드포인트를 사용하는 경우:
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"amazon-bedrock": {
"options": {
"region": "us-east-1",
"profile": "production",
"endpoint": "https://bedrock-runtime.us-east-1.vpce-xxxxx.amazonaws.com"
}
}
}
}
```
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"amazon-bedrock": {
"options": {
"region": "us-east-1",
"profile": "production",
"endpoint": "https://bedrock-runtime.us-east-1.vpce-xxxxx.amazonaws.com"
}
}
}
}
```
:::note
`endpoint` 옵션은 일반적인 `baseURL` 옵션의 별칭입니다. `endpoint`와 `baseURL` 둘 다 지정되는 경우에, `endpoint`는 전진합니다.
@@ -335,8 +335,8 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니
또는 bash 프로파일에 추가:
```bash title="~/.bash_profile"
export AZURE_RESOURCE_NAME=XXX
```
export AZURE_RESOURCE_NAME=XXX
```
6. `/models` 명령을 실행하여 배포 된 모델을 선택하십시오.
@@ -383,8 +383,8 @@ export AZURE_RESOURCE_NAME=XXX
또는 bash 프로파일에 추가:
```bash title="~/.bash_profile"
export AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX
```
export AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX
```
6. `/models` 명령을 실행하여 배포 된 모델을 선택하십시오.
@@ -479,8 +479,8 @@ Cloudflare AI 게이트웨이는 OpenAI, Anthropic, Workers AI 등의 모델에
또는 환경 변수로 설정한다.
```bash title="~/.bash_profile"
export CLOUDFLARE_API_TOKEN=your-api-token
```
export CLOUDFLARE_API_TOKEN=your-api-token
```
5. 모델을 선택하려면 `/models` 명령을 실행하십시오.
@@ -491,18 +491,18 @@ export CLOUDFLARE_API_TOKEN=your-api-token
opencode config를 통해 모델을 추가할 수 있습니다.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"cloudflare-ai-gateway": {
"models": {
"openai/gpt-4o": {},
"anthropic/claude-sonnet-4": {}
}
}
}
}
```
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"cloudflare-ai-gateway": {
"models": {
"openai/gpt-4o": {},
"anthropic/claude-sonnet-4": {}
}
}
}
}
```
---
@@ -669,7 +669,7 @@ Select**OAuth**와 브라우저는 권한이 없습니다.
1. [GitLab User Settings > Access Tokens](https://gitlab.com/-/user settings/personal access tokens)로 이동
2. 새 토큰 추가 \*\*
3. 이름: `opencode`의 범위: `api`
3. 이름: `OpenCode`의 범위: `api`
4. 토큰 복사 (`glpat-`와 함께 시작)
5. terminal에서 그것을 입력하십시오
@@ -848,16 +848,16 @@ opencode로 Google Vertex AI를 사용하려면:
opencode를 실행하면서 설정한다.
```bash
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json GOOGLE_CLOUD_PROJECT=your-project-id opencode
```
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json GOOGLE_CLOUD_PROJECT=your-project-id opencode
```
또는 bash 프로파일에 추가하십시오.
```bash title="~/.bash_profile"
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
export GOOGLE_CLOUD_PROJECT=your-project-id
export VERTEX_LOCATION=global
```
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
export GOOGLE_CLOUD_PROJECT=your-project-id
export VERTEX_LOCATION=global
```
:::tip
`global` 지구는 가용성을 개량하고 추가 비용 없이 과실을 감소시킵니다. 데이터 거주 요건에 대한 지역 엔드포인트(e.g., `us-central1`)를 사용하십시오. [더 알아보기](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#regional and global endpoints)
@@ -1395,17 +1395,17 @@ OpenCode Zen은 opencode 팀에서 제공하는 테스트 및 검증된 모델
opencode config를 통해 추가 모델을 추가할 수 있습니다.
```json title="opencode.json" {6}
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"openrouter": {
"models": {
"somecoolnewmodel": {}
}
}
}
}
```
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"openrouter": {
"models": {
"somecoolnewmodel": {}
}
}
}
}
```
5. 당신은 또한 당신의 opencode config를 통해 그들을 주문을 받아서 만들 수 있습니다. 공급자 지정의 예입니다.
@@ -1459,14 +1459,14 @@ SAP AI Core는 OpenAI, Anthropic, Google, Amazon, Meta, Mistral 및 AI21의 40+
또는 `AICORE_SERVICE_KEY` 환경 변수를 설정:
```bash
AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}' opencode
```
AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}' opencode
```
또는 bash 프로파일에 추가:
```bash title="~/.bash_profile"
export AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}'
```
export AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}'
```
4. 선택적으로 배치 ID 및 자원 그룹:
@@ -1736,17 +1736,17 @@ opencode config를 통해 모델을 사용자 정의 할 수 있습니다. 공
opencode config를 통해 추가 모델을 추가할 수 있습니다.
```json title="opencode.json" {6}
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"zenmux": {
"models": {
"somecoolnewmodel": {}
}
}
}
}
```
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"zenmux": {
"models": {
"somecoolnewmodel": {}
}
}
}
}
```
---

View File

@@ -129,7 +129,7 @@ opencode가 `AGENTS.md`에 있는 자동적으로 파스 파일 참조를 하지
## opencode.json 사용
`opencode.json`의 `instructions` 필드를 사용하는 것이 좋습니다.
`instructions`의 `opencode.json` 필드를 사용하는 것이 좋습니다.
```json title="opencode.json"
{

View File

@@ -28,9 +28,9 @@ npm install @opencode-ai/sdk
opencode의 인스턴스 만들기:
```javascript
import { createopencode } from "@opencode-ai/sdk"
import { createOpencode } from "@opencode-ai/sdk"
const { client } = await createopencode()
const { client } = await createOpencode()
```
서버와 클라이언트 모두 시작
@@ -52,9 +52,9 @@ const { client } = await createopencode()
구성 객체를 전달할 수 있습니다. 인스턴스는 여전히 `opencode.json`를 선택하지만 구성 인라인을 추가 할 수 있습니다.
```javascript
import { createopencode } from "@opencode-ai/sdk"
import { createOpencode } from "@opencode-ai/sdk"
const opencode = await createopencode({
const opencode = await createOpencode({
hostname: "127.0.0.1",
port: 4096,
config: {
@@ -72,9 +72,9 @@ opencode.server.close()
opencode의 실행 인스턴스가 이미 있다면 클라이언트 인스턴스를 만들 수 있습니다.
```javascript
import { createopencodeClient } from "@opencode-ai/sdk"
import { createOpencodeClient } from "@opencode-ai/sdk"
const client = createopencodeClient({
const client = createOpencodeClient({
baseUrl: "http://localhost:4096",
})
```
@@ -243,7 +243,7 @@ const { providers, default: defaults } = await client.config.providers()
| `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 })` | 명령을 실행 | <a href={typesUrl}><code>AssistantMessage</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` |

View File

@@ -177,7 +177,7 @@ opencode 서버는 다음과 같은 API를 노출합니다.
| `GET` | `/session/:id/message/:messageID` | 메시지 보내기 | `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}` |
| `POST` | `/session/:id/prompt_async` | 비동기적으로 메시지 보내기 | 몸: `/session/:id/message`와 동일, `204 No Content`를 반환 |
| `POST` | `/session/:id/command` | 슬래시 명령어 실행 | 본체: `{ messageID?, agent?, model?, command, arguments }`, 반환 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}` |
| `POST` | `/session/:id/shell` | 명령 실행 | 체: `{ agent, model?, command }`, 반환 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}` |
| `POST` | `/session/:id/shell` | shell 명령 실행 | 체: `{ agent, model?, command }`, 반환 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}` |
---

View File

@@ -25,7 +25,7 @@ opencode 이 위치를 검색:
## 발견의 이해
Project-local paths의 경우, opencode는 git worktree에 도달 할 때까지 현재 작업 디렉토리에서 걷습니다.
그것은 `.opencode/`에 있는 어떤 어울리는 `skills/*/SKILL.md` 및 어떤 어울리는 `.claude/skills/*/SKILL.md` 또는 `.agents/skills/*/SKILL.md`를 방법 적재합니다.
그것은 `skills/*/SKILL.md`에 있는 어떤 어울리는 `.opencode/` 및 어떤 어울리는 `.claude/skills/*/SKILL.md` 또는 `.agents/skills/*/SKILL.md`를 방법 적재합니다.
세계적인 정의는 또한 `~/.config/opencode/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md` 및 `~/.agents/skills/*/SKILL.md`에서 적재됩니다.

View File

@@ -15,7 +15,7 @@ opencode를 사용하면 여러 내장 테마 중 하나에서 선택할 수 있
-**체크 지원**: `echo $COLORTERM` - 그것은 `truecolor` 또는 `24bit`를 출력해야 합니다
- ** truecolor 사용 가능**: 프로파일에서 환경 변수 `COLORTERM=truecolor`를 설정
- ** truecolor 사용 가능**: shell 프로파일에서 환경 변수 `COLORTERM=truecolor`를 설정
- **Terminal 호환성 **: terminal 에뮬레이터 지원 24 비트 색상 (iTerm2, Alacritty, Kitty, Windows Terminal 및 GNOME Terminal의 최신 버전)
truecolor 지원 없이, 테마는 감소된 색깔 정확도로 나타날지도 모릅니다 또는 가장 가까운 256 색깔 대류로 뒤떨어질지도 모릅니다.

View File

@@ -47,7 +47,7 @@ description: Manage the tools an LLM can use.
###### bash
프로젝트 환경에서 명령을 실행합니다.
프로젝트 환경에서 shell 명령을 실행합니다.
```json title="opencode.json" {4}
{
@@ -58,7 +58,7 @@ description: Manage the tools an LLM can use.
}
```
이 도구는 `npm install`, `git status` 또는 다른 명령과 같은 terminal 명령을 실행하는 LLM을 허용합니다.
이 도구는 `npm install`, `git status` 또는 다른 shell 명령과 같은 terminal 명령을 실행하는 LLM을 허용합니다.
---

View File

@@ -47,7 +47,7 @@ opencode 데스크톱은 배경에서 로컬 opencode 서버 (`opencode-cli` sid
- 완전히 종료하고 앱을 다시 시작.
- 앱이 오류 화면을 보여 주면 ** Restart**를 클릭하고 오류 세부 정보를 복사합니다.
- macOS만: `opencode` 메뉴 -> **웹뷰 **(UI가 공백/frozen인 경우).
- macOS만: `OpenCode` 메뉴 -> **웹뷰 **(UI가 공백/frozen인 경우).
---

View File

@@ -45,7 +45,7 @@ How is auth handled in @packages/functions/src/api/index.ts?
## Bash 명령
`!`를 사용하여 명령을 실행합니다.
`!`를 사용하여 shell 명령을 실행합니다.
```bash frame="none"
!ls -la
@@ -301,7 +301,7 @@ Unshare 현재 세션. [더 알아보기](/docs/share#un-sharing).
export EDITOR="code --wait"
```
영원한 만들기 위하여, 당신의 포탄 단면도에 이것을 추가하십시오;
영원한 만들기 위하여, 당신의 shell 프로파일에 이것을 추가하십시오;
`~/.bashrc`, `~/.zshrc`, 등.
</TabItem>