Claude Code

用好 Claude Code

从第一次读项目到改代码、跑测试和管理上下文

启动与恢复会话

claude                         # 进入交互模式
claude -p "解释这个项目"       # 完成一次任务后退出
claude --continue              # 继续最近的会话
claude --resume                # 从历史会话中选择

首次进入仓库时，先让 Claude 只读分析：

先阅读项目结构和说明文件，不要修改任何内容。
告诉我项目用途、技术栈、启动方式和测试命令。

常用会话命令

命令可能随版本变化。在会话中输入 /help 查看当前版本支持的完整列表。

命令	用途
`/help`	查看帮助和可用命令
`/clear`	清空当前上下文，开始新任务
`/model`	查看或切换模型
`/status`	检查登录、模型和配置状态
`/context`	查看上下文占用
`/resume`	恢复历史会话
`/mcp`	查看 MCP 连接状态

写出可执行的任务

说明目标、范围、限制和验收方式：

修复登录按钮点击后没有响应的问题。

范围：只修改 src/auth 和对应测试。
限制：不要更换依赖，不要改变公开 API。
验收：复现问题，完成修复，运行相关测试，并总结修改文件。

避免只写“帮我改一下”。Claude 不知道哪些行为必须保留，也无法判断何时完成。

使用权限模式

Claude Code 可以根据当前版本提供询问、自动接受或计划等权限模式。新手应保留逐项确认：

只读调查可以放宽读取权限。
文件修改和命令执行先逐项确认。
删除文件、发布、推送和生产操作必须人工复核。
不要在包含私人文件的上级目录直接启动 Claude Code。

用 `CLAUDE.md` 固化规则

在项目根目录创建 CLAUDE.md，记录 Claude 每次都需要遵守的信息：

# Project instructions

- Use Go 1.24.
- Run `go test ./...` after code changes.
- Keep public API changes backward compatible.
- Do not edit generated files by hand.
- Never commit secrets or local configuration.

规则应具体、可执行，并与仓库真实命令一致。过长的背景资料应放在普通文档中，再从 CLAUDE.md 链接。

管理上下文和订阅用量

用 /context 观察当前上下文占用。
无关任务使用 /clear 或新会话。
大文件只引用相关部分，不要把整个构建产物加入上下文。
先让 Claude 搜索定位，再读取具体文件。
Claude 网页版和订阅授权的 Claude Code 可能共享套餐限制。

常用任务模板

修复错误

复现下面的错误并定位根因：[错误信息]
先解释根因，再做最小修改。
修改后运行相关测试，并列出仍存在的风险。

实现功能

实现 [功能]。
必须满足：[验收条件]
不要修改：[边界]
先给出计划，确认现有模式后再编码，最后运行测试。

代码审查

审查当前分支相对 main 的改动。
优先找行为错误、安全风险、兼容性回归和缺失测试。
按严重程度列出文件和行号，不要直接修改。

工具生态

选择 IDE、用量统计和会话工具。

连接 MCP

让 Claude 访问 GitHub、浏览器和外部数据。

加群 & 客服