Add files using upload-large-folder tool

0dbc9de verified about 1 month ago

3.7 kB

---
title: Web
description: 브라우저에서 OpenCode 사용하기.
---
opencode는 브라우저에서 웹 응용 프로그램을 실행할 수 있으며 terminal을 필요로하지 않고 동일한 강력한 AI 코딩 경험을 제공합니다.

![opencode Web - 새로운 세션](../../../assets/web/web-homepage-new-session.png)

## 시작하기

실행하여 웹 인터페이스를 시작:

```bash
opencode web
```

`127.0.0.1`의 로컬 서버를 랜덤 사용 가능한 포트로 시작하고 기본 브라우저에서 opencode를 자동으로 엽니다.

:::caution
`OPENCODE_SERVER_PASSWORD`가 설정되지 않은 경우 서버가 중단되지 않습니다. 이것은 로컬 사용을위한 괜찮지만 네트워크 액세스를 설정해야합니다.
:::

:::tip[Windows 사용자]
최고의 경험을 위해서는 PowerShell보다 `opencode web`를 실행하십시오. 적절한 파일 시스템 액세스 및 terminal 통합을 보장합니다.
:::

---
## 구성

명령줄 플래그 또는 [config file](/docs/config)에서 웹 서버를 구성할 수 있습니다.

## 포트

기본적으로 opencode는 사용할 수 있는 포트를 선택합니다. 포트를 지정할 수 있습니다:

```bash
opencode web --port 4096
```

## 호스트 이름

기본적으로 서버는 `127.0.0.1` (localhost only)에 바인딩합니다. 네트워크에서 opencode를 사용할 수 있도록:

```bash
opencode web --hostname 0.0.0.0
```

`0.0.0.0`를 사용할 때, opencode는 로컬 및 네트워크 주소를 모두 표시합니다.

```
  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096
```

### mDNS 발견

로컬 네트워크에서 서버를 발견할 수 있는 mDNS:

```bash
opencode web --mdns
```

이 자동으로 `0.0.0.0`에 hostname을 설정하고 `opencode.local`로 서버를 광고합니다.

동일한 네트워크에서 여러 인스턴스를 실행하려면 mDNS 도메인 이름을 지정할 수 있습니다.

```bash
opencode web --mdns --mdns-domain myproject.local
```

###### CORS

CORS에 대한 추가 도메인을 허용하려면 (사용자 정의 frontends에 적합) :

```bash
opencode web --cors https://example.com
```

### 인증

액세스를 보호하려면 `OPENCODE_SERVER_PASSWORD` 환경 변수를 사용하여 암호를 설정하십시오.

```bash
OPENCODE_SERVER_PASSWORD=secret opencode web
```

`opencode`에 대한 사용자의 기본값은 `OPENCODE_SERVER_USERNAME`로 변경할 수 있습니다.

---
## 웹 인터페이스 사용

시작되면 웹 인터페이스는 opencode 세션에 액세스 할 수 있습니다.

## 세션

홈페이지에서 세션을 보고 관리합니다. 활성 세션을 볼 수 있으며 새로운 것을 시작합니다.

![opencode Web - Active Session](../../../assets/web/web-homepage-active-session.png)

## 서버 상태

"See Servers"를 클릭하여 연결된 서버와 상태를 볼 수 있습니다.

![opencode Web - Servers 참조](../../../assets/web/web-homepage-see-servers.png)

---
## 터미널 연결

실행 웹 서버에 terminal TUI를 연결할 수 있습니다.

```bash
# Start the web server
opencode web --port 4096

# In another terminal, attach the TUI
opencode attach http://localhost:4096
```

웹 인터페이스와 terminal을 동시에 사용할 수 있도록, 같은 세션과 상태를 공유합니다.

---
## 구성 파일

`opencode.json` config 파일에서 서버 설정을 구성할 수 있습니다:

```json
{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}
```

