code2prompt

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 对话助手 🍴 复刻 458 🐛 待处理 20 👀 关注 43
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 7756
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,无付费版本。

项目预览

code2prompt 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类对话助手
开发团队mufeedvh
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Rust
技术栈/模型ai,chatgpt,claude,cli,command-line,command-line-tool,gpt,llm,prompt,prompt-engineering,prompt-generator,prompt-toolkit,rust
GitHub 星标★ 7756
上线时间2024-03-09 00:00:00
代码更新2026-11-06
仓库体积8.6 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数6

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 7756

使用教程

难度:入门 约 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

上一篇:dish-ai-commit

下一篇:reference

同类项目推荐

pyflyby 开源

自动补全和清理 Python import,写代码不再手动加库

A set of productivity tools for Python. Learn more at https://www.deshaw.com/library···

★ 496 2026-09-17
ttsc 开源

把编译过程变成可查询的代码证据图

A typescript-go toolchain, with evidence graph

★ 364 2026-10-25
codai 开源

在终端里用自然语言指挥 AI 写代码,提升开发效率。

The open source coding agent for your terminal.

★ 373 2026-08-09
fast-request 开源

IDE 里直接调接口,省去手写请求和切工具

IntelliJ IDEA plugin Fast Request

★ 514 2026-09-16
viberank 开源

看AI编程工具真实花费,选对工具不踩坑

The AI coding usage leaderboard — Claude Code, Codex, Gemini CLI & more. Real costs···

★ 121 2026-08-09
codeassist 开源

本地跑 AI 编程陪练,边刷题边训练专属助手

A completely private and local AI coding assistant, developed by Gensyn. It helps yo···

★ 698 2026-10-30
llm-sast-scanner 开源

给 AI 编程助手装上漏洞扫描眼,写代码时顺手查 34 类风险

A SAST skill that gives AI coding agents structured vulnerability detection across 3···

★ 291 2026-09-16
context7 开源

让 AI 编程助手实时获取最新文档,告别过时 API 幻觉。

Context7 Platform -- Up-to-date docs for AI agents

★ 64378 2026-08-09
craft-anything 开源

拆解任意软件原理,动手复刻自己的版本

Craft Anything: understand how any software works, and craft your own.

★ 21843 2026-11-03