返回资源列表

GitHub（Harvil1） · Harvil1

CodeAgent：终端里的开源 AI 编程 Agent

CodeAgent：终端里的开源 AI 编程 Agent是GitHub（Harvil1）的免费开源项目（中文）。前置条件：需要掌握 Python 基础与命令行操作；了解 LLM 调用、工具调用（function calling）的基本概念会更顺畅。

读者可以按 README 安装并运行 CodeAgent，并通过阅读其模块化源码理解一个真实可跑的编程 Agent 全链路实现：工具自注册、上下文分级压缩、权限审批、长期记忆与技能、子代理与团队、工作流引擎与自学习管线。

打开官方课程
难度
见前置条件
类型
开源项目
语言
中文
规模
1 个课节
内容费用
免费
动手
需要动手环境

使用限制

浏览 GitHub 页面与克隆仓库均无需账号（仅 star、通知等交互需要登录），阅读代码与文档不需要 API key；只有实际运行程序才需要模型 API key，并会产生调用费用。

练习与作业
DeepSeek / OpenAI / Anthropic / OpenRouter / 智谱 中任一厂商的 API key，仅在运行程序驱动模型时需要模型 API 调用产生的费用（价格原站未说明）

学完你能

  • 在自己的终端中安装并运行 CodeAgent，用自然语言完成读代码、改文件、跑命令等任务
  • 配置 OpenAI 兼容或 Anthropic 协议的模型端点，并在会话中用 /model 切换主模型与辅助小模型
  • 说明 tools/ 目录下工具自注册体系与 toolset 如何控制发给模型的工具集
  • 说明上下文分级压缩（L1 轻裁剪到 L4 深度摘要）与前缀缓存友好的设计思路
  • 解释破坏性命令审批、跨会话白名单、注入面检测、秘钥扫描与 SSRF 防护等安全防线的作用
  • 说清长期记忆（MEMORY.md + JSONL）、技能系统与自学习管线的组织方式
  • 了解子代理派发、团队模式、工作流引擎与 checkpoint 回溯的实现模块
  • 用仓库自带依赖与配置跑通一次交互会话，并据此定位继续深入阅读的源码模块

适合你吗

适合

适合想通过读真实代码学习 Agent 工程实现的开发者，仓库提供中文注释、特性说明、安装步骤与 slash 命令表。

暂不适合

不适合只想要 Agent 理论或论文式讲解的读者；仓库以 Windows 优先，README 称 macOS 未充分验证。

需要先会

需要掌握 Python 基础与命令行操作；了解 LLM 调用、工具调用（function calling）的基本概念会更顺畅。

课程特点

内容侧重
侧重实践应用
练习与项目
建议用自己的一个小型仓库做实验：让 Agent 完成一次改文件 + 跑命令的任务，并用 /permission 观察审批流程、/stats 查看花费；也可在 settings.json 中把辅助小模型换成便宜模型以控制成本。
学习时长
1 个课节原站未给出统一学习时长；实际用时取决于已有基础。
内容费用
免费仓库以 MIT 许可公开，README、快速开始与源码可在 GitHub 页面直接阅读，节选未出现付费墙或登录拦截；README 提到插件市场技能（/plugin 管理），但未说明其是否收费。

内容覆盖

  • 终端体验：流式回答、工具事件行、审批面板、Ctrl+C 语义、皮肤与状态栏
  • 模型与工具：多模型接入、主模型 + 辅助小模型、工具自注册与 toolset、MCP 外部工具
  • 安全防线：破坏性命令审批、跨会话白名单、注入面检测、秘钥扫描、SSRF 防护、bwrap 沙箱
  • 记忆与自学习：长期记忆、技能系统、自学习管线
  • 协作与自动化：子代理、团队模式、工作流引擎、定时任务、hooks、checkpoint 回溯
  • 上下文工程：分级压缩、批间工具摘要、前缀缓存友好设计
  • 快速开始：安装 uv、克隆与 uv sync、配置 API key、运行 main.py
  • 常用 slash 命令一览
  • 配置与数据目录 ~/.codeAgent/

常见问题

免费吗？

免费：仓库以 MIT 许可公开，README、快速开始与源码可在 GitHub 页面直接阅读，节选未出现付费墙或登录拦截；README 提到插件市场技能（/plugin 管理），但未说明其是否收费。实践需要付费：实际运行该 Agent 需自备大模型 API key（默认 DeepSeek），调用会产生 API 费用，README 未说明具体价格。

需要什么基础？

需要掌握 Python 基础与命令行操作；了解 LLM 调用、工具调用（function calling）的基本概念会更顺畅。软件、账号与硬件：Python 3.11+、uv 包管理器，以及 Readme 快速开始中的 git clone 与 uv sync；实际运行时需要一个模型 API key（默认 DeepSeek，也支持 OpenAI 兼容或 Anthropic 协议端点）。

有中文吗？

本站记录的语言：中文（另有英文 README）；中文内容的范围以原站为准。

怎么开始？

从原始资源入口开始：https://github.com/Harvil1/codeAgent。本页“学前准备”列出环境与工具，“学习指南”给出开课提示词，可以在自己的电脑上按步骤开始。开课提示词尚未完整验证。练习与作业需要自备：DeepSeek / OpenAI / Anthropic / OpenRouter / 智谱 中任一厂商的 API key，仅在运行程序驱动模型时需要、模型 API 调用产生的费用（价格原站未说明）。

来源与使用须知

收录时间
本站首次收录 2026-10-23
指南参考
课程主页

版权与转载

  • MIT：代码可自由使用和修改，需保留版权声明。原站说明
  • 本站只提供原始链接和学习指南，不转载、不镜像课程材料；引用时请注明原作者与出处。