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)
- Press
Cmd+Shift+P(orCtrl+Shift+Pon Windows/Linux) - Type:
Claude Code: Open in New Tab - Press Enter
Or try these commands:
Claude Code: Open- Opens last conversationClaude Code: Open in Side Bar- Opens in sidebarClaude Code: Open in New Window- Opens in separate window
Method 2: Keyboard Shortcut
- Press
Cmd+Shift+Escapeto open Claude Code in a new tab
Method 3: Sidebar Icon
- Look for the Claude Code icon in the Activity Bar (left sidebar)
- Click it to open Claude Code in the sidebar
Method 4: Editor Title Bar
- Open any file in the editor
- Look for the Claude Code icon in the editor title bar
- Click it to open Claude Code
🔧 If You Still Don't See It
Step 1: Reload Cursor Window
- Press
Cmd+Shift+P - Type:
Developer: Reload Window - Press Enter
Step 2: Check Extension Status
- Press
Cmd+Shift+Xto open Extensions view - Search for "Claude Code"
- Make sure it shows as Enabled (not Disabled)
Step 3: Check Extension Settings
- Press
Cmd+,to open Settings - Search for "claude code"
- Verify these settings:
claudeCode.useTerminal: Should befalse(unless you want terminal mode)claudeCode.preferredLocation: Choosesidebarorpanel
Step 4: Verify Extension Activation
The extension activates on:
onStartupFinished- After Cursor finishes loadingonWebviewPanel:claudeVSCodePanel- When opening the panel
If it's not activating, try:
- Close all Cursor windows
- Reopen Cursor
- Wait a few seconds for startup to complete
- 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:
- Check that the binary exists:
ls -la ~/.cursor/extensions/anthropic.claude-code-2.0.74-darwin-arm64/resources/native-binary/claude - If missing, reinstall the extension
Issue: Extension doesn't activate
- Check Cursor version: Requires VS Code 1.94.0+ (Cursor should be compatible)
- Check workspace trust: Extension doesn't work in untrusted workspaces
- Restart Cursor completely: Close all windows and reopen
📚 Additional Resources
- Claude Code Documentation
- Claude Code Website
- Extension README:
~/.cursor/extensions/anthropic.claude-code-2.0.74-darwin-arm64/README.md
✅ Verification Checklist
- Extension shows as "Enabled" in Extensions view
- Command Palette shows Claude Code commands
-
Cmd+Shift+P→ "Claude Code: Open" works - Claude Code icon appears in Activity Bar (optional)
- Can open Claude Code interface successfully
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.