> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Tutorial de Uso do Claude Code para VS Code

> Claude Code 集成指南 - Ace Data Cloud

Claude Code é uma ferramenta de **Programação Agentiva** lançada pela Anthropic, também conhecida como um dos agentes de programação mais poderosos do mundo. A extensão do Claude Code para o VS Code oferece uma interface gráfica nativa, suportando visualização de Diff inline, referências com `@`-mentions, revisão de planos, entre outras funcionalidades, sendo a forma recomendada de usar o Claude Code no VS Code.

Este documento descreve principalmente como configurar e usar a extensão do Claude Code no VS Code através do serviço de proxy da AceData Cloud.

## Processo de Solicitação

Para usar o Claude Code, você pode primeiro acessar a [página de serviços do Claude Messages](https://platform.acedata.cloud/documents/claude-messages) e clicar no botão "Adquirir" para obter as credenciais necessárias para a solicitação:

![](https://cdn.acedata.cloud/nyq0xz.png)

Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, convidando-o a se registrar e logar. Após o login ou registro, você será redirecionado de volta para a página atual.

Na primeira solicitação, haverá um crédito gratuito disponível para que você possa experimentar o serviço do Claude Code sem custo.

## Instalação do Plugin

### Requisitos do Sistema

* VS Code 1.98.0 ou versão superior (também suporta Cursor)

### Passos de Instalação

No marketplace de extensões do VS Code / Cursor, pressione `Cmd+Shift+X` (Mac) ou `Ctrl+Shift+X` (Windows/Linux) para abrir a visualização de extensões, busque por **Claude Code**, encontre o plugin publicado oficialmente pela Anthropic e clique em "Instalar":

![Plugin Claude Code no Marketplace do VS Code](https://cdn.acedata.cloud/10ddf71320.png)

Você também pode instalar diretamente através dos seguintes links:

* [Link de instalação do VS Code](vscode:extension/anthropic.claude-code)
* [Link de instalação do Cursor](cursor:extension/anthropic.claude-code)

Após a instalação, selecione a opção de confiar na mensagem de aviso que aparecer, e a instalação estará completa.

> Se a extensão não aparecer após a instalação, reinicie o VS Code ou execute "Developer: Reload Window" no painel de comandos.

## Configuração da API da AceData Cloud

Ao abrir o plugin pela primeira vez, será solicitado que você faça login na conta oficial da Anthropic. Podemos pular o login oficial e usar a API de proxy da AceData Cloud, **sem necessidade de assinatura oficial**.

### Passo Um: Configurar Variáveis de Ambiente

Você pode escolher configurar as variáveis de ambiente em qualquer um dos seguintes locais:

**Opção A: Configuração em nível de usuário (aplicável a todos os projetos)**

Edite `~/.claude/settings.json` (se não existir, crie) e adicione a configuração `env`, substituindo `{token}` pelo token da API que você obteve no console da AceData Cloud:

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}
```

**Opção B: Configuração em nível de projeto (apenas para o projeto atual)**

Crie `.claude/settings.json` (configuração compartilhada) ou `.claude/settings.local.json` (configuração pessoal, ignorada pelo git) no diretório raiz do projeto:

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}
```

> **Dica**: O token da API pode ser visualizado no [console da AceData Cloud](https://platform.acedata.cloud/console). O valor de `ANTHROPIC_AUTH_TOKEN` será automaticamente precedido pelo prefixo `Bearer` ao ser enviado para o servidor. A configuração em nível de projeto tem prioridade sobre a configuração em nível de usuário. Recomenda-se usar a configuração compartilhada `.claude/settings.json` em projetos de equipe, enquanto informações sensíveis pessoais devem ser colocadas em `.claude/settings.local.json`.

### Passo Dois: Desativar o Aviso de Login (opcional)

Se você não quiser ver o aviso de login toda vez que abrir, pode marcar a opção **Desativar Aviso de Login** nas configurações do VS Code:

Pesquise "login do Claude Code" nas configurações, encontre a opção **Desativar Aviso de Login** e marque-a.

Após a configuração, reabra o painel do plugin Claude Code para começar a usá-lo normalmente.

## Abrir o Painel do Claude Code

Após a instalação e configuração, existem várias maneiras de abrir o Claude Code:

| Método                             | Ação                                                                                                |
| ---------------------------------- | --------------------------------------------------------------------------------------------------- |
| **Barra de Ferramentas do Editor** | Clique no ícone ✦ Spark no canto superior direito do editor (é necessário abrir um arquivo)         |
| **Barra de Status**                | Clique em "✱ Claude Code" à direita da barra de status inferior (não é necessário abrir um arquivo) |
| **Painel de Comandos**             | `Cmd+Shift+P` / `Ctrl+Shift+P`, busque por "Claude Code"                                            |
| **Atalho**                         | `Cmd+Esc` (Mac) / `Ctrl+Esc` (Windows/Linux) para alternar o foco                                   |

Diferente de ferramentas como Cursor / Copilot que usam uma barra lateral, o Claude Code utiliza por padrão a **visualização da área de edição** como área de chat, proporcionando uma área visível maior e uma exibição de conteúdo mais rica. Você também pode arrastar o painel para a barra lateral ou outras posições.

![Painel do Claude Code no VS Code](https://cdn.acedata.cloud/b84b878420.jpg)

## Uso Básico

### Interação em Diálogo

No painel do Claude Code, você pode digitar diretamente em linguagem natural para interagir com Claude. Por exemplo:

* "Ajude-me a analisar a arquitetura geral deste projeto"
* "Este código tem um bug, conserte-o para mim"
* "Refatore esta função para melhorar a legibilidade"
* "Escreva testes unitários para este módulo"

O Claude Code entenderá automaticamente o contexto do seu repositório de código, analisando e editando entre arquivos. Quando Claude precisar modificar um arquivo, uma visualização de comparação Diff será exibida, permitindo que você aceite ou rejeite as modificações.

![Diálogo e Dicas do Claude Code no VS Code](https://cdn.acedata.cloud/650377f5cc.png)

### Referências de Contexto

Usar o símbolo `@` no diálogo permite referenciar arquivos ou contextos específicos:

* `@filename.py` — Referencia um arquivo específico (suporta correspondência difusa)
* `@src/components/` — Referencia um diretório inteiro (necessita de barra no final)
* `@terminal:name` — Referencia a saída do terminal

Após selecionar o código no editor, pressione `Option+K` (Mac) / `Alt+K` (Windows/Linux) para inserir rapidamente uma referência `@` (como `@app.ts#5-10`).

### Comandos de Barra

Clique no ícone `/` no quadro de diálogo ou digite diretamente `/` para usar uma variedade de funcionalidades integradas:

Os comandos mais comuns incluem:

| Comando    | Função                      |
| ---------- | --------------------------- |
| `/new`     | Criar novo diálogo          |
| `/model`   | Alternar modelo             |
| `/compact` | Compactar contexto          |
| `/mcp`     | Configurar serviço MCP      |
| `/config`  | Abrir configurações         |
| `/usage`   | Ver uso                     |
| `/memory`  | Gerenciar memória do Claude |
| `/help`    | Exibir informações de ajuda |

### Ver Histórico de Diálogos

Clique no menu suspenso na parte superior do painel para visualizar o histórico de diálogos, suportando busca por palavras-chave e navegação por períodos de tempo (Hoje, Ontem, Últimos 7 dias, etc.), facilitando a recuperação de interações anteriores. Clique em qualquer diálogo para restaurar o histórico completo de mensagens.

### Revisar Alterações de Código

Quando Claude precisar modificar um arquivo, uma visualização de comparação Diff será exibida, mostrando a comparação entre o código original e o modificado. Você pode escolher aceitar ou rejeitar cada modificação, ou pode informar a Claude o que você gostaria de fazer de diferente:
![VS Code 中的 Diff 对比视图](https://cdn.acedata.cloud/c42381ea9f.png)

### Modo de Permissão

Você pode alternar entre diferentes modos de permissão através do indicador de modo na parte inferior do painel:

| Modo                  | Descrição                                                                                          |
| --------------------- | -------------------------------------------------------------------------------------------------- |
| **Default（Ask）**      | Pergunta confirmação antes de cada operação (padrão)                                               |
| **Plan**              | Claude faz um plano e aguarda aprovação, só executa após confirmação                               |
| **acceptEdits**       | Aceita automaticamente edições de arquivos, mas comandos de terminal ainda precisam de confirmação |
| **bypassPermissions** | Ignora todos os avisos de permissão, totalmente automatizado (usar com cautela)                    |

### Múltiplas Sessões Paralelas

Usando o comando **Open in New Tab** ou **Open in New Window** no painel de comandos, você pode iniciar várias conversas independentes, cada uma mantendo seu próprio histórico e contexto, permitindo o processamento paralelo de diferentes tarefas.

## Outras Configurações

### Alternar Modelo

Claude Code suporta a troca entre diferentes modelos, como Claude Sonnet, Claude Opus, etc. Você pode configurar isso através do comando `/model` ou nas configurações do plugin em **Selected Model**.

### Modo Automático

Nas configurações do plugin, você pode definir o **Initial Permission Mode** como `bypassPermissions`, após o que Claude Code não solicitará confirmação para edições de arquivos, comandos de terminal, etc., implementando um fluxo de trabalho totalmente automatizado.

Você também pode definir como `acceptEdits` para aceitar edições automaticamente, mas os comandos de terminal ainda precisarão de confirmação em um modo semi-automático.

> **Nota**: Antes de ativar o modo automático, certifique-se de entender os riscos, é recomendável usar em ambientes de projeto confiáveis.

### Usando CLI no Terminal

Se você prefere um estilo de linha de comando, pode marcar **Use Terminal** nas configurações do VS Code, e Claude Code será executado em modo CLI no terminal integrado. Você também pode abrir diretamente o terminal integrado do VS Code e executar o comando `claude`.

## Perguntas Frequentes

### O que fazer se a conexão falhar?

1. Verifique se a configuração das variáveis de ambiente em `~/.claude/settings.json` ou `.claude/settings.json` está correta, especialmente `ANTHROPIC_AUTH_TOKEN` e `ANTHROPIC_BASE_URL`
2. Verifique se o token da API é válido (pode ser verificado no [console](https://platform.acedata.cloud/console))
3. Verifique se a conexão de rede está normal, garantindo acesso a `https://api.acedata.cloud`
4. Reinicie o VS Code e tente novamente

### O ícone do Spark não apareceu?

1. Certifique-se de que um arquivo está aberto (apenas abrir a pasta não é suficiente)
2. Verifique se a versão do VS Code é 1.98.0 ou superior
3. Execute "Developer: Reload Window" no painel de comandos
4. Ou clique diretamente no ícone "✱ Claude Code" na barra de status inferior

### Como verificar o saldo restante?

Faça login no [console da AceData Cloud](https://platform.acedata.cloud/console) para visualizar o saldo restante e o uso atual da conta.

## Saiba Mais

* 📖 [Documentação Oficial do Claude Code para VS Code](https://code.claude.com/docs/en/vs-code)
* ⌨️ [Referência de Comandos e Atalhos do VS Code](https://code.claude.com/docs/en/vs-code#vs-code-commands-and-shortcuts)
* 🔧 [Serviço Claude Code da AceData Cloud](https://platform.acedata.cloud/documents/claude-messages)
* 💬 Se tiver alguma dúvida, sinta-se à vontade para entrar em contato conosco através do suporte da plataforma