文档
日本語ドキュメント
CLI

CLI コマンドライン

OpenCode CLI は、OpenCode 機能へのコマンドラインアクセスを提供します。デフォルトでは、opencode を実行するとターミナルユーザーインターフェース(TUI)が起動します。

opencode

プログラム的な操作にはコマンドを渡します:

opencode run "JavaScript のクロージャがどのように動作するか説明してください"

TUI フラグ

フラグ短縮形用途
--continue-c前のセッションを再開
--session-sセッション ID を指定
--prompt初期プロンプトを提供
--model-mモデルを設定(provider/model)
--agentAgent を選択

コマンド

run

非対話モードで OpenCode を実行:

opencode run [message..]

フラグ:

  • --continue, -c:前のセッションを再開
  • --model, -m:モデルを設定
  • --file, -f:ファイルを添付
  • --formatdefault または json で出力

auth

認証情報を管理:

opencode auth login    # API キーを設定
opencode auth list     # Provider を表示
opencode auth logout   # 認証情報を削除

models

利用可能なモデルを一覧表示:

opencode models [provider]
opencode models --refresh  # キャッシュリストを更新
opencode models --verbose  # コストを表示

session

セッションを管理:

opencode session list
opencode session list --format json

serve

ヘッドレス HTTP サーバーを起動:

opencode serve --port 4096

web

Web インターフェース付きでサーバーを起動:

opencode web --port 4096

agent

Agent を管理:

opencode agent create  # カスタム Agent を作成
opencode agent list    # Agent を一覧表示

mcp

MCP サーバーを管理:

opencode mcp add       # サーバーを追加
opencode mcp list      # サーバーを表示
opencode mcp auth      # 認証
opencode mcp debug     # デバッグ

stats

使用統計を表示:

opencode stats --days 30
opencode stats --models

upgrade

OpenCode を更新:

opencode upgrade           # 最新バージョン
opencode upgrade v0.1.48   # 特定のバージョン

グローバルフラグ

フラグ短縮形用途
--help-hヘルプを表示
--version-vバージョンを表示
--print-logsstderr にログを出力
--log-levelレベルを設定(DEBUG, INFO, WARN, ERROR)

環境変数

コア設定

変数用途
OPENCODE_CONFIG設定ファイルのパス
OPENCODE_CONFIG_DIR設定ディレクトリ
OPENCODE_CONFIG_CONTENTインライン JSON 設定

機能

変数用途
OPENCODE_DISABLE_AUTOUPDATE自動更新を無効化
OPENCODE_ENABLE_EXPERIMENTAL_MODELS実験的モデルを有効化
OPENCODE_DISABLE_AUTOCOMPACT自動圧縮を無効化