完整文档

安装

# 核心包
uv tool install claude-code-tools

# 包含 Google Docs/Sheets 扩展
uv tool install "claude-code-tools[gdocs]"

# 升级现有安装
uv tool install --force claude-code-tools

搜索引擎（aichat search）需要单独的 Rust 二进制文件：

• Homebrew（macOS/Linux）： brew install pchalasani/tap/aichat-search
• Cargo：cargo install aichat-search
• 预编译二进制文件： 发布页面 （查找 rust-v*）

安装 Claude Code 的 插件 以获取钩子、技能和代理：

claude plugin marketplace add pchalasani/claude-code-tools

---

点击卡片跳转至相应功能，或 阅读完整文档。

---

旧版链接 — 下方各节旨在保留早期讨论中分享的链接。如需最新文档，请访问 完整文档网站。

aichat — 会话管理

请参阅完整文档中的 aichat。

tmux-cli — 终端自动化

请参阅完整文档中的 tmux-cli。

语音插件

请参阅完整文档中的 Voice。

许可证

MIT

claude-code-tools 快速上手指南

claude-code-tools 是一套专为 Claude Code 及其他编码智能体设计的 CLI 工具集，包含技能（skills）、代理（agents）、钩子（hooks）和插件，旨在显著提升开发生产力。

环境准备

• 操作系统：macOS 或 Linux（Windows 用户建议通过 WSL2 使用）。
• 前置依赖：
  • Python 环境：需安装 uv 包管理器（推荐）或兼容的 Python 环境。
  • Rust 环境（可选但推荐）：若需使用 aichat search 搜索引擎功能，需安装 Rust 工具链或对应二进制文件。
  • Claude Code：确保已安装并配置好 Claude Code 客户端。

安装步骤

1. 安装核心工具包

使用 uv 安装核心命令行工具：

# 安装核心包
uv tool install claude-code-tools

# 如需集成 Google Docs/Sheets 额外功能
uv tool install "claude-code-tools[gdocs]"

# 升级现有安装
uv tool install --force claude-code-tools

2. 安装搜索引擎组件（可选）

若需使用 aichat search 功能，请根据系统选择以下任一方式安装独立的 Rust 二进制文件：

• Homebrew (macOS/Linux):

  brew install pchalasani/tap/aichat-search
  

• Cargo (Rust):

  cargo install aichat-search
  

• 预编译二进制: 前往 Releases 页面 下载标记为 rust-v* 的文件。

3. 安装 Claude Code 插件

为了启用钩子、技能和代理功能，需在 Claude Code 中注册插件：

claude plugin marketplace add pchalasani/claude-code-tools

基本使用

安装完成后，工具将自动集成到 Claude Code 会话中。以下是几种典型的使用场景：

场景一：调用内置技能与代理

在 Claude Code 对话中，你可以直接通过自然语言调用已安装的技能。例如，请求代码审查或使用特定框架生成代码：

/ask 使用 vault 工具检查当前项目的敏感信息泄露风险

或者让 Agent 自动执行任务：

请使用 tmux-cli 代理在当前终端会话中运行测试并监控输出

场景二：使用终端自动化工具 (tmux-cli)

直接在命令行中调用工具来管理终端会话（需确保 tmux 已安装）：

# 示例：列出当前活跃的 tmux 会话供 AI 参考
aichat tmux list-sessions

场景三：安全与环境检查

利用 env-safe 或安全钩子自动扫描环境变量安全性：

/check 运行 env-safe 检查当前 shell 环境是否存在不安全配置

提示：更多高级功能（如语音插件、Google 文档集成、会话修复等）的详细指令请参阅 完整文档。