Claude Code Installation Guide

Documentation for Developers

Claude Code Extension - Installation & Activation Guide

✅ Status: Extension is Installed

Your Claude Code extension is installed at:

~/.cursor/extensions/anthropic.claude-code-2.0.74-darwin-arm64

🚀 How to Open Claude Code Interface

Method 1: Command Palette (Recommended)

  1. Press Cmd+Shift+P (or Ctrl+Shift+P on Windows/Linux)
  2. Type: Claude Code: Open in New Tab
  3. Press Enter

Or try these commands:

Method 2: Keyboard Shortcut

Method 3: Sidebar Icon

  1. Look for the Claude Code icon in the Activity Bar (left sidebar)
  2. Click it to open Claude Code in the sidebar

Method 4: Editor Title Bar

  1. Open any file in the editor
  2. Look for the Claude Code icon in the editor title bar
  3. Click it to open Claude Code

🔧 If You Still Don't See It

Step 1: Reload Cursor Window

  1. Press Cmd+Shift+P
  2. Type: Developer: Reload Window
  3. Press Enter

Step 2: Check Extension Status

  1. Press Cmd+Shift+X to open Extensions view
  2. Search for "Claude Code"
  3. Make sure it shows as Enabled (not Disabled)

Step 3: Check Extension Settings

  1. Press Cmd+, to open Settings
  2. Search for "claude code"
  3. Verify these settings:
    • claudeCode.useTerminal: Should be false (unless you want terminal mode)
    • claudeCode.preferredLocation: Choose sidebar or panel

Step 4: Verify Extension Activation

The extension activates on:

If it's not activating, try:

  1. Close all Cursor windows
  2. Reopen Cursor
  3. Wait a few seconds for startup to complete
  4. Try opening via Command Palette

🎯 Quick Test

Run this in Command Palette (Cmd+Shift+P):

Claude Code: Open in New Tab

If a new tab opens with Claude Code interface → It's working! ✅

📋 Available Commands

All Claude Code commands (accessible via Cmd+Shift+P):

Command Description
Claude Code: Open in New Tab Opens Claude in a new editor tab
Claude Code: Open Opens last conversation
Claude Code: Open in Side Bar Opens in right sidebar
Claude Code: Open in New Window Opens in separate window
Claude Code: New Conversation Starts a new conversation
Claude Code: Focus input Focuses the input field
Claude Code: Open in Terminal Opens in terminal (if terminal mode enabled)
Claude Code: Show Logs Shows extension logs for debugging

⌨️ Keyboard Shortcuts

Shortcut Action
Cmd+Shift+Escape Open Claude Code in new tab
Cmd+Escape Focus/Blur Claude input
Alt+K Insert @-mention reference
Cmd+N New conversation (when Claude is focused)

🐛 Troubleshooting

Issue: Extension installed but no UI appears

Solution 1: Reload window

Cmd+Shift+P → Developer: Reload Window

Solution 2: Check if extension is enabled

Cmd+Shift+X → Search "Claude Code" → Verify it's Enabled

Solution 3: Check extension logs

Cmd+Shift+P → Claude Code: Show Logs

Issue: "Claude CLI not found" error

The extension includes its own Claude binary. If you see this error:

  1. Check that the binary exists:
    ls -la ~/.cursor/extensions/anthropic.claude-code-2.0.74-darwin-arm64/resources/native-binary/claude
    
  2. If missing, reinstall the extension

Issue: Extension doesn't activate

  1. Check Cursor version: Requires VS Code 1.94.0+ (Cursor should be compatible)
  2. Check workspace trust: Extension doesn't work in untrusted workspaces
  3. Restart Cursor completely: Close all windows and reopen

📚 Additional Resources

✅ Verification Checklist


If you've tried all these steps and still can't see the interface, the extension might need to be reinstalled or there might be a Cursor-specific compatibility issue.