Wiki: /* ログファイルの場所 */

2026-02-27T07:56:28Z

ログファイルの場所

← 古い版		2026年2月27日 (金) 16:56時点における版
610行目:		610行目:
	<center>		<center>
	{\| class="wikitable"		{\| class="wikitable"
			\|+ OS別ログファイルの場所
	! OS !! ログの場所		! OS !! ログの場所
	\|-		\|-
618行目:		619行目:
	</center>		</center>
	<br>		<br>

	===== デバッグモードでの起動 =====		===== デバッグモードでの起動 =====
	opencode web --hostname 0.0.0.0 --port 4096 --log-level DEBUG		opencode web --hostname 0.0.0.0 --port 4096 --log-level DEBUG

Wiki: /* 認証情報 */

2026-02-27T07:56:12Z

認証情報

← 古い版		2026年2月27日 (金) 16:56時点における版
104行目:		104行目:
	<center>		<center>
	{\| class="wikitable"		{\| class="wikitable"
			\|+ 認証用環境変数
	! 環境変数 !! 説明 !! デフォルト		! 環境変数 !! 説明 !! デフォルト
	\|-		\|-
112行目:		113行目:
	</center>		</center>
	<br>		<br>

	==== Windowsサービスとしての登録 ====		==== Windowsサービスとしての登録 ====
	OpenCodeサーバをWindowsサービスとして登録し、バックグラウンドで自動起動するように設定する。<br>		OpenCodeサーバをWindowsサービスとして登録し、バックグラウンドで自動起動するように設定する。<br>

Wiki: /* 環境変数の設定 */

2026-02-27T02:57:57Z

環境変数の設定

← 古い版		2026年2月27日 (金) 11:57時点における版
93行目:		93行目:
	# Windows (PowerShell)		# Windows (PowerShell)
	$env:OPENCODE_SERVER_PASSWORD = "<任意のパスワード>" # これはHTTPベーシック認証のパスワードとして使用される		$env:OPENCODE_SERVER_PASSWORD = "<任意のパスワード>" # これはHTTPベーシック認証のパスワードとして使用される
	# クライアントがサーバにアクセスする時に入力を求められる		# クライアントがサーバにアクセスする時に入力を求められる
	$env:OPENCODE_SERVER_USERNAME = "opencode" # オプション (デフォルト: opencode)		$env:OPENCODE_SERVER_USERNAME = "opencode" # オプション (デフォルト: opencode)

100行目:		100行目:
	</syntaxhighlight>		</syntaxhighlight>
	<br>		<br>

	===== 認証情報 =====		===== 認証情報 =====
	<center>		<center>

Wiki: /* 環境変数の設定 */

2026-02-27T02:57:35Z

環境変数の設定

← 古い版		2026年2月27日 (金) 11:57時点における版
199行目:		199行目:
	===== 環境変数の設定 =====		===== 環境変数の設定 =====
	<syntaxhighlight lang="sh">		<syntaxhighlight lang="sh">
	export OPENCODE_SERVER_PASSWORD="~~your-secure-password~~"		export OPENCODE_SERVER_PASSWORD="<任意のパスワード>" # クライアントがサーバにアクセスする時に入力を求められる
			# これはHTTPベーシック認証のパスワードとして使用される
	export OPENCODE_SERVER_USERNAME="opencode" # オプション (デフォルト: opencode)		export OPENCODE_SERVER_USERNAME="opencode" # オプション (デフォルト: opencode)

206行目:		207行目:
	</syntaxhighlight>		</syntaxhighlight>
	<br>		<br>

	==== systemdサービスとしての登録 ====		==== systemdサービスとしての登録 ====
	OpenCodeサーバをsystemdサービスとして登録して、バックグラウンドで自動起動するように設定する。<br>		OpenCodeサーバをsystemdサービスとして登録して、バックグラウンドで自動起動するように設定する。<br>

2026年2月27日 (金) 02:55にWikiによる

2026-02-27T02:55:46Z

差分を表示

Wiki: ページの作成:「== 概要 == OpenCodeはクライアント・サーバアーキテクチャを備えており、リモートアクセス機能を標準でサポートしている。

`opencode serve` コマンドを使用することで、ヘッドレスHTTPサーバとして動作させ、別のPCからアクセスできる。
また、`opencode web` コマンドを使用することで、WebブラウザベースのWebインターフェースを…」

2026-02-27T00:00:38Z

ページの作成:「== 概要 == OpenCodeはクライアント・サーバアーキテクチャを備えており、リモートアクセス機能を標準でサポートしている。 <code>opencode serve</code> コマンドを使用することで、ヘッドレスHTTPサーバとして動作させ、別のPCからアクセスできる。 また、<code>opencode web</code> コマンドを使用することで、WebブラウザベースのWebインターフェースを…」

新規ページ

== 概要 ==
OpenCodeはクライアント・サーバアーキテクチャを備えており、リモートアクセス機能を標準でサポートしている。 
 
<code>opencode serve</code> コマンドを使用することで、ヘッドレスHTTPサーバとして動作させ、別のPCからアクセスできる。 
また、<code>opencode web</code> コマンドを使用することで、WebブラウザベースのWebインターフェースを提供できる。 
 
クライアント側からの接続方法として、Webブラウザ、デスクトップアプリ、ターミナルTUI、SDKを使用したプログラムからの接続が可能である。 
認証機能としてHTTPベーシック認証をサポートしており、環境変数でユーザ名とパスワードを設定できる。 
 
更に、mDNS discovery機能によりローカルネットワーク上でのサーバ発見が可能である。 
 

== 前提条件 ==
==== サーバ側 (Windows Server) ====
* OpenCodeのインストール
*: [https://opencode.ai OpenCodeの公式サイト] からインストールする。
*: 
* ネットワーク接続
*: クライアントからサーバへのネットワーク接続が必要である。
*: 
* 管理者権限
*: ファイアウォール設定、サービス登録に必要である。
 
==== クライアント側 (Windows 11) ====
* Webブラウザ
*: Chrome、Firefox、Edge等のモダンブラウザ。
*: 
* OpenCode (オプション)
*: ターミナルTUIを使用する場合に必要である。
*: 
* OpenCodeデスクトップアプリ (オプション)
*: デスクトップアプリを使用する場合に必要である。
 

== アーキテクチャ ==
下図に、リモートアクセス構成の概要を示す。 
 
[[ファイル:OpenCode Remote Access Architecture.png|中央]]
 

== サーバ側の設定 (Windows Server) ==
==== OpenCodeのインストール ====
OpenCodeのインストール方法は、[[インストール - OpenCode]]のページを参照すること。 
 
==== サーバの起動 ====
===== ヘッドレスサーバモード =====
APIのみを提供するヘッドレスサーバを起動する。 
 
opencode serve --hostname 0.0.0.0 --port 4096
 
===== Web UI付きサーバモード =====
ブラウザからアクセス可能なWeb UIを提供するサーバを起動する。 
 
opencode web --hostname 0.0.0.0 --port 4096
 
サーバ起動時の出力例を以下に示す。 
 
Local access: http://localhost:4096
Network access: http://192.168.1.100:4096
 
===== 起動オプション =====
<center>
{| class="wikitable"
|+ サーバ起動オプション
! オプション !! 説明 !! デフォルト
|-
| <code>--port</code> || リッスンするポート番号 || 4096
|-
| <code>--hostname</code> || リッスンするホスト名 || 127.0.0.1
|-
| <code>--mdns</code> || mDNS discoveryを有効にする || false
|-
| <code>--mdns-domain</code> || mDNSドメイン名 || opencode.local
|-
| <code>--cors</code> || 許可するCORSオリジン || [] (空)
|}
</center>
 
==== 認証の設定 ====
サーバへのアクセスを保護するために、HTTPベーシック認証を設定する。 
 
===== 環境変数の設定 =====
<syntaxhighlight lang="powershell">
# Windows (PowerShell)
$env:OPENCODE_SERVER_PASSWORD = "your-secure-password"
$env:OPENCODE_SERVER_USERNAME = "opencode" # オプション (デフォルト: opencode)

# 認証付きでサーバ起動
opencode web --hostname 0.0.0.0 --port 4096
</syntaxhighlight>
 
===== 認証情報 =====
<center>
{| class="wikitable"
! 環境変数 !! 説明 !! デフォルト
|-
| <code>OPENCODE_SERVER_USERNAME</code> || 認証ユーザ名 || opencode
|-
| <code>OPENCODE_SERVER_PASSWORD</code> || 認証パスワード || なし (認証無効)
|}
</center>
 
==== Windowsサービスとしての登録 ====
OpenCodeサーバをWindowsサービスとして登録し、バックグラウンドで自動起動するように設定する。 
 
===== NSSMのインストール =====
NSSM (Non-Sucking Service Manager) を使用して、Windowsサービスを作成する。 
 
# [https://nssm.cc/download NSSMの公式サイト] からダウンロードする。
# ZIPファイルを展開し、win64ディレクトリ内のnssm.exeを使用する。
 
===== サービスの登録 =====
<syntaxhighlight lang="powershell">
# OpenCodeのパスを確認
where opencode

# サービスをインストール
nssm install OpenCode-Server "C:\path\to\opencode.exe" web --hostname 0.0.0.0 --port 4096

# 環境変数を設定
nssm set OpenCode-Server AppEnvironmentExtra OPENCODE_SERVER_PASSWORD=your-secure-password

# 作業ディレクトリを設定
nssm set OpenCode-Server AppDirectory "C:\Users\YourName\projects"

# サービスを開始
nssm start OpenCode-Server
</syntaxhighlight>
 
===== サービス管理コマンド =====
<syntaxhighlight lang="powershell">
# サービスの状態確認
nssm status OpenCode-Server

# サービスの停止
nssm stop OpenCode-Server

# サービスの再起動
nssm restart OpenCode-Server

# サービスの削除
nssm remove OpenCode-Server confirm
</syntaxhighlight>
 
==== ファイアウォール設定 ====
WindowsファイアウォールでOpenCodeサーバのポートを開放する。 
 
===== PowerShellを使用する方法 =====
<syntaxhighlight lang="powershell">
# ポート4096を開放
New-NetFirewallRule -DisplayName "OpenCode Server" -Direction Inbound -LocalPort 4096 -Protocol TCP -Action Allow
</syntaxhighlight>
 
===== GUIを使用する方法 =====
# コントロールパネルを開く。
# [システムとセキュリティ] - [Windows Defender ファイアウォール]を選択する。
# [詳細設定]を選択する。
# [受信の規則] - [新しい規則]を選択する。
# [ポート] - [TCP] - [特定のローカルポート: 4096]を指定する。
# [接続を許可する]を選択する。
# ドメイン、プライベート、パブリックから適切なものを選択する。
# [名前:]項目では、OpenCode Server と入力して完了する。
# 
 

== クライアント側の設定 (Windows 11) ==
==== Webブラウザからの接続 ====
===== 接続手順 =====
# Webブラウザを起動する。
# アドレスバーに http://<サーバのIPアドレス>:4096 を入力する。
# 認証ダイアログが表示された場合、ユーザ名とパスワードを入力する。
# OpenCodeのWeb UIが表示される。
 
アクセスURLの例を以下に示す。 
* http://192.168.1.100:4096
* http://opencode.local:4096 # mDNS有効時
 
==== デスクトップアプリからの接続 ====
OpenCodeデスクトップアプリをリモートサーバに接続するように設定することもできる。 
 
===== 設定手順 =====
# OpenCodeデスクトップアプリを起動する。
# 設定画面を開く。
# サーバ選択ダイアログでデフォルトサーバURLを設定する。
# http://server-ip:4096 を入力する。
# 接続を確認する。
 
===== 接続失敗時の対処 =====
サーバに到達できない場合、以下に示すオプションが表示される。 
 
* Retry
*: 再度接続を試みる。
* Start Local
*: ローカルサーバを起動する。
 
==== ターミナル (TUI) からの接続 ====
<code>opencode attach</code> コマンドを実行して、リモートサーバに接続する。 
 
===== 接続コマンド =====
# リモートサーバにアタッチ
opencode attach http://server-ip:4096

# 認証が必要な場合
# Webブラウザで認証を完了してからアタッチ
 
===== 切断方法 =====
[Ctrl] + [C]キーを押下することで、接続を切断できる。 
セッションはサーバ側で維持されるため、再接続後に続きから作業できる。 
 
==== SDKを使用した接続 ====
TypeScript/JavaScript SDKを使用してプログラムから接続できる。 
 
===== SDKのインストール =====
npm install @opencode-ai/sdk
 
===== 接続コード例 =====
<syntaxhighlight lang="typescript">
import { createOpencodeClient } from "@opencode-ai/sdk"

const client = createOpencodeClient({
baseUrl: "http://<サーバのIPアドレス>:4096",
})

// ヘルスチェック
const health = await client.global.health()
console.log(health.data.version)

// セッションの作成
const session = await client.session.create({
body: { title: "My session" },
})

// メッセージの送信
const result = await client.session.prompt({
path: { id: session.id },
body: {
model: { providerID: "zai-coding-plan", modelID: "glm-5" },
parts: [{ type: "text", text: "Hello!" }],
},
})
</syntaxhighlight>
 

== GLM-5の設定 ==
==== プロバイダの追加 ====
<code>opencode auth login</code> コマンドを実行して、Z.aiの認証情報を追加する。 
 
opencode auth login
# Z.ai Coding Plan を選択
# 認証を完了
 
==== 設定ファイルの編集 ====
opencode.json ファイルでGLM-5をデフォルトモデルとして設定する。 
 
===== グローバル設定 =====
* ファイル場所
** Linux / MacOS
**: ~/.config/opencode/opencode.json
** Windows
**: %USERPROFILE%\.config\opencode\opencode.json
 
===== プロジェクト設定 =====
設定ファイルの場所は、プロジェクトルートの opencode.json ファイルである。 
 
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"model": "zai-coding-plan/glm-5",
"provider": {
"zai-coding-plan": {
"options": {
"baseURL": "https://api.z.ai/v1"
}
}
}
}
</syntaxhighlight>
 
==== GLM-5の仕様 ====
<center>
{| class="wikitable"
|+ GLM-5モデル仕様
! 項目 !! 仕様
|-
| パラメータ数 || 744B (40B active)
|-
| コンテキスト長 || 200K tokens
|-
| 最大出力 || 128K tokens
|-
| 入力モダリティ || テキスト
|-
| 出力モダリティ || テキスト
|-
| Thinking Mode || 対応
|-
| Function Call || 対応
|}
</center>
 

== 設定ファイル (opencode.json) ==
==== サーバ設定 ====
サーバ関連の設定を opencode.json ファイルに記述する。 
 
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"server": {
"port": 4096,
"hostname": "0.0.0.0",
"mdns": true,
"mdns-domain": "opencode.local",
"cors": ["http://localhost:5173", "https://app.example.com"]
}
}
</syntaxhighlight>
 
==== 設定ファイルの優先順位 ====
設定ファイルは以下に示す順序で読み込まれ、後のものが優先される。 
 
<center>
{| class="wikitable"
|+ 設定ファイルの優先順位
! 優先度 !! 場所 !! 説明
|-
| 1 (低) || リモート .well-known/opencode || 組織のデフォルト設定
|-
| 2 || ~/.config/opencode/opencode.json || グローバルユーザ設定
|-
| 3 || 環境変数 <code>OPENCODE_CONFIG</code> || カスタム設定ファイルパス
|-
| 4 || ./opencode.json || プロジェクトルート設定
|-
| 5 || ./.opencode/opencode.json || .opencodeディレクトリ設定
|-
| 6 || 環境変数 <code>OPENCODE_CONFIG_CONTENT</code> || インライン設定
|-
| 7 (高) || 管理設定ディレクトリ || エンタープライズ展開用
|}
</center>
 

== HTTPS設定 (リバースプロキシ) ==
OpenCodeは現在HTTPのみをサポートしているため、HTTPSを使用する場合はリバースプロキシが必要である。 
 
==== NginXを使用した設定例 ====
<syntaxhighlight lang="nginx">
server {
listen 443 ssl;
server_name opencode.example.com;

ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;

location / {
proxy_pass http://127.0.0.1:4096;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
</syntaxhighlight>
 
==== Let's Encryptを使用したSSL証明書取得 ====
<syntaxhighlight lang="sh">
# certbotをインストール
# Windows: https://certbot.eff.org/ からダウンロード

# 証明書を取得
certbot certonly --standalone -d opencode.example.com

# 証明書の場所
# /etc/letsencrypt/live/opencode.example.com/fullchain.pem
# /etc/letsencrypt/live/opencode.example.com/privkey.pem
</syntaxhighlight>
 

== トラブルシューティング ==
==== 接続できない場合 ====
===== チェックリスト =====
* サーバが起動しているか確認
*: <code>curl http://localhost:4096/global/health</code> コマンドを実行して確認する。
*: 
* ファイアウォール設定を確認
*: 4096番ポートが開放されているか確認する。
*: 
* ネットワーク接続を確認
*: <code>ping <サーバのIPアドレス></code> で接続確認する。
*: 
* ホスト名の設定を確認
*: <code>--hostname 0.0.0.0</code> が設定されているか確認する。
 
===== ポートが使用中の場合 =====
<syntaxhighlight lang="powershell">
# 使用中のポートを確認
netstat -ano | findstr :4096

# プロセスを終了
taskkill /PID <pid> /F
</syntaxhighlight>
 
==== 認証エラー ====
===== ブラウザで認証ダイアログが繰り返し表示される場合 =====
* ユーザ名とパスワードが正しいか確認する。
* 環境変数が正しく設定されているか確認する。
* Webブラウザのキャッシュをクリアする。
 
===== 環境変数の確認 =====
<syntaxhighlight lang="powershell">
# PowerShell
echo $env:OPENCODE_SERVER_USERNAME
echo $env:OPENCODE_SERVER_PASSWORD
</syntaxhighlight>
 
==== ログの確認方法 ====
===== ログファイルの場所 =====
<center>
{| class="wikitable"
! OS !! ログの場所
|-
| Windows || %USERPROFILE%\.local\share\opencode\log
|-
| MacOS / Linux || ~/.local/share/opencode/log/
|}
</center>
 
===== デバッグモードでの起動 =====
opencode web --hostname 0.0.0.0 --port 4096 --log-level DEBUG
 
==== WSLでの問題 ====
Windows環境でWSLを使用する場合、以下の問題が発生することがある。 
 
===== 空白画面が表示される場合 =====
* WSL2を使用しているか確認する。
* Ubuntu 20.04以降を使用しているか確認する。
* <code>opencode</code> コマンドをWSL内で実行する。
 
===== デスクトップアプリからWSLサーバに接続する場合 =====
<syntaxhighlight lang="bash">
# WSL内でサーバを起動
opencode serve --hostname 0.0.0.0 --port 4096

# デスクトップアプリから接続
# http://localhost:4096
</syntaxhighlight>
 

== 既知の問題 ==
==== HTTPSの直接サポートがない ====
現在、OpenCodeはHTTPSを直接サポートしていない。 
リバースプロキシ (nginx等) を使用してHTTPS化する必要がある。 
 
==== デスクトップアプリとターミナルの同時実行 ====
同じポートで複数のOpenCodeインスタンスを起動しようとすると競合が発生する。 
既存のサーバに接続する場合は <code>opencode attach</code> を使用する。 
 
==== 社内ネットワークでの接続問題 ====
外部ネットワークアクセスがない環境では、一部の機能が動作しない可能性がある。 
プロキシ設定が必要な場合は環境変数を設定する。 
 
<syntaxhighlight lang="sh">
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1
</syntaxhighlight>
 

== APIリファレンス ==
サーバはOpenAPI 3.1仕様に準拠したREST APIを提供する。 
 
==== APIドキュメント ====
http://<サーバのIPアドレス>:4096/doc でSwagger UI形式のAPIドキュメントにアクセスできる。 
 
==== 主なエンドポイント ====
<center>
{| class="wikitable"
|+ 主要APIエンドポイント
! カテゴリ !! エンドポイント !! 説明
|-
| Global || <code>GET /global/health</code> || サーバのヘルスチェック
|-
| Session || <code>GET /session</code> || セッション一覧取得
|-
| Session || <code>POST /session</code> || 新規セッション作成
|-
| Session || <code>POST /session/:id/message</code> || メッセージ送信
|-
| File || <code>GET /file?path=</code> || ファイル一覧取得
|-
| File || <code>GET /file/content?path=</code> || ファイル内容取得
|-
| Find || <code>GET /find?pattern=</code> || テキスト検索
|-
| Config || <code>GET /config</code> || 設定取得
|-
| Provider || <code>GET /provider</code> || プロバイダ一覧
|}
</center>
 

== 関連リンク ==
* [https://opencode.ai OpenCode公式サイト]
* [https://github.com/anomalyco/opencode OpenCode GitHubリポジトリ]
* [https://opencode.ai/docs/server/ OpenCode公式ドキュメント - Server]
* [https://opencode.ai/docs/web/ OpenCode公式ドキュメント - Web]
* [https://opencode.ai/docs/cli/ OpenCode公式ドキュメント - CLI]
* [https://opencode.ai/docs/troubleshooting/ OpenCode公式ドキュメント - Troubleshooting]
* [https://docs.z.ai/guides/llm/glm-5 GLM-5公式ドキュメント]
* [https://nssm.cc/ NSSM - Non-Sucking Service Manager]
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,OpenCode,Remote Access,Server,Client,Windows Server,Windows 11,GLM-5,Z.ai,SSH,HTTPS,nginx,NSSM,SUSE,Linux
|description={{PAGENAME}} - OpenCodeのリモートアクセス機能とWindows Server/Windows 11環境での設定方法 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

OpenCodeの設定 - リモートアクセス - 版の履歴

Wiki: /* ログファイルの場所 */

Wiki: /* 認証情報 */

Wiki: /* 環境変数の設定 */

Wiki: /* 環境変数の設定 */

2026年2月27日 (金) 02:55にWikiによる