高性能智能编程：Claude Code 初学者设置指南

大多数人的 Claude Code 设置从未超越第一天。他们运行安装程序，登录，输入提示，得到一些有用的结果，然后就不再碰配置文件。几周后，会话开始丢失早期决策，相同的权限提示每天出现五十次，每个长任务都以同样的方式结束：一堵上下文警告墙，对话不得不放弃并从零开始重新启动。

这些都不是模型的限制，而是设置的限制。Claude Code 默认设置合理，但合理默认值和高性能是不同的标准，它们之间的差距几乎完全由初学者从未打开的几个文件组成。本指南旨在弥合这一差距，介绍实际配置、权限、钩子和命令习惯，这些将区分全新安装和能经受真实、持续智能工作的设置，并根据 Anthropic 当前文档进行验证。

正确安装 Claude Code

Claude Code 作为独立命令行界面（CLI）安装，当前推荐路径是原生安装器，但 npm 仍可作为备用。安装完成后，在首次运行 claude 之前，请先进入实际项目目录。这一点比听起来更重要：Claude Code 将会话记忆和设置限定在启动它的目录中，因此从主文件夹或桌面启动会导致上下文错误。

首次运行将引导你完成认证：使用 Claude 订阅（Pro、Max 或 Team）的 OAuth 登录，或使用与控制台账户绑定的 API 密钥。除了终端，Claude Code 还通过 VS Code 扩展、JetBrains 插件、桌面应用和基于网页的版本提供，所有这些都读取相同的底层设置和项目文件。

三个关键文件

Claude Code 从两个位置读取配置：项目中的 .claude/ 目录（以及项目根目录的 CLAUDE.md）和全局的 ~/.claude/ 目录。理解它们的区别是决定工具性能的关键。

CLAUDE.md 是项目记忆——Claude 在每个仓库会话开始时读取的指令：架构笔记、构建和测试命令、代码风格规则等。使用 /init 命令生成初始文件，然后用 /memory 细化。保持简洁，Anthropic 建议将其控制在约 2500 个 token 以内，并将长内容放入 .claude/rules/*.md 文件中。

settings.json 位于 .claude/settings.json（项目级别）或 ~/.claude/settings.json（个人默认设置），负责权限、钩子、环境变量和模型默认值。这是大多数初学者从未打开的文件，直接导致两个常见问题：持续的权限中断和 Claude 使用比任务所需更昂贵的模型。

自动记忆是较新的静默层：Claude 可以在会话中读写自己的工作笔记，无需直接管理文件。通过 autoMemoryEnabled 设置或 CLAUDE_CODE_DISABLE_AUTO_MEMORY 环境变量切换。

实用规则：稳定的规则应放在 CLAUDE.md 中，因为仅存储在对话历史中的指令会在长会话触发自动压缩时丢失。如果一个规则需要在本次会话之外继续存在，请将其写下来。

权限与钩子设置

Claude Code 运行在三种权限模式之一：默认（每次有风险的工具调用前询问）、自动接受编辑（允许文件编辑而不提示，但仍限制其他工具）和计划模式（只读，直到你批准计划）。对于不熟悉的代码库，建议默认使用计划模式。

settings.json 允许编写实际的权限规则，避免手动批准相同安全命令。例如，可以允许 npm test:* 等模式，拒绝 rm -rf /* 等危险命令。拒绝规则优先于允许规则。

钩子超越权限规则：规则只能允许或阻止调用，而钩子可以响应调用执行操作。PostToolUse 钩子可在每次 Claude 编辑文件后自动格式化（如使用 Prettier）。PreToolUse 钩子可在命令执行前阻止危险命令，提供更强保障。例如，可以使用 Python 脚本检查命令是否包含递归删除、sudo rm、chmod 777 或强制推送到主分支等模式，并阻止它们。

值得首先学习的命令

Claude Code 目前有超过 60 个内置命令，但初学者无需全部记忆。优先掌握 /compact（总结对话历史以释放上下文）、/plan（切换计划模式）和 /diff（查看所有更改的交互式差异），这三个命令能解决大多数早期挫折。其他命令如 /init、/memory、/clear、/context、/model、/effort 等可在需要时学习。

创建自己的 /truth 命令

虽然 /truth 不是官方命令，但你可以通过自定义技能实现类似功能：让 Claude 在信任其声明之前对照实际代码库进行验证。创建 .claude/skills/truth/SKILL.md 文件，定义描述和允许的工具（如 Read、Grep、Glob、Bash）。然后使用该技能来检查 Claude 最近的声明是否准确。

通过本指南的设置，你将能够充分利用 Claude Code 进行高效、可靠的智能编程。