最終更新日: 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の詳細な使い方(本サイト内ページ) |