详细介绍 Claude Code 的安装登录、终端与桌面端使用、CLAUDE.md、权限模式、MCP、会话管理和工程最佳实践。
Claude Code 是 Anthropic 的 Agent 编程工具，可以理解整个代码库、编辑文件、运行命令并接入开发工具。它提供终端 CLI、VS Code、JetBrains、桌面应用和网页端，多种入口使用同一套核心能力。
本文基于 2026 年 8 月 Claude Code 官方文档。安装命令、套餐支持和实验功能可能变化，操作前请以官方页面为准。
一、Claude Code 适合做什么
- 探索大型代码库并解释模块关系。
- 实现功能、修复 Bug、运行测试和生成提交。
- 通过 MCP 连接 GitHub、数据库、监控和内部工具。
- 用 CLAUDE.md、Skills、Hooks 固化团队工作流。
- 通过 CLI、CI/CD 或 Agent SDK 执行自动化任务。
二、安装 Claude Code
macOS、Linux 和 WSL
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell
irm https://claude.ai/install.ps1 | iex启动
cd /path/to/project
claude首次启动会要求登录；也可以使用 Anthropic Console 的 API Key。桌面端和 IDE 扩展可从官方入口安装，适合希望通过图形界面查看任务、差异和终端的用户。
三、推荐的首次会话
- 进入仓库根目录启动 Claude Code。
- 先询问“概括项目架构、启动方式和测试命令”。
- 让它只读分析一个小问题，确认理解正确。
- 再授权修改，并要求运行验证命令。
- 提交前审查改动文件、依赖和潜在副作用。
先阅读这个仓库，不要修改文件。
找出用户注册的完整调用链、权限检查和测试覆盖。
最后给出最小修复方案，等我确认后再实现。四、CLAUDE.md：给项目长期记忆
CLAUDE.md 用于保存构建命令、架构约定、代码风格和安全规则。它比在每个会话中重复说明更可靠。
# CLAUDE.md
## Commands
- npm ci
- npm run dev
- npm test
## Architecture
- API routes are in src/api
- Database access goes through src/repositories
## Safety
- Never commit secrets
- Ask before adding production dependencies
- Do not run database migrations automatically五、权限模式怎么选
Claude Code 的文件修改和命令执行应与任务风险匹配。阅读和规划可以更保守；明确的本地开发任务可允许工作区写入；生产部署、密钥处理、删除和外部通信应保留人工确认。
| 阶段 | 建议 |
|---|---|
| 探索 | 只读，先理解文件和调用链 |
| 实现 | 允许修改工作区，限制网络和系统范围 |
| 验证 | 允许运行项目测试和构建命令 |
| 发布 | 人工检查 diff、目标分支和凭据 |
六、会话和上下文管理
- 一个会话聚焦一个明确结果，避免混入多个无关任务。
- 长任务先建立计划和完成标准。
- 切换模块时总结已确认事实，减少上下文浪费。
- 使用会话恢复、分叉或远程控制时，先确认当前仓库和分支。
七、MCP、Skills 与 Hooks
MCP 负责连接外部数据和工具；Skills 负责复用工作方法；Hooks 适合在生命周期节点执行确定性脚本。常见组合是：MCP 读取 GitHub Issue，Skill 规定修复流程，Hook 在修改后自动运行格式化或安全检查。
连接外部服务时遵循最小权限原则，不要把长期密钥写进 CLAUDE.md。团队使用时应统一审计可安装的 MCP 和插件来源。
八、常用任务模板
修复 Bug
复现并定位这个错误。先说明根因和证据，再做最小修改。
补充回归测试并运行相关检查，不要顺手重构无关代码。实现功能
实现导出 CSV 功能。保持现有 API 兼容，处理空数据和大数据量。
完成后运行测试，并列出新增文件、行为变化和风险。代码审查
审查当前分支相对 main 的差异，只报告可执行问题。
优先检查权限、数据损坏、并发、兼容性和测试缺口。九、常见问题
安装后找不到 claude 命令
重新打开终端，确认安装目录位于 PATH，并参考官方安装故障排查。
上下文很快用完
减少无关日志和大文件，缩小任务范围，让 Claude 先搜索再读取关键片段。
修改结果不稳定
补充真实测试命令、输入输出示例和不可改变的约束；复杂任务先让它写计划。
