chatblade

在终端里用 ChatGPT，管道、会话、脚本一把梭

chatblade 是一个基于 Python 的命令行工具，为 ChatGPT 提供瑞士军刀式的交互体验。它解决的是在终端环境中高效使用 ChatGPT 的问题，无需离开命令行即可进行对话、批量处理文本、编写脚本等。核心能力包括：支持交互式聊天模式，可保存和恢复会话历史；支持管道输入，能直接处理文件或命令输出；提供多种输出格式（如纯文本、JSON、Markdown）；可自定义角色和系统提示词，适应不同场景；支持使用本地模型或远程 API，灵活配置。项目设计简洁，依赖少，注重实用性和可扩展性，是开发者日常使用 AI 助手的便捷工具。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2590

维护状态低维护

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队npiv

所属国家

官网地址

GitHubhttps://github.com/npiv/chatblade

定价模式free

价格说明开源项目，GPL-3.0许可，本地部署使用，完全免费。

访问状态

是否开源是

开源协议GPL-3.0

主要语言Python

技术栈/模型chatgpt,cli

GitHub 星标★ 2590

30天Star增速

HF 下载量

上线时间2023-03-19 00:00:00

最近更新2026-08-26 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

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

环境要求

Python 环境与 pip（用于 pip 安装）
OpenAI API Key（必须，否则无法使用）
macOS 可选：Homebrew（用于 brew 安装）
终端可访问网络以调用 OpenAI 接口

安装与启动步骤

1准备 API 密钥

在 OpenAI 后台获取 API Key，README 要求必须配置密钥才能使用 chatblade。
2设置环境变量

推荐用环境变量方式传入密钥，避免写进命令历史；把示例值换成你自己的 Key。
```
export OPENAI_API_KEY=sk-xxxxxxxx
```
3从 PyPI 安装

安装最新发布版本，加 --upgrade 可覆盖升级旧版本。
```
pip install chatblade --upgrade
```
4或装主分支版本

README 提供直接从 GitHub 主分支安装的方式，可获取最新未发布改动。
```
pip install 'chatblade @ git+https://github.com/npiv/chatblade'
```
5Homebrew 安装

macOS 用户也可用 Brew 安装，按 README 给出的公式名执行即可。
```
brew install chatblade
```
6发起查询

直接把问题作为参数传入，即可开始一次新对话；换成你自己的问题即可。
```
chatblade "how can I center a div with CSS"
```

关键配置

配置项	必填	说明	示例
`OPENAI_API_KEY`	是	环境变量形式的 OpenAI 密钥，README 推荐这种配置方式	`sk-xxxxxxxx`
`--openai-api-key`	否	命令行参数形式传入密钥，替代设置环境变量	`--openai-api-key sk-xxxxxxxx`

如何确认成功

执行 chatblade 查询命令后能正常返回 ChatGPT 的回答，说明安装和密钥配置都已生效。

常见问题

Q：这个项目还在维护吗？

A：README 顶部已声明项目归档、不再开发，作者建议改用 Claude Code、Codex，或同类的 llm、Fabric 工具。

Q：怎么提供 OpenAI API Key？

A：两种方式：命令加 --openai-api-key KEY，或设置环境变量 OPENAI_API_KEY，README 推荐后者。

Q：有哪些安装方式？

A：三种：pip install chatblade --upgrade（PyPI）、pip install 主分支（git+ 地址）、以及 brew install chatblade。

Q：安装后没有输出或报错怎么办？

A：先确认 OPENAI_API_KEY 已正确导出且密钥有效，再确认 pip 安装的是 chatblade，README 未给出更多排错信息。

注意事项

项目已归档、不再维护，README 明确建议改用其他同类工具，生产使用需谨慎。
API Key 建议只通过环境变量提供，不要写死在脚本或提交到仓库。
README 节选被截断，会话保存、管道输入、输出格式等高级用法未在片段中给出，请查看完整文档。
三种安装方式选其一即可，不要在同一次会话中混用 pip 与 brew 安装。

核心亮点

支持管道输入，可直接处理文件或命令输出，自动化工作流
会话历史可保存和恢复，方便多轮对话和上下文管理
输出格式灵活（纯文本/JSON/Markdown），便于脚本集成

不足之处

文档/社区待观察
依赖外部 API，需自行配置密钥，对非技术用户有门槛

适用场景

开发者快速查询代码问题或生成代码片段
在终端中批量处理文本，如翻译、格式化、摘要
编写脚本时嵌入 ChatGPT 调用，实现自动化任务

替代项目

shell-gpt、aichat、gptcli

项目介绍

chatblade 是对话助手领域的开源项目，由 npiv 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（2,590）位列前 30%，在对话助手分类的 905 个项目里位列前 10%。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-08-26。GPL-3.0许可，本地部署使用，完全免费。

它主要面向的使用场景是：开发者快速查询代码问题或生成代码片段。同类可对比的替代方案包括 shell-gpt、aichat、gptcli。

上一篇：chatgpt-telegram-bot

下一篇：nuxt-chatgpt