---
title: CLI
description: OpenCode CLI のオプションとコマンド。
---

import { Tabs, TabItem } from "@astrojs/starlight/components"

OpenCode CLI は、引数なしで実行すると、デフォルトで [TUI](/docs/tui) を開始します。

```bash
opencode
```

ただし、このページに記載されているようにコマンドも受け入れます。これにより、OpenCode をプログラム的に操作できるようになります。

```bash
opencode run "Explain how closures work in JavaScript"
```

---

### tui

OpenCode terminal ユーザー インターフェイスを開始します。

```bash
opencode [project]
```

#### Flags

| Flag         | Short       | Description                                                |
| ------------ | ----------- | ---------------------------------------------------------- |
| `--continue` | `-c`        | 最後のセッションを続行                                     |
| `--session`  |             | 続行時にセッションをフォーク (`-s` または `--fork` と併用) |
| `--continue` | `--session` | 続行するセッション ID                                      |
| `--prompt`   |             | 使用のプロンプト                                           |
| `--model`    | `-m`        | プロバイダー/モデルの形式で使用するモデル                  |
| `--agent`    |             | 使用するエージェント                                       |
| `--port`     |             | リッスンするポート                                         |
| `--hostname` |             | リッスンするホスト名                                       |

---

## コマンド

OpenCode CLI には次のコマンドもあります。

---

### agent

OpenCode のエージェントを管理します。

```bash
opencode agent [command]
```

---

### attach

`serve` または `web` コマンドを使用して起動された、すでに実行中の OpenCode バックエンド サーバーにterminal を接続します。

```bash
opencode attach [url]
```

これにより、リモート OpenCode バックエンドで TUI を使用できるようになります。例えば：

```bash
# Start the backend server for web/mobile access
opencode web --port 4096 --hostname 0.0.0.0

# In another terminal, attach the TUI to the running backend
opencode attach http://10.20.30.40:4096
```

#### Flags

| Flag        | Short | Description                    |
| ----------- | ----- | ------------------------------ |
| `--dir`     |       | TUI を開始する作業ディレクトリ |
| `--session` | `-s`  | 続行するセッション ID          |

---

#### create

カスタム構成で新しいエージェントを作成します。

```bash
opencode agent create
```

このコマンドは、カスタム システム プロンプトとツール構成を使用して新しいエージェントを作成する手順を示します。

---

#### list

利用可能なエージェントをすべてリストします。

```bash
opencode agent list
```

---

### auth

プロバイダーの資格情報とログインを管理するコマンド。

```bash
opencode auth [command]
```

---

#### login

OpenCode は [Models.dev](https://models.dev) のプロバイダー リストを利用しているため、`opencode auth login` を使用して、使用したいプロバイダーの API キーを構成できます。これは`~/.local/share/opencode/auth.json`に保存されます。

```bash
opencode auth login
```

OpenCode が起動すると、認証情報ファイルからプロバイダーがロードされます。また、環境またはプロジェクト内の `.env` ファイルで定義されたキーがあるかどうかも確認します。

---

#### list

認証情報ファイルに保存されているすべての認証されたプロバイダーをリストします。

```bash
opencode auth list
```

またはショートバージョン。

```bash
opencode auth ls
```

---

#### logout

資格情報ファイルからプロバイダーをクリアすることで、プロバイダーからログアウトします。

```bash
opencode auth logout
```

---

### github

リポジトリ自動化のための GitHub エージェントを管理します。

```bash
opencode github [command]
```

---

#### install

GitHub エージェントをリポジトリにインストールします。

```bash
opencode github install
```

これにより、必要な GitHub Actions ワークフローが設定され、構成プロセスがガイドされます。 [詳細はこちら](/docs/github)。

---

#### run

GitHub エージェントを実行します。これは通常、GitHub Actions で使用されます。

```bash
opencode github run
```

##### Flags

| Flag      | Description                                         |
| --------- | --------------------------------------------------- |
| `--event` | エージェントを実行するための GitHub モック イベント |
| `--token` | GitHub個人アクセストークン                          |

---

### mcp

モデル コンテキスト プロトコル サーバーを管理します。

```bash
opencode mcp [command]
```

---

#### add

MCP サーバーを構成に追加します。

```bash
opencode mcp add
```

このコマンドは、ローカルまたはリモートの MCP サーバーを追加する手順を示します。

---

#### list

構成されているすべての MCP サーバーとその接続ステータスをリストします。

```bash
opencode mcp list
```

または、短いバージョンを使用してください。

```bash
opencode mcp ls
```

---

#### auth

OAuth 対応の MCP サーバーで認証します。

```bash
opencode mcp auth [name]
```

サーバー名を指定しない場合は、利用可能な OAuth 対応サーバーから選択するように求められます。

OAuth 対応サーバーとその認証ステータスを一覧表示することもできます。

```bash
opencode mcp auth list
```

または、短いバージョンを使用してください。

```bash
opencode mcp auth ls
```

---

#### logout

MCP サーバーの OAuth 資格情報を削除します。

```bash
opencode mcp logout [name]
```

---

#### debug

MCP サーバーの OAuth 接続の問題をデバッグします。

```bash
opencode mcp debug <name>
```

---

### models

構成されたプロバイダーから利用可能なすべてのモデルをリストします。

```bash
opencode models [provider]
```

このコマンドは、構成されたプロバイダー全体で利用可能なすべてのモデルを `provider/model` の形式で表示します。

これは、config](/docs/config/) で使用する正確なモデル名を把握するのに役立ちます。

