Tutorial de Python com 17 lições que cria do zero um harness de agente semelhante ao Claude Code, começando com um único loop e bash.
78,8 mil12,6 milPythonMITAtualizado há 22 dias
ghuntley/how-to-build-a-coding-agent
Workshop passo a passo em Go que ensina a criar um agente de programação com a Claude API, adicionando ferramentas de arquivos, shell e busca uma de cada vez.
- Estrelas
- 5,907
- Forks
- 668
- Issues abertas
- 8
- Último commit
- há 3 dias
O que é?
Este é um workshop prático para criar seu próprio assistente de programação com IA em Go. Ele começa com um chatbot básico que conversa com o Claude pela Anthropic API e, em seguida, adiciona ferramentas uma de cada vez: leitura de arquivos, listagem de diretórios, execução de comandos shell, edição de arquivos e busca de código com ripgrep.
Cada etapa é um programa Go independente, como chat.go, read.go ou edit_tool.go, para que você possa executar e comparar cada versão. O workshop explica o loop de eventos central: a entrada do usuário é enviada ao modelo, as chamadas de ferramentas são executadas e os resultados são enviados de volta até que Claude dê uma resposta final. Ele também mostra como definir ferramentas com um nome, um schema de entrada gerado a partir de structs Go e uma função.
O projeto é voltado a desenvolvedores que querem entender como agentes como Cline, Cursor ou Claude Code funcionam por dentro. Para executá-lo, é necessária uma chave da Anthropic API.
Recursos principais
- 01Cria seis versões progressivas de um agente de programação em Go.
- 02Conecta à Anthropic Claude API com um loop de chat básico.
- 03Oferece ferramentas para leitura de arquivos, listagem de diretórios, execução de comandos shell, edição de arquivos e busca de código.
- 04Gera schemas de entrada das ferramentas a partir de structs Go.
- 05Inclui um modo verbose para exibir logs detalhados e arquivos de exemplo para experimentação.
Casos de uso
- Aprender como agentes de programação com IA, como Cline ou Cursor, funcionam por dentro.
- Criar um assistente de desenvolvimento local personalizado com suas próprias ferramentas.
- Ensinar o básico de chamadas de ferramentas de LLM a desenvolvedores Go.
Início rápido
- 1
Entre no ambiente de desenvolvimento devenv (recomendado)
devenv shell - 2
Ou instale as dependências do Go manualmente
go mod tidy - 3
Exporte sua chave da Anthropic API
export ANTHROPIC_API_KEY="your-api-key-here" - 4
Execute o programa básico de chat
go run chat.go
Antes de usar
- É necessária uma chave paga da Anthropic API para usar o Claude.
- O repositório não especifica uma licença.
Tópicos
Perguntas frequentes
- O que é how-to-build-a-coding-agent?
- Workshop passo a passo em Go que ensina a criar um agente de programação com a Claude API, adicionando ferramentas de arquivos, shell e busca uma de cada vez. Este é um workshop prático para criar seu próprio assistente de programação com IA em Go. Ele começa com um chatbot básico que conversa com o Claude pela Anthropic API e, em seguida, adiciona ferramentas uma de cada vez: leitura de arquivos, listagem de diretórios, execução de comandos shell, edição de arquivos e busca de código com ripgrep.
- how-to-build-a-coding-agent é gratuito? Qual é a licença?
- how-to-build-a-coding-agent não declara licença. O código é público, mas sem licença você não tem permissão explícita para reutilizá-lo; fale com o autor antes de depender dele.
- how-to-build-a-coding-agent ainda é mantido?
- Manutenção ativa. O último commit de how-to-build-a-coding-agent foi em 17 de out. de 2026.
- Para que posso usar how-to-build-a-coding-agent?
- Aprender como agentes de programação com IA, como Cline ou Cursor, funcionam por dentro. Criar um assistente de desenvolvimento local personalizado com suas próprias ferramentas. Ensinar o básico de chamadas de ferramentas de LLM a desenvolvedores Go.
- Como instalar how-to-build-a-coding-agent?
- Entre no ambiente de desenvolvimento devenv (recomendado): devenv shell Ou instale as dependências do Go manualmente: go mod tidy Exporte sua chave da Anthropic API: export ANTHROPIC_API_KEY="your-api-key-here" Execute o programa básico de chat: go run chat.go
- Onde consigo how-to-build-a-coding-agent?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ghuntley/how-to-build-a-coding-agent
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Um curso prático de Vibe Coding que ensina não programadores e desenvolvedores a criar produtos reais com ajuda de IA, da ideia ao lançamento.
20 mil1,9 milJavaScriptSem licençaAtualizado ontem
Central de controle auto-hospedada para executar agentes de programação, como OpenHands, Claude Code e Codex, em backends locais, remotos e na nuvem.
91,3 mil12,1 milTypeScriptMITAtualizado há 9 horas
Um agente de programação em TypeScript cuja CLI planeja, delega tarefas a vários modelos e verifica o trabalho quando você inclui `ulw` ou `mass ulw` no prompt.
70,2 mil5,8 milTypeScriptOtherAtualizado há 9 horas
Agente de IA open source para programação no terminal, com interfaces complementares para desktop, web, editores e chat.
28,6 mil3,2 milTypeScriptApache-2.0Atualizado há 9 horas
Framework em Go para criar aplicações com LLMs e agentes de IA, com componentes combináveis, orquestração por grafos e interrupções com participação humana.
13,4 mil1,1 milGoApache-2.0Atualizado ontem