1. 全局安装 Serena
你需要用 包名 serena-agent 来安装，但安装完后命令行工具叫 serena：
uv tool install --from git+https://github.com/oraios/serena serena-agent
安装成功后，全局会有一个可执行命令：
serena --help
后续操作
升级：
uv tool upgrade serena-agent
卸载：
uv tool uninstall serena-agent
2. MCP 客户端配置
✅ Codex CLI 配置（Linux/Mac 路径示例）
编辑 ~/.codex/config.toml：[mcp_servers.serena]
command = "serena"
args = ["start-mcp-server", "--context", "codex", "--project", "."]说明：
command = "serena" → 使用全局安装的命令。
--project . → 默认绑定到当前目录，你也可以改成绝对路径。
✅ Claude Code / Claude Desktop 配置
运行命令一次即可：
claude mcp add serena -- serena start-mcp-server --context ide-assistant --project .
说明：
--project . → 始终服务于当前目录。
如果你有多个项目，可以在不同项目目录下重复执行这条命令。
✅ Gemini CLI 配置
# 编辑 ~/.config/gemini/settings.json（或项目下 .gemini/settings.json）：
{"mcpServers": {"serena": {"displayName": "Serena Coding Agent","command": "serena","args": ["start-mcp-server","--context","ide-assistant","--project","."]}}
}
3. 使用方式
在项目目录下：
codex # 或 claude / gemini
然后直接在 CLI 中对话，比如：
“帮我找出所有 UserService 的调用位置”
“重构这个函数，提取公共逻辑”
CLI 会自动调用 Serena（因为 MCP 已注册），Serena 会基于当前项目目录执行操作。
4. 日常建议
保持全局一份安装：更新时执行
uv tool upgrade serena
跨 CLI 配置一致：三个 CLI 都用 command = "serena"，不用 uvx --from。
多项目支持：
默认用 --project .（当前目录），
特殊情况手动改路径即可。
✅ 总结：
安装一次 → 全局 serena 命令可用。
所有 CLI 配置都指向这个命令。
项目切换靠 --project 参数，一般用 . 即可。