Claude Code 进阶配置

在藕片 API 接入基础上配置 CLAUDE.md、MCP、Hooks 和自定义技能，管理项目上下文、工具权限与 Token 用量。

先在开始使用中完成一次正常对话，再按项目需要增加配置。连接信息继续使用藕片 API 控制台的地址与密钥；项目规则、工具和自动化分别管理，排查时更容易找出是哪一项产生了影响。

项目上下文与 CLAUDE.md

把长期有效的项目说明放进仓库根目录的 CLAUDE.md，例如目录用途、构建命令、测试入口和代码约定。个人习惯可放进 ~/.claude/CLAUDE.md。

下面是一份可以按实际项目修改的起点：

# 项目说明

## 目录
- app/：应用代码
- tests/：测试与样例

## 验证
- 以 package.json 中的脚本为准执行检查。
- 修改后说明做了哪些验证，以及尚未验证的部分。

## 约定
- 优先沿用已有组件和命名。
- 修改公开接口时同步更新调用方。

说明应与仓库现状相符。临时任务直接写在对话中，真实 API Key 保存在个人配置中。

接入 MCP 工具

MCP 可以让 Claude Code 访问额外的文档、浏览器或业务系统。藕片 API 负责模型接入，具体 MCP 服务的安装、登录和权限在你的客户端侧管理。

在终端列出已经配置的服务：

claude mcp list

在 Claude Code 对话中使用 /mcp 查看连接状态。新增服务时采用该服务发布方的配置说明，确认作用范围是个人还是当前项目。

如果模型对话正常而某个 MCP 工具失败，先检查该服务的连接、凭据和依赖程序，再调整模型连接设置。一次只增加一个服务，确认可用后再继续。

用 Hooks 自动化检查

Hooks 将固定操作绑定到客户端事件。脚本文件需要在设置中的 hooks 注册，单独创建脚本目录不会自动生效。

事件	可以处理的任务
`SessionStart`	展示项目当前状态
`PreToolUse`	在工具运行前检查条件
`PostToolUse`	工具执行后运行检查
`UserPromptSubmit`	在提交提示时补充上下文

例如，在项目设置中合并一个只读取 Git 状态的启动钩子：

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          { "type": "command", "command": "git status --short" }
        ]
      }
    ]
  }
}

运行位置需要是 Git 仓库。出现启动迟缓或工具等待时，先单独运行对应脚本，检查耗时和退出状态，再定位 Hooks 配置。

自定义技能与命令

把反复使用的工作步骤整理为技能。项目级文件可放在 .claude/skills/project-review/SKILL.md，示例：

---
name: project-review
description: 检查当前项目改动的行为变化和验证情况。
---

先阅读当前差异，再检查受影响的调用方。
优先报告可复现的问题，引用对应文件位置。
最后列出已完成的验证和需要人工确认的行为。

在客户端中输入 /project-review 使用。个人技能使用 ~/.claude/skills/；已有 .claude/commands/ 自定义命令时，可按官方技能文档逐步维护。

管理上下文与用量

长任务可以按阶段保存结论：已完成什么、改了哪些文件、下一步验证什么。需要压缩上下文时使用 /compact，开始独立任务时新建会话。

减少无关的长日志和重复文件内容有助于控制输入规模。缓存是否命中、每轮调用花费多少，以藕片 API 的使用日志及其费用详情为准。

模型价格与实际倍率在控制台概览查看。不要把工具搜索、上下文压缩或某个缓存开关理解为固定的折扣比例。

联网与工具排查

模型连接、MCP 服务和网页抓取可能分别访问不同地址。网页能打开，并不能证明某个客户端工具的网络路径也正常。

先记录失败的工具名、目标地址和错误原文，再检查对应网络或认证设置。配置变更后重启相关客户端，并用一个最小任务验证。需要定位覆盖关系时查看配置参考。