Claude Code 最佳实践 （一）

安装环境

Claude Code 可以装在这几类环境里：

环境	适合谁	主要优势
CLI（终端）	想要最强控制力、自动化、脚本化的人	完全体，能直接读写项目、运行命令、管理整个工程
VS Code / Cursor 扩展	平时就在 VS Code / Cursor 里开发的人	有原生图形面板、diff 审阅、文件与代码行引用
JetBrains / Android Studio 插件	IntelliJ、PyCharm、Android Studio 用户	支持交互式 diff 审阅、选择上下文等
Desktop（桌面版）	不想长期用命令行、想多会话并行的人	多会话并行、拖拽布局、集成终端和文件编辑器、可视化 diff、应用预览、PR 监控、定时任务
Web	不想本地装环境、想云端跑任务的人	跑在 Anthropic 托管的云端基础设施上，关掉浏览器后会话也会继续运行
Slack	团队协作、在群里直接抛需求/bug 的人	在频道里 @Claude 后，如果识别成编程任务，会自动路由到 Web 应用，Slack 里会回进度、完成摘要，并给 View Session / Create PR / Change Repo 等操作

IDE 扩展里内置了 CLI，需要高级能力时可直接在 IDE 集成终端里跑 claude 获得联动体验。

核心交互

当你给 Claude 一个任务时，它会经历三个阶段：收集上下文、采取行动和验证结果，然后循环持续迭代直到出结果。

你可以在任何时刻中断来重新引导 Claude ，从而避免让它一直偏离方向。

@ 和 ! 的用法

符号	作用	示例
@	感知：将文件/资源注入上下文	解释 @src/auth.ts 的逻辑
!	行动：在提示框中直接执行 Shell	! git log --oneline -5（结果注入上下文）

@ 的常见用法

解释 @src/auth.ts 的逻辑              # 引用单个文件
对比 @old-api.ts 和 @new-api.ts      # 引用多个文件
@src/components 的结构是什么？        # 引用目录

! 的常见用法

! git diff --stat                    # 执行命令，结果注入上下文
! npm test 2>&1 | tail -20           # 运行测试，截取尾部

注意 @ 每次引用都消耗上下文 token，1000 行的文件约占数千 token，所以要精准引用。

Effort Level

这个参数本质上是用来控制模型的推理深度 / 思考强度，在速度、成本、智能表现之间做权衡。Claude Opus 4.7 使用的是 adaptive reasoning，会自动决定使用哪个等级。

等级	任务场景
low	日常简单问答、格式化、小修小补
medium	成本优先、能接受一点能力下降
high	正式干活的起步档
xhigh	默认等级，大多数 coding 和 agentic 任务的最佳设置
max	极难问题、复杂架构、疑难调试

不要一直使用 max 等级，它可能出现收益递减，而且有时会过度思考，所以更适合拿来测试极限任务，而不是默认全场景开启。

常用/命令

在会话里直接输入 /，就会看到当前可用命令，以下是常用的命令：

命令	说明
/init	初始化项目，生成 CLAUDE.md 指南文件
/help	查看帮助和可用命令
/clear	清空当前上下文，开始新对话；旧会话仍可在 /resume 里找回
/compact [instructions]	压缩当前上下文，保留要点继续干活，特别适合长会话
/resume [session]	恢复历史会话
/config	打开设置界面，调主题、模型、输出风格等
/model	切换模型
/effort	会话内改 effort level
/permissions	管理工具权限规则
/context	可视化当前上下文使用情况
/memory	编辑 CLAUDE.md、查看自动记忆、开关 auto-memory

熟悉这些命令可以方便我们的快捷操作。

必备 CLI 工具

工具	功能
rg（ripgrep）	用来搜代码内容，基本可以当成更顺手的 grep -R
fd	用来找文件和目录，可以理解成更现代、更好记的 find
jq	用来处理 JSON
tmux	用来远程开发
gh(GitHub CLI)	用来操作 PR 和 Issue

CLI 工具不仅可以大幅提效，而且也可以节省与外部服务交互中所需要的上下文。