直到我接触到 Serena 这个项目,它直接改变了 Claude Code 的体验。

一句话总结:省钱、更准、更快,就像给 Claude Code 插上了 IDE 的“大脑”。
项目介绍
Serena 是一个开源的 语义级代码智能体工具包,它通过 LSP 提供的符号检索与编辑能力,把 IDE 里常见的“跳转定义 / 查找引用 / 符号编辑”等功能暴露给 LLM 使用。
LSP(Language Server Protocol,语言服务器协议)是一种通用的通信协议,用来让编辑器或 IDE 与不同编程语言的“语言服务器”交互,从而提供代码补全、跳转定义、查找引用、诊断与格式化等智能功能。编辑器只要支持 LSP,就能快速适配多种语言,而不需要自己解析语法。Serena 正是基于 LSP 获取代码的符号级信息(函数、类、变量等),再把这些能力暴露给 LLM 使用,使得 Claude Code 或 Codex 等智能体能够像 IDE 一样进行精准的代码检索与编辑,而不是靠全文搜索替换。
这意味着,Claude Code、Codex、Cursor 等智能体不再需要扫描整个文件,而是能直接基于函数、类、变量这些语义单位进行精准的检索和修改。
没有 Serena 的时候:Claude Code 必须读整个文件,消耗大量上下文,增加出错概率。
有了 Serena 之后:只需读取必要的符号片段,效率提升,API 调用成本显著下降。
功能亮点
符号级别理解与编辑:支持 find_symbol、find_referencing_symbols、insert_after_symbol 等操作,不再依赖字符串替换。
多语言支持:涵盖 Python、TS/JS、Go、Rust、C/C++、Java、Kotlin、Swift、Ruby、PHP、Lua、Dart 等(部分需安装对应 LSP,如 gopls、rust-analyzer 等)。
MCP 支持:内置 MCP 服务器,可无缝接入 Claude Code、Claude Desktop、Codex CLI、Cursor、VSCode 等。
Web Dashboard:启动后自带本地仪表盘(默认 http://localhost:24282),支持日志查看与进程管理。
模式与上下文(Modes & Contexts):可根据场景切换,如 IDE 助手模式、桌面应用模式、Agent 模式,甚至自定义上下文与任务模式。
记忆系统(Memories):首次启动会进行项目 onboarding,生成 .serena/memories/
文件,供后续交互复用。
部署方式
安装非常简单,Serena 支持 uv 包管理器 的即开即用方式:
claude mcp add serena -- \
uvx --from git+https://github.com/oraios/serena \
serena start-mcp-server \
--context ide-assistant \
--project "$(pwd)"
-
--context ide-assistant
:为 IDE 场景适配工具集 -
--project
:直接激活当前工程
也可以接入 Codex CLI,通过 TOML 配置:
[mcp_servers.serena]
command = "uvx"
args = ["--from","git+https://github.com/oraios/serena",
"serena","start-mcp-server","--context","codex"]
除了 uvx 快速运行,Serena 也支持本地安装与自定义配置。
使用场景
Claude Code 增强:最推荐的方式,让 Claude 拥有 IDE 级别的语义检索与编辑能力。
终端客户端:Codex、Gemini-CLI、Qwen3-Coder、OpenHands CLI 等。
IDE 集成:VSCode、Cursor、IntelliJ 等。
Web/本地客户端:OpenWebUI、Jan、Agno 等。
二次开发:可作为库引入,自定义上下文和模式,扩展到任意代理框架。
开源说明
免费 & 开源:完全开放,可自由集成到自己的工作流。
独立性强:不依赖特定 LLM、框架或界面,适配性极高。
安全可控:支持只读模式(read_only: true),避免修改代码库,仅用于分析与探索。
总结
在我看来,Serena 的价值非常直接:让 AI 代码助手从“会写”升级为“写得准”。
过去我们习惯忍受 Claude Code 的“全文搜索式”笨拙,现在通过 Serena,它能像 IDE 一样精准理解代码结构,既节省 token 成本,又大幅提升可靠性。
如果你也在折腾 Claude Code 或其他 AI 编码助手,我真心建议试试 Serena。
它不仅是一个工具,更像是一个 “开源外挂”,让 LLM 真正具备 IDE 的大脑。
项目地址: