OpenCode: OpenCode CLI Commands
最終更新：2026-08-31
--- title: OpenCode CLI使用方法 description: OpenCodeコマンドラインインターフェースの完全なコマンド体系を習得する。run、serve、agent、authなどのコアコマンドを含む order: 8 lang: ja
OpenCode CLIはTUIの起動入口だけでなく、プログラム可能なAI開発インターフェースでもあります。
1. 学習内容
- CLIの3層アーキテクチャ
- コアコマンドの詳細
- runコマンドと自動化
- サービスモード
- 環境変数
2. CLIの3層アーキテクチャ
| 層 | コマンド | 説明 |
|---|---|---|
| インタラクション層 | tui / web / attach |
ユーザー向けインタラクションインターフェース |
| 実行層 | run / agent / mcp / github |
具体的なタスクの実行 |
| サービス層 | serve / acp |
APIサービスの提供 |
本質はAI Agent + ローカル開発環境 + プログラム可能CLI + Server APIの統一入口。
3. 基本的な使い方
(1) TUIの起動（デフォルト動作）
BASH
opencode
(2) プロジェクトディレクトリの指定
BASH
opencode /path/to/project
(3) 非対話モード
BASH
opencode run JavaScriptのクロージャの原理を説明して
インターフェースに入らず、結果を直接返す。
4. コアコマンド一覧
| コマンド | 作用 | 主なサブコマンド |
|---|---|---|
agent |
エージェント管理 | create / list |
auth |
認証管理 | login / list / logout |
attach |
リモートバックエンドに接続 | — |
github |
GitHub自動化 | install / run |
mcp |
MCPサービス管理 | add / list / auth / debug |
models |
モデル一覧表示 | — |
run |
非対話実行 | — |
serve |
APIサービス起動 | — |
web |
Web UIサービス | — |
session |
セッション管理 | list |
stats |
トークン/料金統計 | — |
export |
セッションエクスポート | — |
import |
セッションインポート | — |
upgrade |
バージョンアップグレード | — |
uninstall |
アンインストール | — |
5. runコマンド（最も使用頻度が高い）
非対話実行に使用。スクリプト自動化やCI/CDに適している：
BASH
opencode run このGoプロジェクトのコンテキスト使用方法を分析して
(1) よく使うパラメータ
| パラメータ | 短縮 | 説明 |
|---|---|---|
--continue |
-c |
セッションを継続 |
--session |
-s |
セッションを指定 |
--model |
-m |
モデルを指定 |
--agent |
— | エージェントを指定 |
--file |
-f |
ファイルを添付 |
--format |
— | 出力フォーマット（json） |
--share |
— | セッションを共有 |
--attach |
— | 既存サービスに接続 |
(2) バックエンドサービスへの接続
毎回のコールドスタートを回避：
BASH
# バックエンドサービスを起動
opencode serve
# runで接続
opencode run --attach http://localhost:4096 async/awaitを説明して
6. authコマンド
BASH
# ログイン
opencode auth login
# ログイン済みプロバイダーを確認
opencode auth list
# ログアウト
opencode auth logout
7. modelsコマンド
BASH
# 全モデルを確認
opencode models
# プロバイダーでフィルター
opencode models anthropic
# モデルリストを更新
opencode models --refresh
8. agentコマンド
BASH
# エージェント作成
opencode agent create
# エージェント確認
opencode agent list
9. serveコマンド
APIサービスを起動し、HTTPインターフェースを提供：
BASH
opencode serve
オプションパラメータ：
--port：ポート--hostname：リッスンアドレス
10. webコマンド
Webインターフェース付きバージョンを起動：
BASH
opencode web
11. statsコマンド
トークン使用量と料金を確認：
BASH
opencode stats
# 過去7日間
opencode stats --days 7
# モデル別統計
opencode stats --models
# ツール別統計
opencode stats --tools
12. TUI起動パラメータ
| フラグ | 短縮 | 説明 |
|---|---|---|
--continue |
-c |
前回のセッションを継続 |
--session |
-s |
セッションIDを指定 |
--fork |
— | セッションをフォーク |
--prompt |
— | 初期プロンプト |
--model |
-m |
モデルを指定 |
--agent |
— | エージェントを指定 |
--port |
— | リッスンポート |
13. グローバルフラグ
| フラグ | 短縮 | 説明 |
|---|---|---|
--help |
-h |
ヘルプ表示 |
--version |
-v |
バージョン表示 |
--print-logs |
— | ログ出力 |
--log-level |
— | ログレベル |
14. 環境変数
| 変数 | 型 | 作用 |
|---|---|---|
OPENCODE_AUTO_SHARE |
boolean | 自動共有 |
OPENCODE_CONFIG |
string | 設定パス |
OPENCODE_DISABLE_AUTOUPDATE |
boolean | 更新無効化 |
OPENCODE_SERVER_PASSWORD |
string | API認証 |
OPENCODE_MODELS_URL |
string | モデルソース |
OPENCODE_EXPERIMENTAL |
boolean | 実験機能の有効化 |
15. 使用の推奨
| シーン | 推奨コマンド |
|---|---|
| 日常開発 | opencode（TUI） |
| 自動化/スクリプト | opencode run |
| CI/CD統合 | opencode serve + run --attach |
| 高頻度呼び出し | opencode serve + クライアント |
| Webインターフェース | opencode web |
❓ FAQ
Q runコマンドとTUIの違いは？
A runは非対話モードで、質問を入力すると結果を直接返す。スクリプトや自動化に適している。TUIは対話モードで、複数回のやり取りとスラッシュコマンドをサポート。
Q CI/CDでOpenCodeを使用するには？
A まず
opencode serveを起動し、opencode run --attachでサービスに接続してタスクを実行。毎回のコールドスタートを回避。Q Aliceはrunでコードレビュー、BobはTUIで開発を行っていますが、どちらが効率的か？
A それぞれ長所がある。Aliceのrunモードはバッチ自動化レビューに適し、BobのTUIモードはインタラクティブ開発に適している。シーンに応じて選択。
📖 まとめ
- CLIの3層：インタラクション層、実行層、サービス層
opencode runは自動化のコアコマンドopencode serveはAPIサービスを提供し、コールドスタートを回避- 環境変数はCI/CDや一時設定に適している
- 日常はTUI、自動化はrun、高頻度はserve
📝 練習問題
-
基本問題：
opencode runで非対話型コード分析を実行してください。 -
応用問題：
opencode serveを起動し、run --attachで接続してタスクを実行してください。 -
チャレンジ問題：Shellスクリプトを作成し、
opencode runでプロジェクトコードを自動分析してレポートを生成してください。
