Olá a todos, sou o Cang He.
Hoje, estamos lançando oficialmente o CodexGuide.
Este é um "Guia Prático do Codex" e foi disponibilizado como código aberto no GitHub.
É completamente gratuito e de código aberto.
Para uma melhor experiência de leitura, também criei um site online:
Hoje, é oficialmente anunciado:
Acredito que muitas pessoas, assim como eu era, ficam um pouco confusas com o Codex App, o Codex CLI e os plugins do Codex.
Uma hora dizem para usar o Claude Code, na outra hora dizem para usar o Codex; é de deixar a cabeça girando.
Pensando nisso, partindo da jornada de aprendizado, o CodexGuide está organizado em quatro camadas: "Entendendo os Pontos de Entrada, Executando Tarefas, Estabelecendo Métodos e Acumulação em Equipe." Você pode começar pelo CLI, ou pelo aplicativo de desktop, pelo ChatGPT ou por tarefas na nuvem; o importante é primeiro entender o ritmo de tarefa adequado para cada ponto de entrada.
Atualmente, o mais usado é o Codex Desktop App, que tem capacidades de engenharia excelentes, especialmente para o uso do computador e as capacidades do navegador.
Desde baixar e instalar o Codex Desktop App até assinar o Plus, o CodexGuide fornece tutoriais muito detalhados.
Para ser sincero, só o tutorial de como assinar o Plus já pode te economizar uma boa grana com recargas de terceiros, haha.
Recarregar sua própria conta é mais estável, afinal, ela é sua:
Também incluí um tutorial baseado na minha experiência pessoal sobre como usar o Codex no celular para executar tarefas remotamente.
O "Codex no celular" mencionado aqui é, mais precisamente, o ponto de entrada do Codex dentro do aplicativo do ChatGPT para celular. Não é um aplicativo de Codex móvel independente, nem transforma seu telefone em um mouse e teclado de desktop remoto. Você pode pensar assim: o aplicativo de desktop, uma máquina de desenvolvimento remota ou outro ambiente autorizado está executando o Codex, e a ponta do celular é responsável por conectar-se a esses ambientes, permitindo que você continue visualizando, respondendo, aprovando e ajustando tarefas quando estiver longe do computador.
Agora, posso "vibe coding" a qualquer hora, exceto quando estou dormindo, direcionando convenientemente o Codex no meu Mac Mini para trabalhar de qualquer lugar usando meu celular.
Mais tarde, também adicionarei mais práticas minhas com o Codex aqui.
No mapa de pontos de entrada, diferentes pontos de entrada serão apresentados, do CLI ao APP de desktop e depois à IDE, mostrando tudo sobre o Codex de uma só vez.
Se você acha doloroso configurar o Codex, não se preocupe, você encontra todas as respostas aqui.
Também adicionei especificamente um ponto de entrada de recursos para facilitar a localização imediata dos materiais oficiais para consulta. Vou fazer o Codex verificá-los periodicamente para garantir que a documentação esteja sincronizada com a versão oficial, ou pelo menos não muito atrasada.
Afinal, a velocidade de atualização atual do Codex é muito, muito rápida.
Tutoriais simples são apenas para começar, então também adicionei uma coluna chamada "Casos Práticos".
Ela reunirá muitos casos interessantes do Codex que são fáceis o suficiente para qualquer um replicar.
Por exemplo, usar Codex × Draw.io MCP para deixar a IA desenhar automaticamente diagramas de arquitetura.
Ninguém recusaria um caso tão útil, né?
No entanto, coletamos apenas 13 casos típicos até agora; mais casos práticos serão continuamente aprimorados e coletados depois.
Casos como Codex × GitHub Actions: Teste prático de reparo automático de falhas de CI são altamente recomendados para desenvolvedores experimentarem. É uma parte que vai fazer seu Codex decolar.
Se você gosta de gestão de conhecimento, não pode perder o caso Codex + Obsidian, que ensina como usar o Codex × LLM Wiki para construir uma base de conhecimento de IA no Obsidian.
Para ser sincero, este projeto começou no dia 1º de maio e foi sendo melhorado aos poucos.
O motivo foi simples: no começo, eu não conseguia nem descobrir como fazer login ou recarregar o Codex. Perguntei à IA e procurei tutoriais, mas tudo era conversa fiada.
Finalmente, descobri um caminho por tentativa e erro.
Naquele momento, percebi: com o Codex, a parte difícil não é usá-lo; é "fazê-lo funcionar."
Muitas pessoas não querem deixar de usá-lo; elas simplesmente emperram nas contas, ambientes e redes, o que as desanima.
A documentação oficial existe, mas você sabe, essas coisas são escritas para quem já sabe usar.
Então pensei: por que não criar uma eu mesmo? Do registro à aplicação prática, vou pisar em todas as armadilhas e depois aplainá-las para quem vier depois.
Também tenho um motivo egoísta: ando viciado no Codex ultimamente, interagindo com ele todos os dias e encontrando mais problemas do que escrevendo código.
Em vez de deixar essas experiências apodrecerem em registros de chat, é melhor consolidá-las como um relato para mim mesmo.
Se este tutorial puder te poupar ao menos um desvio, então minhas olheiras das últimas duas semanas não foram em vão.
Finalmente, agradeço a todos os amigos que participaram da construção deste tutorial de código aberto, e contribuições da comunidade são bem-vindas para aprimorá-lo juntos.
Embora ainda seja imperfeito, a conclusão é mais importante que a perfeição.
Obrigado por curtir meu artigo, até a próxima edição.
