安装
macOS、Linux 与 WSL 推荐使用原生安装器，后台自动更新。
CLAUDE CODE FIELD NOTES · 2026
把需求交给
会动手的 Claude。
Claude Code 会进入你的项目，读取文件、执行命令、修改代码并验证结果。关键不是写一段“神奇提示词”，而是给它清楚的目标、项目规则与完成证据。
~/projects/atlas
● connected
❯ claude
Claude Code · Opus 4.6
修复登录超时后无法刷新令牌的问题，先定位根因，补回归测试，最后运行相关测试。
✓ Read src/auth/session.ts
✓ Search refreshToken
● Run npm test -- auth
⏵⏵ accept edits onctrl+c to stop
一个可靠任务
明确结果+相关上下文+操作边界+可运行验证01 / QUICKSTART
从安装到第一次改动
在项目目录启动 Claude Code。它会按需读取代码，不需要你先手动上传整个仓库。
登录
首次运行会打开浏览器，可使用 Claude 订阅、Console 或组织云服务。
进入项目
从项目根目录启动，让 Claude 直接获得正确的工作目录。
先问后改
先让它解释结构或定位入口，再交付一项范围清晰的改动。
$ curl -fsSL https://claude.ai/install.sh | bash
$ claude --version
$ cd /path/to/your/project
$ claude第一条任务
解释这个项目的入口、主要模块与测试方式。只读取，不修改文件。
02 / PROJECT MEMORY
用 CLAUDE.md 固化项目规则
CLAUDE.md 是每次会话都会进入上下文的持久指令。只写长期有效、无法轻易从代码推断、且确实会改变执行方式的事实。
/Library/Application Support/ClaudeCode/CLAUDE.md公司策略与统一规范
~/.claude/CLAUDE.md跨项目个人偏好
./CLAUDE.md随仓库共享的工程约定
./CLAUDE.local.md不提交的个人项目设置
# Commands
- Install: `pnpm install`
- Test: `pnpm test`
- Typecheck: `pnpm typecheck`
# Architecture
- API handlers live in `src/api/handlers/`.
- Keep domain logic out of route modules.
# Workflow
- Run focused tests before the full suite.
- Never edit generated files in `dist/`.构建与测试命令、仓库特有架构、非默认代码规范、常见陷阱、提交与发布约束。
详细 API 文档、临时任务、逐文件说明、标准语言常识，以及只在某个流程中才需要的长步骤。
Claude Code 默认读取 CLAUDE.md。可以在其中写 @AGENTS.md 导入既有规则，避免维护两份内容。
03 / CONTROL
把自主程度调到合适的位置
默认模式会对可能修改系统的操作请求批准。使用 Shift + Tab 在常用模式间切换；复杂任务先进入 Plan。
01
逐项确认关键操作
适合刚接触项目、风险边界尚不明确，或希望逐步审查工具调用的工作。
claude --permission-mode default
精确放行
为可信命令或域名建立允许规则，减少重复确认。
限制边界
用操作系统级隔离限制文件系统与网络访问。
检查环境
诊断安装、配置和环境问题，确认当前设置是否生效。
04 / EXTEND
四种扩展，各司其职
先从 CLAUDE.md 开始。只有当规则变成按需流程、独立角色、确定性自动化或外部连接时，再使用对应扩展。
按需知识
Skills
把部署、分析、文档生成等可复用流程放进 .claude/skills/<name>/SKILL.md，需要时再加载。
隔离角色
Subagents
为探索、审查、测试等任务创建独立上下文与工具权限，避免主会话被大量中间信息占满。
适合：并行研究或独立验证确定性动作
Hooks
在工具调用前后、会话停止等生命周期节点运行脚本，执行格式化、校验或阻止规则。
适合：必须每次发生的自动化外部连接
MCP
把数据库、设计工具、工单系统和内部 API 暴露成 Claude 可发现、可调用的结构化工具。
适合：代码库之外的系统能力05 / PRACTICE
按任务成熟度选择工作流
最有效的提示不是最长的提示。选择场景后，直接使用一条包含目标、范围与验证方式的任务描述。
EXPLORE FIRST
先建立项目地图
阅读项目入口、核心模块、数据流和测试配置。说明一个请求从入口到持久化的路径，并列出最值得先读的 5 个文件。只做分析，不修改文件。
01 Explore→02 Plan→03 Implement→04 Verify→05 Commit
06 / DESK REFERENCE
常用命令速查
在 Claude Code 会话中输入 / 查看当前版本可用的完整命令。下面这些覆盖了最常见的会话操作。
/init生成或改进项目 CLAUDE.md
/clear清空当前会话上下文
/compact压缩上下文并保留重点
/context查看上下文占用与加载来源
/resume继续之前的会话
/rewind回退对话或文件改动
/permissions查看和修改权限规则
/mcp管理 MCP 连接与认证
/hooks查看与配置 Hooks
/doctor诊断安装与配置问题
/cost查看令牌与费用统计
/help打开内置帮助
开始下一项任务前