ガイド
OpenCode の使い方|インストールと最初の実行
無料・オープンソースのターミナル型AIコーディングエージェント「OpenCode」を、インストールからプロバイダ認証、最初の実行まで手順で解説します。コマンドはOpenCode v1.17.8(2026-06-20)で確認済みです。
手順
1. インストール(いずれか1つ)
macOS / Linux は curl スクリプトかHomebrew、全OS(Windows含む)は npm が手軽です。
# 全OS(Node 18+ 必要) npm i -g opencode-ai # macOS / Linux curl -fsSL https://opencode.ai/install | bash brew install anomalyco/tap/opencode2. インストール確認
バージョンを表示して、PATHが通っているか確認します(1.17.8以降が表示されればOK)。
opencode --version3. モデルプロバイダを認証
OpenCodeはモデル非依存です。ログインコマンドで最初のプロバイダ(Anthropic・OpenAI・Googleなど)を追加します。キーはローカルに保存されます。
opencode auth login4. 起動する
対話型TUIを起動するか、単発のヘッドレス実行、サーバーモードを使えます。
# 対話型TUI opencode # 単発タスク opencode run "このリポジトリの概要を説明して" # サーバーモード opencode serve
よくある質問
- Windowsでも使えますか?
- はい。npm(npm i -g opencode-ai)はWindowsのPowerShellで動作し、WSL内ではcurlインストーラも使えます。ネイティブWindows固有の挙動は opencode.ai で最新情報を確認してください。
- APIキーは必要ですか?
- はい。OpenCodeはBYO(自前キー)方式です。インストール後に opencode auth login でプロバイダを追加します。キーはローカル保存。GitHub CopilotやChatGPTをOAuthで接続すれば既存サブスクを再利用できます。
- 更新方法は?
- インストール方法を再実行します。npmなら npm i -g opencode-ai@latest、Homebrewなら brew upgrade opencode。その後 opencode --version で確認します。