본문으로 건너뛰기
V1 문서
시작하기

Web

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

opencode Web - 새로운 세션

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

터미널
opencode web

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


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

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

터미널
opencode web --port 4096

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

터미널
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:

터미널
opencode web --mdns

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

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

터미널
opencode web --mdns --mdns-domain myproject.local
CORS

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

터미널
opencode web --cors https://example.com

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

터미널
OPENCODE_SERVER_PASSWORD=secret opencode web

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


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

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

opencode Web - Active Session

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

opencode Web - Servers 참조


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

터미널
# 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를 가져옵니다.