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

# Claude Code com qualquer LLM

> Use o Claude Code com qualquer modelo grande da plataforma Aihubmix, eliminando completamente a instabilidade de conexão e as dificuldades para comprar cota. O serviço de encaminhamento da Aihubmix é baseado em canais oficiais, compatível e seguro, sem se preocupar com riscos para sua conta ou restrições ocultas.

<Warning>
  1. Devido à natureza multi-agente do Claude Code, o consumo de cota pode ser significativo. Recomendamos definir cotas limitadas para sua chave para evitar surpresas na fatura.
  2. Certifique-se de que sua VPN local esteja desativada durante o uso, caso contrário você pode experimentar lentidão com o GPT-5.
</Warning>

## Guia de Configuração Rápida

### 1️⃣ Instalação Global do Pacote npm

Execute no terminal:

```shell theme={null}
npm install -g @aihubmix/claude-code@latest
```

### 2️⃣ Definir Variáveis de Ambiente do Sistema (Recomendado)

Substitua `sk-***` pela sua [chave de API](https://aihubmix.com/token) gerada na AiHubMix. Itens de configuração que não sejam modelos serão processados com as variáveis de ambiente do sistema tendo prioridade.

```
export AIHUBMIX_API_KEY="sk-***"
export HOST="127.0.0.1"  # Optional
export PORT="3456"        # Optional
export LOG="true"         # Optional
export API_TIMEOUT_MS="30000"  # Optional
```

<Tip>
  * Para usuários de Mac, você pode navegar até o diretório do seu `username` e pressionar `⌘ + ⇧ + .` para mostrar o arquivo oculto .zshrc, depois abri-lo com o aplicativo "TextEdit" do sistema e adicionar o conteúdo acima.
  * Após adicionar a configuração, execute `source ~/.zshrc` no terminal e pressione Enter para tornar a configuração efetiva.
</Tip>

### 3️⃣ Gerar Arquivo de Configuração

Substitua o `sk-***` abaixo pela sua chave de API AiHubMix, depois execute este one-liner no terminal:

```shell theme={null}
mkdir -p ~/.aihubmix-claude-code && cat > ~/.aihubmix-claude-code/config.json <<EOF
{
  "API_KEY": "sk-***",
  "HOST": "127.0.0.1",
  "PORT": 3456,
  "LOG": true,
  "API_TIMEOUT_MS": 30000,
  "Router": {
    "default": "gpt-5",
    "background": "claude-3-5-haiku-20241022",
    "think": "gpt-5",
    "longContext": "gpt-5",
    "longContextThreshold": 60000,
    "webSearch": "gemini-2.0-flash-search"
  }
}
EOF
```

### 4️⃣ Uso

<CodeGroup>
  ```shell Start Service theme={null}
  acc start
  ```

  ```shell Stop Service theme={null}
  acc stop
  ```

  ```shell Run CC theme={null}
  acc code
  ```

  ```shell Restart Service (needed after configuration changes) theme={null}
  acc restart
  ```

  ```shell Status Check theme={null}
  acc status
  ```

  ```shell Show Help theme={null}
  acc help
  ```

  ```shell Check Version theme={null}
  acc version
  ```
</CodeGroup>

## Mais Recursos

* [Encaminhamento do Claude Code](/en/api/Claude-Code)
* [Github](https://github.com/inferera/aihubmix/blob/main/packages/claude-code/README.md)
* [Pacote npm](https://www.npmjs.com/package/@aihubmix/claude-code)
* [Melhores Práticas Oficiais](https://www.anthropic.com/engineering/claude-code-best-practices)
* [Guia Oficial de Configuração](https://docs.anthropic.com/en/docs/claude-code/settings#settings-files)
* [Claude Code: Um Assistente de Codificação Altamente Agêntico](https://www.deeplearning.ai/short-courses/claude-code-a-highly-agentic-coding-assistant/)

***

Última atualização: 2026-06-01