15Certifique-se de que você tem:15Certifique-se de que você tem:

16 16 

17* Um terminal ou prompt de comando aberto17* Um terminal ou prompt de comando aberto

18 * Se você nunca usou o terminal antes, confira o [guia de terminal](/pt/terminal-guide)18 * Se você nunca usou o terminal antes, confira o [guia de terminal](/docs/pt/terminal-guide)

19* Um projeto de código para trabalhar19* Um projeto de código para trabalhar

20* Uma [assinatura Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_prereq) (Pro, Max, Team ou Enterprise), conta do [Claude Console](https://console.anthropic.com/), ou acesso através de um [provedor de nuvem suportado](/pt/third-party-integrations)20* Uma [assinatura Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_prereq) (Pro, Max, Team ou Enterprise), conta do [Claude Console](https://platform.claude.com/), ou acesso através de um [provedor de nuvem suportado](/docs/pt/third-party-integrations)

21 21 

22<Note>22<Note>

23 Este guia cobre o CLI do terminal. Claude Code também está disponível na [web](https://claude.ai/code), como um [aplicativo de desktop](/pt/desktop), em [VS Code](/pt/vs-code) e [IDEs JetBrains](/pt/jetbrains), no [Slack](/pt/slack), e em CI/CD com [GitHub Actions](/pt/github-actions) e [GitLab](/pt/gitlab-ci-cd). Veja [todas as interfaces](/pt/overview#use-claude-code-everywhere).23 Este guia cobre o CLI do terminal. Claude Code também está disponível na [web](https://claude.ai/code), como um [aplicativo de desktop](/docs/pt/desktop), em [VS Code](/docs/pt/vs-code) e [IDEs JetBrains](/docs/pt/jetbrains), no [Slack](/docs/pt/slack), e em CI/CD com [GitHub Actions](/docs/pt/github-actions) e [GitLab](/docs/pt/gitlab-ci-cd). Veja [todas as interfaces](/docs/pt/overview#use-claude-code-everywhere).

24</Note>24</Note>

25 25 

26<h2 id="step-1-install-claude-code">26<h2 id="step-1-install-claude-code">

33 <Tab title="Native Install (Recommended)">33 <Tab title="Native Install (Recommended)">

34 **macOS, Linux, WSL:**34 **macOS, Linux, WSL:**

35 35 

36 ```bash theme={null}36 ```bash theme={null} theme={null} theme={null} theme={null}

37 curl -fsSL https://claude.ai/install.sh | bash37 curl -fsSL https://claude.ai/install.sh | bash

38 ```38 ```

39 39 

40 **Windows PowerShell:**40 **Windows PowerShell:**

41 41 

42 ```powershell theme={null}42 ```powershell theme={null} theme={null} theme={null} theme={null}

43 irm https://claude.ai/install.ps1 | iex43 irm https://claude.ai/install.ps1 | iex

44 ```44 ```

45 45 

46 **Windows CMD:**46 **Windows CMD:**

47 47 

48 ```batch theme={null}48 ```batch theme={null} theme={null} theme={null} theme={null}

49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50 ```50 ```

51 51 

52 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.52 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.

53 53 

54 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.54 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.

55 55 

56 [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.56 [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.

57 57 

61 </Tab>61 </Tab>

62 62 

63 <Tab title="Homebrew">63 <Tab title="Homebrew">

64 ```bash theme={null}64 ```bash theme={null} theme={null} theme={null} theme={null}

65 brew install --cask claude-code65 brew install --cask claude-code

66 ```66 ```

67 67 

73 </Tab>73 </Tab>

74 74 

75 <Tab title="WinGet">75 <Tab title="WinGet">

76 ```powershell theme={null}76 ```powershell theme={null} theme={null} theme={null} theme={null}

77 winget install Anthropic.ClaudeCode77 winget install Anthropic.ClaudeCode

78 ```78 ```

79 79 

83 </Tab>83 </Tab>

84</Tabs>84</Tabs>

85 85 

86You can also install with [apt, dnf, or apk](/en/setup#install-with-linux-package-managers) on Debian, Fedora, RHEL, and Alpine.86You can also install with [apt, dnf, or apk](/docs/en/setup#install-with-linux-package-managers) on Debian, Fedora, RHEL, and Alpine.

87 

88Para confirmar que a instalação funcionou, execute:

89 

90```bash theme={null}

91claude --version

92```

93 

94O comando imprime um número de versão seguido por `(Claude Code)`.

87 95 

88<h2 id="step-2-log-in-to-your-account">96<h2 id="step-2-log-in-to-your-account">

89 Passo 2: Faça login em sua conta97 Passo 2: Faça login em sua conta

95claude103claude

96```104```

97 105 

98Para contas de assinatura Claude ou Console, siga os prompts para concluir a autenticação no seu navegador. Para trocar de contas mais tarde ou fazer nova autenticação, digite `/login` dentro da sessão em execução:106Para contas de assinatura Claude ou Console, siga os prompts para concluir a autenticação no seu navegador. Se você tiver definido a variável de ambiente `ANTHROPIC_API_KEY`, Claude Code ignora o prompt de login e pede que você aprove a chave. Para trocar de contas mais tarde ou fazer nova autenticação, digite `/login` dentro da sessão em execução:

99 107 

100```text theme={null}108```text wrap theme={null}

101/login109/login

102```110```

103 111 

104Você pode fazer login usando qualquer um destes tipos de conta:112Você pode fazer login usando qualquer um destes tipos de conta:

105 113 

106* [Claude Pro, Max, Team ou Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (recomendado)114* [Claude Pro, Max, Team ou Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (recomendado)

107* [Claude Console](https://console.anthropic.com/) (acesso à API com créditos pré-pagos). No primeiro login, um workspace "Claude Code" é criado automaticamente no Console para rastreamento centralizado de custos.115* [Claude Console](https://platform.claude.com/) (acesso à API com créditos pré-pagos). No primeiro login, um workspace "Claude Code" é criado automaticamente no Console para rastreamento centralizado de custos.

108* [Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](/pt/third-party-integrations) (provedores de nuvem empresariais)116* [Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](/docs/pt/third-party-integrations) (provedores de nuvem empresariais)

109* Um [gateway de aplicativos Claude](/pt/claude-apps-gateway) auto-hospedado, se sua organização executar um: seu administrador pré-configura a URL do gateway, e `/login` abre diretamente na tela **Cloud gateway** para você fazer login com SSO corporativo117* Um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) auto-hospedado, se sua organização executar um: seu administrador pré-configura a URL do gateway, e `/login` abre diretamente na tela **Cloud gateway** para você fazer login com SSO corporativo

110 118 

111Depois de fazer login, suas credenciais são armazenadas e você não precisará fazer login novamente.119Depois de fazer login, suas credenciais são armazenadas e você não precisará fazer login novamente. Saiba mais em [Gerenciamento de Credenciais](/docs/pt/authentication#credential-management).

112 120 

113<h2 id="step-3-start-your-first-session">121<h2 id="step-3-start-your-first-session">

114 Passo 3: Inicie sua primeira sessão122 Passo 3: Inicie sua primeira sessão

121claude129claude

122```130```

123 131 

124Você verá o prompt do Claude Code com a versão, modelo atual e diretório de trabalho mostrados acima. Digite `/help` para comandos disponíveis ou `/resume` para continuar uma conversa anterior.132Substitua `/path/to/your/project` pelo caminho do projeto em que você deseja trabalhar.

125 133 

126<Tip>134Você verá o prompt do Claude Code com a versão, modelo atual e diretório de trabalho mostrados acima. Digite `/help` para comandos disponíveis ou `/resume` para continuar uma conversa anterior.

127 Depois de fazer login (Passo 2), suas credenciais são armazenadas em seu sistema. Saiba mais em [Gerenciamento de Credenciais](/pt/authentication#credential-management).

128</Tip>

129 135 

130<h2 id="step-4-ask-your-first-question">136<h2 id="step-4-ask-your-first-question">

131 Passo 4: Faça sua primeira pergunta137 Passo 4: Faça sua primeira pergunta

133 139 

134Vamos começar entendendo sua base de código. Tente um destes comandos:140Vamos começar entendendo sua base de código. Tente um destes comandos:

135 141 

136```text theme={null}142```text wrap theme={null}

137what does this project do?143what does this project do?

138```144```

139 145 

140Claude analisará seus arquivos e fornecerá um resumo. Você também pode fazer perguntas mais específicas:146Claude analisará seus arquivos e fornecerá um resumo. Você também pode fazer perguntas mais específicas:

141 147 

142```text theme={null}148```text wrap theme={null}

143what technologies does this project use?149what technologies does this project use?

144```150```

145 151 

146```text theme={null}152```text wrap theme={null}

147where is the main entry point?153where is the main entry point?

148```154```

149 155 

150```text theme={null}156```text wrap theme={null}

151explain the folder structure157explain the folder structure

152```158```

153 159 

154Você também pode perguntar ao Claude sobre suas próprias capacidades:160Você também pode perguntar ao Claude sobre suas próprias capacidades:

155 161 

156```text theme={null}162```text wrap theme={null}

157what can Claude Code do?163what can Claude Code do?

158```164```

159 165 

160```text theme={null}166```text wrap theme={null}

161how do I create custom skills in Claude Code?167how do I create custom skills in Claude Code?

162```168```

163 169 

164```text theme={null}170```text wrap theme={null}

165can Claude Code work with Docker?171can Claude Code work with Docker?

166```172```

167 173 

175 181 

176Agora vamos fazer Claude Code fazer alguma codificação real. Tente uma tarefa simples:182Agora vamos fazer Claude Code fazer alguma codificação real. Tente uma tarefa simples:

177 183 

178```text theme={null}184```text wrap theme={null}

179add a hello world function to the main file185add a hello world function to the main file

180```186```

181 187 

182Claude Code irá:188Claude Code encontra o arquivo apropriado e mostra a alteração. Se ele pedir antes de fazer a alteração, selecione **Sim** para aprovar.

183 189 

1841. Encontrar o arquivo apropriado190O modo Auto é o [modo de permissão inicial integrado](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) para sessões de terminal interativas nos planos Pro, Max e Team: um classificador revisa as ações em vez de você, e Claude edita a maioria dos arquivos e executa a maioria dos comandos sem pedir. Em outros planos, o modo Manual é o modo de permissão inicial integrado. Para a sessão que você inicia logo após a instalação, consulte [Primeira sessão após uma instalação ou atualização](/docs/pt/env-vars#first-session-after-an-install-or-upgrade).

1852. Mostrar as alterações propostas

1863. Pedir sua aprovação

1874. Fazer a edição

188 191 

189<Note>192<Note>

190 Claude Code sempre pede permissão antes de modificar arquivos. Você pode aprovar alterações individuais ou ativar o modo "Aceitar tudo" para uma sessão.193 Suas configurações ou sua organização podem definir um modo de permissão inicial diferente. [Qual modo de permissão uma sessão inicia](/docs/pt/permission-modes#which-mode-a-session-starts-in) lista o que faz. Pressione `Shift+Tab` a qualquer momento para alternar o modo de permissão da sessão em que você está.

191</Note>194</Note>

192 195 

193<h2 id="step-6-use-git-with-claude-code">196<h2 id="step-6-use-git-with-claude-code">

196 199 

197Claude Code torna as operações Git conversacionais:200Claude Code torna as operações Git conversacionais:

198 201 

199```text theme={null}202```text wrap theme={null}

200what files have I changed?203what files have I changed?

201```204```

202 205 

203```text theme={null}206```text wrap theme={null}

204commit my changes with a descriptive message207commit my changes with a descriptive message

205```208```

206 209 

207Você também pode solicitar operações Git mais complexas:210Você também pode solicitar operações Git mais complexas:

208 211 

209```text theme={null}212```text wrap theme={null}

210create a new branch called feature/quickstart213create a new branch called feature/quickstart

211```214```

212 215 

213```text theme={null}216```text wrap theme={null}

214show me the last 5 commits217show me the last 5 commits

215```218```

216 219 

217```text theme={null}220```text wrap theme={null}

218help me resolve merge conflicts221help me resolve merge conflicts

219```222```

220 223 

226 229 

227Descreva o que você quer em linguagem natural:230Descreva o que você quer em linguagem natural:

228 231 

229```text theme={null}232```text wrap theme={null}

230add input validation to the user registration form233add input validation to the user registration form

231```234```

232 235 

233Ou corrija problemas existentes:236Ou corrija problemas existentes:

234 237 

235```text theme={null}238```text wrap theme={null}

236there's a bug where users can submit empty forms - fix it239there's a bug where users can submit empty forms - fix it

237```240```

238 241 

251 254 

252**Refatore código**255**Refatore código**

253 256 

254```text theme={null}257```text wrap theme={null}

255refactor the authentication module to use async/await instead of callbacks258refactor the authentication module to use async/await instead of callbacks

256```259```

257 260 

258**Escreva testes**261**Escreva testes**

259 262 

260```text theme={null}263```text wrap theme={null}

261write unit tests for the calculator functions264write unit tests for the calculator functions

262```265```

263 266 

264**Atualize documentação**267**Atualize documentação**

265 268 

266```text theme={null}269```text wrap theme={null}

267update the README with installation instructions270update the README with installation instructions

268```271```

269 272 

270**Revisão de código**273**Revisão de código**

271 274 

272```text theme={null}275```text wrap theme={null}

273review my changes and suggest improvements276review my changes and suggest improvements

274```277```

275 278 

288| Comando | O que faz | Exemplo |291| Comando | O que faz | Exemplo |

289| ------------------- | -------------------------------------------------- | ----------------------------------- |292| ------------------- | -------------------------------------------------- | ----------------------------------- |

290| `claude` | Iniciar modo interativo | `claude` |293| `claude` | Iniciar modo interativo | `claude` |

291| `claude "task"` | Executar uma tarefa única | `claude "fix the build error"` |294| `claude "task"` | Iniciar modo interativo com um prompt inicial | `claude "fix the build error"` |

292| `claude -p "query"` | Executar consulta única, depois sair | `claude -p "explain this function"` |295| `claude -p "query"` | Executar consulta única, depois sair | `claude -p "explain this function"` |

293| `claude -c` | Continuar conversa mais recente no diretório atual | `claude -c` |296| `claude -c` | Continuar conversa mais recente no diretório atual | `claude -c` |

294| `claude -r` | Retomar uma conversa anterior | `claude -r` |297| `claude -r` | Retomar uma conversa anterior | `claude -r` |

296**Comandos de sessão**299**Comandos de sessão**

297 300 

298| Comando | O que faz | Exemplo |301| Comando | O que faz | Exemplo |

299| ----------------- | ---------------------------- | -------- |302| ---------------------------- | ---------------------------- | -------- |

300| `/clear` | Limpar histórico de conversa | `/clear` |303| `/clear` | Limpar histórico de conversa | `/clear` |

301| `/help` | Mostrar comandos disponíveis | `/help` |304| `/help` | Mostrar comandos disponíveis | `/help` |

302| `/exit` ou Ctrl+D | Sair do Claude Code | `/exit` |305| `/exit` ou Ctrl+D duas vezes | Sair do Claude Code | `/exit` |

303 306 

304Veja a [referência CLI](/pt/cli-reference) para a lista completa de comandos shell e a [referência de comandos](/pt/commands) para a lista completa de comandos de sessão.307Veja a [referência CLI](/docs/pt/cli-reference) para a lista completa de comandos shell e a [referência de comandos](/docs/pt/commands) para a lista completa de comandos de sessão.

305 308 

306<h2 id="pro-tips-for-beginners">309<h2 id="pro-tips-for-beginners">

307 Dicas profissionais para iniciantes310 Dicas profissionais para iniciantes

308</h2>311</h2>

309 312 

310Para mais, veja [melhores práticas](/pt/best-practices) e [fluxos de trabalho comuns](/pt/common-workflows).313Para mais, veja [melhores práticas](/docs/pt/best-practices) e [fluxos de trabalho comuns](/docs/pt/common-workflows).

311 314 

312<AccordionGroup>315<AccordionGroup>

313 <Accordion title="Seja específico com seus pedidos">316 <Accordion title="Seja específico com seus pedidos">

319 <Accordion title="Use instruções passo a passo">322 <Accordion title="Use instruções passo a passo">

320 Divida tarefas complexas em etapas:323 Divida tarefas complexas em etapas:

321 324 

322 ```text theme={null}325 ```text wrap theme={null}

323 1. criar uma nova tabela de banco de dados para perfis de usuário326 1. criar uma nova tabela de banco de dados para perfis de usuário

324 2. criar um endpoint de API para obter e atualizar perfis de usuário327 2. criar um endpoint de API para obter e atualizar perfis de usuário

325 3. construir uma página da web que permite aos usuários ver e editar suas informações328 3. construir uma página da web que permite aos usuários ver e editar suas informações

329 <Accordion title="Deixe Claude explorar primeiro">332 <Accordion title="Deixe Claude explorar primeiro">

330 Antes de fazer alterações, deixe Claude entender seu código:333 Antes de fazer alterações, deixe Claude entender seu código:

331 334 

332 ```text theme={null}335 ```text wrap theme={null}

333 analisar o esquema do banco de dados336 analisar o esquema do banco de dados

334 ```337 ```

335 338 

336 ```text theme={null}339 ```text wrap theme={null}

337 construir um painel mostrando produtos que são devolvidos com mais frequência por nossos clientes do Reino Unido340 construir um painel mostrando produtos que são devolvidos com mais frequência por nossos clientes do Reino Unido

338 ```341 ```

339 </Accordion>342 </Accordion>

340 343 

341 <Accordion title="Economize tempo com atalhos">344 <Accordion title="Economize tempo com atalhos">

342 * Digite `/` para ver todos os comandos e skills345 * Digite `/` para ver todos os comandos e skills disponíveis para você

343 * Use Tab para conclusão de comando346 * Use Tab para conclusão de comando

344 * Pressione ↑ para histórico de comando347 * Pressione ↑ para histórico de comando

345 * Pressione `Shift+Tab` para alternar modos de permissão348 * Pressione `Shift+Tab` para alternar modos de permissão

353Agora que você aprendeu o básico, explore recursos mais avançados:356Agora que você aprendeu o básico, explore recursos mais avançados:

354 357 

355<CardGroup cols={2}>358<CardGroup cols={2}>

356 <Card title="Como Claude Code funciona" icon="microchip" href="/pt/how-claude-code-works">359 <Card title="Como Claude Code funciona" icon="microchip" href="/docs/pt/how-claude-code-works">

357 Entenda o loop agêntico, ferramentas integradas e como Claude Code interage com seu projeto360 Entenda o loop agêntico, ferramentas integradas e como Claude Code interage com seu projeto

358 </Card>361 </Card>

359 362 

360 <Card title="Melhores práticas" icon="star" href="/pt/best-practices">363 <Card title="Melhores práticas" icon="star" href="/docs/pt/best-practices">

361 Obtenha melhores resultados com prompting eficaz e configuração de projeto364 Obtenha melhores resultados com prompting eficaz e configuração de projeto

362 </Card>365 </Card>

363 366 

364 <Card title="Fluxos de trabalho comuns" icon="graduation-cap" href="/pt/common-workflows">367 <Card title="Fluxos de trabalho comuns" icon="graduation-cap" href="/docs/pt/common-workflows">

365 Guias passo a passo para tarefas comuns368 Guias passo a passo para tarefas comuns

366 </Card>369 </Card>

367 370 

368 <Card title="Estenda Claude Code" icon="puzzle-piece" href="/pt/features-overview">371 <Card title="Estenda Claude Code" icon="puzzle-piece" href="/docs/pt/features-overview">

369 Personalize com CLAUDE.md, skills, hooks, MCP e muito mais372 Personalize com CLAUDE.md, skills, hooks, MCP e muito mais

370 </Card>373 </Card>

371</CardGroup>374</CardGroup>