Provedores de IA, modelos e chaves

O que é e como abrir

Toda a configuração de IA fica em um só lugar: abra Configurações e entre na seção IA. Nada ali exige um plano, e nada é uma assinatura de IA do PocketCode: você conecta suas próprias contas e o app fala diretamente com elas. Estas são as linhas, na ordem em que o app as mostra.

Atalhos a partir do chat

• Em um chat vazio e sem provedor, o cartão Nenhum serviço de IA configurado tem um botão Configurar serviços de IA que abre a lista de chaves.
• No seletor de modelos do chat, um provedor sem chave mostra Falta a chave e Toca para a adicionar; ao tocar, abre-se a linha desse provedor.
• Os dois atalhos abrem o painel de chaves diretamente, sem pedir a digital. O pedido só protege a linha Chaves API das Configurações.

Provedores e como você entra

O PocketCode tem cinco tipos de provedor. Quatro são serviços com nome; o quinto, Endpoint próprio, é qualquer servidor que fale a API da OpenAI. O painel Chaves API os lista nessa ordem e acrescenta uma sexta linha, GitHub (git ops), em Operações Git. Essa não é IA: guarda o token que o cliente Git do app usa para push, pull e clone, e o chat de IA nunca o usa. Cada linha diz Configurada ou Não configurado.

Adicionar uma chave (OpenAI, Gemini, Claude)

1. 1Abra Configurações → IA → Chaves API e toque na linha do provedor. No caso da OpenAI, fique na aba Chave de API.
2. 2Passo 1, Obtenha sua chave. O app diz onde criá-la e com o que ela começa (OpenAI: platform.openai.com/api-keys, Gemini: aistudio.google.com/apikey, Claude: console.anthropic.com/settings/keys). O link logo abaixo abre essa página.
3. 3Passo 2, Cole aqui. Cole a chave no campo, ou use Colar da área de transferência. O app limpa o que você cola (espaços, aspas, Bearer , NOME=valor, JSON) e avisa na hora se o formato parecer errado, por exemplo uma chave do Claude no campo da OpenAI.
4. 4Toque em Verificar e salvar. O app envia uma requisição pequena ao provedor para verificar a chave e depois a salva. Chaves que o provedor rejeita nunca são salvas.

O que “Verificar e salvar” faz

Sua chave: verificar, substituir, remover

Com uma chave salva, ao tocar na linha você vê Sua chave: uma impressão da chave (os primeiros caracteres e os quatro últimos, nunca ela inteira), quando foi verificada pela última vez e o resultado.

OpenAI com a sua conta do ChatGPT

A linha OpenAI tem duas abas: Chave de API (a recomendada, funciona com qualquer conta) e Conta ChatGPT. A segunda entra na sua própria conta do ChatGPT e gasta a sua assinatura do ChatGPT em vez de uma fatura de API. Por baixo, o app executa o CLI do Codex da OpenAI, que vem dentro do app: todo turno da OpenAI passa por ele, e a lista de modelos é a que o Codex aceita para a sua conta. O seletor rotula essa seção como OpenAI · via Codex.

GitHub Copilot

A linha GitHub Copilot tem um único método, Device Flow do GitHub. Você precisa de uma assinatura paga ativa do Copilot: você usa os modelos que o seu plano inclui, cobrados pelo GitHub. O app fala com o Copilot por meio do language server do Copilot que vem no app.

Gemini, e o login do Google desativado

O Gemini funciona só com uma chave de API. O Google encerrou o login no Gemini CLI com conta Google para contas individuais (gratuita, AI Pro e AI Ultra) em 18 de junho de 2026, então uma chave do AI Studio é o caminho, e o AI Studio oferece chaves gratuitas com limites definidos pelo Google. Se uma versão anterior do PocketCode tinha salvo um login do Google para você, a linha do Gemini diz Login do Google desativado — adicione uma chave de API: abra-a, leia o aviso e toque em Remover o login antigo do Google, ou simplesmente salve uma chave do Gemini, que o apaga.

Modelos

Quais modelos você pode usar depende das suas chaves. Você escolhe o modelo no seletor de modelos do chat; os ajustes desta página decidem o que o seletor mostra e qual modelo as tarefas em segundo plano usam.

De onde vem a lista de modelos

