GDScript Code Intelligence — Godot LSP Plugin for Claude Code

Make Claude Code actually understand your Godot project.

If you've ever wished Claude could navigate your GDScript codebase the way a proper IDE does — jumping to definitions, catching errors, suggesting completions — this plugin makes that happen.

What It Does

This plugin connects Claude Code to Godot's built-in language server, giving it real-time code intelligence for your .gd and .gdshader files. No guessing, no hallucinating API names — Claude gets the same type info and diagnostics your editor does.

• 🔴 Real-time diagnostics — errors and warnings as you work
• 🔵 Hover info — type information and documentation on any symbol
• 🟢 Go-to-definition — jump to where functions, variables, and classes are defined
• 🟡 Code completions — context-aware suggestions powered by Godot's own engine
• 🔍 Symbol search — find anything across your entire project
• 🔁 Auto-reconnect — restart Godot, and the plugin picks right back up

How It Works

Godot 4 ships with a built-in LSP server that speaks TCP. Claude Code's plugin system expects stdio. This plugin runs a lightweight Node.js bridge (~200 lines, zero runtime dependencies) that translates between the two:

Claude Code  ↔  Bridge (stdio)  ↔  Godot LSP (TCP:6005)

It buffers messages when Godot isn't running yet and flushes them on connect, so you never lose context.

Requirements

• Claude Code v2.0.74+ (with LSP plugin support)
• Godot Engine 4.x
• Node.js 18+

Install (One Command)

git clone https://github.com/Sods2/claude-code-gdscript-lsp.git cd claude-code-gdscript-lsp ./scripts/install.sh

The script builds the bridge, links it globally, and registers the plugin with Claude Code. That's it.

Install from ZIP (Downloaded Here)

If you downloaded the ZIP from this page instead of cloning with Git, follow these steps:

1. Extract the ZIP to a folder of your choice
2. Open a terminal and navigate into the extracted folder
3. Build the bridge:

   cd bridge npm install npm run build cd ..

4. Link the bridge globally so Claude Code can find it:

   cd bridge npm link cd ..

5. Register the plugin with Claude Code (replace the path with wherever you extracted the folder):

   claude plugin marketplace add /path/to/claude-code-gdscript-lsp claude plugin install gdscript-lsp

6. Restart Claude Code for the plugin to take effect

To confirm it installed correctly, run claude plugin list — you should see gdscript-lsp listed and enabled.

Usage

1. Open your project in the Godot Editor (this starts the LSP server automatically)
2. Run claude in your Godot project directory
3. Code intelligence is active — Claude now understands your GDScript

Prefer headless? You can run Godot without the GUI:

godot --editor --headless --lsp-port 6005

Who Is This For?

• Godot developers who want AI-assisted coding that actually understands GDScript types, signals, and node paths — not just pattern matching on text
• Claude Code users who work on Godot projects and want the same LSP-powered intelligence they get in other languages

Free & Open Source

MIT licensed. Use it, modify it, share it. Source code and contributions welcome on GitHub.