企业官网建设流程全解析

5分钟上手Tau Coding Agent：从安装到第一次自动改代码的完整指南

【免费下载链接】tauA Python port of Pi’s minimalist coding agent.项目地址: https://gitcode.com/gh_mirrors/tau16/tau

Tau是一个用 Python 编写的终端Coding Agent（AI 编程智能体）——Pi 极简编码智能体的 Python 移植版。它运行在你的终端里：你用自然语言说"给这个函数加文档"或"修复这个报错"，它就能自动读文件、改代码、跑命令，并实时展示每一步操作。本文带你在 5 分钟内完成Tau 安装、连接 AI 模型，并让它在真实项目中完成第一次自动改代码。

🧩 Tau Coding Agent 是什么？

把 Tau 理解成一个"会看代码、能动手"的终端助手：

• 对话式编程：输入自然语言请求，它自己决定读哪些文件、执行什么命令、改哪段代码
• 内置 4 个编码工具：read（读文件）、write（写新文件）、edit（精确修改）、bash（执行命令）
• 会话可恢复：每次对话自动保存为持久会话，随时可以继续，甚至从历史任意点"分支"尝试不同方案
• 多模型支持：OpenAI、Anthropic、OpenRouter、Hugging Face，以及任意 OpenAI 兼容的本地模型

它还有一个特别的地方——代码本身也是教学材料。三个小包分工清晰，适合想搞懂"AI 编程智能体是怎么造出来的"的读者：

🚀 一键安装：3 种方式装好 Tau

Tau 要求Python 3.12 或更高版本，发布在 PyPI 上，包名为tau-ai。任选一种方式安装（推荐前两种，环境隔离更干净）：

uv tool install tau-ai # 或 pipx install tau-ai # 或 python -m pip install tau-ai

安装完成后，验证命令是否可用：

tau --version

✅ 看到版本号输出，说明安装成功，全程不到 1 分钟。

💡想从源码开发？也可以克隆仓库本地运行（详见 README.md 的 Development 一节）：

git clone https://gitcode.com/gh_mirrors/tau16/tau cd tau uv sync --dev uv run tau --version

🔑 连接第一个 AI 模型：/login 是最快路径

Tau 需要连接一个模型服务商（Provider）才能工作。最快的方式是在 Tau 内部用/login：

cd my-project # 进入你的项目目录 tau # 启动 Tau

进入界面后，输入以下任一命令：

/login # 打开服务商选择器（带搜索） /login openai # 保存 OpenAI API 密钥 /model # 切换 / 选择模型

Tau 内置支持OpenAI、Anthropic、OpenAI Codex（订阅）、GitHub Copilot、OpenRouter、Hugging Face等服务商，也支持添加任意 OpenAI 兼容端点（包括本地模型）。内置模型目录在 src/tau_coding/data/catalog.toml，你只需把同样格式的catalog.toml放到~/.tau/下即可扩展，无需改代码。更多接入方式见 providers-and-models 指南。

✍️ 第一次自动改代码：3 句话让 Tau 动手

模型连好后，试试这两步——这就是"AI 自动改代码"最直观的形态：

第一步，让它读懂项目：

explain what this project does

Tau 会流式输出分析结果，期间它自己决定读哪些文件。

第二步，让它改代码：

add a docstring to every function in src/utils.py

你会看到read→edit的工具调用逐个实时发生：它先读取目标文件，再执行精确的文本替换，每次修改都附带 diff 供你核对。这就是 Coding Agent 的完整闭环：理解 → 规划 → 动手 → 展示。

🛠️ 4 个内置工具速查：Tau 靠它们干活

其中edit的机制很讲究：所有替换先整体校验、全部通过才落盘，且每段旧文本必须在文件中唯一匹配，避免了改坏文件的尴尬。细节见 Built-in tools 参考。

⏪ 稍后继续：会话自动保存，随时恢复

Tau 把每次对话作为**会话（Session）**追加保存到~/.tau/sessions/，按项目目录组织。常用操作：

tau sessions # 列出所有会话 tau --session <session-id> # 恢复指定会话

在 TUI 里输入/resume则打开图形化选择器，按项目分栏浏览历史会话；退出时 Tau 还会贴心地打印恢复命令。会话甚至是一棵"树"——用/tree可以从历史任意点分叉，尝试不同的修改路线。完整玩法见 Sessions 指南。

⚡ 脚本党福音：一次性 print 模式

不需要界面？一行命令搞定，非常适合写进脚本或管道：

tau -p "summarize the architecture" tau --cwd /path/to/project -p "find the CLI entry point"

⌨️ 常用快捷键一览

更多按键可在会话内输入/hotkeys查看，完整列表见 Keyboard shortcuts。

📚 下一步去哪

• 官方快速上手：Quickstart
• 理解核心概念（智能体循环、事件流）：Core concepts
• 终端界面完整指南：TUI 指南
• 想读源码？从 README.md 的架构图开始，dev-notes/目录里有完整的分阶段开发记录

回顾一下：装好 Tau Coding Agent（uv tool install tau-ai）→/login连模型 → 在项目目录输入一句自然语言 → 看它自动读文件、改代码。5 分钟，你已经拥有了一个可长期使用的终端 AI 编程智能体。🎉

【免费下载链接】tauA Python port of Pi’s minimalist coding agent.项目地址: https://gitcode.com/gh_mirrors/tau16/tau