• Com uma chave de API, o app pede ao provedor a lista de modelos dele, então um modelo novo aparece assim que o provedor o publica. O app mantém a versão mais recente de cada família de modelos e recolhe as mais antigas em Mostrar N versões antigas; a OpenAI mostra só modelos de chat.
• Catálogo remoto. O app também lê um pequeno manifesto hospedado pelo PocketCode (pocketcodeapp.com/models.json) com nomes, descrições, limites de saída e marcas de raciocínio e visão, para que um modelo novo possa ser adicionado sem lançar uma versão do app. É atualizado a cada 6 horas, a última cópia boa é mantida para quando você está offline, e uma lista embutida é o último recurso.
• Login do ChatGPT: os modelos que o Codex aceita para a sua conta. Copilot: a lista ao vivo do language server do Copilot para a sua conta. Endpoint próprio: o /v1/models do próprio endpoint.
• Um provedor sem chave mostra Falta a chave · Toca para a adicionar no seletor.

O seletor de modelos do chat

Toque no nome do modelo no cabeçalho do chat. Ele abre em Recentes se você tem modelos recentes, senão em Todos.

• Recentes (os últimos 5 modelos com que você enviou um turno), Favoritos (toque na estrela de um modelo) e Todos (uma seção por provedor conectado e uma por endpoint próprio salvo).
• Pesquisar em todos os modelos procura em todos os provedores de uma vez.
• Cada linha mostra o modelo, seu id e a janela de contexto, e os chips Visão, Raciocínio e Grátis. Grátis só aparece em ids que terminam em :free, a convenção da OpenRouter para modelos sem custo: não significa grátis no PocketCode.
• Recarregar modelos recarrega a lista de um provedor; modelos aposentados ficam esmaecidos com (retirado); os modelos que raciocinam têm um seletor de Esforço de raciocínio (Desativado, Baixo, Médio, Alto).
• Escolher um modelo de um endpoint próprio salvo troca o chat para esse endpoint. Adicionar um endpoint personalizado (LM Studio, Ollama, OpenRouter…) fica no fim.

Você não pode, e por quê

• Entender Grátis como gratuito no PocketCode: ele só reflete o sufixo :free da OpenRouter.De propósito
• Ver um modelo que você ocultou nas Configurações: os modelos ocultos são ignorados, exceto o que está em uso.De propósito

Modelos visíveis

Configurações → IA → Modelos visíveis (“Arruma o seletor de modelos do chat”) lista os modelos agrupados por provedor.

Modelo por tarefa

As tarefas de IA em segundo plano, as que não são o chat, escolhem o próprio modelo. Configurações → IA → Modelo por tarefa tem dois níveis: um modo global e uma fixação por tarefa.

Endpoint próprio

Endpoint próprio conecta qualquer servidor que fale a API da OpenAI; a legenda da linha é “OpenRouter, Groq, DeepSeek, Ollama e mais de 170”. O painel mostra um passo por vez: escolher e depois configurar.

1. 1Abra Configurações → IA → Chaves API → Endpoint próprio.
2. 2Escolher. Escolha um provedor em Provedores na nuvem, ou um dos três atalhos em No seu computador. Procurar fornecedor lista todos os provedores compatíveis com a OpenAI para os quais o catálogo público models.dev tem uma URL base (mais de 170, uma lista ao vivo, não um número fixo). Os já conectados ficam em Ligados.
3. 3Configurar. O provedor escolhido e a chave dele: Mudar volta atrás, depois vem o campo Chave de API. Definições avançadas mostra a URL base, já preenchida e editável para o seu próprio servidor.
4. 4Toque em Testar conexão para experimentar sem salvar nada: ele pede ao endpoint a lista de modelos e mede a demora. Depois Ligar (ou Salvar, ao editar).

No seu computador e na nuvem

Provedores na nuvem mostra dez serviços populares com as URLs já preenchidas: OpenRouter, Groq, DeepSeek, Together AI, Mistral, xAI, Cerebras, Fireworks AI, DeepInfra e Perplexity.

Chaves, vários endpoints e modelos

A chave de API só é opcional em servidores locais: localhost e endereços de loopback, 0.0.0.0, endereços de rede privada, nomes .local e a rede Tailscale (*.ts.net). Para qualquer outro, o painel pede “Insira a chave de API”.

Uso, diagnóstico e ajustes

Dois painéis ajustam um provedor. Uso e ajustes é a visão completa; Definições por fornecedor é um atalho para o último bloco dele, que não pede a digital.