オプションでプロバイダー ID を渡して、そのプロバイダーによってモデルをフィルターできます。

```bash
opencode models anthropic
```

#### Flags

| Flag        | Description                                                     |
| ----------- | --------------------------------------------------------------- |
| `--refresh` | models.dev からモデル キャッシュを更新します。                  |
| `--verbose` | より詳細なモデル出力を使用します (コストなどのメタデータを含む) |

`--refresh` フラグを使用して、キャッシュされたモデル リストを更新します。これは、新しいモデルがプロバイダーに追加され、それを OpenCode で確認したい場合に便利です。

```bash
opencode models --refresh
```

---

### run

プロンプトを直接渡して、非対話モードでopencodeを実行します。

```bash
opencode run [message..]
```

これは、スクリプト作成、自動化、または完全な TUI を起動せずに迅速な回答が必要な場合に便利です。例えば。

```bash "opencode run"
opencode run Explain the use of context in Go
```

実行中の `opencode serve` インスタンスにアタッチして、実行ごとの MCP サーバーのコールド ブート時間を回避することもできます。

```bash
# Start a headless server in one terminal
opencode serve

# In another terminal, run commands that attach to it
opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"
```

#### Flags

| Flag         | Short       | Description                                                                               |
| ------------ | ----------- | ----------------------------------------------------------------------------------------- |
| `--command`  |             | 実行するコマンド。引数には message を使用します。                                         |
| `--continue` | `-c`        | 最後のセッションを続行                                                                    |
| `--session`  |             | 続行時にセッションをフォーク (`-s` または `--fork` と併用)                                |
| `--continue` | `--session` | 続行するセッション ID                                                                     |
| `--share`    |             | セッションを共有する                                                                      |
| `--model`    | `-m`        | プロバイダー/モデルの形式で使用するモデル                                                 |
| `--agent`    |             | 使用するエージェント                                                                      |
| `--file`     | `-f`        | メッセージに添付するファイル                                                              |
| `--format`   |             | 形式: デフォルト (フォーマット済み) または json (生の JSON イベント)                      |
| `--title`    |             | セッションのタイトル (値が指定されていない場合は、切り詰められたプロンプトが使用されます) |
| `--attach`   |             | 実行中のopencodeサーバー (http://localhost:4096 など) に接続します。                      |
| `--port`     |             | ローカルサーバーのポート (デフォルトはランダムポート)                                     |

---

### serve

API アクセスのためにヘッドレス OpenCode サーバーを起動します。完全な HTTP インターフェイスについては、[server docs](/docs/server) を確認してください。

```bash
opencode serve
```

これにより、TUI インターフェイスを使用せずにopencode機能への API アクセスを提供する HTTP サーバーが起動します。 `OPENCODE_SERVER_PASSWORD` を設定して HTTP 基本認証を有効にします (ユーザー名のデフォルトは `opencode`)。

#### Flags

| Flag         | Description                             |
| ------------ | --------------------------------------- |
| `--port`     | リッスンするポート                      |
| `--hostname` | リッスンするホスト名                    |
| `--mdns`     | mDNS 検出を有効にする                   |
| `--cors`     | CORS を許可する追加のブラウザーオリジン |

---

### session

OpenCode セッションを管理します。

```bash
opencode session [command]
```

---

#### list

すべての OpenCode セッションをリストします。

```bash
opencode session list
```

##### Flags

| Flag          | Short | Description                              |
| ------------- | ----- | ---------------------------------------- |
| `--max-count` | `-n`  | 最新のセッションを N 個に制限            |
| `--format`    |       | 出力形式: テーブルまたは json (テーブル) |

---

### stats

OpenCode セッションのトークンの使用状況とコストの統計を表示します。

```bash
opencode stats
```

#### Flags

| Flag        | Description                                                                 |
| ----------- | --------------------------------------------------------------------------- |
| `--days`    | Show stats for the last N days (all time)                                   |
| `--tools`   | Number of tools to show (all)                                               |
| `--models`  | Show model usage breakdown (hidden by default). Pass a number to show top N |
| `--project` | Filter by project (all projects, empty string: current project)             |

---

### export

セッションデータをJSONとしてエクスポートします。

```bash
opencode export [sessionID]
```

セッション ID を指定しない場合は、利用可能なセッションから選択するように求められます。

---

### import

JSON ファイルまたは OpenCode 共有 URL からセッション データをインポートします。

```bash
opencode import <file>
```

ローカル ファイルまたは OpenCode 共有 URL からインポートできます。

```bash
opencode import session.json
opencode import https://opncd.ai/s/abc123
```

---

### web

Web インターフェイスを使用してヘッドレス OpenCode サーバーを起動します。

```bash
opencode web
```

これにより、HTTP サーバーが起動し、Web ブラウザが開き、Web インターフェイスを通じて OpenCode にアクセスします。 `OPENCODE_SERVER_PASSWORD` を設定して HTTP 基本認証を有効にします (ユーザー名のデフォルトは `opencode`)。

#### Flags

| Flag         | Description                             |
| ------------ | --------------------------------------- |
| `--port`     | リッスンするポート                      |
| `--hostname` | リッスンするホスト名                    |
| `--mdns`     | mDNS 検出を有効にする                   |
| `--cors`     | CORS を許可する追加のブラウザーオリジン |

---

### acp

ACP (エージェント クライアント プロトコル) サーバーを起動します。

```bash
opencode acp
```

このコマンドは、nd-JSON を使用して stdin/stdout 経由で通信する ACP サーバーを起動します。

#### Flags

| Flag         | Description          |
| ------------ | -------------------- |
| `--cwd`      | 作業ディレクトリ     |
| `--port`     | リッスンするポート   |
| `--hostname` | リッスンするホスト名 |

---

### uninstall

OpenCode をアンインストールし、関連ファイルをすべて削除します。

```bash
opencode uninstall
```

#### Flags

| Flag            | Short | Description                                 |
| --------------- | ----- | ------------------------------------------- |
| `--keep-config` | `-c`  | Keep configuration files                    |
| `--keep-data`   | `-d`  | Keep session data and snapshots             |
| `--dry-run`     |       | Show what would be removed without removing |
| `--force`       | `-f`  | Skip confirmation prompts                   |

---

### upgrade

opencodeを最新バージョンまたは特定のバージョンに更新します。

```bash
opencode upgrade [target]
```

最新バージョンにアップグレードするには。

```bash
opencode upgrade
```

特定のバージョンにアップグレードするには。

```bash
opencode upgrade v0.1.48
```

#### Flags

| Flag       | Short | Description                                            |
| ---------- | ----- | ------------------------------------------------------ |
| `--method` | `-m`  | 使用されたインストール方法。curl, npm, pnpm, bun, brew |

---

## Global Flags

opencode CLI は次のグローバル フラグを受け取ります。

| Flag           | Short | Description                            |
| -------------- | ----- | -------------------------------------- |
| `--help`       | `-h`  | ヘルプを表示                           |
| `--version`    | `-v`  | バージョン番号を出力                   |
| `--print-logs` |       | ログを標準エラー出力に出力             |
| `--log-level`  |       | ログ レベル (DEBUG、INFO、WARN、ERROR) |

---

## 環境変数

OpenCode は環境変数を使用して構成できます。

| 変数                                  | タイプ   | 説明                                                                |
| ------------------------------------- | -------- | ------------------------------------------------------------------- |
| `OPENCODE_AUTO_SHARE`                 | ブール値 | セッションを自動的に共有する                                        |
| `OPENCODE_GIT_BASH_PATH`              | 文字列   | Windows 上で実行可能な Git Bash へのパス                            |
| `OPENCODE_CONFIG`                     | 文字列   | 構成ファイルへのパス                                                |
| `OPENCODE_CONFIG_DIR`                 | 文字列   | config ディレクトリへのパス                                         |
| `OPENCODE_CONFIG_CONTENT`             | 文字列   | インライン JSON 構成コンテンツ                                      |
| `OPENCODE_DISABLE_AUTOUPDATE`         | ブール値 | 自動更新チェックを無効にする                                        |
| `OPENCODE_DISABLE_PRUNE`              | ブール値 | 古いデータのプルーニングを無効にする                                |
| `OPENCODE_DISABLE_TERMINAL_TITLE`     | ブール値 | terminal titleの自動更新を無効にする                                |
| `OPENCODE_PERMISSION`                 | 文字列   | インライン化された json 権限設定                                    |
| `OPENCODE_DISABLE_DEFAULT_PLUGINS`    | ブール値 | デフォルトのプラグインを無効にする                                  |
| `OPENCODE_DISABLE_LSP_DOWNLOAD`       | ブール値 | LSP サーバーの自動ダウンロードを無効にする                          |
| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | ブール値 | 実験モデルを有効にする                                              |
| `OPENCODE_DISABLE_AUTOCOMPACT`        | ブール値 | 自動コンテキスト圧縮を無効にする                                    |
| `OPENCODE_DISABLE_CLAUDE_CODE`        | ブール値 | `.claude` からの読み取りを無効にする (プロンプト + スキル)          |
| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | ブール値 | `~/.claude/CLAUDE.md` の読み取りを無効にする                        |
| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | ブール値 | `.claude/skills` のロードを無効にする                               |
| `OPENCODE_DISABLE_MODELS_FETCH`       | ブール値 | リモート ソースからのモデルの取得を無効にする                       |
| `OPENCODE_FAKE_VCS`                   | 文字列   | テスト目的の偽の VCS プロバイダー                                   |
| `OPENCODE_DISABLE_FILETIME_CHECK`     | ブール値 | 最適化のためにファイル時間チェックを無効にする                      |
| `OPENCODE_CLIENT`                     | 文字列   | クライアント識別子 (デフォルトは `cli`)                             |
| `OPENCODE_ENABLE_EXA`                 | ブール値 | Exa Web 検索ツールを有効にする                                      |
| `OPENCODE_SERVER_PASSWORD`            | 文字列   | `serve`/`web` の基本認証を有効にする                                |
| `OPENCODE_SERVER_USERNAME`            | 文字列   | 基本認証ユーザー名 (デフォルト `opencode`) をオーバーライドします。 |
| `OPENCODE_MODELS_URL`                 | 文字列   | モデル設定を取得するためのカスタム URL                              |

---

### 実験的

これらの環境変数により、変更または削除される可能性のある実験的な機能が有効になります。

| 変数                                            | タイプ   | 説明                                             |
| ----------------------------------------------- | -------- | ------------------------------------------------ |
| `OPENCODE_EXPERIMENTAL`                         | ブール値 | すべての実験的機能を有効にする                   |
| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY`          | ブール値 | アイコン検出を有効にする                         |
| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`  | ブール値 | TUI で選択時のコピーを無効にする                 |
| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | 番号     | bash コマンドのデフォルトのタイムアウト (ミリ秒) |
| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`        | 番号     | LLM 応答の最大出力トークン                       |
| `OPENCODE_EXPERIMENTAL_FILEWATCHER`             | ブール値 | ディレクトリ全体のファイル監視を有効にする       |
| `OPENCODE_EXPERIMENTAL_OXFMT`                   | ブール値 | oxfmt フォーマッタを有効にする                   |
| `OPENCODE_EXPERIMENTAL_LSP_TOOL`                | ブール値 | 実験的な LSP ツールを有効にする                  |
| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER`     | ブール値 | ファイルウォッチャーを無効にする                 |
| `OPENCODE_EXPERIMENTAL_EXA`                     | ブール値 | 実験的な Exa 機能を有効にする                    |
| `OPENCODE_EXPERIMENTAL_LSP_TY`                  | ブール値 | 実験的な LSP タイプ チェックを有効にする         |
| `OPENCODE_EXPERIMENTAL_MARKDOWN`                | ブール値 | 試験的なMarkdown機能を有効にする                 |
| `OPENCODE_EXPERIMENTAL_PLAN_MODE`               | ブール値 | プランモードを有効にする                         |
