Claude Code 使用前必须先理解权限、项目目录、命令执行、费用和验证流程。它可以读取代码库、编辑文件、运行测试并协助完成开发任务,但也可能触发 API 费用、误改文件或执行高风险命令。本文整理新手上手前必须知道的 10 件事。
摘要:先懂规则,再让 Claude Code 改项目
Claude Code 是强大的 AI 编程 Agent,但它不是“打开就能放心全自动跑”的工具。根据 Anthropic 官方安全文档,Claude Code 默认使用严格的只读权限;当需要编辑文件、运行测试或执行命令时,会请求明确许可。你可以选择单次批准,也可以设置自动允许,但新手不建议一开始就全部放开。
费用同样需要提前弄清楚。Pro/Max 用户可以用 Claude Code,但如果选择使用 API credits,后续会按标准 API 价格另行计费;API Key 用户则可以通过 /cost 查看当前 session 花费。使用前先确认登录方式、计划额度、API credits 和自动充值设置,能避免“以为包含在订阅里,结果额外扣费”的误解。
如果你还在入门阶段,可以先看站内 Claude Code 是什么 和 Claude Code 怎么用;如果你不会编程但想做网站,可以看 零基础做网站实测;如果要区分 Claude Code 和普通 Claude,可参考 聊天助手和编程 Agent 对比。
第 1 件事:Claude Code 默认不是无限权限
很多新手担心 Claude Code 会自动乱改项目。官方安全文档说明,Claude Code 默认采用严格只读权限。读取基础信息、查看文件、运行一些只读命令时风险较低;一旦涉及编辑文件、运行测试、执行 Bash 命令,系统会请求明确许可。
哪些命令通常较安全
例如 ls、cat、git status 这类只读命令通常不需要同等强度的风险确认。它们用于了解项目结构和当前状态。
哪些操作要谨慎
编辑文件、安装依赖、运行迁移、删除文件、执行脚本、修改配置、访问外部服务,都要谨慎。新手看到权限确认时,不要直接全选允许,要先看命令内容。
第 2 件事:启动目录决定工作范围
Claude Code 通常从项目目录启动。你在哪个目录运行 claude,它就会围绕这个工作区理解项目。进入错误目录,会导致它读不到代码、改错项目或找不到依赖。
启动前先检查
pwd
ls
git status
Windows PowerShell 可以用:
Get-Location
Get-ChildItem
git status
Monorepo 要说明子项目
如果项目是 monorepo,提示词里要写清楚本次只处理哪个 app 或 package,避免 Claude Code 扫到无关目录。
第 3 件事:它不会一次性索引整个代码库
Claude Code FAQ 说明,它不是先自动索引整个仓库,而是根据任务需要用工具搜索和读取文件。这有利于灵活处理大项目,但也意味着你的任务描述要清楚。
更好的提示方式
请先阅读 README、package.json 和 src/pages/login 相关文件。
不要修改文件。
请先告诉我登录页的主要结构和验证命令。
避免太宽泛的问题
“帮我优化整个项目”太宽泛。更好的是“只优化登录页首屏加载,不修改认证逻辑”。
第 4 件事:命令执行要分级管理
Claude Code 的价值之一是能运行命令,但命令也带来风险。测试、lint、build 通常是验证命令;删除、迁移、部署、安装全局包则可能影响环境。
建议允许的命令
npm run lint
npm test
npm run build
git status
git diff
新手应谨慎的命令
任何包含 rm、del、数据库迁移、生产部署、全局安装、权限修改、网络下载脚本的命令,都要先问清楚影响范围。
第 5 件事:不要暴露密钥和生产配置
Claude Code 进入真实项目后,很容易遇到 .env、证书、API Key、数据库密码。不要为了排查方便把这些文件交给 AI。正确做法是提供 .env.example 或脱敏变量名。
推荐做法
不要读取 .env 和任何密钥文件。
如果需要配置,请只参考 .env.example。
如果变量缺失,请列出变量名,不要要求查看真实值。
第 6 件事:费用取决于登录方式和计划
Claude Code 可以通过 Claude Pro/Max 计划使用,也可以通过 Console/API credits 或第三方云平台使用。官方帮助文档明确提醒:如果你选择用 API credits,使用会按标准 API 价格计费,和 Pro/Max 订阅价格不同。
Pro/Max 用户要注意
如果希望严格使用计划额度,不要在提示中选择 API credit 选项。官方建议可以在达到额度后等待使用周期重置,并使用 /status 查看剩余额度。
API Key 用户要注意
如果使用 API Key,官方文档提到 /cost 可以显示当前 session 的运行花费。长任务、长上下文和多轮工具调用都会增加成本。
第 7 件事:学会这几个状态命令
/status
用于查看当前账号状态、计划额度等信息。Pro/Max 用户尤其应该关注它。
/cost
API Key 用户可以用它查看当前 session 花费。做长任务前先看一次,任务后再看一次,有助于建立成本感觉。
/model
用于查看和切换当前可用模型。官方模型和限制文档建议,Sonnet 通常适合大多数编码工作,速度、能力和成本比较平衡。
第 8 件事:Git diff 是最后一道保险
Claude Code 修改完成后,不要只看它的总结。真正需要审查的是 Git diff。
每次任务后运行
git status
git diff
确认它没有修改无关文件、没有碰密钥、没有删除重要逻辑、没有引入不必要依赖。
建议先开分支
git checkout -b claude-code-test
新手练习时先在分支里操作,出问题更容易回滚。
第 9 件事:settings、deny 和 hooks 能管住行为
Claude Code 支持通过 settings 管理权限、工具、MCP、信任设置等。官方 settings 文档提到,~/.claude.json 和项目配置会保存 OAuth session、MCP 配置、允许工具、信任状态等信息。
deny 规则
你可以用 deny 规则阻止读取敏感文件,或限制某些工具调用。团队环境还可以通过 managed permissions 统一管控。
hooks
Hooks 可以在工具调用前后运行检查逻辑,也可以阻止或拒绝某些权限。对团队和企业来说,这是把 Claude Code 纳入工程治理的重要方式。
第 10 件事:复杂任务要先计划后执行
Claude Code 最适合的方式不是“直接改”,而是“先读、再计划、后执行、再验证”。复杂任务尤其要先让它说明影响范围。
推荐模板
先不要修改文件。
请先完成:
1. 阅读相关文件
2. 说明问题根因
3. 列出修改计划
4. 标注可能风险
5. 给出验证命令
等我确认后再执行。
适合拆分的任务
大重构、支付、登录、权限、数据库、部署、CI/CD 都应该拆成多步。每一步完成后运行验证,再进入下一步。
使用前检查清单
- 确认当前目录是正确项目。
- 确认项目已用 Git 管理。
- 确认哪些文件可以改,哪些不能改。
- 确认不会读取真实密钥。
- 确认登录方式是 Pro/Max、Team、API 还是云平台。
- 确认是否启用 API credits 或 auto-reload。
- 确认验证命令是什么。
- 确认上线前有人工复核和回滚方案。
FAQ:Claude Code 使用前常见问题
Claude Code 会自动扣 API 费用吗?
取决于你的登录方式和是否选择 API credits。Pro/Max 计划和 API/Console 计费是不同路径,API credits 会按标准 API 价格另计。
如何确认当前有没有走 API 费用?
API Key 用户可以使用 /cost 查看当前 session 花费;Pro/Max 用户可以用 /status 查看额度状态。
可以让 Claude Code 自动允许所有命令吗?
技术上可以配置更宽权限,但新手不建议。先熟悉只读、编辑、Bash、测试和部署命令的区别。
Claude Code 可以读取 .env 吗?
不要让它读取真实 .env。建议使用 .env.example 或脱敏变量名,避免泄露密钥和生产配置。
修改错了怎么办?
用 git diff 找到改动,不满意就撤回相关文件。重要任务建议先建分支。
Team 或 Enterprise 能统一管控权限吗?
可以。官方 enterprise deployment 文档说明,安全团队可配置 managed permissions,限制 Claude Code 可以和不可以做什么。
参考来源
- Claude Code Docs:Security
- Claude Code Docs:Settings
- Claude Code Docs:CLI reference
- Claude Help Center:Use Claude Code with your Pro or Max plan
- Claude Help Center:Models, usage, and limits in Claude Code
- Claude Help Center:Manage usage credits for paid Claude plans
会员充值与订阅排查资料
适合阅读会员充值、订阅购买、权益对比和支付问题类文章后继续转化。