Repolode
ghuntley

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. 1

    进入 devenv 开发环境(推荐)

    devenv shell
  2. 2

    或者手动安装 Go 依赖

    go mod tidy
  3. 3

    导出你的 Anthropic API 密钥

    export ANTHROPIC_API_KEY="your-api-key-here"
  4. 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 数据每日更新。

相关项目