Command line flags는 config 파일 설정에 대한 precedence를 가져옵니다.

	---
	title: Web
	description: 브라우저에서 OpenCode 사용하기.
	---

	opencode는 브라우저에서 웹 응용 프로그램을 실행할 수 있으며 terminal을 필요로하지 않고 동일한 강력한 AI 코딩 경험을 제공합니다.

	![opencode Web - 새로운 세션](../../../assets/web/web-homepage-new-session.png)

	## 시작하기

	실행하여 웹 인터페이스를 시작:

	```bash
	opencode web
	```

	`127.0.0.1`의 로컬 서버를 랜덤 사용 가능한 포트로 시작하고 기본 브라우저에서 opencode를 자동으로 엽니다.

	:::caution
	`OPENCODE_SERVER_PASSWORD`가 설정되지 않은 경우 서버가 중단되지 않습니다. 이것은 로컬 사용을위한 괜찮지만 네트워크 액세스를 설정해야합니다.
	:::

	:::tip[Windows 사용자]
	최고의 경험을 위해서는 PowerShell보다 `opencode web`를 실행하십시오. 적절한 파일 시스템 액세스 및 terminal 통합을 보장합니다.
	:::

	---

	## 구성

	명령줄 플래그 또는 [config file](/docs/config)에서 웹 서버를 구성할 수 있습니다.

	## 포트

	기본적으로 opencode는 사용할 수 있는 포트를 선택합니다. 포트를 지정할 수 있습니다:

	```bash
	opencode web --port 4096
	```

	## 호스트 이름

	기본적으로 서버는 `127.0.0.1` (localhost only)에 바인딩합니다. 네트워크에서 opencode를 사용할 수 있도록:

	```bash
	opencode web --hostname 0.0.0.0
	```

	`0.0.0.0`를 사용할 때, opencode는 로컬 및 네트워크 주소를 모두 표시합니다.

	```
	Local access: http://localhost:4096
	Network access: http://192.168.1.100:4096
	```

	### mDNS 발견

	로컬 네트워크에서 서버를 발견할 수 있는 mDNS:

	```bash
	opencode web --mdns
	```

	이 자동으로 `0.0.0.0`에 hostname을 설정하고 `opencode.local`로 서버를 광고합니다.

	동일한 네트워크에서 여러 인스턴스를 실행하려면 mDNS 도메인 이름을 지정할 수 있습니다.

	```bash
	opencode web --mdns --mdns-domain myproject.local
	```

	###### CORS

	CORS에 대한 추가 도메인을 허용하려면 (사용자 정의 frontends에 적합) :

	```bash
	opencode web --cors https://example.com
	```

	### 인증

	액세스를 보호하려면 `OPENCODE_SERVER_PASSWORD` 환경 변수를 사용하여 암호를 설정하십시오.

	```bash
	OPENCODE_SERVER_PASSWORD=secret opencode web
	```

	`opencode`에 대한 사용자의 기본값은 `OPENCODE_SERVER_USERNAME`로 변경할 수 있습니다.

	---

	## 웹 인터페이스 사용

	시작되면 웹 인터페이스는 opencode 세션에 액세스 할 수 있습니다.

	## 세션

	홈페이지에서 세션을 보고 관리합니다. 활성 세션을 볼 수 있으며 새로운 것을 시작합니다.

	![opencode Web - Active Session](../../../assets/web/web-homepage-active-session.png)

	## 서버 상태

	"See Servers"를 클릭하여 연결된 서버와 상태를 볼 수 있습니다.

	![opencode Web - Servers 참조](../../../assets/web/web-homepage-see-servers.png)

	---

	## 터미널 연결

	실행 웹 서버에 terminal TUI를 연결할 수 있습니다.

	```bash
	# Start the web server
	opencode web --port 4096

	# In another terminal, attach the TUI
	opencode attach http://localhost:4096
	```

	웹 인터페이스와 terminal을 동시에 사용할 수 있도록, 같은 세션과 상태를 공유합니다.

	---

	## 구성 파일

	`opencode.json` config 파일에서 서버 설정을 구성할 수 있습니다:

	```json
	{
	"server": {
	"port": 4096,
	"hostname": "0.0.0.0",
	"mdns": true,
	"cors": ["https://example.com"]
	}
	}
	```

	Command line flags는 config 파일 설정에 대한 precedence를 가져옵니다.