クイックスタート：インストールと設定

この章で学べること

この章では、以下のことができるようになります：

1. opencode-supermemory プラグインを OpenCode 環境にインストールします。
2. Supermemory API Key を設定し、クラウド記憶ストアに接続します。
3. プラグインが正常に読み込まれたことを確認します。
4. 他のプラグイン（Oh My OpenCode など）との潜在的な競合を解決します。

完了後、Agent はクラウド記憶ストアに接続する基本能力を持つようになります。

今の課題

お気づきかもしれませんが、OpenCode の Agent は賢いですが、非常に忘れっぽいです：

• 新しいセッションを開始するたびに、まるで記憶を失ったかのように、以前の設定を忘れてしまいます。
• プロジェクト A で教えたアーキテクチャ規約も、プロジェクト B に移ると忘れてしまいます。
• 長いセッションで会話を続けていると、重要な情報がコンテキストから「押し出されて」しまいます。

Agent にこれらを記憶させる外部ブレインが必要です。

いつこの方法を使うべきか

• 初めて使用する場合：opencode-supermemory を初めて使用する場合。
• 環境を再インストールする場合：新しいコンピューターに移行した場合や OpenCode の設定をリセットした場合。
• トラブルシューティング：プラグインが正しくインストールされていないと疑う場合や API 接続に問題がある場合。

---

🎒 開始前の準備

開始する前に、以下が完了していることを確認してください：

1. OpenCode をインストール済み：ターミナルで opencode コマンドが使用可能であること。
2. API Key を取得済み：
   • Supermemory Console にアクセス
   • アカウントに登録/ログイン
   • 新しい API Key を作成する（sm_ で始まる）

Supermemory とは？

Supermemory は AI Agent 専用に設計されたクラウドベースの記憶レイヤーです。データを保存するだけでなく、セマンティック検索を通じて、適切なタイミングで適切なことを想起するのを Agent に支援します。

---

基本的な考え方

インストールプロセスは非常にシンプルで、本質的には 3 つのステップです：

1. プラグインをインストール：インストールスクリプトを実行し、プラグインを OpenCode に登録します。
2. キーを設定：プラグインにあなたの API Key を伝えます。
3. 接続を確認：OpenCode を再起動し、Agent が新しいツールを認識できることを確認します。

---

実践：一緒に作業しましょう

ステップ 1：プラグインをインストール

2 つのインストール方法を提供しています。あなたに適した方法を選択してください。

人間用（対話型インストール）

# 推奨：対話型ガイドがあり、設定を自動的に処理します
bunx opencode-supermemory@latest install

Agent 用（自動インストール）

# Agent にインストールを依頼する場合、このコマンドを使用します（対話確認をスキップし、競合を自動的に解決します）
bunx opencode-supermemory@latest install --no-tui --disable-context-recovery

期待される出力： ターミナルに ✓ Setup complete! と表示され、プラグインが ~/.config/opencode/opencode.jsonc に正常に登録されたことを示します。

ステップ 2：API Key を設定

プラグインはクラウド記憶を読み書きするために API Key が必要です。2 つの設定方法があります。

方法 A：環境変数（推奨）

シェル設定ファイル（.zshrc や .bashrc など）に直接追加します：

export SUPERMEMORY_API_KEY="sm_あなたのキー..."

方法 B：設定ファイル

または、専用の設定ファイル ~/.config/opencode/supermemory.jsonc を作成します：

{
  "apiKey": "sm_あなたのキー..."
}

理由：環境変数の方がより安全で、誤ってコードリポジトリにコミットされることを防ぎます。設定ファイルは複数の設定を管理するのに便利です。

ステップ 3：競合を解決（Oh My OpenCode を使用している場合）

Oh My OpenCode をインストールしている場合、その組み込みコンテキスト管理機能が Supermemory と競合する可能性があります。

確認方法： インストールスクリプトは通常、競合するフックを自動的に検出して無効化するよう促します。そうでない場合は、手動で ~/.config/opencode/oh-my-opencode.json を確認してください：

{
  "disabled_hooks": [
    "anthropic-context-window-limit-recovery"  // ✅ この行が存在することを確認
  ]
}

理由：Supermemory はよりスマートな「先制圧縮（Preemptive Compaction）」を提供します。2 つのプラグインが同時にコンテキストを管理しようとすると、混乱を引き起こします。

ステップ 4：インストールを確認

OpenCode を再起動し、チェックコマンドを実行します：

opencode -c

または、直接 OpenCode 対話モードに入り、ツールリストを確認します。

期待される出力： ツールリスト（Tools）に supermemory ツールが表示されます。

Available Tools:
- supermemory (add, search, profile, list, forget)
...

---

チェックポイント ✅

以下の項目を自己チェックして、すべてが準備完了であることを確認してください：

• [ ] cat ~/.config/opencode/opencode.jsonc を実行し、plugin リストに "opencode-supermemory" が含まれていること。
• [ ] 環境変数 SUPERMEMORY_API_KEY が有効であること（echo $SUPERMEMORY_API_KEY で確認可能）。
• [ ] opencode を実行後、Agent がエラーを報告していないこと。

---

落とし穴の警告

一般的なエラー：API Key が有効でない

環境変数を設定したのにプラグインが認証されていないと示す場合、以下を確認してください：

1. ターミナルを再起動しましたか？（.zshrc を変更した後、source ~/.zshrc または再起動が必要です）
2. OpenCode を再起動しましたか？（OpenCode プロセスを再起動しないと新しい変数を読み込めません）

一般的なエラー：JSON 形式エラー

opencode.jsonc を手動で変更する場合、JSON 形式が正しいことを確認してください（特にカンマ）。インストールスクリプトはこれを自動的に処理しますが、手動変更ではエラーが発生しやすいです。

---

この章のまとめ

おめでとうございます！OpenCode に「海馬」を搭載できました。これで、Agent は記憶を開始する準備が整いました。

• opencode-supermemory プラグインをインストールしました。
• クラウド接続の認証情報を設定しました。
• 潜在的なプラグインの競合を解決しました。

次の章の予告

次の章では プロジェクト初期化：第一印象を確立 を学びます。

以下のことができるようになります：

• 1 つのコマンドで Agent にプロジェクト全体を深くスキャンさせる方法
• Agent にプロジェクトのアーキテクチャ、技術スタック、暗黙のルールを記憶させる方法
• Agent が実際に何を記憶したかを確認する方法

---

付録：ソースコード参照

クリックしてソースコードの場所を表示

更新日：2026-01-23

機能	ファイルパス	行番号
インストールスクリプトロジック	src/cli.ts	327-410
プラグイン登録ロジック	src/cli.ts	195-248
競合検出ロジック	src/cli.ts	273-320
設定ファイルの読み込み	src/config.ts	-