17* [Delegar pesquisa para subagents](#delegate-research-to-subagents) para manter seu contexto principal limpo17* [Delegar pesquisa para subagents](#delegate-research-to-subagents) para manter seu contexto principal limpo

18* [Canalizar Claude em scripts](#pipe-claude-into-scripts) para CI e processamento em lote18* [Canalizar Claude em scripts](#pipe-claude-into-scripts) para CI e processamento em lote

19 19 

20<h2 id="prompt-recipes">20## Receitas de prompt

21 Receitas de prompt

22</h2>

23 21 

24Estes são padrões de prompt para tarefas cotidianas como explorar código desconhecido, depuração, refatoração, escrita de testes e criação de PRs. Cada um funciona em qualquer superfície do Claude Code; adapte a redação ao seu projeto.22Estes são padrões de prompt para tarefas cotidianas como explorar código desconhecido, depuração, refatoração, escrita de testes e criação de PRs. Cada um funciona em qualquer superfície do Claude Code; adapte a redação ao seu projeto.

25 23 

26<h3 id="understand-new-codebases">24### Entender novas bases de código

27 Entender novas bases de código

28</h3>

29 25 

30Para configurar Claude Code em um monorepo ou base de código grande, consulte [Monorepos e repositórios grandes](/docs/pt/large-codebases).26Para configurar Claude Code em um monorepo ou base de código grande, consulte [Monorepos e repositórios grandes](/docs/pt/large-codebases).

31 27 

32<h4 id="get-a-quick-codebase-overview">28#### Obter uma visão geral rápida da base de código

33 Obter uma visão geral rápida da base de código

34</h4>

35 29 

36Suponha que você acabou de ingressar em um novo projeto e precisa entender sua estrutura rapidamente.30Suponha que você acabou de ingressar em um novo projeto e precisa entender sua estrutura rapidamente.

37 31 

38<Steps>32**1. Navegue até o diretório raiz do projeto**

39 <Step title="Navegue até o diretório raiz do projeto">33 

40 ```bash theme={null}34```bash theme={null}

41 cd /path/to/project 35cd /path/to/project

42 ```36```

43 37 

44 Substitua `/path/to/project` pelo caminho para seu projeto.38Substitua `/path/to/project` pelo caminho para seu projeto.

45 </Step>39 

46 40**2. Inicie Claude Code**

47 <Step title="Inicie Claude Code">41 

48 ```bash theme={null}42```bash theme={null}

49 claude 43claude

50 ```44```

51 </Step>45 

52 46**3. Peça uma visão geral de alto nível**

53 <Step title="Peça uma visão geral de alto nível">47 

54 ```text wrap theme={null}48```text wrap theme={null}

55 give me an overview of this codebase49give me an overview of this codebase

56 ```50```

57 </Step>51 

58 52**4. Aprofunde-se em componentes específicos**

59 <Step title="Aprofunde-se em componentes específicos">53 

60 ```text wrap theme={null}54```text wrap theme={null}

61 explain the main architecture patterns used here55explain the main architecture patterns used here

62 ```56```

63 57 

64 ```text wrap theme={null}58```text wrap theme={null}

65 what are the key data models?59what are the key data models?

66 ```60```

67 61 

68 ```text wrap theme={null}62```text wrap theme={null}

69 how is authentication handled?63how is authentication handled?

70 ```64```

71 </Step>65 

72</Steps>66> [!TIP]

73 67>

74<Tip>68> Dicas:

75 Dicas:69>

76 70> * Comece com perguntas amplas e depois estreite para áreas específicas

77 * Comece com perguntas amplas e depois estreite para áreas específicas71> * Pergunte sobre convenções de codificação e padrões usados no projeto

78 * Pergunte sobre convenções de codificação e padrões usados no projeto72> * Solicite um glossário de termos específicos do projeto

79 * Solicite um glossário de termos específicos do projeto73 

80</Tip>74#### Encontrar código relevante

81 

82<h4 id="find-relevant-code">

83 Encontrar código relevante

84</h4>

85 75 

86Suponha que você precise localizar código relacionado a um recurso ou funcionalidade específica.76Suponha que você precise localizar código relacionado a um recurso ou funcionalidade específica.

87 77 

88<Steps>78**1. Peça ao Claude para encontrar arquivos relevantes**

89 <Step title="Peça ao Claude para encontrar arquivos relevantes">79 

90 ```text wrap theme={null}80```text wrap theme={null}

91 find the files that handle user authentication81find the files that handle user authentication

92 ```82```

93 </Step>83 

94 84**2. Obtenha contexto sobre como os componentes interagem**

95 <Step title="Obtenha contexto sobre como os componentes interagem">85 

96 ```text wrap theme={null}86```text wrap theme={null}

97 how do these authentication files work together?87how do these authentication files work together?

98 ```88```

99 </Step>89 

100 90**3. Entenda o fluxo de execução**

101 <Step title="Entenda o fluxo de execução">91 

102 ```text wrap theme={null}92```text wrap theme={null}

103 trace the login process from front-end to database93trace the login process from front-end to database

104 ```94```

105 </Step>95 

106</Steps>96> [!TIP]

107 97>

108<Tip>98> Dicas:

109 Dicas:99>

110 100> * Seja específico sobre o que você está procurando

111 * Seja específico sobre o que você está procurando101> * Use linguagem de domínio do projeto

112 * Use linguagem de domínio do projeto102> * Instale um [plugin de inteligência de código](/docs/pt/plugins/code-intelligence) para sua linguagem para dar ao Claude navegação precisa de "ir para definição" e "encontrar referências"

113 * Instale um [plugin de inteligência de código](/docs/pt/plugins/code-intelligence) para sua linguagem para dar ao Claude navegação precisa de "ir para definição" e "encontrar referências"

114</Tip>

115 103 

116***104***

117 105 

118<h3 id="fix-bugs-efficiently">106### Corrigir bugs com eficiência

119 Corrigir bugs com eficiência

120</h3>

121 107 

122Suponha que você tenha encontrado uma mensagem de erro e precise encontrar e corrigir sua origem.108Suponha que você tenha encontrado uma mensagem de erro e precise encontrar e corrigir sua origem.

123 109 

124<Steps>110**1. Compartilhe o erro com Claude**

125 <Step title="Compartilhe o erro com Claude">111 

126 ```text wrap theme={null}112```text wrap theme={null}

127 I'm seeing an error when I run npm test113I'm seeing an error when I run npm test

128 ```114```

129 </Step>115 

130 116**2. Peça recomendações de correção**

131 <Step title="Peça recomendações de correção">117 

132 ```text wrap theme={null}118```text wrap theme={null}

133 suggest a few ways to fix the @ts-ignore in user.ts119suggest a few ways to fix the @ts-ignore in user.ts

134 ```120```

135 </Step>121 

136 122**3. Aplique a correção**

137 <Step title="Aplique a correção">123 

138 ```text wrap theme={null}124```text wrap theme={null}

139 update user.ts to add the null check you suggested125update user.ts to add the null check you suggested

140 ```126```

141 </Step>127 

142</Steps>128> [!TIP]

143 129>

144<Tip>130> Dicas:

145 Dicas:131>

146 132> * Diga ao Claude o comando para reproduzir o problema e obtenha um rastreamento de pilha

147 * Diga ao Claude o comando para reproduzir o problema e obtenha um rastreamento de pilha133> * Mencione quaisquer etapas para reproduzir o erro

148 * Mencione quaisquer etapas para reproduzir o erro134> * Deixe Claude saber se o erro é intermitente ou consistente

149 * Deixe Claude saber se o erro é intermitente ou consistente

150</Tip>

151 135 

152***136***

153 137 

154<h3 id="refactor-code">138### Refatorar código

155 Refatorar código

156</h3>

157 139 

158Suponha que você precise atualizar código antigo para usar padrões e práticas modernas.140Suponha que você precise atualizar código antigo para usar padrões e práticas modernas.

159 141 

160Para portar uma base de código inteira para uma nova linguagem, consulte [como a Anthropic executa migrações de código em larga escala com Claude Code](https://claude.com/blog/ai-code-migration) no blog.142Para portar uma base de código inteira para uma nova linguagem, consulte [como a Anthropic executa migrações de código em larga escala com Claude Code](https://claude.com/blog/ai-code-migration) no blog.

161 143 

162<Steps>144**1. Identifique código legado para refatoração**

163 <Step title="Identifique código legado para refatoração">145 

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

165 find deprecated API usage in our codebase147find deprecated API usage in our codebase

166 ```148```

167 </Step>149 

168 150**2. Obtenha recomendações de refatoração**

169 <Step title="Obtenha recomendações de refatoração">151 

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

171 suggest how to refactor utils.js to use modern JavaScript features153suggest how to refactor utils.js to use modern JavaScript features

172 ```154```

173 </Step>155 

174 156**3. Aplique as alterações com segurança**

175 <Step title="Aplique as alterações com segurança">157 

176 ```text wrap theme={null}158```text wrap theme={null}

177 refactor utils.js to use ES2024 features while maintaining the same behavior159refactor utils.js to use ES2024 features while maintaining the same behavior

178 ```160```

179 </Step>161 

180 162**4. Verifique a refatoração**

181 <Step title="Verifique a refatoração">163 

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

183 run tests for the refactored code165run tests for the refactored code

184 ```166```

185 </Step>167 

186</Steps>168> [!TIP]

187 169>

188<Tip>170> Dicas:

189 Dicas:171>

190 172> * Peça ao Claude para explicar os benefícios da abordagem moderna

191 * Peça ao Claude para explicar os benefícios da abordagem moderna173> * Solicite que as alterações mantenham compatibilidade com versões anteriores quando necessário

192 * Solicite que as alterações mantenham compatibilidade com versões anteriores quando necessário174> * Faça refatoração em pequenos incrementos testáveis

193 * Faça refatoração em pequenos incrementos testáveis

194</Tip>

195 175 

196***176***

197 177 

198<h3 id="work-with-tests">178### Trabalhar com testes

199 Trabalhar com testes

200</h3>

201 179 

202Suponha que você precise adicionar testes para código não coberto.180Suponha que você precise adicionar testes para código não coberto.

203 181 

204<Steps>182**1. Identifique código não testado**

205 <Step title="Identifique código não testado">183 

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

207 find functions in NotificationsService.swift that are not covered by tests185find functions in NotificationsService.swift that are not covered by tests

208 ```186```

209 </Step>187 

210 188**2. Gere scaffolding de teste**

211 <Step title="Gere scaffolding de teste">189 

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

213 add tests for the notification service191add tests for the notification service

214 ```192```

215 </Step>193 

216 194**3. Adicione casos de teste significativos**

217 <Step title="Adicione casos de teste significativos">195 

218 ```text wrap theme={null}196```text wrap theme={null}

219 add test cases for edge conditions in the notification service197add test cases for edge conditions in the notification service

220 ```198```

221 </Step>199 

222 200**4. Execute e verifique os testes**

223 <Step title="Execute e verifique os testes">201 

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

225 run the new tests and fix any failures203run the new tests and fix any failures

226 ```204```

227 </Step>

228</Steps>

229 205 

230Claude pode gerar testes que seguem os padrões e convenções existentes do seu projeto. Ao solicitar testes, seja específico sobre qual comportamento você quer verificar. Claude examina seus arquivos de teste existentes para corresponder ao estilo, frameworks e padrões de asserção já em uso.206Claude pode gerar testes que seguem os padrões e convenções existentes do seu projeto. Ao solicitar testes, seja específico sobre qual comportamento você quer verificar. Claude examina seus arquivos de teste existentes para corresponder ao estilo, frameworks e padrões de asserção já em uso.

231 207 

233 209 

234***210***

235 211 

236<h3 id="create-pull-requests">212### Criar pull requests

237 Criar pull requests

238</h3>

239 213 

240Você pode criar pull requests pedindo ao Claude diretamente ("create a pr for my changes"), ou guiar Claude através disso passo a passo:214Você pode criar pull requests pedindo ao Claude diretamente ("create a pr for my changes"), ou guiar Claude através disso passo a passo:

241 215 

242<Steps>216**1. Resuma suas alterações**

243 <Step title="Resuma suas alterações">217 

244 ```text wrap theme={null}218```text wrap theme={null}

245 summarize the changes I've made to the authentication module219summarize the changes I've made to the authentication module

246 ```220```

247 </Step>221 

248 222**2. Gere uma pull request**

249 <Step title="Gere uma pull request">223 

250 ```text wrap theme={null}224```text wrap theme={null}

251 create a pr225create a pr

252 ```226```

253 </Step>227 

254 228**3. Revise e refine**

255 <Step title="Revise e refine">229 

256 ```text wrap theme={null}230```text wrap theme={null}

257 enhance the PR description with more context about the security improvements231enhance the PR description with more context about the security improvements

258 ```232```

259 </Step>

260</Steps>

261 233 

262Para encontrar a sessão mais tarde, execute `claude --from-pr 1234` com seu próprio número de PR, que abre o seletor de sessão filtrado para sessões vinculadas a essa PR, ou cole a URL da PR no seletor [`/resume`](/docs/pt/sessions#use-the-session-picker). Claude Code vincula a sessão à PR quando Claude a cria com `gh pr create` ou `glab mr create`, e quando Claude [trabalha em uma PR existente](/docs/pt/agent-view#pull-request-status).234Para encontrar a sessão mais tarde, execute `claude --from-pr 1234` com seu próprio número de PR, que abre o seletor de sessão filtrado para sessões vinculadas a essa PR, ou cole a URL da PR no seletor [`/resume`](/docs/pt/sessions#use-the-session-picker). Claude Code vincula a sessão à PR quando Claude a cria com `gh pr create` ou `glab mr create`, e quando Claude [trabalha em uma PR existente](/docs/pt/agent-view#pull-request-status).

263 235 

264<Tip>236> [!TIP]

265 Revise a PR gerada por Claude antes de enviar e peça ao Claude para destacar riscos ou considerações potenciais.237>

266</Tip>238> Revise a PR gerada por Claude antes de enviar e peça ao Claude para destacar riscos ou considerações potenciais.

267 239 

268<h3 id="handle-documentation">240### Lidar com documentação

269 Lidar com documentação

270</h3>

271 241 

272Suponha que você precise adicionar ou atualizar documentação para seu código.242Suponha que você precise adicionar ou atualizar documentação para seu código.

273 243 

274<Steps>244**1. Identifique código não documentado**

275 <Step title="Identifique código não documentado">245 

276 ```text wrap theme={null}246```text wrap theme={null}

277 find functions without proper JSDoc comments in the auth module247find functions without proper JSDoc comments in the auth module

278 ```248```

279 </Step>249 

280 250**2. Gere documentação**

281 <Step title="Gere documentação">251 

282 ```text wrap theme={null}252```text wrap theme={null}

283 add JSDoc comments to the undocumented functions in auth.js253add JSDoc comments to the undocumented functions in auth.js

284 ```254```

285 </Step>255 

286 256**3. Revise e melhore**

287 <Step title="Revise e melhore">257 

288 ```text wrap theme={null}258```text wrap theme={null}

289 improve the generated documentation with more context and examples259improve the generated documentation with more context and examples

290 ```260```

291 </Step>261 

292 262**4. Verifique a documentação**

293 <Step title="Verifique a documentação">263 

294 ```text wrap theme={null}264```text wrap theme={null}

295 check if the documentation follows our project standards265check if the documentation follows our project standards

296 ```266```

297 </Step>267 

298</Steps>268> [!TIP]

299 269>

300<Tip>270> Dicas:

301 Dicas:271>

302 272> * Especifique o estilo de documentação que você deseja (JSDoc, docstrings, etc.)

303 * Especifique o estilo de documentação que você deseja (JSDoc, docstrings, etc.)273> * Peça por exemplos na documentação

304 * Peça por exemplos na documentação274> * Solicite documentação para APIs públicas, interfaces e lógica complexa

305 * Solicite documentação para APIs públicas, interfaces e lógica complexa

306</Tip>

307 275 

308***276***

309 277 

310<h3 id="work-in-notes-and-non-code-folders">278### Trabalhar em notas e pastas não-código

311 Trabalhar em notas e pastas não-código

312</h3>

313 279 

314Claude Code funciona em qualquer diretório. Execute-o dentro de um cofre de notas, uma pasta de documentação ou qualquer coleção de arquivos markdown para pesquisar, editar e reorganizar conteúdo da mesma forma que você faria com código.280Claude Code funciona em qualquer diretório. Execute-o dentro de um cofre de notas, uma pasta de documentação ou qualquer coleção de arquivos markdown para pesquisar, editar e reorganizar conteúdo da mesma forma que você faria com código.

315 281 

317 283 

318***284***

319 285 

320<h3 id="work-with-images">286### Trabalhar com imagens

321 Trabalhar com imagens

322</h3>

323 287 

324Suponha que você precise trabalhar com imagens em sua base de código e queira ajuda do Claude para analisar o conteúdo da imagem.288Suponha que você precise trabalhar com imagens em sua base de código e queira ajuda do Claude para analisar o conteúdo da imagem.

325 289 

326<Steps>290**1. Adicione uma imagem à conversa**

327 <Step title="Adicione uma imagem à conversa">291 

328 Você pode usar qualquer um destes métodos:292Você pode usar qualquer um destes métodos:

329 293 

330 1. Arraste e solte uma imagem na janela do Claude Code2941. Arraste e solte uma imagem na janela do Claude Code

331 2. Copie uma imagem e cole-a no CLI com `Ctrl+V`, ou com [`Alt+V` no Windows e WSL](/docs/pt/interactive-mode#general-controls)2952. Copie uma imagem e cole-a no CLI com `Ctrl+V`, ou com [`Alt+V` no Windows e WSL](/docs/pt/interactive-mode#general-controls)

332 3. Forneça um caminho de imagem ao Claude, por exemplo "Analyze this image: /path/to/your/image.png"2963. Forneça um caminho de imagem ao Claude, por exemplo "Analyze this image: /path/to/your/image.png"

333 </Step>297 

334 298**2. Peça ao Claude para analisar a imagem**

335 <Step title="Peça ao Claude para analisar a imagem">299 

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

337 What does this image show?301What does this image show?

338 ```302```

339 303 

340 ```text wrap theme={null}304```text wrap theme={null}

341 Describe the UI elements in this screenshot305Describe the UI elements in this screenshot

342 ```306```

343 307 

344 ```text wrap theme={null}308```text wrap theme={null}

345 Are there any problematic elements in this diagram?309Are there any problematic elements in this diagram?

346 ```310```

347 </Step>311 

348 312**3. Use imagens para contexto**

349 <Step title="Use imagens para contexto">313 

350 ```text wrap theme={null}314```text wrap theme={null}

351 Here's a screenshot of the error. What's causing it?315Here's a screenshot of the error. What's causing it?

352 ```316```

353 317 

354 ```text wrap theme={null}318```text wrap theme={null}

355 This is our current database schema. How should we modify it for the new feature?319This is our current database schema. How should we modify it for the new feature?

356 ```320```

357 </Step>321 

358 322**4. Obtenha sugestões de código do conteúdo visual**

359 <Step title="Obtenha sugestões de código do conteúdo visual">323 

360 ```text wrap theme={null}324```text wrap theme={null}

361 Generate CSS to match this design mockup325Generate CSS to match this design mockup

362 ```326```

363 327 

364 ```text wrap theme={null}328```text wrap theme={null}

365 What HTML structure would recreate this component?329What HTML structure would recreate this component?

366 ```330```

367 </Step>331 

368</Steps>332> [!TIP]

369 333>

370<Tip>334> Dicas:

371 Dicas:335>

372 336> * Use imagens quando descrições de texto seriam pouco claras ou complicadas

373 * Use imagens quando descrições de texto seriam pouco claras ou complicadas337> * Inclua capturas de tela de erros, designs de UI ou diagramas para melhor contexto

374 * Inclua capturas de tela de erros, designs de UI ou diagramas para melhor contexto338> * Você pode trabalhar com múltiplas imagens em uma conversa

375 * Você pode trabalhar com múltiplas imagens em uma conversa339> * A análise de imagem funciona com diagramas, capturas de tela, mockups e muito mais

376 * A análise de imagem funciona com diagramas, capturas de tela, mockups e muito mais340> * Quando Claude referencia imagens (por exemplo, `[Image #1]`), `Cmd+Click` (Mac) ou `Ctrl+Click` (Windows/Linux) o link para abrir a imagem em seu visualizador padrão

377 * Quando Claude referencia imagens (por exemplo, `[Image #1]`), `Cmd+Click` (Mac) ou `Ctrl+Click` (Windows/Linux) o link para abrir a imagem em seu visualizador padrão

378</Tip>

379 341 

380***342***

381 343 

382<h3 id="reference-files-and-directories">344### Referenciar arquivos e diretórios

383 Referenciar arquivos e diretórios

384</h3>

385 345 

386Use @ para incluir rapidamente arquivos ou diretórios sem esperar que Claude os leia.346Use @ para incluir rapidamente arquivos ou diretórios sem esperar que Claude os leia.

387 347 

388<Steps>348**1. Referencie um único arquivo**

389 <Step title="Referencie um único arquivo">

390 ```text wrap theme={null}

391 Explain the logic in @src/utils/auth.js

392 ```

393 349 

394 Isso inclui o conteúdo do arquivo na conversa quando ele cabe no limite de tokens da [ferramenta Read](/docs/pt/tools-reference#read-tool-behavior), 25.000 tokens por padrão. Um arquivo de texto maior que 256KB não é incluído.350```text wrap theme={null}

395 </Step>351Explain the logic in @src/utils/auth.js

352```

353 

354Isso inclui o conteúdo do arquivo na conversa quando ele cabe no limite de tokens da [ferramenta Read](/docs/pt/tools-reference#read-tool-behavior), 25.000 tokens por padrão. Um arquivo de texto maior que 256KB não é incluído.

396 355 

397 <Step title="Referencie um diretório">356**2. Referencie um diretório**

398 ```text wrap theme={null}357 

399 What's the structure of @src/components?358```text wrap theme={null}

400 ```359What's the structure of @src/components?

401 </Step>360```

402 361 

403 <Step title="Referencie recursos MCP">362**3. Referencie recursos MCP**

404 ```text wrap theme={null}

405 Show me the data from @github:repos/owner/repo/issues

406 ```

407 363 

408 Isso busca dados de servidores MCP conectados usando o formato @server:resource. Consulte [recursos MCP](/docs/pt/mcp#use-mcp-resources) para detalhes.364```text wrap theme={null}

409 </Step>365Show me the data from @github:repos/owner/repo/issues

410</Steps>366```

411 367 

412<Tip>368Isso busca dados de servidores MCP conectados usando o formato @server:resource. Consulte [recursos MCP](/docs/pt/mcp#use-mcp-resources) para detalhes.

413 Dicas:

414 369 

415 * Os caminhos de arquivo podem ser relativos ou absolutos370> [!TIP]

416 * Digite `@` para abrir um menu de sugestão de caminho, depois pressione Enter ou Tab para aceitar o caminho destacado e Enter novamente para enviar a mensagem371>

417 * Referências de arquivo @ adicionam `CLAUDE.md` no diretório do arquivo e diretórios pai ao contexto372> Dicas:

418 * Referências de diretório mostram listagens de arquivo, não conteúdos373>

419 * Você pode referenciar múltiplos arquivos em uma única mensagem (por exemplo, "@file1.js and @file2.js")374> * Os caminhos de arquivo podem ser relativos ou absolutos

420</Tip>375> * Digite `@` para abrir um menu de sugestão de caminho, depois pressione Enter ou Tab para aceitar o caminho destacado e Enter novamente para enviar a mensagem

376> * Referências de arquivo @ adicionam `CLAUDE.md` no diretório do arquivo e diretórios pai ao contexto

377> * Referências de diretório mostram listagens de arquivo, não conteúdos

378> * Você pode referenciar múltiplos arquivos em uma única mensagem (por exemplo, "@file1.js and @file2.js")

421 379 

422Para impedir que referências `@` incluam conteúdos de arquivos e listagens de diretórios em sua mensagem, defina [`CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`](/docs/pt/env-vars#variables) no seu shell ou nas configurações de usuário. Claude então recebe os caminhos que você referenciou com uma nota para lê-los usando suas ferramentas de arquivo. A variável requer Claude Code v2.1.299 ou posterior, e Claude Code a ignora nas configurações de projeto e locais.380Para impedir que referências `@` incluam conteúdos de arquivos e listagens de diretórios em sua mensagem, defina [`CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`](/docs/pt/env-vars#variables) no seu shell ou nas configurações de usuário. Claude então recebe os caminhos que você referenciou com uma nota para lê-los usando suas ferramentas de arquivo. A variável requer Claude Code v2.1.299 ou posterior, e Claude Code a ignora nas configurações de projeto e locais.

423 381 

424***382***

425 383 

426<h3 id="run-claude-on-a-schedule">384### Executar Claude em um cronograma

427 Executar Claude em um cronograma

428</h3>

429 385 

430Suponha que você queira que Claude lide com uma tarefa automaticamente em uma base recorrente, como revisar PRs abertas todas as manhãs, auditar dependências semanalmente ou verificar falhas de CI durante a noite.386Suponha que você queira que Claude lide com uma tarefa automaticamente em uma base recorrente, como revisar PRs abertas todas as manhãs, auditar dependências semanalmente ou verificar falhas de CI durante a noite.

431 387 

433 389 

434| Opção | Onde é executado | Melhor para |390| Opção | Onde é executado | Melhor para |

435| :- | :- | :- |391| :- | :- | :- |

436| [Rotinas](/docs/pt/routines) | Nuvem, gerenciada pela Anthropic por padrão | Tarefas que devem ser executadas mesmo quando seu computador está desligado. Também podem ser acionadas por chamadas de API ou eventos do GitHub além de um cronograma. Configure em [claude.ai/code/routines](https://claude.ai/code/routines). |392| [Tarefas agendadas na nuvem](/docs/pt/routines) | Nuvem, gerenciada pela Anthropic por padrão | Tarefas que devem ser executadas mesmo quando seu computador está desligado. Também podem ser acionadas por chamadas de API ou eventos do GitHub além de um cronograma. Configure em [claude.ai/code/routines](https://claude.ai/code/routines). |

437| [Tarefas agendadas no desktop](/docs/pt/desktop-scheduled-tasks) | Sua máquina, via aplicativo desktop | Tarefas que precisam de acesso direto a arquivos locais, ferramentas ou alterações não confirmadas. |393| [Tarefas agendadas no desktop](/docs/pt/desktop-scheduled-tasks) | Sua máquina, via aplicativo desktop | Tarefas que precisam de acesso direto a arquivos locais, ferramentas ou alterações não confirmadas. |

438| [GitHub Actions](/docs/pt/github-actions) | Seu pipeline de CI | Tarefas vinculadas a eventos de repositório como PRs abertos, ou cronogramas cron que devem viver junto com sua configuração de fluxo de trabalho. |394| [GitHub Actions](/docs/pt/github-actions) | Seu pipeline de CI | Tarefas vinculadas a eventos de repositório como PRs abertos, ou cronogramas cron que devem viver junto com sua configuração de fluxo de trabalho. |

439| [`/loop`](/docs/pt/scheduled-tasks) | A sessão CLI atual | Polling rápido enquanto uma sessão está aberta. `--resume` e `--continue` restauram loops de intervalo fixo não expirados. |395| [`/loop`](/docs/pt/scheduled-tasks) | A sessão CLI atual | Polling rápido enquanto uma sessão está aberta. `--resume` e `--continue` restauram loops de intervalo fixo não expirados. |

440 396 

441<Tip>397> [!TIP]

442 Ao escrever prompts para tarefas agendadas, seja explícito sobre o que o sucesso parece e o que fazer com os resultados. A tarefa é executada autonomamente, então não pode fazer perguntas de esclarecimento. Por exemplo: "Review open PRs labeled `needs-review`, leave inline comments on any issues, and post a summary in the `#eng-reviews` Slack channel."398>

443</Tip>399> Ao escrever prompts para tarefas agendadas, seja explícito sobre o que o sucesso parece e o que fazer com os resultados. A tarefa é executada autonomamente, então não pode fazer perguntas de esclarecimento. Por exemplo: "Review open PRs labeled `needs-review`, leave inline comments on any issues, and post a summary in the `#eng-reviews` Slack channel."

444 400 

445***401***

446 402 

447<h3 id="ask-claude-about-its-capabilities">403### Pergunte ao Claude sobre suas capacidades

448 Pergunte ao Claude sobre suas capacidades

449</h3>

450 404 

451Claude pode responder perguntas sobre seus próprios recursos e limitações. Ele busca as respostas na documentação atual do Claude Code, então elas não se limitam à versão que você está executando.405Claude pode responder perguntas sobre seus próprios recursos e limitações. Ele busca as respostas na documentação atual do Claude Code, então elas não se limitam à versão que você está executando.

452 406 

453<h4 id="example-questions">407#### Perguntas de exemplo

454 Perguntas de exemplo

455</h4>

456 408 

457```text wrap theme={null}409```text wrap theme={null}

458can Claude Code create pull requests?410can Claude Code create pull requests?

478what are the limitations of Claude Code?430what are the limitations of Claude Code?

479```431```

480 432 

481<Note>433> [!NOTE]

482 Claude fornece respostas baseadas em documentação para essas perguntas. Para demonstrações práticas, execute `/powerup` para lições interativas com demos animadas, ou consulte as seções de fluxo de trabalho específicas acima.434>

483</Note>435> Claude fornece respostas baseadas em documentação para essas perguntas. Para demonstrações práticas, execute `/powerup` para lições interativas com demos animadas, ou consulte as seções de fluxo de trabalho específicas acima.

484 

485<Tip>

486 Dicas:

487 436 

488 * Faça perguntas específicas para obter respostas detalhadas437> [!TIP]

489 * Claude pode explicar recursos complexos como integração MCP, configurações empresariais e fluxos de trabalho avançados438>

490</Tip>439> Dicas:

440>

441> * Faça perguntas específicas para obter respostas detalhadas

442> * Claude pode explicar recursos complexos como integração MCP, configurações empresariais e fluxos de trabalho avançados

491 443 

492***444***

493 445 

494<h2 id="resume-previous-conversations">446## Retomar conversas anteriores

495 Retomar conversas anteriores

496</h2>

497 447 

498Quando uma tarefa abrange múltiplas sessões, retome de onde parou em vez de re-explicar o contexto. Claude Code salva cada conversa localmente.448Quando uma tarefa abrange múltiplas sessões, retome de onde parou em vez de re-explicar o contexto. Claude Code salva cada conversa localmente.

499 449 

503 453 

504Isso retoma a sessão mais recente no diretório atual; se não houver uma ainda, ele imprime `No conversation found to continue` e sai. Use `claude --resume` para escolher de uma lista, ou `/resume` de dentro de uma sessão em execução. Consulte [Gerenciar sessões](/docs/pt/sessions) para nomeação, ramificação e referência completa do seletor.454Isso retoma a sessão mais recente no diretório atual; se não houver uma ainda, ele imprime `No conversation found to continue` e sai. Use `claude --resume` para escolher de uma lista, ou `/resume` de dentro de uma sessão em execução. Consulte [Gerenciar sessões](/docs/pt/sessions) para nomeação, ramificação e referência completa do seletor.

505 455 

506<h2 id="run-parallel-sessions-with-worktrees">456## Executar sessões paralelas com worktrees

507 Executar sessões paralelas com worktrees

508</h2>

509 457 

510Trabalhe em um recurso em um terminal enquanto Claude corrige um bug em outro, sem que as edições colidam. Cada [git worktree](https://git-scm.com/docs/git-worktree) é um checkout separado em seu próprio branch, criado a partir de um commit existente, portanto o repositório precisa ter pelo menos um commit primeiro.458Trabalhe em um recurso em um terminal enquanto Claude corrige um bug em outro, sem que as edições colidam. Cada [git worktree](https://git-scm.com/docs/git-worktree) é um checkout separado em seu próprio branch, criado a partir de um commit existente, portanto o repositório precisa ter pelo menos um commit primeiro.

511 459 

515 463 

516Execute o mesmo comando com um nome diferente em um segundo terminal para iniciar uma sessão paralela isolada. Em um repositório sem commits, o comando falha com `Failed to resolve base branch "HEAD": git rev-parse failed`. Consulte [Worktrees](/docs/pt/worktrees) para limpeza, `.worktreeinclude` e suporte a VCS não-git. Para monitorar sessões paralelas de uma tela em vez de terminais separados, consulte [agentes em segundo plano](/docs/pt/agent-view).464Execute o mesmo comando com um nome diferente em um segundo terminal para iniciar uma sessão paralela isolada. Em um repositório sem commits, o comando falha com `Failed to resolve base branch "HEAD": git rev-parse failed`. Consulte [Worktrees](/docs/pt/worktrees) para limpeza, `.worktreeinclude` e suporte a VCS não-git. Para monitorar sessões paralelas de uma tela em vez de terminais separados, consulte [agentes em segundo plano](/docs/pt/agent-view).

517 465 

518<h2 id="plan-before-editing">466## Planejar antes de editar

519 Planejar antes de editar

520</h2>

521 467 

522Para alterações que você quer revisar antes de tocarem o disco, mude para plan mode. Claude lê arquivos e propõe um plano, mas não faz edições até que você aprove. A barra de status mostra `⏸ plan mode on` enquanto plan mode está ativo.468Para alterações que você quer revisar antes de tocarem o disco, mude para plan mode. Claude lê arquivos e propõe um plano, mas não faz edições até que você aprove. A barra de status mostra `⏸ plan mode on` enquanto plan mode está ativo.

523 469 

527 473 

528Você também pode pressionar `Shift+Tab` durante uma sessão até a barra de status mostrar `⏸ plan mode on`. Consulte [Plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) para o fluxo de aprovação e edição do plano em seu editor de texto.474Você também pode pressionar `Shift+Tab` durante uma sessão até a barra de status mostrar `⏸ plan mode on`. Consulte [Plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) para o fluxo de aprovação e edição do plano em seu editor de texto.

529 475 

530<h2 id="delegate-research-to-subagents">476## Delegar pesquisa para subagents

531 Delegar pesquisa para subagents

532</h2>

533 477 

534Explorar uma base de código grande preenche seu contexto com leituras de arquivo. Delegue a exploração para que apenas os achados retornem.478Explorar uma base de código grande preenche seu contexto com leituras de arquivo. Delegue a exploração para que apenas os achados retornem.

535 479 

539 483 

540O subagent lê arquivos em sua própria janela de contexto e relata um resumo. Consulte [Subagents](/docs/pt/sub-agents) para definir agentes personalizados com suas próprias ferramentas e prompts.484O subagent lê arquivos em sua própria janela de contexto e relata um resumo. Consulte [Subagents](/docs/pt/sub-agents) para definir agentes personalizados com suas próprias ferramentas e prompts.

541 485 

542<h2 id="pipe-claude-into-scripts">486## Canalizar Claude em scripts

543 Canalizar Claude em scripts

544</h2>

545 487 

546Execute Claude de forma não interativa para CI, hooks de pré-commit ou processamento em lote. Stdin e stdout funcionam como qualquer ferramenta Unix.488Execute Claude de forma não interativa para CI, hooks de pré-commit ou processamento em lote. Stdin e stdout funcionam como qualquer ferramenta Unix.

547 489 

551 493 

552Consulte [Modo não interativo](/docs/pt/headless) para formatos de saída, flags de permissão e padrões de fan-out.494Consulte [Modo não interativo](/docs/pt/headless) para formatos de saída, flags de permissão e padrões de fan-out.

553 495 

554<h2 id="next-steps">496## Próximos passos

555 Próximos passos

556</h2>

557 497 

558<CardGroup cols={2}>498> **[Melhores práticas](/docs/pt/best-practices)**

559 <Card title="Melhores práticas" icon="lightbulb" href="/docs/pt/best-practices">499>

560 Padrões para aproveitar ao máximo Claude Code500> Padrões para aproveitar ao máximo Claude Code

561 </Card>

562 501 

563 <Card title="Gerenciar sessões" icon="rotate-left" href="/docs/pt/sessions">502> **[Gerenciar sessões](/docs/pt/sessions)**

564 Retomar, nomear e ramificar conversas503>

565 </Card>504> Retomar, nomear e ramificar conversas

566 505 

567 <Card title="Worktrees" icon="code-branch" href="/docs/pt/worktrees">506> **[Worktrees](/docs/pt/worktrees)**

568 Executar sessões paralelas isoladas507>

569 </Card>508> Executar sessões paralelas isoladas

570 509 

571 <Card title="Estender Claude Code" icon="puzzle-piece" href="/docs/pt/features-overview">510> **[Estender Claude Code](/docs/pt/features-overview)**

572 Adicionar skills, hooks, MCP, subagents e plugins511>

573 </Card>512> Adicionar skills, hooks, MCP, subagents e plugins

574</CardGroup>