はじめに

Serenaのセットアップ方法を紹介します。

「Serena」とは？

強力なコーディングエージェントツールキットです。
LLMにIDEの機能を提供するイメージとのことです。

Seranaを使うことで、Claude CodeなどのAI内でコードを効率よく取得や編集でき、トークンと時間を節約できます。

環境

macOS: Sequoia 15.7.2
uv: uv 0.10.2 (Homebrew 2026-02-10)

Serenaのセットアップ（ローカル）

Serenaのセットアップにおいて、全員がローカルで行うことを紹介します。

uvのインストール

Serenaはuvで管理されているため、インストールが必須です。

私はHomebrewでインストールしました。

$ brew install uv

ダッシュボードを自動で開かないようにする

デフォルトでは、 claude コマンドを実行するたびに Web ブラウザでダッシュボードが開きます。

無効にする場合は ~/.serena/serena_config.yml で web_dashboard_open_on_launch を true から false へ変更します。

~/.serena/serena_config.yml

- web_dashboard_open_on_launch: true
+ web_dashboard_open_on_launch: false

なお、ダッシュボードが開くのをデフォルトで無効にする計画はないようです。

Serenaのセットアップ（プロジェクト）

Serenaのセットアップにおいて、プロジェクト単位で誰かひとりが行うことを紹介します。

MCPサーバーの追加

SerenaはMCPサーバーとして使うのが一般的です。

プロジェクトルートの .mcp.json に以下を追記し、SerenaのMCPサーバーを追加します。

.mcp.json

{
  "mcpServers": {
+     "serena": {
+       "type": "stdio",
+       "command": "uvx",
+       "args": [
+         "--from",
+         "git+https://github.com/oraios/serena",
+         "serena",
+         "start-mcp-server",
+         "--context",
+         "claude-code",
+         "--project",
+         "."
+       ]
+     }
  }
}

--context に渡すオプションは、使う環境に合わせて変えてください。
Claude Codeで使う場合は claude-code を渡します。

設定ファイルの更新

.serena フォルダが自動で生成され、その中に project.yml というファイルがあるので、必要に応じて更新します。

.serena/project.yml

project_name: "{プロジェクト名}"
languages:
- {LSPを使う言語リスト}
encoding: "utf-8"
ignore_all_files_in_gitignore: true
ignored_paths: []
read_only: false
excluded_tools: []
included_optional_tools: []
fixed_tools: []
base_modes:
default_modes:
initial_prompt: ""

基本的には languages のみ更新すれば問題ありません。

インデックスの作成

初回のみインデックスの作成を手動で行います。

$ uvx --from git+https://github.com/oraios/serena serena project index

初回以降は、ファイルが変更されるたびに自動でインデックスが更新されます。

オンボーディングの実行

Serenaの初回起動時にオンボーディングを実行します。

以下のようなプロンプトで実行できます。

Serenaでオンボーディングを実行したいです。

オンボーディングでは、Serenaがプロジェクトのコンテンツを読み取り、結果を .serena/memories/ フォルダ内にまとめます。

メモリをGit管理するかは好みかもしれませんが、Serena公式はGit管理しています。

オンボーディングではコンテキストが埋め尽されるため、実行後は /clear などでコンテキストをリセットするのがオススメです。

おわりに

これでSerenaのセットアップが完了しました。
有効に活用して、素晴らしいAIライフを送りましょう

参考リンク