通俗版 Claude Code 文档

结构照原 docs,内容改成真能照着做的人话版。

查看原始文档 目录顺序与官方保持一致

平台和集成

Slack

Slack 这一页讲的,就是 Slack 这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

Slack

页面性质

第三方中文解释页

使用建议

先看人话解释,再对照原页命令和代码

这页不是官方原文,而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留,解释部分则尽量讲成人能照着做的话。

如果你碰到特别敏感的配置、权限或企业环境差异,最好顺手点上面的“查看原始文档”再核一遍。

这一页先讲明白

Slack 集成适合把团队聊天里的需求直接送到 Claude 手里。

比如群里有人报 bug,它可以顺着去开工。

这像在群里喊一声,帮工就从聊天记录里接单。

对团队协作特别省来回转述的功夫。

最适合报障、转需求、催调查这类协作场景。

群里说的话最好也尽量清楚,不然 Claude 只会把糊涂单接过去。

预留广告位

正文中段响应式广告 等你后面真接 AdSense,这里再放正式广告。

Documentation Index

这里不是让你背"Documentation Index"这个词,而是让你看它真干活时怎么使。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Use cases

这一段主要是在把"Use cases"讲实,不是只摆个标题给你看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Prerequisites

这一块主要是在说"Prerequisites"真到手上该怎么用,哪里最容易踩坑。

Setting up Claude Code in Slack

这一段就是安装 the Claude App in Slack。这种地方最怕跳步骤,最好老老实实按顺序来。

How it works

这里讲底层是怎么运转的。你把它看明白,后面遇到异常时就知道该往哪儿查。

Automatic detection

这一段更像在讲判断条件,什么时候该上,什么时候先别急。把触发条件看清,比背标题更重要。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Context gathering

这里不是让你背"Context gathering"这个词,而是让你看它真干活时怎么使。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Session flow

这一段主要是在把"Session flow"讲实,不是只摆个标题给你看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

User interface elements

这一块主要是在说"User interface elements"真到手上该怎么用,哪里最容易踩坑。

App Home

这里主要是在交代"App Home"这一块会碰到哪些事。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Message actions

这种内容最怕想当然,老老实实照它列的格式走最稳。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Repository selection

这里不是让你背"Repository selection"这个词,而是让你看它真干活时怎么使。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Access and permissions

这一块主要是在说"Access and permissions"真到手上该怎么用,哪里最容易踩坑。

User-level access

这里不是让你背"User-level access"这个词,而是让你看它真干活时怎么使。

Workspace-level access

这里不是让你背"Workspace-level access"这个词,而是让你看它真干活时怎么使。

Channel-based access control

这一段主要是在把"Channel-based access control"讲实,不是只摆个标题给你看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

What’s accessible where

这一块主要是在说"What’s accessible where"真到手上该怎么用,哪里最容易踩坑。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Best practices

这段算经验活,听劝通常能省事。

Writing effective requests

这一块主要是在说"Writing effective requests"真到手上该怎么用,哪里最容易踩坑。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

When to use Slack vs. web

这一段主要是在帮你判断:When to use Slack vs. web 这种东西到底值不值得现在就上。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Troubleshooting

这里讲的是怎么找毛病,先查明白哪一步出错,再决定怎么修。

Sessions not starting

这一段主要是在把"Sessions not starting"讲实,不是只摆个标题给你看。

Repository not showing

这一段主要是在把"Repository not showing"讲实,不是只摆个标题给你看。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Wrong repository selected

这里不是让你背"Wrong repository selected"这个词,而是让你看它真干活时怎么使。

Authentication errors

这一块主要是在说"Authentication errors"真到手上该怎么用,哪里最容易踩坑。

Session expiration

看到这里,就把"Session expiration"当成一件真要上手的活来看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Current limitations

这一段主要是在把"Current limitations"讲实,不是只摆个标题给你看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Related resources

这一段主要是在把"Related resources"讲实,不是只摆个标题给你看。

Claude Code on the web

这一块主要是在说"Claude Code on the web"真到手上该怎么用,哪里最容易踩坑。

Claude for Slack

看到这里,就把"Claude for Slack"当成一件真要上手的活来看。

Slack App Marketplace

这一段就是安装 the Claude app from the Slack Marketplace。这种地方最怕跳步骤,最好老老实实按顺序来。

照着做一遍

这页属于“Slack”这类活,最稳的办法还是一小步一小步来。

下面这三步不一定华丽,但通常最不容易绕晕。

第 1 步:先起步

最适合报障、转需求、催调查这类协作场景。

第 2 步:边做边看

群里说的话最好也尽量清楚,不然 Claude 只会把糊涂单接过去。

一眼看懂这一页

这页的作用,就是把原本偏专业的话题,拆成能直接照着走的明白话。

Slack
   |
   v
Slack 这一页讲的,就是 Slack 这件事在 Claude Code 里到底怎么用。
   |
   v
照着步骤去做

文末提醒

这站会按官方 docs 的导航和内容变化继续重生成,原站加页、删页、改页时,这里会跟着更新。

人话解释会尽量顺着原页往下讲,但命令、参数名、配置名这些硬东西还是保留原样,免得你抄过去跑不起来。