你一定经历过这样的场景：

# 你兴冲冲地装好了 Claude Code
npm install -g @anthropic-ai/claude-code
# 接下来对着终端敲下第一句话
claude "帮我重构这个项目"
# 接下来的几分钟。你看着它一顿操作猛如虎
# 改了一个文件，删了你精心设计的抽象层
# 把 TypeScript 类型全干成了 any
# 还顺手给你升了三个大版本的依赖

改完之后你 git diff 一看，心态直接崩了。不是 Claude 不行，是你没告诉它“规矩”。

这篇文章不聊 Claude 有多智能、AGI 离我们有多近这些虚的。从我只聊一件事来看，怎么配置 Claude Code。让它真正变成你的生产力工具，而不是一个需要你反复擦屁股的代码生成器。老实说，

关键配置的观点是。CLAUDE.md 才是灵魂

CLAUDE.md 是 Claude Code 的记忆文件——这个等下再说放在项目根目录，它会在每次对话开始时被自动加载。这是你跟 Claude 建立“工作契约”的地方。

一个真正有用的 CLAUDE.md

这是一个 B2B SaaS 的前端项目，技术栈：React + TypeScript + Vite + TanStack Query v5。状态管理用 Zustand，UI 组件库是内部封装的 @acme/ui。后端 API 是 RESTful 风格，统一走 /api/v2 前缀。鉴权用 JWT + Refresh Token。怎么说呢，

# 代码规范
- 组件文件用 PascalCase，工具函数用 camelCase
- 禁止使用 default export，全都用 named export
- 禁止使用 enum，用 as const 对象替代
- CSS 方案是 CSS Modules + PostCSS，不要引入 Tailwind 或 styled-components
- 类型定义统一放在同目录的 types.ts 中，不要用 interface，统一用 type
# 目录结构
src/
features/
-- 按业务模块划分。每个模块包含 components/hooks/api/types
shared/
-- 跨模块复用的工具、组件、hooks
app/
-- 路由配置、全局 Provider、入口文件
# 绝对不要做的事
- 不要修改 src/shared/legacy/ 下的任何文件，这是历史遗留代码，正在逐步迁移
- 不要动 package.json 的依赖版本
- 不要创建新的全局状态 store，需要的话先跟我确认
- 不要使用 any 类型，实在推断不出来用 unknown + 类型守卫

看到区别了吗？好的 CLAUDE.md 要具体到能直接指导编码决策的程度。哦不准确说是 INLINE_CODE_5__ 要具体到能直接指导编码决策的程度。“用 TypeScript”是废话，“禁止使用 enum。用 as const 替代”才是有效指令。

CLAUDE.md 的层级机制

这个不少人不知道——CLAUDE.md 支持多级放置：

项目根目录/CLAUDE.md -- 全局生效
项目根目录/src/CLAUDE.md -- 仅在操作 src 目录下文件时生效
项目根目录/tests/CLAUDE.md -- 仅在操作 tests 目录下文件时生效
~/.claude/CLAUDE.md -- 你所有项目都生效的个人偏好 

我的实际用法是：根目录放项目级规范；/src/features/ 下每个业务模块放一个，写清楚这个模块的业务上下文。再看比如，

负责计费相关功能。主要概念的观点是，- Plan: 套餐方案
- Subscription: 使用者的订阅实例，关联 Plan
- Invoice: 账单，由 Subscription 周期性生成
至于注意事项，- 金额统一用"分"作为单位，展示时再转换
- 所有金额计算必须用 Decimal.js，禁止浮点运算
- 退款逻辑非常复杂。修改前必须先读 src/features/billing/REFUND_LOGIC.md 

环境区分这方面，开发、CI、Code Review 三套配置

很多团队开始在 CI 流程里集成 Claude Code 做自动 Code Review 或者自动修复 lint 问题。这时候你需要区分环境，不过，

本地开发配置

{
"permissions": {
"allow":
},"model": "claude-sonnet--" }

CI 自动 Review 配置

# .github/workflows/claude-review.yml
name的观点是，Claude Code Review
从run来看。|
claude --print \
--model claude-sonnet-- \
--permission-mode bypass \
--max-turns \
"Review changes in this PR. Focus on:
. Type safety issues
. Missing error handling at API boundaries
. Performance anti-patterns
Do NOT suggest style changes,linter handles that."
说到env，ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

• 用 –print 模式，输出结果但不进入交互。
• 用 –max-turns 限制它的操作轮次避免跑飞。其实，
• "Prompt"里明确告诉它不要做什么

深度分析配置

遇到复杂架构决策或者疑难 bug 切到 Opus：

claude --model claude-opus-- \
"分析 src/features/billing/hooks/useSubscription.ts 的性能问题。这个 hook 在订阅列表页会导致每次筛选都触发全量重渲染。给出具体的调整方法，包括代码修改。" 

：跟 Claude Code 聊天是一门手艺

• Avoid saying “帮我写一个组件”。那只是模糊指令，让 Claude 随意发挥。
• Saying “在 src/features/user/components/ 下创建 UserList …” 给出了精确上下文和预期行为。也可以让 Claude 学习已有实现，从而保持一致性。
.

"别说 '帮我写一个组件'"—示例对比说明理由与好处。

请把上面示例中提到的一段说明补充完整

Sure!其实，Let's rewrite last part accurately and fully using proper tags:

But I think it's best to present it correctly within a single block without additional commentary. Let's provide a corrected snippet below:

Sure!Here's full corrected version for that section:

Sure!Here's correct version of that section in a single HTML snippet with proper tags:

We’ll avoid adding extra explanations outside final snippet so you can copy‑paste directly.

Sure!Here’s，