KozeKoze
← Voltar ao blog
Tutorial2026年3月23日·管理员

Tutorial de Configuração do Código Claude

Tutorial de Configuração do Código Claude

📋 Etapas Preparatórias

Antes de começar, certifique-se de que você:

  • Tenho registrado uma conta Koze e feito login
  • Tenho criado uma chave de API na página de Gerenciamento de API
  • Tenho instalado o Claude Code (npm install -g @anthropic-ai/claude-code)

🚀 Etapa 1: Configurando Variáveis de Ambiente

Execute os seguintes comandos no terminal para definir o endereço e a chave da API como variáveis de ambiente:

# Defina o endereço do proxy Koze para a URL base
export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1'

# Defina a chave de API que você criou no backend do Koze
export ANTHROPIC_AUTH_TOKEN="Seu" Chave de API"

💡 Dica: Substitua https://api.kozeai.com pelo domínio real do seu serviço. As chaves de API podem ser visualizadas ou criadas na página "Gerenciamento de API → Chaves Existentes".

🔧 Etapa Dois: Configuração do Plugin do VSCode (Opcional)

Se você estiver usando o plugin Claude para VSCode, você precisa configurá-lo em `~/.claude/config.json`:

{

"primaryApiKey": "Sua chave de API",

"apiBaseUrl": "https://api.kozeai.com/v1"

}

Se o arquivo não existir, crie-o manualmente.

  • macOS / Linux: ~/.claude/config.json
  • Windows: C:\Users\Seu Nome de Usuário\.claude\config.json

🎯 Passo 3: Inicie o Claude Code

Após configurar as variáveis de ambiente, inicie-o diretamente no terminal:

claude

O Claude Code usará automaticamente o endereço do proxy Koze que você configurou para fazer requisições.

📌 Variáveis de Ambiente Persistentes

Para evitar a redefinição das variáveis sempre que você abrir o terminal, recomenda-se gravá-las no arquivo de configuração do shell:

# Usuário Bash

echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.bashrc

echo 'export ANTHROPIC_AUTH_TOKEN='sua chave de API' >>> ~/.bashrc

source ~/.bashrc

# Usuário Zsh

echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.zshrc

echo 'export ANTHROPIC_AUTH_TOKEN='sua chave de API' >> ~/.zshrc

source ~/.zshrc

✅ Verificar Conexão

Após iniciar o Claude Code, se você vir uma interface de diálogo normal, a configuração foi bem-sucedida.

Você pode visualizar registros de chamadas em tempo real na página "Estatísticas de Uso" do Koze.

⚠️ Perguntas Frequentes

Problema Solução
Dica: Chave de API Inválida Verifique se a chave de API foi copiada corretamente, garantindo que não haja espaços extras
Tempo limite de conexão Confirme se a URL base está correta e contém o sufixo /v1
Modelo Indisponível Verifique a lista de modelos disponíveis para o pacote atual em Hall de entrada do modelo Koze

 

Tutorial de Configuração do Código Claude | Koze AI