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

> ## Agent Instructions
> JieKou AI model APIs are OpenAI-compatible. Base URL for users in mainland China (direct, no VPN): https://api.highwayapi.ai/openai; elsewhere: https://api.jiekou.ai/openai. Anthropic-compatible base URL: https://api.highwayapi.ai/anthropic or https://api.jiekou.ai/anthropic.
> Authenticate with `Authorization: Bearer <API_KEY>`; with Anthropic SDKs or Claude Code, pass the same key as `ANTHROPIC_AUTH_TOKEN`. Users create keys at https://jiekou.ai/settings/key-management. Never print or hardcode a real key.
> Get current model IDs from GET https://api.jiekou.ai/openai/v1/models instead of reusing model names from memory.

# Zcode

## O que é o Zcode?

O ZCode é um Agentic Development Environment (ADE) que traz o GLM para fluxos de trabalho reais de programação, ajudando você a transformar o contexto longo, as tarefas de longa duração e as capacidades de programação agêntica do GLM em uma experiência de desktop estável e utilizável, cobrindo planejamento, codificação, revisão e iteração em tarefas complexas de desenvolvimento.

Com base na capacidade estável de contexto e de tarefas de longa duração da série de modelos GLM, o ZCode Agent pode manter objetivos, arquivos, resultados do terminal, contexto do navegador, modos de execução e estado do Git na mesma tarefa, permitindo que tarefas complexas de desenvolvimento avancem do planejamento até a implementação e a conclusão da validação, sem perder a continuidade.

O ZCode passou por integração profunda e otimizações específicas em torno da série GLM, com foco nas capacidades do ZCode Agent desenvolvido internamente. Modelos, ferramentas e fluxos de trabalho de execução estão mais integrados, permitindo que tarefas complexas de desenvolvimento avancem do planejamento até a conclusão da validação dentro do mesmo contexto.

Com instruções em linguagem natural, você pode fazer com que o ZCode Agent lide com codificação, depuração, testes, pré-visualização de projetos e revisão de alterações; e, por meio do workspace de desktop, do Remote e do Bot Channel, também é possível acompanhar o progresso continuamente e adicionar novas instruções durante a execução de tarefas longas.

Atualmente, o ZCode organiza a experiência de desenvolvimento em torno do ZCode Agent desenvolvido internamente e realizou uma adaptação profunda aos modelos da série GLM, com reforço especial nas seguintes capacidades:

* Integração profunda com o GLM: várias rodadas de refinamento em torno das capacidades do modelo, das chamadas de ferramentas e do fluxo de execução, tornando o Agent mais adequado para tarefas reais de desenvolvimento contínuas e de múltiplas etapas.
* Execução de tarefas longas: conclua a compreensão de requisitos, a decomposição de planos, as modificações de código, a validação e o Review na mesma tarefa, reduzindo as interrupções causadas por trocas frequentes de contexto.
* Manutenção estável do contexto: combinando a capacidade de contexto longo do GLM, lê continuamente arquivos, terminal, navegador, modos de execução e estado do Git, aprimorando a capacidade de raciocínio contínuo em tarefas de longa duração.
* Fluxo de trabalho de Agent próprio: tarefas, permissões, contexto, chamadas de ferramentas e fluxos de commit são todos organizados em torno do ZCode Agent, permitindo que as saídas do modelo se traduzam de forma mais natural em operações reais de engenharia.
* Acompanhamento contínuo em múltiplos dispositivos: o desktop, o Remote no celular e os Bots do Feishu / WeChat podem avançar em conjunto as tarefas do mesmo workspace.
* Seguro e controlável: comandos críticos, modificações de arquivos e operações de alto privilégio passam por um fluxo de confirmação antes da execução.

## Como integrar a Interface AI ao Zcode?

### Obter a API Key

1. Acesse o site oficial jiekou.ai e registre-se.

2. Acesse o painel de administração, clique em "Meu perfil" no canto superior direito e selecione "Gerenciamento de chaves de API" na lista suspensa.

   ![](https://mintcdn.com/jiekou/woskTYHkYOH0CRpH/images/zcode-01.png?fit=max\&auto=format\&n=woskTYHkYOH0CRpH\&q=85\&s=d5dae2d90e86ef1f5c78e115d985af38)

3. Clique em "Criar" e insira o nome da chave. Recomenda-se usar um nome fácil de identificar, para facilitar a distinção entre chaves de diferentes finalidades no console posteriormente.

   ![](https://mintcdn.com/jiekou/woskTYHkYOH0CRpH/images/zcode-02.png?fit=max\&auto=format\&n=woskTYHkYOH0CRpH\&q=85\&s=318a702309c7e8be5757b8ea643b0d6e)

4. Clique em copiar e anote a Key gerada. Ela não poderá ser visualizada novamente no console, portanto guarde-a com segurança para uso futuro.

### Integrar a Interface AI ao Zcode

1. Após instalar o Zcode, abra-o e clique em Configurações → Configurações de modelo → Adicionar provedor → Criar provedor personalizado

   ![](https://mintcdn.com/jiekou/TQxWIVZT1BEyadAo/images/zcode-03.png?fit=max\&auto=format\&n=TQxWIVZT1BEyadAo\&q=85\&s=74a250039f33a55a32e6fc3bffd8e03b)

2. Insira a API Key copiada anteriormente, preencha a URL e selecione o formato de API (API Endpoint) adequado ao modelo que você deseja chamar

* URL de conexão direta (China): [https://api.highwayapi.ai/openai](https://api.highwayapi.ai/openai)
* URL internacional: [https://api.jiekou.ai/openai](https://api.jiekou.ai/openai)

  ![](https://mintcdn.com/jiekou/TQxWIVZT1BEyadAo/images/zcode-04.png?fit=max\&auto=format\&n=TQxWIVZT1BEyadAo\&q=85\&s=4a704458c6de34f59e4e6722e9b758bc)

3. Adicione o modelo: copie o ID do modelo da Interface AI para o campo de entrada "ID do modelo"; o Zcode fará a correspondência automática das propriedades relacionadas ao modelo. Clique em salvar e o modelo poderá ser chamado nas conversas

   ![](https://mintcdn.com/jiekou/TQxWIVZT1BEyadAo/images/zcode-05.png?fit=max\&auto=format\&n=TQxWIVZT1BEyadAo\&q=85\&s=31978a11c94088d0c165bb906e2887dc)

![](https://mintcdn.com/jiekou/TQxWIVZT1BEyadAo/images/zcode-06.png?fit=max\&auto=format\&n=TQxWIVZT1BEyadAo\&q=85\&s=667613f54137f6875b87c6974aa60767)


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