最終更新日: 2026年09月25日

テンプレート説明

OpenCodeは、ターミナル上で動作するオープンソースのAIコーディングエージェントです。TUI(Terminal User Interface)を通じて、コードの生成・デバッグ・リファクタリングといった開発作業をAIの支援のもと効率的に行えます。Anthropic、OpenAI、Google、GitHub Copilot、AWS Bedrock など多数のAIプロバイダーに対応しており、利用するモデルを自由に選択できます。

本テンプレートは、専用ユーザー(opencode-user)によるセキュアな実行環境を自動構築します。

加えて、2026年9月25日より、サプライチェーン攻撃対策として同梱ツール「Takumi Guard」の管理スクリプトが同梱されます(デフォルトは無効)。2026年9月24日以前に作成したサーバーには同梱されていません。詳しくは後述の「同梱ツール(Takumi Guard)」をご覧ください。

スタートアップスクリプトのテンプレートを利用してサーバー作成を行う手順はご利用ガイドを参照してください。

仕様

対応OSイメージ

Ubuntu 24.04 LTS

主要ソフトウェア

ソフトウェア名 バージョン ライセンス 用途
OpenCode Latest MIT AIコーディングエージェント本体
Node.js v24 MIT OpenCode実行環境

スタートアップスクリプト情報

項目 説明
アプリケーション利用ポート なし(CLI/TUIツールのためWebポート不要)
インストールディレクトリ /home/opencode-user/.npm-global/
管理スクリプト /root/opencode-manage.sh(/root/takumi-guard.sh)
※2026年9月24日以前に作成したサーバーでは、従来の /root/opencode-diagnose.sh・/root/opencode-uninstall.sh をご利用ください。
インストール情報ファイル /root/opencode-info.txt
実行ユーザー opencode-user

メモ

管理スクリプトは2026年9月25日に更新されました。2026年9月25日以降に本テンプレートでサーバーを作成した場合は、単一の管理スクリプト(/root/opencode-manage.sh、diagnose/update/uninstallサブコマンド)をご利用ください。2026年9月24日以前に作成したサーバーでは、従来の /root/opencode-diagnose.sh・/root/opencode-uninstall.sh がそのままご利用いただけます。

その他

最小システム要件

  • CPU: 1コア以上
  • メモリ: 最小1GB、推奨2GB以上
  • ディスク容量: 2GB以上(推奨5GB以上)
  • ネットワーク: インターネット接続必須(AIプロバイダーAPIへのアクセスに使用)

利用手順

メモ

スタートアップスクリプトにてアプリケーションのインストールが完了するまで数分かかります。
インストール完了後、rootディレクトリに「opencode-info.txt」というファイルが作成されますのでご確認ください。
ファイルが存在しない場合、作成されるまでしばらくお待ちください。
スタートアップスクリプトの実行状況は、SSH接続後に以下のコマンドで確認できます。

# tail -f /var/log/opencode-install.log

Step 1: VPSへの接続

SSHクライアントを使用してrootユーザーでVPSに接続します。

# ssh root@<IPアドレス>

Step 2: 専用ユーザーへの切り替え

OpenCodeはセキュリティのため専用ユーザー(opencode-user)として実行します。以下のコマンドでユーザーを切り替えてください。

# su - opencode-user

Step 3: OpenCodeの起動

ユーザーを切り替えたら、作業ディレクトリに移動してOpenCodeを起動します。

# mkdir my-project && cd my-project
# opencode

メモ

初回起動時は、AIプロバイダーの認証設定が必要です。OpenCode TUI内で /connect コマンドを実行し、使用するプロバイダー(Anthropic、OpenAI、Google等)のAPIキーを設定してください。プロジェクトディレクトリで /init コマンドを実行すると、プロジェクト情報をまとめた AGENTS.md ファイルが生成されます。詳細な手順は公式ドキュメントを参照してください。

管理スクリプト一覧

メモ

管理スクリプトは2026年9月25日に更新されています。サーバーの作成日に応じて、以下のいずれかをご利用ください。

2026年9月25日以降に作成したサーバー

スクリプト名 機能 使用例
opencode-manage.sh diagnose システム・OpenCodeの状態確認(診断) # /root/opencode-manage.sh diagnose
opencode-manage.sh update OpenCode最新版への更新 # /root/opencode-manage.sh update
opencode-manage.sh uninstall OpenCodeの削除(設定ファイルは保持) # /root/opencode-manage.sh uninstall

2026年9月24日以前に作成したサーバー

スクリプト名 機能 使用例
opencode-diagnose.sh システム・OpenCodeの状態確認 # /root/opencode-diagnose.sh
opencode-uninstall.sh OpenCodeの削除 # /root/opencode-uninstall.sh

メモ

2026年9月24日以前に作成したサーバーには、更新(update)機能を持つ管理スクリプトは含まれていません。OpenCodeを更新する場合は、以下の「アップデート手順」をご参照ください。

メモ

インストール情報(接続先情報・使用手順など)は /root/opencode-info.txt に保存されています。

アップデート手順

OpenCodeを最新版に更新する手順は、サーバーの作成日によって異なります。

2026年9月25日以降に作成したサーバー:

# /root/opencode-manage.sh update

2026年9月24日以前に作成したサーバー:

# su - opencode-user
# npm update -g opencode-ai

セキュリティグループ設定

ポート番号 プロトコル 用途 必須/オプション
22 TCP SSH 任意

同梱ツール(Takumi Guard)

本テンプレートには、2026年9月25日より、サプライチェーン攻撃対策としてTakumi Guardの管理スクリプト(/root/takumi-guard.sh)が同梱されています(デフォルトは無効)。2026年9月24日以前に作成したサーバーには同梱されていません。Takumi Guardは複数のテンプレートに共通で同梱されるツールのため、詳しい使い方は独立したページにまとめて記載しています。

基本的な有効化・無効化は、root権限で以下のコマンドを実行します。

# /root/takumi-guard.sh status
# /root/takumi-guard.sh enable
# /root/takumi-guard.sh disable

メモ

メール認証モードへの切り替え、レート制限、対象パッケージマネージャーの一覧、組織向けプランなど詳細な使い方は、Takumi Guard(同梱ツール)のページを参照してください。

サイト名 URL 説明
OpenCode公式サイト https://opencode.ai プロダクト情報・最新ニュース
OpenCode公式ドキュメント https://opencode.ai/docs 技術ドキュメント・チュートリアル
OpenCodeのGitHubリポジトリ https://github.com/sst/opencode ソースコード・イシュートラッカー
Takumi Guard(同梱ツール) https://doc.conoha.jp/products/vps-v3/startupscripts-v3/takumi-guard/ Takumi Guardの詳細な使い方(本サイト内ページ)