Olá a todos, sou o Cang He.
Hoje, estamos lançando oficialmente o CodexGuide.
Este é um "Guia Prático do Codex", e está disponível como código aberto no GitHub.
É completamente gratuito e de código aberto.
Para uma melhor experiência de leitura, também configurei um site online:
Hoje, é anunciado oficialmente:
Acredito que muitas pessoas, assim como eu costumava ser, ficam um pouco confusas sobre o App Codex, o Codex CLI e os plugins do Codex.
Uma hora dizem para usar o Claude Code, na outra falam para usar o Codex; é de deixar a cabeça tonta.
Por isso, partindo da trilha de aprendizado, o CodexGuide está organizado em quatro camadas: "Entendendo os Pontos de Entrada, Executando Tarefas, Estabelecendo Métodos e Acumulação de Equipe." Você pode começar com o CLI, ou com o cliente desktop, ChatGPT, ou tarefas na nuvem; o segredo é primeiro entender o ritmo de tarefa adequado para cada ponto de entrada.
Atualmente, o mais usado é o App Codex Desktop, que tem excelentes capacidades de engenharia, especialmente para uso de computador e capacidades de navegador.
Desde baixar e instalar o App Codex Desktop até assinar o Plus, o CodexGuide fornece tutoriais muito detalhados.
Para ser sincero, o tutorial sobre 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 móvel" mencionado aqui é, mais precisamente, o ponto de entrada do Codex dentro do aplicativo ChatGPT para celular. Não é um aplicativo Codex móvel independente, nem transforma seu celular em um mouse e teclado de acesso remoto. Pense assim: o aplicativo desktop, uma máquina de desenvolvimento remota ou outro ambiente autorizado está executando o Codex, e o 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 code" a qualquer momento, exceto quando estou dormindo, direcionando convenientemente o Codex no meu Mac Mini para trabalhar de qualquer lugar usando meu celular.
Mais tarde, adicionarei mais práticas minhas com o Codex aqui.
No mapa de pontos de entrada, diferentes pontos de entrada serão introduzidos, do CLI ao APP desktop, e depois à IDE, te levando a dominar o Codex de uma vez.
Se você acha difícil configurar o Codex, não se preocupe, você encontra todas as respostas aqui.
Também adicionei especialmente um ponto de entrada de recursos para facilitar para todos encontrarem materiais oficiais para consulta imediata. 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 defasada.
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 vai reunir muitos casos interessantes de uso 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 diagramas de arquitetura automaticamente.
Ninguém recusaria um caso tão útil, certo?
No entanto, coletamos apenas 13 casos típicos até agora; mais casos práticos serão continuamente aprimorados e coletados posteriormente.
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 gerenciamento de conhecimento, não pode perder o caso Codex + Obsidian, que ensina como usar Codex × LLM Wiki para construir uma base de conhecimento de IA no Obsidian.
Para ser honesto, este projeto começou no dia 1º de maio e foi sendo melhorado de forma intermitente.
O motivo foi simples: no começo, eu não conseguia nem descobrir como fazer login ou recarregar o Codex. Perguntei para a IA e procurei tutoriais, mas todos eram inúteis.
Finalmente, encontrei um jeito 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: ultimamente, viciei no Codex, 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 terão sido 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 polirmos juntos.
Embora ainda seja imperfeito, o mais importante é completar, mais do que a perfeição.
Obrigado por curtir meu artigo, até a próxima edição.
