code2prompt：将代码库一键转换为LLM提示词

工具介绍

code2prompt 是一款基于 Rust 构建的高效命令行工具，解决的是 AI 辅助编程中一个非常实际的痛点：如何把整个代码库的上下文完整、高效地传递给大语言模型。当开发者想让 ChatGPT 或 Claude 帮助修改代码、重构模块或排查问题时，往往需要手动复制多个文件、整理目录结构，既繁琐又容易遗漏关键信息。code2prompt 将这一过程自动化——只需一条命令，就能把整个项目打包成结构化的单一提示词，包含源代码树、文件内容和必要的元数据，直接粘贴进对话即可。

它的核心定位是"AI 编程工作流中的上下文传递层"，轻量、跨平台（支持 Windows、macOS、Linux），不依赖任何云端服务，所有处理都在本地完成。对于依赖 CLI 工具的效率型开发者来说，这是连接本地代码库与 LLM 之间的桥梁。

核心功能

• 一键生成代码库提示词：扫描整个目录，自动生成包含文件内容和目录结构的完整提示词，可直接复制给 ChatGPT 或 Claude
• 自动生成源代码树结构：在提示词开头展示项目的文件树，让模型快速理解代码组织方式
• 自定义提示词模板：支持使用 Handlebars 模板引擎定制输出格式，适配不同的模型或使用场景
• 精确的 token 计数：内置 token 计算器，在生成提示词时显示总 token 数，帮助控制上下文长度，避免超出模型限制
• Git 集成：自动读取 .gitignore 规则，跳过被版本控制排除的文件（如 node_modules、dist 等），确保只传递有效代码
• 文件过滤与排除：支持通过正则表达式或 glob 模式精确控制哪些文件被包含或排除

适合哪些人

这款工具最直接的受益者是深度使用 AI 辅助编程的开发者，尤其是那些已经习惯将项目代码粘贴给 ChatGPT 或 Claude 获取建议的人群。如果你经常需要向模型解释项目结构、传递多个文件的代码，或者希望模型在理解完整上下文后给出更精准的重构方案，code2prompt 能显著节省准备时间。

它也适合使用 CLI 工具的效率型开发者——安装简单（可通过 Cargo、Homebrew、下载二进制文件等方式），命令简洁，可以轻松集成到 shell 脚本或自动化工作流中。对于团队协作场景，成员可以统一使用同一套提示词生成流程，确保每次传递给模型的信息一致且完整。

可以用来做什么

• 为 AI 编程提供完整项目上下文：在向 ChatGPT 或 Claude 询问修改建议前，先用 code2prompt 生成项目快照，让模型基于完整代码而非零散文件给出建议
• 一键生成代码库提示词：快速将整个项目打包成单个提示词，用于代码审查、漏洞分析或架构评估
• 生成项目结构供模型分析：只需项目文件树和关键文件内容，无需传递全部代码，即可让模型分析模块划分、依赖关系或潜在问题
• 将代码打包给 ChatGPT/Claude 使用：在遇到复杂 bug 或需要跨文件重构时，将相关代码完整打包，减少来回追问的次数
• 配合自定义模板实现特定输出：比如只提取 TODO 注释、只包含测试文件，或按特定格式组织代码供模型阅读

使用方式

code2prompt 是开源 CLI 工具，获取方式灵活：

bash
# 通过 Cargo 安装（需先安装 Rust）
cargo install code2prompt

# 通过 Homebrew 安装（macOS/Linux）
brew install code2prompt

# 基本用法：生成当前目录的提示词
code2prompt

# 指定目标目录，并显示 token 数
code2prompt --path ./my-project --tokens

# 排除指定文件或目录
code2prompt --exclude "*.test.js" --exclude "docs/**"

# 使用自定义模板
code2prompt --template custom_template.hbs

# 将输出保存到文件
code2prompt --output prompt.txt

生成的内容会直接输出到终端，也可以重定向到文件或通过管道传递给其他工具。对于开源项目，也可以直接从 GitHub 仓库克隆源码自行编译。

优点

• 轻量高效：基于 Rust 编写，启动速度快、内存占用低，处理大型代码库也毫不吃力
• 精准控制：token 计数和文件过滤功能让开发者对发送给模型的内容有完全掌控，避免浪费上下文窗口
• 开箱即用：默认配置就能生成结构清晰的提示词，无需额外设置；Git 集成自动排除无关文件，非常省心
• 高度可定制：Handlebars 模板支持让高级用户完全自定义输出格式，适配不同模型或团队规范

使用时需要注意

• 需要基本的命令行操作能力，虽然安装方式多样，但使用过程中会涉及参数配置
• 对于包含大量二进制文件或超大文件的项目，建议先配置排除规则，否则生成的提示词可能过大
• token 计数是估算值，不同模型的 tokenizer 算法略有差异，实际消耗可能稍有出入
• 如果项目没有初始化 Git 仓库，.gitignore 规则不会生效，需要手动配置排除项
• 生成的提示词可能包含敏感信息（如 API 密钥、密码等），在发送给第三方 AI 服务前请仔细检查内容

总结

code2prompt 是 AI 辅助编程工作流中一款实用且纯粹的效率工具，尤其适合需要频繁将完整项目上下文传递给 ChatGPT 或 Claude 的开发者。它以极低的使用成本，解决了"模型不了解项目全貌"这一常见痛点，让 AI 给出的建议更贴合实际代码。对于追求高效、注重上下文质量的编程场景，code2prompt 是一个值得纳入日常工具箱的选择。