设置你的工具
在开始构建之前,先确保你已准备好所需的一切。本页将逐步引导你完成每个账号和工具的设置。
你需要准备: 一台能联网的笔记本电脑。无需任何编程经验 —— 我们会一步一步带你完成每个步骤。
分步设置
创建或登录你的 GitHub 账号
GitHub 是你的代码存放的地方,也是机器人每天早上自动运行的地方。
- 前往 github.com
- 如果没有账号,点击 Sign up;如果已有账号,点击 Sign in
- 按照提示创建账号(免费套餐即可)
选择一个专业的用户名 —— 雇主和同事都能看到它。
安装 Claude Code
Claude Code 是为我们编写所有代码的 AI 编程助手。它在你的终端中运行。
打开终端(Mac 上是 Terminal,Windows 上是 PowerShell 或 Git Bash),然后运行:
复制此命令npm install -g @anthropic-ai/claude-code然后输入以下命令启动它:
复制此命令claude按照屏幕上的说明登录你的 Anthropic 账号。
如果我没有 npm 怎么办?
npm随 Node.js 一起提供。从 nodejs.org 下载并安装 Node.js(选择 LTS 版本)。安装后,关闭并重新打开终端,然后再试安装命令。安装 Claude in Chrome
Claude in Chrome 是一个浏览器扩展,帮助你研究文档和调试错误,无需离开浏览器。
- 打开 Chrome,前往 Chrome Web Store
- 搜索 Anthropic 的 "Claude"
- 点击 Add to Chrome
- 将其固定到工具栏以便快速访问
获取 OpenAI API 密钥
机器人使用 OpenAI 的 API 将你的 git 提交记录转化为人类可读的每日更新。
- 前往 platform.openai.com
- 注册或登录
- 导航到 API keys(在左侧边栏或个人资料下)
- 点击 Create new secret key
- 给它起个名字,例如
daily-report-bot - 立即复制密钥 —— 你以后将无法再次看到它
- 将其保存在安全的地方(密码管理器是理想选择)
什么是 API 密钥?
API 密钥就像一个密码,让你的代码能与外部服务通信。当你的机器人需要 OpenAI 来摘要你的提交记录时,它会将 API 密钥一起发送,这样 OpenAI 就知道是谁在请求并能向正确的账号收费。保管好你的 API 密钥 —— 任何拥有它的人都可以使用你的账号。
OpenAI 为新账号提供少量免费额度。对于这个项目,你每月只会花几分钱 —— 每份每日报告大约花费 $0.01。
创建 Slack 应用和 Webhook
Webhook 是你的机器人发送消息的地址。我们将创建两个:一个用于测试,一个用于生产。
什么是 Webhook?
Webhook 是一个接收传入消息的 URL。当你的机器人向这个 URL 发送数据时,Slack 会自动将其作为消息发布到你选择的频道。把它想象成一个信箱 —— 你的机器人投入信件,Slack 将其投递到正确的房间。
创建 Slack 应用:
- 前往 api.slack.com/apps
- 点击 Create New App → From scratch
- 命名为
Daily Report Bot - 选择你的工作区
- 点击 Create App
添加 Incoming Webhooks:
- 在应用设置中,点击左侧边栏的 Incoming Webhooks
- 将 Activate Incoming Webhooks 切换为 On
- 点击 Add New Webhook to Workspace
- 选择一个测试频道(例如
#bot-testing),点击 Allow - 复制 Webhook URL —— 这是你的测试 Webhook
- 重复步骤 3–5,但选择你的生产频道(例如
#daily-standup)—— 这是你的生产 Webhook
将两个 URL 保存在安全的地方。
永远不要将 Webhook URL 提交到代码中。我们稍后会将它们存储为 GitHub Secrets。
创建 GitHub 仓库
这是你的机器人代码存放的地方。
- 前往 github.com/new
- 命名为
daily-report-bot - 设置为 Private(推荐,因为它将包含你的工作提交记录)
- 勾选 Add a README file
- 点击 Create repository
然后将其克隆到你的电脑:
复制此命令git clone https://github.com/YOUR-USERNAME/daily-report-bot.git
cd daily-report-bot将
YOUR-USERNAME替换为你的实际 GitHub 用户名。安装 Wispr Flow(可选 —— 语音输入)
Wispr Flow 让你可以对 Claude Code 说话而不是打字。你的声音会被转换成文字,直接传入终端 —— Claude Code 看到的方式与键盘输入完全相同。
此步骤是可选的。 Wispr Flow 让你可以说话代替打字 —— 如果你更喜欢说话而不是打字,会很方便。如果你更喜欢打字输入提示词,可以跳过此步骤。
使用此邀请链接注册,获得一个月免费 Pro 版: https://wisprflow.ai/r?CHAN115
你和教程作者都能受益 —— 你获得一个月免费 Pro,当你口述 2,000 个单词时,作者也会获得一个月免费!
- 在 wisprflow.ai/r?CHAN115 注册
- 下载并安装适合你操作系统的应用
- 配置设置 —— 启用以下选项以获得最佳体验:
- 实验性功能 > Command Mode —— 启用高级语音命令
- Press Enter Command —— 当你说"press enter"时自动按回车
- Bulk Import —— 导入片段和字典项目
什么是 Wispr Flow?
Wispr Flow 是一款语音转文字工具,让你可以口述代替打字。它在任何应用中都能使用,包括终端。与其向 Gemini CLI 打出一段长提示词,你可以直接说出来。如果你觉得打字慢或疲惫,这特别有用。
为什么为编程使用语音输入? 当你向 Claude Code 描述功能、业务逻辑或调试问题时,说话通常比打字更快、更自然。你可以像向同事解释一样说出你想要什么 —— Wispr Flow 负责转录,Claude Code 负责编码。
验证你的设置
继续之前,检查一切是否就绪:
GitHub 账号
你可以登录 github.com 并看到你的新 daily-report-bot 仓库。
Claude Code
在终端运行 claude --version,应看到版本号。
Claude in Chrome
你能在 Chrome 工具栏看到 Claude 图标,点击 它会打开扩展。
OpenAI API 密钥
你有一个保存在安全地方的 API 密钥(以 sk- 开头)。
Slack Webhooks
你保存了两个 Webhook URL:一个用于测试频道,一个用于生产频道。
仓库已克隆
你的电脑上有 daily-report-bot 文件夹,可以 cd 进入。
Wispr Flow(可选)
Wispr Flow 正在运行,你可以在任何应用中看到说出的话变成文字。
全部就绪?前往用 Claude Code 构建 —— 开始有趣的部分。