Instruções personalizadas do ChatGPT para programar: o que declarar e testar

As instruções personalizadas do ChatGPT são o lugar certo para fixar a sua linguagem e as versões, as convenções de código, o formato de resposta (diff, bloco único ou explicação curta) e o que o modelo deve evitar. Segundo a central de ajuda da OpenAI sobre instruções personalizadas, elas passam a valer na hora em todos os chats, existem em todos os planos e funcionam na Web, no Desktop, no iOS e no Android. Se o trabalho se repete num repositório específico, use as instruções de projeto. Elas valem só dentro daquele projeto e passam por cima das globais.
Por que isso importa para quem programa? Sem contexto fixo, cada chat começa do zero. Aí você pede uma função e recebe Python quando trabalha com TypeScript, ou o arquivo inteiro reescrito quando só queria mudar três linhas.
A ideia é a mesma de um .editorconfig ou de um lint configurado no repositório: você define a regra uma vez e para de repetir. Só que aqui a regra é para o assistente.
O que você precisa antes de configurar
O básico é uma conta do ChatGPT em qualquer plano, porque tanto as instruções personalizadas quanto os Projetos existem em todos (instruções, Projetos). Se você acessa por navegador, vale confirmar que está no site oficial do ChatGPT antes de colar qualquer coisa sobre o seu trabalho.
Depois, se liga no limite de texto, que muda por plano conforme a central de ajuda:
| Plano | Limite das instruções personalizadas |
|---|---|
| Free e Go | até 1.500 caracteres |
| Plus, Pro, Enterprise, Business e Education | até 5.000 caracteres |
Também ajuda ter em mãos a sua stack real: linguagem, runtime, framework, banco e ferramenta de testes, com as versões que você usa de fato. Instrução genérica gera resposta genérica.
E um aviso de privacidade importante. A OpenAI informa que o que você escreve nas instruções personalizadas pode ser usado para melhorar os modelos, a não ser que você tenha desligado isso nos controles de dados (fonte). Então nada de chave de API, token, senha ou nome interno sensível de cliente ali dentro.

Black Week do Nexus
A formação de IA mais completa do Brasil
- 7 formações · 112 cursos · 26 mil alunos
Como configurar as instruções personalizadas para programar, passo a passo
O caminho é: ativar a personalização, escrever um bloco curto com stack, estilo, formato e proibições, e deixar a personalidade só para o tom.
- Ative a personalização. Na Web e no Desktop, vá em Settings > Personalization, ligue "Enable customization" e escreva no campo Custom Instructions. No iOS e no Android, o caminho é Settings > Customize ChatGPT, também ligando "Enable customization" (fonte).
Erro comum deste passo: escrever tudo de uma vez sem olhar o limite. No Free ou no Go, o texto passa de 1.500 caracteres e você precisa cortar. Por isso o modelo lá embaixo foi pensado para caber nesse teto.
- Declare linguagem e versões. Diga qual é a linguagem principal, o runtime, o framework e o banco. As versões são as SUAS, as que estão no
package.json, norequirements.txtou equivalente. Não copie números de exemplo de ninguém, nem deste post.Stack principal: TypeScript <sua versão>, Node.js <sua versão>, React <sua versão>. Banco: PostgreSQL <sua versão>.Erro comum deste passo: colocar aqui o nome e os detalhes de um repositório específico. A instrução global vale para todos os chats, então essa informação contamina conversas que não têm nada a ver com aquele projeto. Isso vai para um Projeto (mais abaixo).
- Defina as convenções de estilo. Pense no que você corrigiria num code review: padrão de nomes, nível de tipagem, framework e padrão de testes, idioma dos comentários.
- Nomes de variáveis e funções em inglês, camelCase. Componentes em PascalCase. - Tipagem explícita, sem any. - Testes com <seu framework de testes>, no mesmo padrão do projeto. - Comentários em português, só quando explicarem o porquê. - Escolha um formato de resposta padrão. Aqui mora boa parte do ganho. Defina o formato padrão e diga quando o modelo pode fugir dele. Diff funciona bem para mudança em arquivo existente. Bloco único completo funciona bem para código novo. Explicação curta antes do código ajuda quando você quer entender a decisão sem ler um textão.
- Explicação curta (até 3 frases) antes do código. - Mudança em arquivo existente: responda em diff. - Código novo: um único bloco completo. - Liste o que evitar. É o guardrail (limite) da instrução. Bibliotecas que você não quer no projeto, reescrever arquivo inteiro sem pedir, inventar funções ou APIs, e responder no chute quando falta contexto.
- Não sugira bibliotecas novas sem eu pedir. Nunca use <biblioteca que você não quer>. - Não reescreva o arquivo inteiro quando a mudança for pontual. - Não invente funções, métodos ou APIs. Se não tiver certeza de que existe, diga. - Se faltar contexto (versão, arquivo, erro completo), pergunte antes. - Ajuste o Base style and tone, sabendo o que ele faz. A personalidade muda só o jeito de se comunicar. Na Web ela fica em Settings > Personalization > Base style and tone, com as opções Default, Professional, Friendly, Candid, Quirky, Efficient, Nerdy e Cynical (fonte). No iOS e no Android, ela aparece em Settings > Customize ChatGPT (fonte).

