claude-code-guide

<div align="center"> <h2 id="claude-code-community-guide">Claude Code Guide</h2>

For reference and contributions, visit the official Claude Code documentation

</div> <div align="center"> <kbd>

| Section | Status | Other Resources | | ------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------- | | Getting Started | ✅ | Claude-Code Docs | | Configuration & Environment Variables | ✅ | Claude-Code via Discord | | Commands & Usage | ✅ | Security Agents SKILL.md | | Interface & Input | ✅ | Let Agent Create SKILL.md | | Advanced Features | ✅ | 954+ Agent Skills | | Automation & Integration | ✅ | No cost ai resources | | Help & Troubleshooting | ✅ | 250+ Mermaid templates | | Third-Party Integrations | ✅ | Discord Communication MCP |

</kbd> </div>

---

<h3 id="content">Contents</h3>

Fast paths: Install · Commands · Config · MCP · Agents · Troubleshoot

| Area | Start here | Also useful | | --- | --- | --- | | Getting Started | Quick Start | Initial Setup, System Requirements | | Configuration | Environment Variables | Configuration Files | | Commands | Slash Commands | CLI Quick Reference | | Interface | Keyboard Shortcuts | Vim Mode | | Advanced Features | Plan Mode, Auto Mode, MCP | Sub Agents, Skills, Hooks | | Security | Security & Permissions | Dangerous Mode, Best Practices | | Automation | Automation & Scripting | PR Review, Issue Triage | | Help | Troubleshooting | Best Practices, Monitoring | | Third-Party Integrations | DeepSeek Integration | Provider Setup Examples |

<details> <summary>Full content map</summary>

• Getting Started

  • Quick Start
  • System Requirements
  • Initial Setup

• Configuration & Environment

  • Environment Variables
  • Configuration Files

• Commands & Usage

  • Slash Command Reference
  • CLI Quick Reference

• Interface & Input

  • Keyboard Shortcuts
  • Vim Mode

• Advanced Features

  • Thinking Mode
  • Effort Levels
  • Fast Mode
  • Auto Mode
  • Plan Mode
  • Background Tasks
  • Workflows & Scheduling
  • Remote Sessions
  • Claude in Chrome
  • Sandbox Mode
  • LSP Tool
  • Sub Agents
  • Agent Teams
  • Skills
  • Plugin System
  • Worktree Isolation
  • Native Installer
  • Authentication CLI
  • Agent Management CLI
  • Remote Control
  • Managed Settings
  • Model Updates
  • Theming & Customization
  • Code Review
  • Insights
  • MCP Integration
  • Hooks System

• Security & Permissions

  • Dangerous Mode
  • Security Best Practices

• Automation & Integration

  • Automation & Scripting
  • Auto PR Review
  • Issue Triage

• Help & Troubleshooting

  • Installation Issues
  • MCP Issues
  • Best Practices
  • Monitoring & Alerting

• Third-Party Integrations

  • Provider Setup Examples
  • DeepSeek Integration

</details>

---

<h1 id="getting-started">Getting Started</h1>

Enable sound alerts when claude completes the task:

<kbd>claude config set --global preferredNotifChannel terminal_bell</kbd>

<h2 id="quick-start">Quick Start</h2>

[!TIP] Send <mark>claude</mark> or <mark>npx claude</mark> in terminal to start the interface

Go to Help & Troubleshooting to fix issues...

# Native Installer (preferred — no Node.js required) ⭐️
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
# Windows
/* Via CMD (native)      */ curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
/* Via Powershell        */ irm https://claude.ai/install.ps1 | iex
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
# macOS / Linux / WSL
/* Via Terminal          */ curl -fsSL https://claude.ai/install.sh | bash
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
# Arch
/* Via Terminal          */ yay -S claude-code*/
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

# Alternative (npm) — useful when your environment already standardizes on Node.js
# Requires Node.js 18+
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
# Windows
/* Via CMD (npm)         */ npm install -g @anthropic-ai/claude-code
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
# macOS
/* Via Terminal          */ brew install node && npm install -g @anthropic-ai/claude-code
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
# Linux
/* Via Terminal          */ sudo apt update && sudo apt install -y nodejs npm
/* Via Terminal          */ npm install -g @anthropic-ai/claude-code
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
# WSL/GIT
/* Via Terminal          */ npm install -g @anthropic-ai/claude-code
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
# Docker
/* Windows (CMD)         */ docker run -it --rm -v "%cd%:/workspace" -e ANTHROPIC_API_KEY="sk-your-key" node:20-slim bash -lc "npm i -g @anthropic-ai/claude-code && cd /workspace && claude"
/* macOS/Linux (bash/zsh)*/ docker run -it --rm -v "$PWD:/workspace" -e ANTHROPIC_API_KEY="sk-your-key" node:20-slim bash -lc 'npm i -g @anthropic-ai/claude-code && cd /workspace && claude'
/* No bash Fallback      */ docker run -it --rm -v "$PWD:/workspace" -e ANTHROPIC_API_KEY="sk-your-key" node:20-slim sh -lc 'npm i -g @anthropic-ai/claude-code && cd /workspace && claude'
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
# Check if claude is installed correctly
/* Linux                 */ which claude
/* Windows               */ where claude
/* Universal             */ claude --version
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
# Common Management
/*claude config          */ Configure settings
/*claude mcp list        */ Setup MCP servers, you can also replace "list" with add/remove
/*claude agents          */ Open the agent/session dashboard
/*claude update          */ Run a manual update check

---

[!Tip] <ins>Open Project Via Terminal Into VS Code / Cursor</ins>

$ - <kbd>cd /path/to/project</kbd>

$ - <kbd>code .</kbd>

Make sure you have the <mark>(Claude Code extension)</mark> installed in your VS Code / Cursor

---

<h2 id="system-requirements">System Requirements</h2>

• OS: macOS 10.15+, Ubuntu 20.04+/Debian 10+, or Windows 10/11 or WSL

• Hardware: 4GB RAM minimum 8GB+ recommended

• Software: Git 2.23+ is optional for PR/worktree workflows. Node.js 18+ is only required for npm-based installation; the native installer bundles its own runtime.

• Internet: Connection for API calls

---

<h2 id="initial-setup">Initial Setup</h2>

[!Tip] Find API key from Anthropic Console

Do NOT commit real keys use git-ignored files, OS key stores, or secret managers

# Universal
/* Authenticate via Anthropic account     */ claude auth login
/* Authenticate via Console/API billing   */ claude auth login --console
/* Switch accounts inside Claude          */ /login
-------------------------------------------------------------------------------------------------------------------------