Tutorial de Uso do Terminal (CLI) do Claude Code

Claude Code é uma ferramenta de Codificação Agente lançada pela Anthropic, também conhecida como um dos agentes de programação mais poderosos do mundo. O terminal CLI é a experiência central do Claude Code, onde você pode executar o comando claude em qualquer terminal e colaborar em programação com a IA usando linguagem natural. Este documento apresenta como instalar, configurar e usar o Claude Code CLI através do serviço de proxy da AceData Cloud no terminal.

Processo de Solicitação

Para usar o Claude Code, primeiro você pode acessar a página de serviços Claude Messages e clicar no botão “Acquire” para obter as credenciais necessárias para a solicitação:

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 registro e login, 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 Claude Code sem custo.

Instalação do Claude Code

Requisitos do Sistema

macOS, Linux ou Windows (incluindo WSL)
Node.js não é obrigatório, o método de instalação nativo gerenciará automaticamente as dependências

Métodos de Instalação

Claude Code suporta vários métodos de instalação: Método 1: Instalação Nativa (Recomendado) macOS / Linux / WSL:

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

Windows PowerShell:

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

Windows CMD:

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

Método 2: Homebrew (macOS / Linux)

brew install claude-code

Método 3: WinGet (Windows)

winget install Claude.ClaudeCode

A instalação nativa atualizará automaticamente em segundo plano, mantendo sempre a versão mais recente.

Configuração da API da AceData Cloud

Após a instalação, você será solicitado a fazer login na conta oficial da Anthropic. Podemos usar variáveis de ambiente para configurar a API de proxy da AceData Cloud, sem necessidade de assinatura oficial.

Configuração de Variáveis de Ambiente

Existem duas maneiras de configurar variáveis de ambiente, escolha uma delas. Método 1: Configurar no arquivo de configuração do Shell (Recomendado) Adicione o seguinte conteúdo ao seu arquivo de configuração do Shell (~/.zshrc, ~/.bashrc ou ~/.bash_profile), substituindo {token} pelo token da API que você obteve no console da AceData Cloud:

# AceData Cloud - Configuração do Proxy do Claude Code
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"

Após a modificação, execute o seguinte comando para aplicar a configuração:

source ~/.zshrc  # ou source ~/.bashrc

Método 2: Configurar no settings.json do Claude Code Edite ~/.claude/settings.json (crie se não existir) e adicione a configuração env:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}

A vantagem desse método é que as variáveis de ambiente só afetam o Claude Code, sem impactar outros programas.

Dica: O token da API pode ser visualizado no console da AceData Cloud. O valor de ANTHROPIC_AUTH_TOKEN será automaticamente precedido pelo prefixo Bearer ao ser enviado ao servidor.

Começando a Usar

Iniciar Modo Interativo

Abra o terminal, navegue até o diretório do seu projeto e execute:

cd /path/to/your/project
claude

Você verá a tela de boas-vindas do Claude Code, onde pode começar a interagir digitando em linguagem natural.

Comandos Comuns

Comando	Descrição	Exemplo
`claude`	Iniciar modo interativo	`claude`
`claude "tarefa"`	Executar tarefa única	`claude "corrigir erro de construção"`
`claude -p "consulta"`	Executar consulta e sair	`claude -p "explique esta função"`
`claude -c`	Continuar a conversa mais recente no diretório atual	`claude -c`
`claude -r`	Recuperar conversa anterior	`claude -r`
`claude commit`	Criar commit no Git	`claude commit`

Comandos do Modo Interativo

No modo interativo, você pode usar os seguintes comandos internos:

Comando	Função
`/help`	Exibir informações de ajuda
`/clear`	Limpar histórico de conversa
`/config`	Abrir painel de configurações
`/model`	Alternar modelo
`/mcp`	Gerenciar serviço MCP
`/compact`	Compactar contexto
`/memory`	Gerenciar memória
`/login`	Alternar conta
`exit` ou `Ctrl+C`	Sair

Exemplos de Interação

# Analisando o projeto
> o que este projeto faz?

# Corrigindo Bug
> há um bug onde os usuários podem enviar formulários vazios - conserte isso

# Escrevendo testes
> escreva testes unitários para as funções do calculador

# Refatorando código
> refatore o módulo de autenticação para usar async/await

# Operações Git
> faça commit das minhas alterações com uma mensagem descritiva
> crie um PR para este recurso

Uso Avançado

Encadeamento e Scriptização

Claude Code segue a filosofia Unix, suportando encadeamento e operações scriptadas:

# Monitorar logs e alertar automaticamente
tail -f app.log | claude -p "se encontrar anomalias, me avise"

