CodeGPT
appleboy/CodeGPT加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
在日常开发中，你是否曾对着空空的提交信息框发呆，绞尽脑汁地想"这次改了什么来着"？或者写出的 commit message 永远是 fix bug、update code、WIP 这样毫无信息量的千篇一律？又或者 code review 时，面对一堆 Pull Request，需要逐行阅读代码才能理解作者的意图，效率极低？
CodeGPT 正是为解决这些痛点而生——它是一个用 Go 语言编写的命令行工具，通过调用 ChatGPT、Claude、Gemini 等主流 LLM API，自动为你的 Git 提交生成规范化的 commit message，或对代码变更进行 AI 驱动的 code review。它还会自动注册 Git prepare-commit-msg hook，让 commit message 生成完全自动化，融入开发者既有的工作流，无需改变任何习惯。
CodeGPT 由台湾开发者 Bo-Yi Wu（GitHub @appleboy）开发和维护。Bo-Yi Wu 是一位资深的 DevOps 工程师和开源贡献者，其 GitHub 主页显示他长期活跃于 Go 语言生态，仓库 star 数累计超过数万。CodeGPT 最早于 2022 年推出，最初仅支持 OpenAI 的 GPT-3.5-turbo 模型生成 commit message，随着大模型生态的快速演进，工具逐步扩展支持 Anthropic Claude、Google Gemini、Azure OpenAI Service、Ollama（本地模型）、Groq 和 OpenRouter 等十余种 LLM 后端，成为目前支持 LLM 提供商最广泛的 Git AI 辅助工具之一。
该工具被广泛应用在开源社区中，项目在 GitHub 上已积累超过 1500 颗 star，CI/CD 流水线经过 GitHub Actions 完整测试覆盖验证，并集成了 Trivy 安全扫描、GolangCI-Lint 代码检查和 Codecov 覆盖率报告，属于工程实践非常规范的 Go 项目。
CodeGPT 的核心功能是分析 Git diff 内容，将变更的代码片段发送给 LLM，由模型根据代码语义生成符合 Conventional Commits 规范的提交信息。典型的使用流程是：开发者在本地修改代码后，运行 git add 暂存变更，然后执行 codegpt commit，工具会自动读取 diff 内容、调用配置的 LLM API（如 gpt-4o），并在终端输出生成的消息。开发者可以选择接受、修改或重新生成。生成的 commit message 通常包含以下要素：
feat:、fix:、docs:、refactor:，对应代码变更的性质通过 codegpt review 命令，工具可以对一个 Git commit 或 Pull Request 进行 AI 驱动的代码审查。它会分析代码变更，检查潜在 bug、安全漏洞、代码风格问题，并给出改进建议。与传统静态分析工具（如 linter）不同，CodeGPT 的 review 具备语义理解能力，能够理解代码的业务逻辑上下文，给出更贴合实际的审查意见。
CodeGPT 支持通过 codegpt hook install 命令自动安装 Git prepare-commit-msg hook。Hook 安装后，每次执行 git commit 时，工具会自动读取 diff 并生成 commit message，开发者只需确认或编辑后保存即可。这意味着 commit message 生成对开发者完全透明，不需要额外的命令行操作步骤。
CodeGPT 的设计亮点在于其 Provider 架构：所有 AI 服务均实现统一的 core.Generative 接口，切换不同 LLM 无需修改核心逻辑。目前支持的 Provider 包括：
gpt-5、gpt-4o、gpt-4 等模型claude.ai API 调用 Claude 系列模型配置方式灵活多样，可通过环境变量、配置文件（YAML/JSON）或 codegpt config set 命令动态设置，甚至支持 API Key Helper 机制，可从外部脚本动态获取凭证并自动刷新，满足企业级安全合规要求。
CodeGPT 的代码结构高度模块化，采用经典的 Go 项目分层架构：
commit.go（提交消息生成）、review.go（代码审查）、hook.go（Hook 管理）、provider.go（Provider 工厂函数）等子命令。每个子命令职责单一，便于维护和扩展。openai.go 中声明了 Generative 接口，所有 Provider 必须实现该接口的 Completion() 和 GetSummaryPrefix() 方法。这种设计确保了核心逻辑与具体 AI 服务完全解耦。openai/、anthropic/、gemini/）独立封装对应 API 的调用细节、认证方式和请求格式。git.go 处理 diff 读取、上下文行控制、文件排除等；hook.go 负责 prepare-commit-msg hook 的安装与卸载，写入 .git/hooks/ 目录。language.go 读取语言配置），提供可自定义的 prompt 模板文件，开发者可完全控制 AI 生成内容的风格和格式。CodeGPT 的安装门槛极低。对于普通用户，只需运行一行安装脚本：
curl -sSL https://raw.githubusercontent.com/appleboy/CodeGPT/main/install.sh | sh
该脚本会自动检测操作系统（Linux/macOS/Windows）和 CPU 架构，从 GitHub Releases 下载对应平台的预编译二进制文件，添加到 $PATH 中。对于 Docker 用户，可以直接拉取 Alpine-based 镜像运行：
docker run -it --rm -e OPENAI_API_KEY=$OPENAI_API_KEY -v $(pwd):/workspace appleboy/codegpt commit
使用门槛方面，该工具纯命令行操作，不具备图形界面，适合熟悉终端操作的开发者。对于团队协作场景，需要确保每个成员的 LLM API Key 配置一致（可通过共享配置文件或环境变量注入），否则生成的 commit message 风格可能不一致。
API 成本依赖：使用 OpenAI、Anthropic 等商业 API 需要付费。虽然单个 commit message 的 token 消耗极低（通常几十到几百 token），但在大规模团队使用场景下仍需关注成本控制。可考虑切换至 Ollama 或 Groq 等低成本/免费替代方案。
信息泄露风险：Git diff 内容会被发送给第三方 LLM 服务商，代码变更细节将离开本地环境。对于涉及敏感业务逻辑、专有算法或内部基础设施代码的仓库，需评估是否适合使用此类工具，或切换至完全本地化的 Ollama 部署方案。
生成质量依赖模型能力：Commit message 的可读性和准确性受限于所选模型的能力。GPT-4o/Claude 等前沿模型效果较好，但响应速度和成本较高；本地模型（如 Ollama 的 Llama 3）完全免费且保障数据隐私，但生成质量可能不稳定。
多语言支持依赖 Prompt 配置：默认 prompt 为英文，切换至其他语言（如中文）需要手动配置语言模板。
CodeGPT 代表了 AI 辅助开发工具在工程自动化方向的一个细分探索。它并非要取代程序员的创造力，而是将"写 commit message"这一在开发流程中既耗时又缺乏成就感的"体力活"自动化，让开发者把精力集中在真正有价值的代码创作上。
从开源生态角度看，CodeGPT 的 Provider 模式为 AI 编程工具的架构设计提供了一个优秀范本：通过定义清晰的接口契约，使新模型/新 API 的接入成本降到最低。这种设计思路已被后续的许多 AI 编程工具（如Continue.dev、Aider）所借鉴。同时，支持 Ollama 的特性也反映出当前 AI 开发工具的一个趋势：从云端商业模型向本地开源模型的迁移，反映了开发者对数据主权和成本控制日益增长的需求。