ghuntley/how-to-build-a-coding-agent
一个分步骤的 Go 教程,带你基于 Claude API 从零构建一个编程智能体,逐步加入文件、命令和代码搜索工具。
- Star
- 5,907
- Fork
- 668
- 未关闭 Issue
- 8
- 最近提交
- 3天前
这是什么?
这是一个动手实践的 Go 教程,教你构建自己的 AI 编程助手。从通过 Anthropic API 与 Claude 对话的基础聊天机器人开始,逐步加入读取文件、列出目录、执行 shell 命令、编辑文件以及基于 ripgrep 的代码搜索工具。
每个阶段都是独立的 Go 程序(如 chat.go、read.go、edit_tool.go),可以分别运行和对比。教程讲解了核心事件循环:用户输入发送给模型,模型请求调用工具后由程序执行,并把结果返回给 Claude,直到它给出最终回答。教程还展示了工具如何通过名称、由 Go 结构体生成的输入 schema 和执行函数来定义。
适合想了解 Cline、Cursor 等编程智能体内部工作原理的开发者。运行需要 Anthropic API Key。
核心功能
- 01使用 Go 分六个递进版本构建编程智能体。
- 02通过基础聊天循环对接 Anthropic Claude API。
- 03提供读取文件、列出目录、执行命令、编辑文件和代码搜索工具。
- 04由 Go 结构体自动生成工具的输入 schema。
- 05支持 verbose 模式输出详细日志,并附带示例文件供练习。
适用场景
- 学习 Cline、Cursor 等 AI 编程智能体的内部工作原理。
- 基于自定义工具构建本地开发助手。
- 帮助 Go 开发者入门 LLM 工具调用。
快速上手
- 1
进入 devenv 开发环境(推荐)
devenv shell - 2
或者手动安装 Go 依赖
go mod tidy - 3
导出你的 Anthropic API 密钥
export ANTHROPIC_API_KEY="your-api-key-here" - 4
运行基础聊天程序
go run chat.go
使用前须知
- 需要付费的 Anthropic API 密钥才能使用 Claude。
- 该仓库未指定许可证。
标签
常见问题
- how-to-build-a-coding-agent 是什么?
- 一个分步骤的 Go 教程,带你基于 Claude API 从零构建一个编程智能体,逐步加入文件、命令和代码搜索工具。 这是一个动手实践的 Go 教程,教你构建自己的 AI 编程助手。从通过 Anthropic API 与 Claude 对话的基础聊天机器人开始,逐步加入读取文件、列出目录、执行 shell 命令、编辑文件以及基于 ripgrep 的代码搜索工具。
- how-to-build-a-coding-agent 可以免费使用吗?用的什么许可证?
- how-to-build-a-coding-agent 没有声明许可证。代码虽然公开,但没有许可证就没有明确的使用授权,正式使用前建议先联系作者。
- how-to-build-a-coding-agent 还在维护吗?
- 活跃维护中。how-to-build-a-coding-agent 最近一次提交是在 2026年10月17日。
- how-to-build-a-coding-agent 适合用来做什么?
- 学习 Cline、Cursor 等 AI 编程智能体的内部工作原理。 基于自定义工具构建本地开发助手。 帮助 Go 开发者入门 LLM 工具调用。
- how-to-build-a-coding-agent 怎么安装和运行?
- 进入 devenv 开发环境(推荐): devenv shell 或者手动安装 Go 依赖: go mod tidy 导出你的 Anthropic API 密钥: export ANTHROPIC_API_KEY="your-api-key-here" 运行基础聊天程序: go run chat.go
- 在哪里获取 how-to-build-a-coding-agent?
- 源代码和安装说明在 GitHub 上:https://github.com/ghuntley/how-to-build-a-coding-agent
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
一门面向产品人员与开发者的 Vibe Coding 实战课程,带你从想法走到产品上线。
自托管的编码智能体控制中心,可在本地、远程和云端后端运行 OpenHands、Claude Code、Codex 等智能体。
一款 TypeScript 编程 Agent 命令行工具,在提示词中加入 ulw 或 mass ulw 关键词即可自动规划、调度多模型并校验结果。
一款开源的终端 AI 编程智能体,并提供桌面端、Web、编辑器和即时通讯等入口。
一个用 Go 编写的 LLM 应用开发框架,提供组件、图编排与智能体开发能力。