Anthropic · 终端协作工作流
Claude Code 使用攻略
用持续对话理解代码库,再用权限、规则和工具控制执行边界。
Claude Code 适合长上下文协作:探索遗留代码、补测试、多文件重构和连接 MCP 服务。项目说明、权限规则、Skills 与子代理可以组合成稳定的团队工作流。
约 12 分钟资料核验 含安全检查
本轮资料更新
安装与协作方式更新
- 官方已提供原生安装、Homebrew、WinGet 和桌面端路径,不再把 Node.js 作为统一的上手前提。
- 桌面端可查看差异、并行会话和安排任务;Homebrew 与 WinGet 安装需要按对应渠道升级。
01 · 快速上手
从第一次启动,到完成一个真实任务
01
安装并启动
在项目目录运行 claude;首次进入可用 /init 生成项目说明草稿。
02
建立项目记忆
精简 CLAUDE.md,只记录项目特有约定、常用命令与关键决策。
03
逐步开放权限
先用 plan 模式探索,再允许编辑;用 /permissions 和 /mcp 检查边界。
建议从这个任务开始
请先以 plan 模式检查这个 PR:找出行为变化、缺失测试和潜在回归。不要修改文件,最后给出按优先级排序的建议。
先用小样本验证结果,再扩大任务范围。
02 · 基础配置
上手设置与任务模板
项目上下文与权限 · CLAUDE.md + .claude/settings.json
# CLAUDE.md
## 常用命令
- pnpm dev
- pnpm test
- pnpm lint
## 项目约定
- 优先复用现有组件和 tokens
- 修改后说明测试结果
- 不读取 .env 和生产配置
认证逻辑位于 app/(auth),共享 UI 位于 components/ui。命令按当前官方资料整理;选择适合自己系统的安装方式,执行前核对版本与工作目录。
03 · 实用技巧
真正拉开效果差距的使用习惯
技巧 01
规则写短,入口写准
CLAUDE.md 优先记录这个项目独有的约束与关键路径,不重复通用常识。
技巧 02
团队与个人配置分开
共享服务使用项目级配置;个人凭据留在本地范围,避免提交 secrets。
技巧 03
按任务选择权限模式
探索用 plan,日常迭代用默认模式;高权限模式只用于可信的隔离环境。
可直接复用的任务模板
请先以 plan 模式检查这个 PR:找出行为变化、缺失测试和潜在回归。不要修改文件,最后给出按优先级排序的建议。
04 · 安全边界
明确使用与执行边界
执行前检查
- 把 allow / ask / deny 规则放在可审查的位置
- MCP 只连接可信域名、仓库和服务
- 不要在生产目录或 root 权限下使用高权限模式
05 · 学习资源
继续深入
官方资料用于确认安装、命令和权限;社区资料用于补充中文经验与案例。涉及版本的内容请以官方为准。