VPS Hostinger para seu sistema
10% OFF extraVPS com SSD NVMe e backups semanais. O cupom MATHEUSHORADECODAR é aplicado automaticamente pelo link.
Ver planos com 10% OFF →Erro comum deste passo: escolher uma personalidade mais direta e esperar que isso resolva o formato. Ela não define stack nem formato de resposta. Diff, bloco único e proibições continuam sendo trabalho do campo Custom Instructions.
Modelo completo para colar e adaptar
Juntando os passos, o bloco fica assim. É um modelo didático: troque cada marcador <...> pela sua realidade e apague o que não se aplica. Ele foi escrito para caber no limite de 1.500 caracteres, mas confira a contagem depois de preencher, porque nomes longos de versão e biblioteca aumentam o texto.
Contexto: sou dev web.
Stack principal: TypeScript <sua versão>, Node.js <sua versão>, React <sua versão>.
Banco: PostgreSQL <sua versão>.
Estilo de código:
- Nomes de variáveis e funções em inglês, camelCase. Componentes em PascalCase.
- Tipagem explícita, sem any.
- Testes com <seu framework de testes>, no mesmo padrão do projeto.
- Comentários em português, só quando explicarem o porquê.
Formato de resposta:
- Explicação curta (até 3 frases) antes do código.
- Mudança em arquivo existente: responda em diff.
- Código novo: um único bloco completo.
- Se eu pedir só explicação, não mande código.
Evite:
- Sugerir bibliotecas novas sem eu pedir. Nunca use <biblioteca que você não quer>.
- Reescrever o arquivo inteiro quando a mudança for pontual.
- Inventar funções, métodos ou APIs. Se não tiver certeza de que existe, diga.
- Responder no chute: se faltar contexto (versão, arquivo, erro completo), pergunte antes.
Repare que não tem nada de repositório específico ali. É preferência que vale para qualquer código que você escreve.
Instruções globais, memória ou Projeto: onde colocar cada informação
O critério é simples: quanto mais específica a informação, mais perto do trabalho ela deve morar.
- Instrução global: preferências que valem para qualquer código. Formato de resposta, estilo e o que evitar entram aqui.
- Memória salva: é o que você pediu explicitamente para o ChatGPT lembrar. Ela entra no contexto como as instruções personalizadas e continua sendo considerada até você apagar. Os controles ficam em Settings > Personalization > Memory, onde você liga, desliga e vê o resumo do que foi lembrado (fonte).
- Projeto: um repositório ou um trabalho longo. Projetos reúnem chats, arquivos de referência e instruções próprias (fonte).

