我如何配置 Claude Code 作为日常开发伙伴

Claude Code 是我每天用得最多的开发工具，横跨 Rust、Python、TypeScript 和 C# 项目，一天几百条消息。折腾了几个月，现在这套配置比任何 IDE 插件都顺手。这篇文章把整套配置拆开讲讲。

整体结构

所有东西都在 ~/.claude/ 下面：

~/.claude/
├── CLAUDE.md              # 全局指令（每次会话自动加载）
├── settings.json          # 权限、Hooks、插件、状态栏
├── rules/                 # 10 个规则文件（代码风格、Git、安全等）
├── projects/              # 按项目的持久化记忆
│   └── <project>/memory/
│       ├── MEMORY.md      # 记忆索引
│       ├── user-profile.md
│       └── ...
├── skills/                # 自定义技能（深度调研等）
│   ├── SKILL.md
│   └── templates/
├── statusline-command.sh  # 自定义状态栏脚本
├── update-pricing.sh      # 自动抓取 Anthropic 定价
└── cache/
    └── model-pricing.env  # 缓存的定价数据

CLAUDE.md —— 系统提示词

每次会话都会加载这个文件。我在里面写了：

• 身份：全栈开发，Rust/C#/.NET/Python/TypeScript
• 环境：macOS 宿主机 + Windows 虚拟机（Parallels）跑 .NET Framework 4.8
• 行为约束：先读代码再改、不确定就问、匹配现有风格、永远不 force-push main
• 规则索引：每种语言/领域指向独立的规则文件

CLAUDE.md 只做索引，不堆内容。一大坨文字反而容易被忽略。

规则文件 —— 把标准写下来

~/.claude/rules/ 下 10 个文件：

全局生效，所有项目通用。项目还可以有自己的 CLAUDE.md 做本地覆盖。

写一次规则，就不用再重复了。Claude 会自己在 Rust 提交前跑 cargo clippy，Python 项目用 uv，API 错误格式严格走 RFC 9457。

插件 —— 能力扩展

一共 12 个插件，官方和第三方都有。

官方插件（来自 claude-code/plugins↗︎ 和 claude-plugins-official↗︎）：

• commit-commands↗︎ —— Git 提交（/commit、/commit-push-pr）
• feature-dev↗︎ —— 引导式功能开发
• code-review↗︎ —— PR 审查，按置信度过滤
• code-simplifier↗︎ —— 代码清理（/simplify）
• frontend-design↗︎ —— UI 设计指导
• rust-analyzer-lsp↗︎ —— 实时 Rust 诊断

第三方插件：

• context7↗︎ —— 实时拉最新库文档，LLM 训练数据过时的问题靠它解决
• vercel-plugin↗︎ —— 部署、可观测性、Next.js/AI SDK 指导
• interface-design↗︎ —— 设计系统审计和组件模式
• ecc↗︎ —— 社区插件合集
• playwright —— 浏览器自动化测试
• github —— GitHub 集成

第三方插件通过 settings.json 的 extraKnownMarketplaces 装：

{
  "extraKnownMarketplaces": {
    "interface-design": {
      "source": {
        "source": "github",
        "repo": "Dammyjay93/interface-design"
      }
    }
  }
}

agents.md 里还有张映射表，让 Claude 知道什么场景该用什么插件：

Hooks —— 自动护栏

Hooks 在 Claude 使用工具前后跑 shell 命令。

PreToolUse —— 任何 Bash 调用前提醒一下：

{
  "matcher": "Bash",
  "hooks": [{
    "type": "command",
    "command": "echo '⚠️  Confirm branch and remote before pushing'"
  }]
}

matcher 按工具名过滤。想按参数过滤（比如只拦 git push）可以加 if 字段。我这里保持简单。

PostToolUse —— 编辑文件后，按扩展名提醒跑对应的 linter：

FILE=$(echo "$CLAUDE_TOOL_INPUT" | jq -r '.file_path // empty')
if [[ "$FILE" == *.rs ]]; then
    echo "Reminder: run cargo clippy"
elif [[ "$FILE" == *.cs ]]; then
    echo "Reminder: run dotnet build"
elif [[ "$FILE" == *.py ]]; then

不阻塞，就是拍一下肩膀。但确实能拦住不少问题。

权限 —— 纵深防御

settings.json 里的允许/拒绝列表：

允许（自动批准）：

• 文件操作：Read、Edit、Write、Glob、Grep
• Shell：Bash（受拒绝列表约束）
• 网络：WebFetch、WebSearch
• 所有 Playwright 和 Context7 工具

拒绝（硬性封堵）：

