トラブルシューティング

OpenCode は診断情報をログとローカルストレージに保存します。

ログ

ログファイルは以下に保存されます：

• macOS/Linux：~/.local/share/opencode/log/
• Windows：%USERPROFILE%\.local\share\opencode\log\

ログファイルはタイムスタンプ付きの名前で保存されます（例：2025-01-09T123456.log）。最新の10ファイルが保持されます。

詳細度を上げる：

opencode --log-level DEBUG

ストレージ

アプリケーションデータの場所：

• macOS/Linux：~/.local/share/opencode/
• Windows：%USERPROFILE%\.local\share\opencode

ヘルプの取得

1. GitHub Issues：github.com/anomalyco/opencode/issues
2. Discord コミュニティ：opencode.ai/discord

一般的な問題

OpenCode が起動しない

• ログファイルのエラーメッセージを確認
• --print-logs フラグを付けて実行
• 最新版に更新：opencode upgrade

認証の問題

• /connect で再認証
• API キーの有効性を確認
• ネットワークアクセスを確認

モデルが利用できない

• Provider の認証を確認
• フォーマットを確認：<providerId>/<modelId>
• opencode models でモデル一覧を表示

ProviderInitError

1. プロバイダーのドキュメントを確認
2. 設定をクリア：rm -rf ~/.local/share/opencode
3. /connect で再認証

Provider パッケージの問題

キャッシュをクリア：

rm -rf ~/.cache/opencode

コピー/ペーストが動作しない（Linux）

クリップボードユーティリティをインストール：

# X11
apt install -y xclip
 
# Wayland
apt install -y wl-clipboard