makeCoder
  • 对话
  • 智能体
  • 模型&API
  • 知识库
    • 免费注册
    最佳实践

    CLAUDE.md 配置指南与最佳实践

    由coder创建，最终由coder 被浏览 19 用户

    在使用 Coder 超级编程智能体 时，除了模型本身的推理能力，上下文管理是决定任务成功率的核心因素。

    CLAUDE.md 是一个位于项目根目录的特定配置文件，被 coder 与 claude code使用。当 coder 启动时，它会自动读取该文件作为“系统级上下文”。配置得当的 CLAUDE.md 能够显著减少 Token 消耗，降低幻觉，并确保生成的代码符合项目特定的工程规范。

    本文将详细介绍 CLAUDE.md 的标准结构、编写原则以及与 coder 交互的高级技巧。


    这是一个非常棒的补充！/init 命令大大降低了用户的上手门槛。

    结合这一点，我重新调整了文章结构：将“从零编写”改为“自动生成 + 人工调优”，这更符合实际高效的工程流。

    以下是更新后的最佳实践指南：

    CLAUDE.md 最佳实践指南：从 /init 开始构建 AI 编程上下文

    在使用 coder (MakeCoder 集成的 Claude Code 引擎) 时，上下文管理是决定 AI 编码质量的核心因素。

    CLAUDE.md 是项目根目录下的关键配置文件，它充当了 AI 的“项目入职手册”。配置得当的 CLAUDE.md 能显著减少 Token 消耗，消除幻觉，并确保 AI 遵守团队的工程规范。

    本文将介绍如何利用 /init 快速启动，以及如何通过人工调优打造完美的项目上下文。

    使用 /init 自动生成

    一般情况下你不需要从头手写配置文件。执行 /init 命令，能够扫描当前项目的结构（如 package.json, requirements.txt 等），自动推断出适合的构建和测试命令。

    操作步骤

    1. 在终端启动 coder：

      coder

    2. 在交互会话中输入初始化指令：

      /init

    3. 交互确认：系统会分析项目并生成一份 CLAUDE.md 草稿，通常会询问你确认或修改关键命令（如 Build、Test 命令）。

    完成这一步后，项目根目录下会出现一个基础版的 CLAUDE.md。

    /init 生成的通常是通用配置，你也可以对 CLAUDE.md 进行手动微调。

    Coder 最佳实践

    配置好文件后，在实际使用 coder 命令时，遵循以下模式可以获得更佳体验。

    "Read-Plan-Act" 工作流

    对于涉及多个文件的复杂修改，不要直接下达修改指令。

    • ❌ 错误示范：

      "帮我把用户登录功能重构一下，加上 OAuth。"

    • ✅ 最佳实践：

      "阅读 src/auth 目录下的代码。我想添加 OAuth 支持。请先分析当前架构，并根据 CLAUDE.md 中的规范列出修改计划。在我确认计划之前，不要修改任何代码。"

    这种方式强制 AI 先建立上下文索引，避免“走火入魔”修改了错误的文件。

    利用 CLI 的执行能力进行自我修复

    coder (Claude Code) 的一大特性是它能看到终端输出。利用这一点进行闭环调试：

    # 在 coder 会话中
> 运行测试。
# (AI 执行 npm test，发现报错)
> 读取上面的错误日志，定位到具体文件，修复它，然后再次运行测试以验证。

    管理上下文窗口 (/compact)

    随着会话变长，上下文窗口会被历史对话填满，导致 AI 反应变慢或遗忘之前的指令。

    • 使用 /compact：Claude Code 内置指令。它会将历史对话压缩成摘要，释放 Token 空间，同时保留关键信息。
    • 定期重置：对于完全不同的任务（例如从“修复 Bug”转到“写新功能”），建议退出并重新运行 coder，以获得干净的上下文。

    处理大型项目

    如果项目非常大，不要试图在 CLAUDE.md 中描述所有细节。

    • 分级文档策略：在 CLAUDE.md 中仅保留核心架构。对于特定模块的文档，可以使用“指向性引用”。
      • 示例：For detailed database schema, read docs/schema.md.
      • 当涉及到数据库任务时，AI 会根据这个提示去主动读取 docs/schema.md。

    常见问题排查

    • AI 总是使用错误的命令？
      • 检查 CLAUDE.md 中的 Commands 部分是否是最新的。AI 倾向于优先使用文档中定义的命令，而不是根据 package.json 猜测。
    • AI 忽略了代码风格？
      • 尝试将 CLAUDE.md 中的 Style 部分不仅写成“建议”，而是写成“规则”。例如使用 DO NOT（不要）来强调禁止的行为。
    • 如何让 AI 知道我安装了新库？
      • 直接告诉它：“我刚安装了 pandas，更新你的上下文。”或者让它运行 pip list 或查看 package.json。

    \

    {link}