• 破坏性：rm -rf /、git push --force、git reset --hard、git clean -f
• 危险：dd、mkfs、shutdown、reboot、chmod 777
• 供应链：npm publish、cargo publish、curl | bash
• 密钥：cat ~/.ssh/*、cat *id_rsa*

Claude 就算产生幻觉想跑危险命令，也执行不了。这个在出事之前就该配好。

状态栏 —— 实时仪表盘

我最喜欢的自定义。终端底部一行，该看的都在：

[Opus 4.6] misoto22-site | main | 45k 12k | 32% (57k/200k) | $0.45 | 12m30s | 3f +42 -8

从左到右：

• 模型（青色）
• 项目目录（绿色）
• Git 分支（洋红色）
• Token 输入/输出，以千为单位（黄色）
• 上下文使用率 —— 绿色 (<50%)、黄色 (50-75%)、红色 (>75%)
• 当前会话费用
• 会话时长
• Git diff —— 改了几个文件、增删多少行

费用是从缓存的定价算出来的。一个小脚本每天自动从 Anthropic 定价页抓一次，解析 HTML 表格，存到本地：

if [ ! -f "$PRICING_CACHE" ] || \
   [ "$(( $(date +%s) - $(stat -f %m "$PRICING_CACHE") ))" -gt 86400 ]; then
    bash "$PRICING_SCRIPT" &>/dev/null &  # 缓存超过 24 小时自动刷新
fi

不需要 API key。我盯得最多的其实是上下文颜色条 —— 变黄了就该 /compact 了。

记忆系统 —— 跨会话持久化

记忆在会话之间留存，按项目存在 ~/.claude/projects/<project>/memory/。每条记忆是个带 frontmatter 的 markdown 文件：

---
name: user-profile
description: 用户身份、技术栈和工作偏好
type: user
---
 
Inovit 全栈开发（汽车轮毂/轮胎/零件行业）...

分四类：

• user —— 角色、偏好、技术水平
• feedback —— 纠正过的做法（"用 pnpm 不用 npm"）
• project —— 架构决策、进行中的工作
• reference —— 外部系统指引（Linear 看板、仪表盘等）

MEMORY.md 做索引：

User
  - user-profile.md — 用户身份、技术栈和工作偏好
 
Feedback
  - feedback-patterns.md — 行为纠正：pnpm 不是 npm，发布前验证 API 合规性
 
Project
  - project-decisions.md — 跨项目架构决策
 
Reference
  - toolchain.md — 本地开发环境版本信息

这些记忆会产生实际影响。Claude 知道我是中文母语者、喜欢简短回复、Efision 项目用 5 层 Clean Architecture 和 Service<R> 泛型、上次在 pnpm 项目里跑了 npm 被我纠正过。这些细节会积累，慢慢改变 Claude 处理任务的方式。

自定义技能 —— 可复用的工作流

技能是 ~/.claude/skills/ 下的 SKILL.md 文件。和插件不同，技能就是纯 markdown —— 一步一步告诉 Claude 怎么做。用 /<技能名> 调用。

用得最多的是 /ship。一个命令，从改动到 PR 合并：

1. 测试 —— 跑测试，失败的话最多自动修 2 次
2. 提交 —— 暂存、从 diff 生成 conventional commit 消息
3. PR —— 建分支、推送、开 PR（带摘要和测试计划）
4. CI —— 每 30 秒轮询 gh pr checks，10 分钟超时。CI 挂了就读日志、修、推、再等，最多重试 2 次
5. 合并 —— squash merge，删分支，报告 PR URL

整个流程定义在一个 markdown 文件里，没有代码。Claude 按步骤走，搞不定就停下来问。一条 /ship 顶过去 5-10 条手动命令。

还有个深度调研技能 —— 8 步，把一个模糊问题变成结构化报告：

1. 问题分类（概念对比、决策支持、趋势分析等）
2. 问题分解，评估时效性
3. 信息源收集，按权威度分级（L1: 官方文档 > L2: 博客 > L3: 媒体 > L4: 社区）
4. 事实提取为结构化卡片，标注置信度
5. 对比框架构建
6. 差距识别和定向补充
7. 推理验证
8. 报告生成，保留所有中间产物

说"深度调研"、"对比分析"就能触发。中间成果存在 ~/Downloads/research/<topic>/，不会丢。还自带报告模板保持格式统一。

另外还有几个从 interface-design↗︎ 插件 symlink 过来的设计技能 —— /arrange、/audit、/critique、/distill、/normalize —— 全局可用，不绑定项目。

项目级配置

每个项目有自己的 CLAUDE.md。比如我个人网站的：

• 用 pnpm（不是 npm）
• 博客是 content/blog/ 下的 MDX 文件
• 导入用 @/i18n/navigation（不是 next/link）
• API 设计走全局 RFC 9457 规则
• 博客页面静态生成，数据库页面用 ISR

全局规则管通用标准，项目规则管本地约定。cd 到不同仓库，Claude 自动切换上下文。

日常怎么用

1. 在项目目录打开 Claude Code。状态栏马上显示模型、分支、费用、上下文。
2. 全局 CLAUDE.md + 项目 CLAUDE.md + 规则 + 记忆自动加载。
3. 我说要做什么。Claude 先读代码（规则里写了的），不清楚就问，然后动手。
4. 每次改文件 Hooks 都会提醒跑 linter，push 前会确认分支。
5. 上下文条变黄，在合适的地方 /compact。
6. 大功能用 Plan 模式，或者开子代理并行调研。
7. 值得记住的东西写进 memory，下次会话还在。

如果从零开始，我会先配这些

1. 写规则，别写提示词。 ~/.claude/rules/ 跨会话跨项目生效。提示词关掉对话就没了。
2. 先把拒绝列表配好。 rm -rf、--force、publish 这些，在你需要之前就该封掉。
3. 加一个 PostToolUse linter 提醒。 一行配置，能拦住不少事。
4. 自定义状态栏。 能实时看到费用和上下文使用率之后，你会自然地在对的时机压缩上下文。
5. 让记忆自己长。 别想着一次性全写好。Claude 犯错你纠正，纠正就成了记忆。
6. 分层配置。 全局管标准，项目管约定。

这套配置大多是从实际踩坑来的 —— 不该发生的 force-push、pnpm 项目里跑了 npm、上下文用到一半代码写了一半。每条规则背后都有个教训。