Crie sistemas com IA para vender
Prompts, modelos e checklists para criar e publicar seu sistema com IA e preparar a oferta para o primeiro cliente.
Quero o e-book gratuito Receba o livro e os bônus no seu e-mail.Tome cuidado com a memória salva: como ela fica valendo até ser apagada, um "lembra que estou usando a lib X" de meses atrás pode continuar influenciando respostas de hoje. Vale passar em Settings > Personalization > Memory de vez em quando e limpar o que ficou velho.
Como usar um Projeto para um repositório
Para adicionar as instruções do projeto, abra o menu de três pontos no canto superior direito do projeto e vá em Project settings. Essas instruções valem só ali dentro e passam por cima das instruções personalizadas globais (fonte).
É ali que entram o nome do repositório, a estrutura de pastas, a versão exata do framework daquele sistema e as convenções que só ele tem.
Também dá para colocar material de referência subindo PDFs, planilhas, documentos e imagens, ou colando texto. O limite de arquivos por projeto, segundo a mesma página, é este:
| Plano | Arquivos por projeto |
|---|---|
| Free | até 5 |
| Go e Plus | até 25 |
| Edu, Pro, Business e Enterprise | até 40 |
Com limite baixo, escolha bem: um resumo de arquitetura e um guia de convenções costumam render mais que despejar arquivos soltos.
Se você quer que um projeto não puxe nada de fora, existe a memória restrita ao projeto (project-only). Com ela, os chats usam como contexto as conversas daquele projeto e não puxam memórias nem conversas de fora (fonte). Isso evita que o contexto de um freela vaze para o sistema da empresa, por exemplo.
Como testar se o ChatGPT está seguindo suas instruções
Não confie na sensação. Faça um teste controlado, comparando o mesmo pedido com e sem as instruções.
- Faça um pedido neutro num chat novo. Abra um chat novo e peça algo simples sem citar a linguagem, como "escreva uma função que valida um e-mail". Confira se a resposta veio na stack declarada, com o estilo de nomes e tipagem que você pediu, e no formato padrão (explicação curta e um bloco único, no caso do modelo acima). Depois peça uma alteração nessa função e veja se ela vem em diff, como manda a instrução.
- Compare um chat temporário Unpersonalized com um Personalized. Ao abrir um chat temporário, você escolhe Personalized ou Unpersonalized antes da primeira mensagem, e essa escolha não muda depois. Só o Personalized usa as instruções personalizadas (fonte). Mande exatamente o mesmo prompt nos dois e compare. Como os chats temporários não usam as memórias que já existem nem criam memórias novas (fonte), a diferença entre as duas respostas aponta para o efeito das instruções, sem memória no meio.
- Repita o teste dentro de um Projeto. Se o projeto tem instruções próprias que contradizem as globais (por exemplo, outra linguagem ou outro formato), mande o mesmo pedido neutro num chat do projeto. A resposta deve seguir o projeto, já que as instruções dele passam por cima das globais.
Erro comum deste passo: tirar conclusão a partir de um chat comum em que uma memória salva ou a instrução de um projeto está interferindo. Se o resultado ficou estranho, volte ao teste do chat temporário para isolar a causa.
Se o modelo ignorar uma regra no teste, reescreva aquela linha de forma mais concreta. "Responda em diff quando eu mandar código existente" funciona melhor que "seja objetivo", porque dá um critério que dá para conferir.
Um detalhe que confunde bastante: quem abre o chat por link compartilhado não vê as suas instruções personalizadas (fonte). Então, se você manda o link para um colega, ele não sabe por que a resposta veio em diff ou em determinada stack. Se isso importar, explique junto.
Próximo passo
Escreva agora a primeira versão da sua instrução usando o modelo acima, dentro do limite do seu plano, e troque todos os marcadores pela stack real.
Em seguida abra dois chats temporários, um Personalized e um Unpersonalized, e mande o mesmo pedido neutro nos dois. Se a diferença não aparecer, a instrução precisa ficar mais concreta.
Por fim, pegue tudo o que você escreveu e que só vale para um repositório e mova para as instruções de um Projeto. A global fica com o que vale para qualquer código, e cada repo ganha o seu próprio contexto 🙂.
Fontes consultadas
Consulta em .
Formações
Formação Vibe Coding
Do Prompt ao Produto: Crie Software Real com IA
- 474 aulas
- 20 projetos
- 39h 30min
Blog | Mais populares
O que significa “ChatGPT network error” e como resolver
Network error indica falha de comunicação, mas não identifica sozinho a causa. Confira o status do ChatGPT, teste uma nova conversa e uma janela sem […]
ChatGPT: o que é, como usar, dicas e como acessar login
ChatGPT é uma ferramenta de processamento de linguagem natural (NLP) baseada na arquitetura GPT-3.5, desenvolvida pela OpenAI. Sua criação representa um marco significativo no campo […]
Como acessar o ChatGPT? Guia de login chat OpenAI
Como acessar o ChatGPT? O ChatGPT foi lançado pela OpenAI, empresa de pesquisa em inteligência artificial, em 30 de novembro de 2022 (em 2020 o […]
