code2prompt

一条命令把整个代码库变成 LLM 提示词,省去手动复制粘贴。

code2prompt 是一个用 Rust 编写的命令行工具,旨在将整个代码库转换为单个 LLM(大语言模型)提示词。它解决了开发者在向 ChatGPT、Claude 等 AI 助手提问时,需要手动复制粘贴多个文件、整理上下文的问题。该工具会自动生成源代码目录树,支持自定义提示词模板,并能统计 token 数量,帮助用户控制成本。核心能力包括:递归扫描代码库、过滤无关文件(如 .gitignore)、生成结构化的文本输出,以及通过模板系统灵活定制提示词格式。它特别适合需要将大型项目上下文一次性打包给 AI 的场景,提高了与 LLM 协作的效率。

开源 free 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 7694
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类对话助手
开发团队mufeedvh
所属国家
定价模式free
价格说明开源项目,MIT许可证,完全免费,无付费版本。
访问状态
是否开源是
开源协议MIT
主要语言Rust
技术栈/模型ai,chatgpt,claude,cli,command-line,command-line-tool,gpt,llm,prompt,prompt-engineering,prompt-generator,prompt-toolkit,rust
GitHub 星标★ 7694
30天Star增速
HF 下载量
上线时间2024-03-09 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数4

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 6 步

环境要求

  • Cargo 与 Rust 工具链(使用 cargo 安装方式时需要)
  • Homebrew 包管理器(使用 brew 安装方式时需要)
  • Python 与 pip 环境(使用 SDK 安装方式时需要)
  • 可访问 crates.io / PyPI 的网络环境

安装与启动步骤

  1. 1用 Cargo 安装

    已安装 Rust 与 Cargo 时,直接通过 cargo 从 crates.io 安装 code2prompt 可执行文件。

    cargo install code2prompt
  2. 2启用 Wayland 支持

    在 Wayland 桌面环境下需要剪贴板集成时,安装时加上 wayland feature flag。

    cargo install --features wayland code2prompt
  3. 3用 Homebrew 安装

    macOS 或 Linux 上已装 Homebrew 时,可用 brew 一条命令完成安装。

    brew install code2prompt
  4. 4安装 Python SDK

    想在 Python 项目中调用 code2prompt 能力时,安装官方 pip 包 code2prompt-rs。

    pip install code2prompt-rs
  5. 5生成提示词

    把工具指向代码库目录,默认将生成的提示词输出到 stdout(终端)。注意最后一个点表示当前目录。

    code2prompt .
  6. 6保存为文件

    将生成的提示词写入指定文件,便于后续粘贴或上传给 LLM。路径与文件名可自行替换。

    code2prompt path/to/project --output-file prompt.txt

关键配置

配置项必填说明示例
-c否将生成的提示词直接复制到剪贴板,而不是只打印到终端code2prompt . -c
--output-file否把生成的提示词写入指定文件--output-file prompt.txt

如何确认成功

执行 code2prompt . 后,终端能打印出由代码库内容构成的提示词文本,即表示安装与运行成功。

常见问题

Q:cargo、brew、pip 三种安装方式该选哪个?

A:按本机已有环境选:装了 Rust 用 cargo,macOS/Linux 常用 brew,Python 项目可直接 pip 安装 SDK。README 另附官方文档可查详细安装说明。

Q:在 Wayland 桌面下剪贴板复制不生效怎么办?

A:README 说明需在安装时启用 wayland feature flag,即执行 cargo install --features wayland code2prompt 重新安装。

Q:生成的提示词跑到哪里去了?

A:默认输出到 stdout(终端);加 -c 可复制到剪贴板,或用 --output-file prompt.txt 保存到文件。

Q:还想看更详细的安装步骤怎么办?

A:README 的 Alternative Installation 一节点名指向官方文档 https://code2prompt.dev/docs/how_to/install/,可前往查阅。

注意事项

  • README 未给出可执行文件的安装路径、默认端口等细节,请以官方文档为准。
  • 命令中的 path/to/project、prompt.txt 为示例路径与文件名,请替换成自己的真实值。
  • 若使用 Wayland 且需要剪贴板功能,必须带 wayland feature flag 安装,否则 -c 复制可能不可用。

核心亮点

  • 自动生成目录树,让 AI 快速理解项目结构
  • 内置 token 计数,避免超出模型上下文限制
  • 支持模板定制,适配不同 LLM 和场景

不足之处

  • 仅支持命令行,无图形界面,对新手不友好
  • 文档/社区待观察

适用场景

  • 向 ChatGPT 提问前,快速打包整个项目上下文
  • 在 CI/CD 中自动生成代码摘要供 AI 审查
  • 为代码库生成文档或训练数据时预处理

替代项目

aider、repomix、gpt-repository-loader

项目介绍

code2prompt 是编程开发领域的开源项目,由 mufeedvh 开发,2024 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(7,694)位列前 7%,在编程开发分类的 490 个项目里位列前 9%。

近 44 天,它的 GitHub 星标从 7,551 增加到 7,694,净增 143。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。MIT许可证,完全免费,无付费版本。

它主要面向的使用场景是:向ChatGPT提问前,快速打包整个项目上下文。同类可对比的替代方案包括 aider、repomix、gpt-repository-loader。

上一篇:dish-ai-commit

下一篇:reference

同类项目推荐

bolt.new 开源

想到啥说啥,网页应用当场生成直接能用

Prompt, run, edit, and deploy full-stack web applications. -- bolt.new -- Help Cente···

★ 16557 2026-08-09
fuzz4all 开源

用大模型自动生成测试输入,发现各种软件漏洞

️Fuzz4All: Universal Fuzzing with Large Language Models

★ 338 2026-08-09
superpowers-zh 开源

全套 AI 编程神技汉化好了,照着用就行。

AI 编程超能力 · 中文增强版 — superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills···

★ 8188 2026-08-09
Gitea 代码托管 开源

轻量 Git 代码托管平台

Git with a cup of tea! Painless self-hosted all-in-one software development service,···

★ 58115 2026-08-22