跳到主要内容
版本:2026 HER WAKA 活动

设置你的工具

在开始构建之前,先确保你已准备好所需的一切。本页将逐步引导你完成每个账号和工具的设置。

你需要准备: 一台能联网的笔记本电脑。无需任何编程经验 —— 我们会一步一步带你完成每个步骤。

分步设置

  1. 创建或登录你的 GitHub 账号

    GitHub 是你的代码存放的地方,也是机器人每天早上自动运行的地方。

    1. 前往 github.com
    2. 如果没有账号,点击 Sign up;如果已有账号,点击 Sign in
    3. 按照提示创建账号(免费套餐即可)

    选择一个专业的用户名 —— 雇主和同事都能看到它。

  2. 安装 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 版本)。安装后,关闭并重新打开终端,然后再试安装命令。

  3. 安装 Claude in Chrome

    Claude in Chrome 是一个浏览器扩展,帮助你研究文档和调试错误,无需离开浏览器。

    1. 打开 Chrome,前往 Chrome Web Store
    2. 搜索 Anthropic 的 "Claude"
    3. 点击 Add to Chrome
    4. 将其固定到工具栏以便快速访问
  4. 获取 OpenAI API 密钥

    机器人使用 OpenAI 的 API 将你的 git 提交记录转化为人类可读的每日更新。

    1. 前往 platform.openai.com
    2. 注册或登录
    3. 导航到 API keys(在左侧边栏或个人资料下)
    4. 点击 Create new secret key
    5. 给它起个名字,例如 daily-report-bot
    6. 立即复制密钥 —— 你以后将无法再次看到它
    7. 将其保存在安全的地方(密码管理器是理想选择)
    什么是 API 密钥?

    API 密钥就像一个密码,让你的代码能与外部服务通信。当你的机器人需要 OpenAI 来摘要你的提交记录时,它会将 API 密钥一起发送,这样 OpenAI 就知道是谁在请求并能向正确的账号收费。保管好你的 API 密钥 —— 任何拥有它的人都可以使用你的账号。

    OpenAI 为新账号提供少量免费额度。对于这个项目,你每月只会花几分钱 —— 每份每日报告大约花费 $0.01。

  5. 创建 Slack 应用和 Webhook

    Webhook 是你的机器人发送消息的地址。我们将创建两个:一个用于测试,一个用于生产。

    什么是 Webhook?

    Webhook 是一个接收传入消息的 URL。当你的机器人向这个 URL 发送数据时,Slack 会自动将其作为消息发布到你选择的频道。把它想象成一个信箱 —— 你的机器人投入信件,Slack 将其投递到正确的房间。

    创建 Slack 应用:

    1. 前往 api.slack.com/apps
    2. 点击 Create New AppFrom scratch
    3. 命名为 Daily Report Bot
    4. 选择你的工作区
    5. 点击 Create App

    添加 Incoming Webhooks:

    1. 在应用设置中,点击左侧边栏的 Incoming Webhooks
    2. Activate Incoming Webhooks 切换为 On
    3. 点击 Add New Webhook to Workspace
    4. 选择一个测试频道(例如 #bot-testing),点击 Allow
    5. 复制 Webhook URL —— 这是你的测试 Webhook
    6. 重复步骤 3–5,但选择你的生产频道(例如 #daily-standup)—— 这是你的生产 Webhook

    将两个 URL 保存在安全的地方。

    永远不要将 Webhook URL 提交到代码中。我们稍后会将它们存储为 GitHub Secrets。

  6. 创建 GitHub 仓库

    这是你的机器人代码存放的地方。

    1. 前往 github.com/new
    2. 命名为 daily-report-bot
    3. 设置为 Private(推荐,因为它将包含你的工作提交记录)
    4. 勾选 Add a README file
    5. 点击 Create repository

    然后将其克隆到你的电脑:

    复制此命令
    git clone https://github.com/YOUR-USERNAME/daily-report-bot.git
    cd daily-report-bot

    YOUR-USERNAME 替换为你的实际 GitHub 用户名。

  7. 安装 Wispr Flow(可选 —— 语音输入)

    Wispr Flow 让你可以对 Claude Code 说话而不是打字。你的声音会被转换成文字,直接传入终端 —— Claude Code 看到的方式与键盘输入完全相同。

    此步骤是可选的。 Wispr Flow 让你可以说话代替打字 —— 如果你更喜欢说话而不是打字,会很方便。如果你更喜欢打字输入提示词,可以跳过此步骤。

    使用此邀请链接注册,获得一个月免费 Pro 版: https://wisprflow.ai/r?CHAN115

    你和教程作者都能受益 —— 你获得一个月免费 Pro,当你口述 2,000 个单词时,作者也会获得一个月免费!

    1. wisprflow.ai/r?CHAN115 注册
    2. 下载并安装适合你操作系统的应用
    3. 配置设置 —— 启用以下选项以获得最佳体验:
      • 实验性功能 > 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 构建 —— 开始有趣的部分。