tgpt：终端里的 AI 聊天工具

项目简介

tgpt 是一个用 Go 编写的跨平台命令行（CLI）工具，让你可以直接在终端里使用 AI。它支持多种 provider，README 中给出了完整的 provider 列表链接，适合习惯在终端里工作的开发者和命令行用户。

主要功能

• 在终端中直接与 AI 对话，无需离开命令行
• 支持多个 AI provider，可自由切换（完整列表见 providers 文档）
• 跨平台：GNU/Linux、macOS、Windows、FreeBSD
• 支持代理，可通过环境变量或配置文件设置 HTTP / Socks5 代理
• 内置更新命令，安装脚本安装的版本可一键升级

安装与使用

GNU/Linux 或 macOS

安装脚本默认安装到 /usr/local/bin，可以在命令中改成其他位置，但要确保该位置已加入 PATH：

curl -sSL https://raw.githubusercontent.com/aandrew-me/tgpt/main/install | bash -s /usr/local/bin

Arch Linux 可以用 pacman 安装：

pacman -S tgpt

也可以用 Homebrew：

brew install tgpt

FreeBSD

cd /usr/ports/www/tgpt/ && make install clean

或者安装软件包：

pkg install www/tgpt
pkg install tgpt

使用 Go 安装

需要先把 Go 的安装目录加入系统 shell 的 PATH：

go install github.com/aandrew-me/tgpt/v2@latest

Windows

在 PowerShell 中执行安装脚本：

irm https://raw.githubusercontent.com/aandrew-me/tgpt/refs/heads/main/install-win.ps1 | iex

卸载：

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/aandrew-me/tgpt/refs/heads/main/install-win.ps1))) -Uninstall

也可以用 Scoop 或 Chocolatey：

scoop install https://raw.githubusercontent.com/aandrew-me/tgpt/main/tgpt.json

choco install tgpt

从 Release 安装

下载对应操作系统的可执行文件，改名为 tgpt（或任意想要的名字），在该目录下执行 ./tgpt 即可；也可以把它加入 PATH，之后直接输入 tgpt 运行。

配置代理

方式一：环境变量

使用 http_proxy 或 HTTP_PROXY，支持以下格式：

• HTTP 代理：http://ip:port
• HTTP 认证：http://user:pass@ip:port
• Socks5 代理：socks5://ip:port
• Socks5 认证：socks5://user:pass@ip:port

方式二：配置文件

支持以下位置：

• ./proxy.txt（与执行命令相同的目录）
• ~/.config/tgpt/proxy.txt

示例内容：

http://127.0.0.1:8080

更新

如果通过安装脚本安装（GNU/Linux、macOS、Windows），可以执行：

tgpt -u

在 GNU/Linux 和 macOS 上，视安装位置可能需要管理员权限。如果用包管理器（Homebrew、Pacman、Scoop、Chocolatey、Go）安装，请使用对应包管理器的更新命令（例如 brew upgrade tgpt、pacman -Syu tgpt、scoop update tgpt、choco upgrade tgpt 或 go install github.com/aandrew-me/tgpt/v2@latest）。

卸载

如果使用安装脚本安装，可以执行以下命令删除可执行文件：

sudo rm $(which tgpt)

配置文件在 GNU/Linux 上通常位于 ~/.config/tgpt，在 macOS 上位于 Library/Application Support/tgpt。

注意事项

• 项目采用 GPL-3.0 许可证。
• 使用安装脚本时，注意安装目录需要包含在 PATH 环境变量中，否则无法直接通过 tgpt 命令调用。
• 通过包管理器安装的版本请用包管理器更新，不要混用 tgpt -u。

---

本作品整理自 GitHub 开源项目 aandrew-me/tgpt，原作者 @aandrew-me，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。