Claude Code Installation

[tony-stark-eth]

Could you add an Installation Guide for Claude Code for better results?

[AJenbo]

Sorry this question isn't really clear to me Claude Code is a terminal based AI chat, not an IDE, it has no LSP intergration. If you mean Cursor or Cline then I belive that the VS Code instructions should work for them as well.

[dotdash]

Claude can actually use an LSP, there's a guide on writing a custom plugin

[veewee]

It took me a while to set this up, so I let claude generate a more detailed guide + bash script:

#!/usr/bin/env bash
set -euo pipefail

# Setup PHPantom LSP as a Claude Code plugin
# Usage: bash setup-phpantom-lsp.sh

MARKETPLACE_DIR="$HOME/.claude/plugins/marketplaces/phpantom-marketplace"
PLUGIN_DIR="$MARKETPLACE_DIR/plugins/phpantom-lsp"

# Check phpantom_lsp is installed
if ! command -v phpantom_lsp &>/dev/null; then
  echo "Error: phpantom_lsp not found on PATH"
  echo "Install PHPantom first: https://github.com/AJenbo/phpantom_lsp"
  exit 1
fi

echo "Found phpantom_lsp at: $(which phpantom_lsp)"

# Create directory structure
mkdir -p "$MARKETPLACE_DIR/.claude-plugin"
mkdir -p "$PLUGIN_DIR"

# Write marketplace.json
cat > "$MARKETPLACE_DIR/.claude-plugin/marketplace.json" <<'EOF'
{
  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  "name": "phpantom-marketplace",
  "description": "PHPantom LSP for Claude Code",
  "owner": { "name": "local" },
  "plugins": [
    {
      "name": "phpantom-lsp",
      "description": "Ultra-fast PHP language server (PHPantom)",
      "version": "1.0.0",
      "source": "./plugins/phpantom-lsp",
      "category": "development",
      "lspServers": {
        "phpantom": {
          "command": "phpantom_lsp",
          "args": ["--stdio"],
          "extensionToLanguage": { ".php": "php" }
        }
      }
    }
  ]
}
EOF

# Write .lsp.json
cat > "$PLUGIN_DIR/.lsp.json" <<'EOF'
{
  "phpantom": {
    "command": "phpantom_lsp",
    "args": ["--stdio"],
    "extensionToLanguage": { ".php": "php" }
  }
}
EOF

# Write README
cat > "$PLUGIN_DIR/README.md" <<'EOF'
# phpantom-lsp

Ultra-fast PHP language server (PHPantom) plugin for Claude Code.
EOF

# Enable LSP in settings if not already enabled
SETTINGS="$HOME/.claude/settings.json"
if [ -f "$SETTINGS" ]; then
  if ! grep -q '"ENABLE_LSP_TOOL"' "$SETTINGS"; then
    # Add ENABLE_LSP_TOOL using a temp file (portable)
    tmp=$(mktemp)
    jq '. + {"ENABLE_LSP_TOOL": "1"}' "$SETTINGS" > "$tmp" && mv "$tmp" "$SETTINGS"
    echo "Enabled LSP tool in settings"
  fi
else
  echo '{"ENABLE_LSP_TOOL": "1"}' > "$SETTINGS"
  echo "Created settings with LSP enabled"
fi

# Register marketplace and install plugin
echo "Registering marketplace..."
claude plugin marketplace add "$MARKETPLACE_DIR"

echo "Installing plugin..."
claude plugin install phpantom-lsp@phpantom-marketplace --scope user

echo ""
echo "Done! Restart Claude Code to activate the PHPantom LSP."

PHPantom LSP for Claude Code

Claude Code supports LSP plugins for code intelligence. PHPantom is an ultra-fast PHP language server that provides goToDefinition, findReferences, hover, and other features.

Prerequisites

• PHPantom installed and phpantom_lsp on your $PATH
• Claude Code with LSP support enabled

Quick Setup

bash setup-phpantom-lsp.sh

Then restart Claude Code.

Manual Setup

1. Enable LSP in Claude Code settings (~/.claude/settings.json):

   {
     "ENABLE_LSP_TOOL": "1"
   }

2. Create the marketplace directory:

   mkdir -p ~/.claude/plugins/marketplaces/phpantom-marketplace/.claude-plugin
   mkdir -p ~/.claude/plugins/marketplaces/phpantom-marketplace/plugins/phpantom-lsp

3. Create ~/.claude/plugins/marketplaces/phpantom-marketplace/.claude-plugin/marketplace.json:

   {
     "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
     "name": "phpantom-marketplace",
     "description": "PHPantom LSP for Claude Code",
     "owner": { "name": "local" },
     "plugins": [
       {
         "name": "phpantom-lsp",
         "description": "Ultra-fast PHP language server (PHPantom)",
         "version": "1.0.0",
         "source": "./plugins/phpantom-lsp",
         "category": "development",
         "lspServers": {
           "phpantom": {
             "command": "phpantom_lsp",
             "args": ["--stdio"],
             "extensionToLanguage": { ".php": "php" }
           }
         }
       }
     ]
   }

4. Create ~/.claude/plugins/marketplaces/phpantom-marketplace/plugins/phpantom-lsp/.lsp.json:

   {
     "phpantom": {
       "command": "phpantom_lsp",
       "args": ["--stdio"],
       "extensionToLanguage": { ".php": "php" }
     }
   }

5. Register and install:

   claude plugin marketplace add ~/.claude/plugins/marketplaces/phpantom-marketplace
   claude plugin install phpantom-lsp@phpantom-marketplace --scope user

6. Restart Claude Code.

Verify

After restarting, the LSP tool should be available. Test with:

goToDefinition on any PHP class reference

Or check debug logs:

grep -i 'phpantom\|Total LSP' ~/.claude/debug/latest

Supported Operations

Operation	Status
goToDefinition	Supported
findReferences	Supported
hover	Supported
goToImplementation	Supported
workspaceSymbol	Supported
documentSymbol	Not supported

Notes

• File-based marketplaces (claude plugin marketplace add <file>) don't work for LSP plugins. You must use a directory-based marketplace that mirrors the official marketplace structure.
• The marketplace directory must live inside ~/.claude/plugins/marketplaces/.

[AJenbo]

Ok that's interesting, I'll have to look in to it at some point.

We currently don't support workspaceSymbol but it is planned.

[tony-stark-eth]

Had a bit of sparetime and used claude code to combine intelephense free and phantom.
Feel free to close the issue :)

https://github.com/tony-stark-eth/php-lsp-docker-claude-code

[AJenbo]

Having researched this a bit I think the right solution is to use a MCP like https://github.com/jonrad/lsp-mcp