Tutorial de configuração do ZCode: conectar à API do NextHub
O ZCode é o ambiente de desenvolvimento de agentes (ADE) lançado pela Zhipu. Ele permite adicionar qualquer serviço de modelo compatível com os protocolos Anthropic / OpenAI como provedor personalizado. Depois de configurar o NextHub, você pode usar os modelos Claude e GPT diretamente no ZCode.
Etapas para conectar
1. Instalar o ZCode
Acesse o site oficial do ZCode para baixar o instalador de Windows / macOS / Linux e conclua a instalação. Na página de boas-vindas da primeira execução você pode pular a conexão de conta e entrar direto na interface principal.
2. Entrar nas configurações de modelo
Clique no nome do modelo na caixa de entrada → Gerenciar modelos (ou entre no painel de Configurações de modelo pelas configurações) e clique em Adicionar provedor na parte inferior da lista de provedores à esquerda.
3. Preencher as informações do provedor (canal Claude)
| Campo | Conteúdo |
|---|---|
| Nome | NextHub |
| Protocolo de interface | Anthropic |
| Endereço da interface (Base URL) | https://api.nexthub.cc |
| API Key | sua ApiKey do NextHub (grupo da família Claude) |
A Base URL não deve levar /v1
O endereço da interface do protocolo Anthropic segue o mesmo critério do ANTHROPIC_BASE_URL do Claude Code: preencha o domínio puro https://api.nexthub.cc, sem acrescentar /v1 no final — o caminho da interface Messages é concatenado automaticamente pelo ZCode.
4. Adicionar o modelo e habilitar
Clique em Adicionar modelo, preencha manualmente o ID do modelo suportado por esse serviço, por exemplo claude-opus-5-5, claude-fable-5 (a lista completa está em Canais e modelos, e vale o que estiver em tempo real no Model Plaza). Depois de salvar, ative a chave de habilitação do provedor.
5. Verificar
Volte para a caixa de diálogo, selecione o modelo recém-adicionado no seletor de modelos, envie uma mensagem e, se receber uma resposta, a conexão foi feita com sucesso.
Também dá para conectar o canal GPT
Adicione mais um provedor: em protocolo de interface escolha OpenAI, em endereço da interface coloque https://api.nexthub.cc/v1 (com /v1), use como API Key a chave do grupo GPT-Azure (0.47x) ou GPT-Pro (0.11x) e preencha os IDs de modelo gpt-5.6, gpt-6-astra etc. Os dois provedores podem coexistir, e você alterna entre eles a qualquer momento no seletor de modelos.
Problemas comuns
A configuração de provedor do ZCode e as variáveis de ambiente do terminal são duas entradas independentes e não se sincronizam. Se a conexão ficar girando sem parar, verifique primeiro se o endereço da interface não tem um caminho sobrando — no protocolo OpenAI o ZCode concatena /chat/completions automaticamente, e um caminho extra no endereço gera 404; o ID do modelo precisa ser exatamente igual ao da lista de modelos.