Claude Code

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.

​

Início Rápido

​

1. Instalar o Claude Code

​

Instalação Local

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

​

Instalar via npm

npm install -g @anthropic-ai/claude-code

​

2. Configurar a API da AIHubMix

1. Defina ANTHROPIC_BASE_URL como https://aihubmix.com
2. Defina ANTHROPIC_AUTH_TOKEN como a chave de API obtida na plataforma AIHubMix
3. Defina ANTHROPIC_MODEL como um modelo suportado da lista de modelos.

echo $SHELL

# Replace AIHUBMIX_API_KEY with the Key obtained from the AIHUBMIX platform
echo 'export ANTHROPIC_BASE_URL="https://aihubmix.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="AIHUBMIX_API_KEY"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5"' >> ~/.zshrc

source ~/.zshrc

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_MODEL

REM Replace AIHUBMIX_API_KEY with your AIHubMix API Key
setx ANTHROPIC_AUTH_TOKEN "AIHUBMIX_API_KEY"
setx ANTHROPIC_BASE_URL "https://aihubmix.com"
setx ANTHROPIC_MODEL "claude-sonnet-4-5"

echo %ANTHROPIC_AUTH_TOKEN%
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

# Replace AIHUBMIX_API_KEY with your AIHubMix API Key
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "AIHUBMIX_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://aihubmix.com", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5", [EnvironmentVariableTarget]::User)

echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL

​

3. Começar

$ cd /path/your-project
> claude

1. Localize o arquivo .claude.json no diretório home do seu usuário, com os seguintes caminhos:
   • macOS / Linux: ~/.claude.json
   • Windows: C:\Users\%USERNAME%\.claude.json
2. Defina o valor do campo hasCompletedOnboarding como true.

{
  "hasCompletedOnboarding": true
}

3. Salve o arquivo e execute novamente claude no terminal.

​

(Opcional) Métodos Adicionais de Configuração de Modelo

1. Durante uma conversa: Execute o comando /model <model_name> para trocar de modelos. Adequado para mudanças temporárias de modelo.

/model claude-sonnet-4-5

2. Ao iniciar o Claude Code: Execute claude --model <model_name> para especificar o modelo. Adequado para uso em uma única sessão.

claude --model claude-sonnet-4-5

3. Definir variáveis de ambiente: Você pode configurar diferentes níveis de modelos com base na complexidade da tarefa. O Claude Code selecionará automaticamente o modelo apropriado com base no tipo de tarefa. Adequado para efeitos globais.

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

• ANTHROPIC_DEFAULT_OPUS_MODEL: Para raciocínio complexo, design arquitetural e outras tarefas de alta dificuldade.
• ANTHROPIC_DEFAULT_SONNET_MODEL: Para codificação, implementação de funcionalidades e outras tarefas de rotina.
• ANTHROPIC_DEFAULT_HAIKU_MODEL: Para verificações gramaticais, buscas de arquivos e outras tarefas simples.

4. Configurar permanentemente no arquivo settings.json: Crie um arquivo settings.json no diretório raiz do projeto ou no diretório home do usuário, e escreva as informações de configuração de modelo para configuração permanente em nível de projeto ou de usuário.

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

​

Configurar via cc-switch

1. Execute o CC-Switch e clique em “Adicionar Provider”.

2. Selecione “AiHubMix” da lista predefinida.

3. Preencha sua chave no campo “API Key”.

4. Após a configuração estar completa, clique em “Adicionar” para salvar as configurações.

5. Retorne à página inicial, selecione “AiHubMix” na lista de providers e clique em “Iniciar” para usá-lo.

​

Configuração através do Plugin do VS Code

1. Execute o VS Code e instale o plugin.

2. Pressione Ctrl + Shift + P (ou Cmd + Shift + P), digite Settings para abrir as configurações.

3. Busque por Claude Code, encontre Claude Code: Environment Variable → Edit in settings.json.

4. Preencha as informações relacionadas à AIHubMix em claudeCode.environmentVariables.

​

Wechat-Agent-SDK

Link de instalação: https://github.com/AIhubmix/wechat-agent-sdk

​

Perguntas Frequentes

​

Q: Ao usar o Claude Code, recebo a mensagem “401, No token provided…”

​

Q: Após instalar com sucesso no macOS, ainda recebo um erro: zsh: command not found: claude

1. Confirme o caminho de instalação do Claude. O script oficial do Claude Code normalmente instala em um dos seguintes diretórios:

• ~/.claude/bin
• ~/.local/bin

ls -l ~/.claude/bin
or
ls -l ~/.local/bin | grep claude

2. Adicione o diretório de instalação ao PATH. Execute o comando correspondente com base na localização real da instalação:

Caso A: Instalado em ~/.claude/bin

echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Caso B: Instalado em ~/.local/bin

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

3. Verifique se ficou efetivo. Execute:

which claude
claude -v

​

Q: Claude Code não consegue se conectar aos serviços da Anthropic

​

Mais Recursos

• Github
• Pacote npm
• Melhores Práticas Oficiais
• Guia Oficial de Configuração

​

Bom desenvolvimento!