Uso e ajustes

Períodos do uso registrado

Diagnóstico

Cada nível inclui os anteriores e para na primeira falha grave, então nunca gasta tokens quando uma verificação gratuita já achou o problema.

O que o painel pode e não pode fazer

É um painel só, com rolagem, não abas.

Ajustes por provedor

Configurações → IA → Definições por fornecedor tem uma faixa de cinco chips (OpenAI, Gemini, Claude, Copilot, Custom). O que você não mexer mantém o padrão do provedor, e Reset devolve um controle ao padrão. O painel só oferece os controles que cada provedor tem.

• Definir Max tokens acima do limite do modelo ativo, ou ajustar um parâmetro que o provedor não tem.De propósito

Servidores MCP

Configurações → IA → Servidores MCP conecta servidores externos de ferramentas pelo Model Context Protocol. As ferramentas deles são oferecidas ao modelo junto com as do próprio PocketCode, com Claude, Gemini, OpenAI, endpoints próprios e Copilot, com o nome <server id>__<tool>. Os servidores são programas que rodam no seu celular, por meio do runtime Node.js que vem no app.

Adicionar e gerenciar servidores

O painel começa vazio: “Ainda não há servidores MCP. Toque em “Adicionar” para conectar um — ex.: node /sdcard/mcp/server.js.”

Limites de um servidor

Ajustes do Swarmcode e do Cortex

Configurações → IA → Swarmcode configura o modo multiagente do chat, em que vários agentes trabalham em paralelo no seu pedido e, com a verificação ativada, um painel de juízes confere a resposta antes de ela ser mostrada. Abrir e editar o painel é grátis; executar o Swarmcode exige Pro, com 2 execuções grátis de teste. Como usá-lo está em Chat de IA.

Missões de um toque

Interruptores e ajuste fino

Os cartões de missão preenchem os valores abaixo. Se você mudar um à mão, o cartão deixa de ficar marcado.

Cortex

Privacidade e segurança

O que o app guarda, onde, e o que sai do celular:

• As chaves são criptografadas no dispositivo. AES-256-GCM, com uma chave guardada no Android Keystore (StrongBox quando o celular tem). São guardadas por conta: sair não apaga nada, e outra conta no mesmo celular não consegue lê-las.
• O painel de chaves protege a tela. Capturas de tela e a prévia de apps recentes são bloqueadas, e uma chave salva só é mostrada como impressão.
• O pedido de digital é uma porta, não um cofre. Ele protege a abertura de Chaves API a partir das Configurações. Não cobre os atalhos do chat, e a própria chave do Keystore não pede nada a cada uso, então o app pode usar suas chaves em segundo plano.
• Direto ao provedor. As requisições vão do seu celular para a API do provedor (Claude, OpenAI, Gemini), para o seu próprio servidor (Endpoint), para o GitHub pelo language server do Copilot, ou para a OpenAI pelo CLI do Codex. O PocketCode não tem proxy de IA nem cópia das suas chaves.
• O que vai para o servidor do PocketCode: só o catálogo de modelos (pocketcodeapp.com/models.json; pedir esse catálogo informa ao nosso servidor que o app está aberto, com o seu endereço IP) e, se você denunciar uma resposta de IA, essa denúncia. A lista de provedores e preços para endpoints próprios vem do catálogo de terceiros models.dev.
• O uso registrado fica guardado no dispositivo e conta só o que os provedores devolveram. Os segredos são criptografados por conta e nunca são mostrados nem enviados ao PocketCode.
• As permissões de ferramentas falham fechadas: se não puderem ser lidas, a ferramenta é recusada.

Zero-egress (IA sem rede)

Configurações → IA → Zero-egress (IA sem rede): “Quando ligado, o app não faz chamadas de rede à IA — tudo fica no dispositivo. Os modelos online ficam desativados até você desligar.” Um aviso confirma: “Zero-egress ligado — IA na nuvem desativada”.

Consentimento antes de enviar

A primeira vez que você manda algo a um provedor, o chat pergunta Enviar para …?: “Para responder, o PocketCode envia a tua mensagem e o código ou ficheiros que anexares para … — um fornecedor de IA externo — pela internet. Evita partilhar segredos ou dados pessoais que não queiras que sejam processados.” Você pode Enviar ou Cancelar.