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

# Usando o GccAi no Claude Code

> Um guia detalhado sobre como configurar e usar os serviços de API do GccAi no CLI do Claude Code, permitindo que você acesse vários modelos de IA para programação assistida com uma configuração simples.

![Claude Code Main Interface](https://mintcdn.com/apicore/_4UKBib4iqrgK4Ws/images/integrations/claude-code/claude-code-cli.png?fit=max\&auto=format\&n=_4UKBib4iqrgK4Ws\&q=85\&s=219739f4029aa915b90253ad02b01437)

## Pré-requisitos

O Claude Code é um assistente de programação de IA em linha de comando da Anthropic que suporta conversa direta com IA, geração de código e depuração no terminal.
Ao conectar-se ao GccAi, você pode usar vários modelos, incluindo GPT, Claude e Gemini, dentro do Claude Code.

Antes de começar, certifique-se de ter:

1. **Obtido uma chave de API do GccAi**
   Acesse o [Console do GccAi](https://gccai.heqingsong.uk/keys) para obter sua chave de API (começa com `sk-`)

> [!NOTE]
>
> **Dica:** Se você ainda não tem uma conta no GccAi, registre-se primeiro em [GccAi](https://gccai.heqingsong.uk) e obtenha sua chave de API.

## Etapa 1: Instalar o Claude Code

Escolha um dos seguintes métodos para instalar:

**macOS / Linux (Recomendado)**

Instale com o script oficial:

```bash theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```

Ou instale via Homebrew:

```bash theme={null}
brew install --cask claude-code
```

> [!NOTE]
>
> Se encontrar problemas de permissão, adicione `sudo` antes do comando.

**Windows**

**PowerShell:**

```powershell theme={null}
irm https://claude.ai/install.ps1 | iex
```

**CMD:**

```cmd theme={null}
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```

**Instalação via NPM**

Se você tem Node.js 18 ou mais recente instalado, pode instalar via npm:

```bash theme={null}
npm install -g @anthropic-ai/claude-code
```

Funciona em todos os sistemas operacionais.

### Verificar a instalação

Após a instalação, execute o seguinte comando para confirmar:

```bash theme={null}
claude --version
```

Se um número de versão for exibido (por exemplo, `1.x.x`), a instalação foi bem-sucedida.

## Etapa 2: Configurar a API do GccAi

Três métodos de configuração estão disponíveis. Escolha o que melhor se adapta ao seu fluxo de trabalho.

### Método 1: Editar settings.json (recomendado)

A abordagem mais estável — configure uma vez e ela persiste.

**1. Localize o diretório de configuração:**

* Windows: Pressione `Win + R`, digite `%userprofile%\.claude`
* macOS: Pressione `Command + Shift + G`, digite `~/.claude`
* Linux: Navegue até `~/.claude`

> [!NOTE]
>
> Se o diretório não existir, execute `claude` uma vez no terminal e pressione `Ctrl + C` para sair — o diretório será criado automaticamente.

**2. Crie ou edite o arquivo `settings.json`:**

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gccai.heqingsong.uk",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "claude-opus-5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
```

| Parâmetro | Descrição |
| - | - |
| `ANTHROPIC_BASE_URL` | Endereço da API do GccAi, fixado em `https://gccai.heqingsong.uk` |
| `ANTHROPIC_AUTH_TOKEN` | Sua chave de API do GccAi (começa com `sk-`) |
| `ANTHROPIC_MODEL` | Modelo padrão a ser usado, escolha na lista de modelos abaixo |
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Defina como `1` para reduzir requisições de rede não essenciais |

Salve o arquivo e reinicie o Claude Code para aplicar.

### Método 2: Variáveis de ambiente permanentes

Grave a configuração no ambiente do sistema para que todas as janelas de terminal a carreguem automaticamente.

**macOS (zsh)**

```bash theme={null}
echo 'export ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-opus-5"' >> ~/.zshrc
source ~/.zshrc
```

**macOS / Linux (bash)**

```bash theme={null}
echo 'export ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL="claude-opus-5"' >> ~/.bashrc
source ~/.bashrc
```

**Windows**

**Opção A: Configurações GUI**

1. Clique com o botão direito em "Este Computador" → "Propriedades" → "Configurações avançadas do sistema" → "Variáveis de ambiente"
2. Adicione novas variáveis de usuário:
   * `ANTHROPIC_BASE_URL` = `https://gccai.heqingsong.uk`
   * `ANTHROPIC_API_KEY` = `sk-xxxxxxxxxxxx`
   * `ANTHROPIC_MODEL` = `claude-opus-5`
3. Reinicie o terminal

**Opção B: Comandos PowerShell**

```powershell theme={null}
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://gccai.heqingsong.uk', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-xxxxxxxxxxxx', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-opus-5', 'User')
```

### Método 3: Variáveis de ambiente temporárias

Adequado para testes rápidos — a configuração é perdida quando o terminal é fechado.

**macOS / Linux**

```bash theme={null}
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
export ANTHROPIC_MODEL="claude-opus-5"
export ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"
claude
```

**Windows (PowerShell)**

```powershell theme={null}
$env:ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
$env:ANTHROPIC_MODEL="claude-opus-5"
$env:ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"
claude
```

**Windows (CMD)**

```cmd theme={null}
set ANTHROPIC_API_KEY=sk-xxxxxxxxxxxx
set ANTHROPIC_MODEL=claude-opus-5
set ANTHROPIC_BASE_URL=https://gccai.heqingsong.uk
claude
```

> [!WARNING]
>
> As variáveis de ambiente temporárias funcionam apenas na janela de terminal atual. Você precisará defini-las novamente após mudar de janela ou fechar o terminal.

## Etapa 3: Começar a usar

### Verificar a configuração

Inicie o Claude Code e envie uma mensagem simples para confirmar:

```bash theme={null}
claude "Hello"
```

Se você receber uma resposta da IA, a configuração foi bem-sucedida. Se você vir erros `401`, `403` ou outros, consulte a FAQ abaixo.

### Modos de uso

O Claude Code oferece dois modos de interação:

* **Modo interativo**: Execute `claude` para uma conversa contínua, ideal para tarefas complexas
* **Comando único**: Execute `claude "sua pergunta"` para uma resposta única, ideal para consultas rápidas

### Modelos suportados

O GccAi suporta a série completa de modelos Claude. Você pode alternar flexivelmente com base nas suas necessidades:

| Nome do modelo | Características | Uso recomendado |
| - | - | - |
| `claude-opus-5` | Modelo principal de nova geração | Arquitetura complexa, depuração difícil |
| `claude-opus-4-6` | Forte capacidade geral | Arquitetura complexa, depuração difícil |
| `claude-sonnet-4-6` | Desempenho e velocidade equilibrados | Programação diária, geração de código |
| `claude-opus-4-5-20251101` | Raciocínio avançado | Código complexo, análise profunda |
| `claude-sonnet-4-5-20250929` | Excelente capacidade de código | Design de algoritmos, otimização de código |
| `claude-haiku-4-5-20251001` | Resposta ultrarrápida | Perguntas e respostas rápidas, trechos de código |

Todos os modelos acima suportam uma versão Thinking (raciocínio estendido) — adicione `-thinking` ao ID do modelo, por exemplo, `claude-opus-4-6-thinking`. O modo Thinking é ideal para tarefas complexas que exigem raciocínio profundo.

> [!TIP]
>
> **Recomendações de modelos:**
>
> * 🚀 **Alto desempenho:** `claude-opus-5` — Para os desafios mais complexos de código e arquitetura
> * ⚖️ **Desempenho equilibrado:** `claude-sonnet-4-6` — Para programação diária
> * ⚡ **Resposta rápida:** `claude-haiku-4-5-20251001` — Quando você precisa de feedback instantâneo
> * 🧠 **Pensamento profundo:** `claude-opus-5-thinking` — Quando é necessário raciocínio profundo

Para trocar de modelo, use o comando `/model` no modo interativo, ou modifique o campo `ANTHROPIC_MODEL` na sua configuração e reinicie.

### Comandos comuns

Aqui estão os comandos e atalhos frequentemente usados no Claude Code:

| Comando | Descrição |
| - | - |
| `claude` | Entrar no modo interativo |
| `claude "pergunta"` | Consulta única |
| `claude --version` | Verificar a versão |
| `/model` | Trocar de modelo no modo interativo |
| `/help` | Visualizar informações de ajuda |
| `Ctrl + C` | Sair do modo interativo |

## FAQ

### Q1: Ainda vejo a página de seleção de login após a configuração?

Se "Select login method" ainda aparecer após a inicialização, a configuração não teve efeito.

**Passos para solução de problemas:**

1. **Usando settings.json**: Verifique se o caminho do arquivo está correto
   * Windows: `C:\Users\<username>\.claude\settings.json`
   * macOS / Linux: `~/.claude/settings.json`
2. **Usando variáveis de ambiente**: Certifique-se de ter iniciado o Claude Code na **mesma janela de terminal** onde você definiu as variáveis
3. **Verifique o formato JSON**: Certifique-se de que colchetes, vírgulas e aspas estejam todos corretos

### Q2: Recebendo erros 401 / 403?

| Código de erro | Significado | Solução |
| - | - | - |
| `401 Unauthorized` | Chave de API ausente ou inválida | Verifique se a chave está correta e começa com `sk-` |
| `403 Forbidden` | Permissões insuficientes ou chave expirada | Acesse o [Console](https://gccai.heqingsong.uk/keys) para verificar o status da chave |

Certifique-se também de que `ANTHROPIC_BASE_URL` está definido como `https://gccai.heqingsong.uk`, e não o endereço oficial da Anthropic.

### Q3: Erro "Unable to connect"?

Isso significa que o Claude Code não conseguiu se conectar ao serviço de API.

1. Verifique sua conexão de rede
2. Verifique se `ANTHROPIC_BASE_URL` está configurado corretamente
3. Se estiver usando um proxy, certifique-se de que ele permite o acesso a `gccai.heqingsong.uk`

### Q4: Erro "Auth conflict"?

Se você vir uma mensagem como:

```
Auth conflict: Both a token (claude.ai) and an API key (ANTHROPIC_API_KEY) are set.
```

Isso significa que você está logado no claude.ai e tem uma chave de API definida ao mesmo tempo, causando um conflito.

**Solução:** Execute `/logout` no modo interativo do Claude Code para sair do claude.ai, mantendo apenas a configuração da chave de API.

### Q5: Erro max\_tokens ao usar modelos não-Claude?

Se você vir um erro como:

```
max_tokens is too large: 32000. This model supports at most 16384 completion tokens.
```

Isso ocorre porque o Claude Code envia requisições com parâmetros do modelo Claude por padrão (32000 tokens), enquanto alguns modelos não-Claude (por exemplo, `gpt-4o`) têm limites de tokens mais baixos.

**Solução:** Mude para um modelo Claude (por exemplo, `claude-sonnet-4-6`), que é nativamente compatível com o Claude Code e não causará esse problema.

### Q6: Resposta lenta?

1. Mude para um modelo mais rápido (por exemplo, `claude-haiku-4-5-20251001` ou `claude-sonnet-4-6`)
2. Encurte seus prompts para reduzir o comprimento do contexto
3. Verifique as condições da sua rede

### Q7: Como trocar de modelo?

Duas maneiras:

1. **No modo interativo**: Digite o comando `/model`
2. **Edite a configuração**: Altere o campo `ANTHROPIC_MODEL` em `settings.json` ou nas variáveis de ambiente e reinicie o Claude Code

### Q8: O Claude Code lê arquivos locais automaticamente?

Não. O Claude Code requer que você faça referência aos arquivos explicitamente e pedirá confirmação antes de realizar operações sensíveis. É recomendável usá-lo em diretórios de projeto dedicados.

### Q9: Como analisar arquivos locais com o Claude Code?

No modo interativo, você pode fazer referência a arquivos:

* Digitando o caminho do arquivo diretamente
* Arrastando arquivos para a janela do terminal
* Copiando e colando o conteúdo do arquivo

### Q10: Como verificar o uso e os custos?

Acesse o [Console do GccAi](https://gccai.heqingsong.uk/overview) para visualizar:

* Estatísticas de chamadas de API
* Detalhes de consumo de tokens
* Estatísticas e tendências de custos

## Suporte

Se você encontrar algum problema:

* 📚 [Documentação do GccAi](https://gccai.heqingsong.uk)
* 💬 [Comunidade do Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @GccAi\_](https://x.com/GccAi_)
* 📧 Suporte técnico: [zhihong@gccai.heqingsong.uk](mailto:zhihong@gccai.heqingsong.uk)

***

> **[Comece a usar o GccAi](https://gccai.heqingsong.uk)**
>
> Cadastre-se no GccAi agora, obtenha sua chave de API e experimente o assistente de programação multimodelo no Claude Code!


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.