# Traduzir automaticamente novos textos
claude -p "se houver novas strings de texto, traduza para francês e crie um PR"

# Revisão de código
git diff main | claude -p "revise essas alterações"

Referência de Variáveis de Ambiente

Aqui estão algumas variáveis de ambiente comuns suportadas pelo Claude Code:

Variável	Descrição
`ANTHROPIC_AUTH_TOKEN`	Valor do cabeçalho Authorization personalizado (prefixo Bearer adicionado automaticamente)
`ANTHROPIC_API_KEY`	Chave da API (enviada como cabeçalho X-Api-Key)
`ANTHROPIC_BASE_URL`	URL base da API
`ANTHROPIC_MODEL`	Sobrescrever modelo padrão
`ANTHROPIC_SMALL_FAST_MODEL`	Modelo de nível Haiku (para tarefas em segundo plano)
`MAX_THINKING_TOKENS`	Definir orçamento de tokens de pensamento (defina como 0 para desativar o modo de pensamento)
`DISABLE_COST_WARNINGS`	Defina como 1 para desativar avisos de custo

Memória do Projeto CLAUDE.md

Crie um arquivo CLAUDE.md no diretório raiz do projeto para fornecer instruções e contexto específicos do projeto ao Claude Code. Claude carregará automaticamente este arquivo ao iniciar.

# Descrição do Projeto
Este é um projeto full-stack Django + Vue.js.

## Padrões de Codificação
- Usar Python 3.12
- Seguir o estilo de código PEP 8
- Todos os APIs precisam ter testes unitários

Perguntas Frequentes

O que fazer se a conexão falhar?

Verifique se o arquivo ~/.claude/config.json foi criado corretamente, com o conteúdo {"primaryApiKey": "self"}
Confirme se as variáveis de ambiente estão configuradas corretamente:
echo $ANTHROPIC_AUTH_TOKEN echo $ANTHROPIC_BASE_URL
Confirme se o token da API é válido (pode ser verificado no console)
Tente reiniciar o terminal

comando não encontrado: claude

Se, após a instalação, aparecer a mensagem command not found, tente:

Fechar e reabrir o terminal
Verificar o PATH: echo $PATH
Reinstalar: curl -fsSL https://claude.ai/install.sh | bash

Como verificar o saldo restante?

Faça login no console da AceData Cloud para ver o saldo restante e o uso atual da conta.

Saiba mais

📖 Documentação oficial do Claude Code CLI
📋 Referência de comandos CLI
🔧 Serviço Claude Code da AceData Cloud
💬 Se tiver alguma dúvida, sinta-se à vontade para entrar em contato conosco através do suporte da plataforma

Primeiros passos

Chat AI

Imagem AI

Vídeo AI

Áudio AI

Web e Dados

CAPTCHA

Identidade

Proxy

Avançado

Tutorial de Uso do Terminal (CLI) do Claude Code

Processo de Solicitação

Instalação do Claude Code

Requisitos do Sistema

Métodos de Instalação

Configuração da API da AceData Cloud

Configuração de Variáveis de Ambiente

Começando a Usar

Iniciar Modo Interativo

Comandos Comuns

Comandos do Modo Interativo

Exemplos de Interação

Uso Avançado

Encadeamento e Scriptização

Referência de Variáveis de Ambiente

Memória do Projeto CLAUDE.md

Perguntas Frequentes

O que fazer se a conexão falhar?

comando não encontrado: claude

Como verificar o saldo restante?

Saiba mais

​Processo de Solicitação

​Instalação do Claude Code

​Requisitos do Sistema

​Métodos de Instalação

​Configuração da API da AceData Cloud

​Configuração de Variáveis de Ambiente

​Começando a Usar

​Iniciar Modo Interativo

​Comandos Comuns

​Comandos do Modo Interativo

​Exemplos de Interação

​Uso Avançado

​Encadeamento e Scriptização

​Referência de Variáveis de Ambiente

​Memória do Projeto CLAUDE.md

​Perguntas Frequentes

​O que fazer se a conexão falhar?

​comando não encontrado: claude

​Como verificar o saldo restante?

​Saiba mais

Processo de Solicitação

Instalação do Claude Code

Requisitos do Sistema

Métodos de Instalação

Configuração da API da AceData Cloud

Configuração de Variáveis de Ambiente

Começando a Usar

Iniciar Modo Interativo

Comandos Comuns

Comandos do Modo Interativo

Exemplos de Interação

Uso Avançado

Encadeamento e Scriptização

Referência de Variáveis de Ambiente

Memória do Projeto CLAUDE.md

Perguntas Frequentes

O que fazer se a conexão falhar?

comando não encontrado: claude

Como verificar o saldo restante?

Saiba mais