콘텐츠로 이동

Web

Using opencode in your browser.

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

opencode Web - 새로운 세션

시작하기

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

Terminal window
opencode web

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


구성

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

포트

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

Terminal window
opencode web --port 4096

호스트 이름

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

Terminal window
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:

Terminal window
opencode web --mdns

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

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

Terminal window
opencode web --mdns --mdns-domain myproject.local
CORS

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

Terminal window
opencode web --cors https://example.com

인증

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

Terminal window
OPENCODE_SERVER_PASSWORD=secret opencode web

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


웹 인터페이스 사용

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

세션

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

opencode Web - Active Session

서버 상태

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

opencode Web - Servers 참조


terminal 부착

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

Terminal window
# Start the web server
opencode web --port 4096
# In another terminal, attach the TUI
opencode attach http://localhost:4096

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


Config 파일

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

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

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