ガイド

OpenCode の使い方|インストールと最初の実行

無料・オープンソースのターミナル型AIコーディングエージェント「OpenCode」を、インストールからプロバイダ認証、最初の実行まで手順で解説します。コマンドはOpenCode v1.17.8(2026-06-20)で確認済みです。

英語の全文: Install OpenCode (English)OpenCode とは?

手順

  1. 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/opencode
  2. 2. インストール確認

    バージョンを表示して、PATHが通っているか確認します(1.17.8以降が表示されればOK)。

    opencode --version
  3. 3. モデルプロバイダを認証

    OpenCodeはモデル非依存です。ログインコマンドで最初のプロバイダ(Anthropic・OpenAI・Googleなど)を追加します。キーはローカルに保存されます。

    opencode auth login
  4. 4. 起動する

    対話型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 で確認します。