10 10
11## Get started11## Get started
12 12
13Claude Code runs on several surfaces: the terminal, IDE extensions, a desktop app, and the web. Choose one from the tabs below to get started. Most surfaces require a [Claude subscription](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing) or [Anthropic Console](https://console.anthropic.com/) account. The Terminal CLI and VS Code also support [third-party providers](/en/third-party-integrations).13Claude Code runs on several surfaces: the terminal, IDE extensions, a desktop app, and the web. Choose one from the tabs below to get started. Most surfaces require a [Claude subscription](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing) or [Anthropic Console](https://console.anthropic.com/) account. The Terminal CLI and VS Code also support [third-party providers](/docs/en/third-party-integrations).
14 14
15<Tabs>15<Tabs>
16 <Tab title="Terminal">16 <Tab title="Terminal">
22 <Tab title="Native Install (Recommended)">22 <Tab title="Native Install (Recommended)">
23 **macOS, Linux, WSL:**23 **macOS, Linux, WSL:**
24 24
25 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}25 ```bash theme={null}
26 curl -fsSL https://claude.ai/install.sh | bash26 curl -fsSL https://claude.ai/install.sh | bash
27 ```27 ```
28 28
29 **Windows PowerShell:**29 **Windows PowerShell:**
30 30
31 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}31 ```powershell theme={null}
32 irm https://claude.ai/install.ps1 | iex32 irm https://claude.ai/install.ps1 | iex
33 ```33 ```
34 34
35 **Windows CMD:**35 **Windows CMD:**
36 36
37 ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}37 ```batch theme={null}
38 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd38 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
39 ```39 ```
40 40
41 If you see `The token '&&' is not a valid statement separator`, you're in PowerShell, not CMD. If you see `'irm' is not recognized as an internal or external command`, you're in CMD, not PowerShell. Your prompt shows `PS C:\` when you're in PowerShell and `C:\` without the `PS` when you're in CMD.41 If you see `The token '&&' is not a valid statement separator`, you're in PowerShell, not CMD. If you see `'irm' is not recognized as an internal or external command`, you're in CMD, not PowerShell. Your prompt shows `PS C:\` when you're in PowerShell and `C:\` without the `PS` when you're in CMD.
42 42
43 If the install command fails with `syntax error near unexpected token '<'`, a `403`, or another curl error, see [Troubleshoot installation](/en/troubleshoot-install#find-your-error) to match the error to a fix and for alternative install methods.43 If the install command fails with `syntax error near unexpected token '<'`, a `403`, or another curl error, see [Troubleshoot installation](/docs/en/troubleshoot-install#find-your-error) to match the error to a fix and for alternative install methods.
44 44
45 [Git for Windows](https://git-scm.com/downloads/win) is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.45 [Git for Windows](https://git-scm.com/downloads/win) is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.
46 46
50 </Tab>50 </Tab>
51 51
52 <Tab title="Homebrew">52 <Tab title="Homebrew">
53 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}53 ```bash theme={null}
54 brew install --cask claude-code54 brew install --cask claude-code
55 ```55 ```
56 56
62 </Tab>62 </Tab>
63 63
64 <Tab title="WinGet">64 <Tab title="WinGet">
65 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}65 ```powershell theme={null}
66 winget install Anthropic.ClaudeCode66 winget install Anthropic.ClaudeCode
67 ```67 ```
68 68
72 </Tab>72 </Tab>
73 </Tabs>73 </Tabs>
74 74
75 You can also install with [apt, dnf, or apk](/en/setup#install-with-linux-package-managers) on Debian, Fedora, RHEL, and Alpine.75 You can also install with [apt, dnf, or apk](/docs/en/setup#install-with-linux-package-managers) on Debian, Fedora, RHEL, and Alpine.
76 76
77 Then start Claude Code in any project. Replace `your-project` with the path to a project directory on your machine:77 Then start Claude Code in any project. Replace `your-project` with the path to a project directory on your machine:
78 78
81 claude81 claude
82 ```82 ```
83 83
84 You'll be prompted to log in on first use. That's it! [Continue with the Quickstart →](/en/quickstart)84 You'll be prompted to log in on first use. That's it! [Continue with the Quickstart →](/docs/en/quickstart)
85 85
86 <Tip>86 <Tip>
87 See [advanced setup](/en/setup) for installation options, manual updates, or uninstallation instructions. Visit [installation troubleshooting](/en/troubleshoot-install) if you hit issues.87 See [advanced setup](/docs/en/setup) for installation options, manual updates, or uninstallation instructions. Visit [installation troubleshooting](/docs/en/troubleshoot-install) if you hit issues.
88 </Tip>88 </Tip>
89 </Tab>89 </Tab>
90 90
96 96
97 Or search for "Claude Code" in the Extensions view (`Cmd+Shift+X` on Mac, `Ctrl+Shift+X` on Windows/Linux). After installing, open the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`), type "Claude Code", and select **Open in New Tab**.97 Or search for "Claude Code" in the Extensions view (`Cmd+Shift+X` on Mac, `Ctrl+Shift+X` on Windows/Linux). After installing, open the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`), type "Claude Code", and select **Open in New Tab**.
98 98
99 [Get started with VS Code →](/en/vs-code#get-started)99 [Get started with VS Code →](/docs/en/vs-code#get-started)
100 </Tab>100 </Tab>
101 101
102 <Tab title="Desktop app">102 <Tab title="Desktop app">
110 110
111 After installing, launch Claude, sign in, and click the **Code** tab to start coding. A [paid subscription](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_desktop_pricing) is required.111 After installing, launch Claude, sign in, and click the **Code** tab to start coding. A [paid subscription](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_desktop_pricing) is required.
112 112
113 [Learn more about the desktop app →](/en/desktop-quickstart)113 [Learn more about the desktop app →](/docs/en/desktop-quickstart)
114 </Tab>114 </Tab>
115 115
116 <Tab title="Web">116 <Tab title="Web">
117 Run Claude Code in your browser with no local setup. Kick off long-running tasks and check back when they're done, work on repos you don't have locally, or run multiple tasks in parallel. Available on desktop browsers and [the Claude app for iOS and Android](/en/mobile).117 Run Claude Code in your browser with no local setup. Kick off long-running tasks and check back when they're done, work on repos you don't have locally, or run multiple tasks in parallel. Available on desktop browsers and [the Claude app for iOS and Android](/docs/en/mobile).
118 118
119 Start coding at [claude.ai/code](https://claude.ai/code).119 Start coding at [claude.ai/code](https://claude.ai/code).
120 120
121 [Get started on the web →](/en/web-quickstart)121 [Get started on the web →](/docs/en/web-quickstart)
122 </Tab>122 </Tab>
123 123
124 <Tab title="JetBrains">124 <Tab title="JetBrains">
125 A plugin for IntelliJ IDEA, PyCharm, WebStorm, and other JetBrains IDEs with interactive diff viewing and selection context sharing.125 A plugin for IntelliJ IDEA, PyCharm, WebStorm, and other JetBrains IDEs with interactive diff viewing and selection context sharing.
126 126
127 Install the [Claude Code plugin](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) from the JetBrains Marketplace and restart your IDE. The plugin requires the Claude Code CLI, installed separately; see the [JetBrains setup steps](/en/jetbrains#installation).127 Install the [Claude Code plugin](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) from the JetBrains Marketplace and restart your IDE. The plugin requires the Claude Code CLI, installed separately; see the [JetBrains setup steps](/docs/en/jetbrains#installation).
128 128
129 [Get started with JetBrains →](/en/jetbrains)129 [Get started with JetBrains →](/docs/en/jetbrains)
130 </Tab>130 </Tab>
131</Tabs>131</Tabs>
132 132
146 <Accordion title="Build features and fix bugs" icon="hammer">146 <Accordion title="Build features and fix bugs" icon="hammer">
147 Describe what you want in plain language. Claude Code plans the approach, writes the code across multiple files, and verifies it works.147 Describe what you want in plain language. Claude Code plans the approach, writes the code across multiple files, and verifies it works.
148 148
149 For bugs, paste an error message or describe the symptom. Claude Code traces the issue through your codebase, identifies the root cause, and implements a fix. See [common workflows](/en/common-workflows) for more examples.149 For bugs, paste an error message or describe the symptom. Claude Code traces the issue through your codebase, identifies the root cause, and implements a fix. See [common workflows](/docs/en/common-workflows) for more examples.
150 </Accordion>150 </Accordion>
151 151
152 <Accordion title="Create commits and pull requests" icon="code-branch">152 <Accordion title="Create commits and pull requests" icon="code-branch">
156 claude "commit my changes with a descriptive message"156 claude "commit my changes with a descriptive message"
157 ```157 ```
158 158
159 In CI, you can automate code review and issue triage with [GitHub Actions](/en/github-actions) or [GitLab CI/CD](/en/gitlab-ci-cd).159 In CI, you can automate code review and issue triage with [GitHub Actions](/docs/en/github-actions) or [GitLab CI/CD](/docs/en/gitlab-ci-cd).
160 </Accordion>160 </Accordion>
161 161
162 <Accordion title="Connect your tools with MCP" icon="plug">162 <Accordion title="Connect your tools with MCP" icon="plug">
163 The [Model Context Protocol (MCP)](/en/mcp) is an open standard for connecting AI tools to external data sources. With MCP, Claude Code can read your design docs in Google Drive, update tickets in Jira, pull data from Slack, or use your own custom tooling. The [MCP quickstart](/en/mcp-quickstart) connects your first server end to end.163 The [Model Context Protocol (MCP)](/docs/en/mcp) is an open standard for connecting AI tools to external data sources. With MCP, Claude Code can read your design docs in Google Drive, update tickets in Jira, pull data from Slack, or use your own custom tooling. The [MCP quickstart](/docs/en/mcp-quickstart) connects your first server end to end.
164 </Accordion>164 </Accordion>
165 165
166 <Accordion title="Customize with instructions, skills, and hooks" icon="sliders">166 <Accordion title="Customize with instructions, skills, and hooks" icon="sliders">
167 [`CLAUDE.md`](/en/memory) is a markdown file you add to your project root that Claude Code reads at the start of every session. Use it to set coding standards, architecture decisions, preferred libraries, and review checklists. Claude also builds [auto memory](/en/memory#auto-memory) as it works, saving learnings like build commands and debugging insights across sessions without you writing anything.167 [`CLAUDE.md`](/docs/en/memory) is a markdown file you add to your project root that Claude Code reads at the start of every session. Use it to set coding standards, architecture decisions, preferred libraries, and review checklists. Claude also builds [auto memory](/docs/en/memory#auto-memory) as it works, saving learnings like build commands and debugging insights across sessions without you writing anything.
168 168
169 Create [skills](/en/skills) to package repeatable workflows your team can share, like `/review-pr` or `/deploy-staging`.169 Create [skills](/docs/en/skills) to package repeatable workflows your team can share, like `/review-pr` or `/deploy-staging`.
170 170
171 [Hooks](/en/hooks) let you run shell commands before or after Claude Code actions, like auto-formatting after every file edit or running lint before a commit.171 [Hooks](/docs/en/hooks) let you run shell commands before or after Claude Code actions, like auto-formatting after every file edit or running lint before a commit.
172 </Accordion>172 </Accordion>
173 173
174 <Accordion title="Run agent teams and build custom agents" icon="users">174 <Accordion title="Run agent teams and build custom agents" icon="users">
175 Spawn [multiple Claude Code agents](/en/sub-agents) that work on different parts of a task simultaneously. A lead agent coordinates the work, assigns subtasks, and merges results.175 Spawn [multiple Claude Code agents](/docs/en/sub-agents) that work on different parts of a task simultaneously. A lead agent coordinates the work, assigns subtasks, and merges results.
176 176
177 To run several full sessions in parallel and watch them from one screen, use [background agents](/en/agent-view). For fully custom workflows, the [Agent SDK](/en/agent-sdk/overview) lets you build your own agents powered by Claude Code's tools and capabilities, with full control over orchestration, tool access, and permissions.177 To run several full sessions in parallel and watch them from one screen, use [background agents](/docs/en/agent-view). For fully custom workflows, the [Agent SDK](/docs/en/agent-sdk/overview) lets you build your own agents powered by Claude Code's tools and capabilities, with full control over orchestration, tool access, and permissions.
178 </Accordion>178 </Accordion>
179 179
180 <Accordion title="Pipe, script, and automate with the CLI" icon="terminal">180 <Accordion title="Pipe, script, and automate with the CLI" icon="terminal">
191 git diff main --name-only | claude -p "review these changed files for security issues"191 git diff main --name-only | claude -p "review these changed files for security issues"
192 ```192 ```
193 193
194 See the [CLI reference](/en/cli-reference) for the full set of commands and flags.194 See the [CLI reference](/docs/en/cli-reference) for the full set of commands and flags.
195 </Accordion>195 </Accordion>
196 196
197 <Accordion title="Schedule recurring tasks" icon="clock">197 <Accordion title="Schedule recurring tasks" icon="clock">
198 Run Claude on a schedule to automate work that repeats: morning PR reviews, overnight CI failure analysis, weekly dependency audits, or syncing docs after PRs merge.198 Run Claude on a schedule to automate work that repeats: morning PR reviews, overnight CI failure analysis, weekly dependency audits, or syncing docs after PRs merge.
199 199
200 * [Routines](/en/routines) run on Anthropic-managed infrastructure, so they keep running even when your computer is off. They can also trigger on API calls or GitHub events. Create them from the web, the Desktop app, or by running `/schedule` in the CLI.200 * [Routines](/docs/en/routines) run on Anthropic-managed infrastructure, so they keep running even when your computer is off. They can also trigger on API calls or GitHub events. Create them from the web, the Desktop app, or by running `/schedule` in the CLI.
201 * [Desktop scheduled tasks](/en/desktop-scheduled-tasks) run on your machine, with direct access to your local files and tools201 * [Desktop scheduled tasks](/docs/en/desktop-scheduled-tasks) run on your machine, with direct access to your local files and tools
202 * [`/loop`](/en/scheduled-tasks) repeats a prompt within a CLI session for quick polling202 * [`/loop`](/docs/en/scheduled-tasks) repeats a prompt within a CLI session for quick polling
203 </Accordion>203 </Accordion>
204 204
205 <Accordion title="Work from anywhere" icon="globe">205 <Accordion title="Work from anywhere" icon="globe">
206 Sessions aren't tied to a single surface. Move work between them as your context changes:206 Sessions aren't tied to a single surface. Move work between them as your context changes:
207 207
208 * Step away from your desk and keep working from your phone or any browser with [Remote Control](/en/remote-control)208 * Step away from your desk and keep working from your phone or any browser with [Remote Control](/docs/en/remote-control)
209 * Message [Dispatch](/en/desktop#sessions-from-dispatch) a task from your phone and open the Desktop session it creates209 * Message [Dispatch](/docs/en/desktop#sessions-from-dispatch) a task from your phone and open the Desktop session it creates
210 * Kick off a long-running task on the [web](/en/claude-code-on-the-web) or the [Claude mobile app](/en/mobile), then pull it into your terminal with `claude --teleport`. Teleport requires a claude.ai subscription.210 * Kick off a long-running task on the [web](/docs/en/claude-code-on-the-web) or the [Claude mobile app](/docs/en/mobile), then pull it into your terminal with `claude --teleport`. Teleport requires a claude.ai subscription.
211 * Run `/desktop` to continue your current terminal session in the [Desktop app](/en/desktop), where you can review diffs visually. Available on macOS and x64 Windows.211 * Run `/desktop` to continue your current terminal session in the [Desktop app](/docs/en/desktop), where you can review diffs visually. Available on macOS and x64 Windows.
212 * Route tasks from team chat: mention `@Claude` in [Slack](/en/slack) with a bug report and get a pull request back212 * Route tasks from team chat: mention `@Claude` in [Slack](/docs/en/slack) with a bug report and get a pull request back
213 </Accordion>213 </Accordion>
214</AccordionGroup>214</AccordionGroup>
215 215
216## Use Claude Code everywhere216## Use Claude Code everywhere
217 217
218Each [surface](/en/glossary#surface) connects to the same underlying Claude Code engine, so your CLAUDE.md files, settings, and MCP servers work across all of them.218Each [surface](/docs/en/glossary#surface) connects to the same underlying Claude Code engine, so your CLAUDE.md files, settings, and MCP servers work across all of them.
219 219
220Beyond the [Terminal](/en/quickstart), [VS Code](/en/vs-code), [JetBrains](/en/jetbrains), [Desktop](/en/desktop), and [Web](/en/claude-code-on-the-web) surfaces above, Claude Code integrates with CI/CD, chat, and browser workflows:220Beyond the [Terminal](/docs/en/quickstart), [VS Code](/docs/en/vs-code), [JetBrains](/docs/en/jetbrains), [Desktop](/docs/en/desktop), and [Web](/docs/en/claude-code-on-the-web) surfaces above, Claude Code integrates with CI/CD, chat, and browser workflows:
221 221
222| I want to... | Best option |222| I want to... | Best option |
223| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |223| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
224| Continue a local session from my phone or another device | [Remote Control](/en/remote-control) |224| Continue a local session from my phone or another device | [Remote Control](/docs/en/remote-control) |
225| Push events from Telegram, Discord, iMessage, or my own webhooks into a session | [Channels](/en/channels) |225| Push events from Telegram, Discord, iMessage, or my own webhooks into a session | [Channels](/docs/en/channels) |
226| Start a task locally, continue on mobile | [`claude --cloud`](/en/claude-code-on-the-web#from-terminal-to-web), then the [Claude mobile app](/en/mobile) |226| Start a task locally, continue on mobile | [`claude --cloud`](/docs/en/claude-code-on-the-web#from-terminal-to-web), then the [Claude mobile app](/docs/en/mobile) |
227| Run Claude on a recurring schedule | [Routines](/en/routines) or [Desktop scheduled tasks](/en/desktop-scheduled-tasks) |227| Run Claude on a recurring schedule | [Routines](/docs/en/routines) or [Desktop scheduled tasks](/docs/en/desktop-scheduled-tasks) |
228| Automate PR reviews and issue triage | [GitHub Actions](/en/github-actions) or [GitLab CI/CD](/en/gitlab-ci-cd) |228| Automate PR reviews and issue triage | [GitHub Actions](/docs/en/github-actions) or [GitLab CI/CD](/docs/en/gitlab-ci-cd) |
229| Get automatic code review on every PR | [GitHub Code Review](/en/code-review) |229| Get automatic code review on every PR | [GitHub Code Review](/docs/en/code-review) |
230| Route bug reports from Slack to pull requests | [Slack](/en/slack) |230| Route bug reports from Slack to pull requests | [Slack](/docs/en/slack) |
231| Debug live web applications | [Chrome](/en/chrome) |231| Debug live web applications | [Chrome](/docs/en/chrome) |
232| Build custom agents for your own workflows | [Agent SDK](/en/agent-sdk/overview) |232| Build custom agents for your own workflows | [Agent SDK](/docs/en/agent-sdk/overview) |
233 233
234## Next steps234## Next steps
235 235
236Once you've installed Claude Code, these guides help you go deeper.236Once you've installed Claude Code, these guides help you go deeper.
237 237
238* [Quickstart](/en/quickstart): walk through your first real task, from exploring a codebase to committing a fix238* [Quickstart](/docs/en/quickstart): walk through your first real task, from exploring a codebase to committing a fix
239* [Store instructions and memories](/en/memory): give Claude persistent instructions with CLAUDE.md files and auto memory239* [Store instructions and memories](/docs/en/memory): give Claude persistent instructions with CLAUDE.md files and auto memory
240* [Common workflows](/en/common-workflows) and [best practices](/en/best-practices): patterns for getting the most out of Claude Code240* [Common workflows](/docs/en/common-workflows) and [best practices](/docs/en/best-practices): patterns for getting the most out of Claude Code
241* [A harness for every task](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code): how the Claude Code team uses [dynamic workflows](/en/workflows) to orchestrate subagents at scale241* [A harness for every task](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code): how the Claude Code team uses [dynamic workflows](/docs/en/workflows) to orchestrate subagents at scale
242* [Settings](/en/settings): customize Claude Code for your workflow242* [Settings](/docs/en/settings): customize Claude Code for your workflow
243* [Troubleshooting](/en/troubleshooting): solutions for common issues243* [Troubleshooting](/docs/en/troubleshooting): solutions for common issues
244* [code.claude.com](https://code.claude.com/): demos, pricing, and product details244* [code.claude.com](https://code.claude.com/): demos, pricing, and product details