资讯详情

资讯详情

Claude Code 100条实用指令:从启动到工程化配置的完整指南

先说个真实感受我用 Claude Code 不是拿来“玩一下试试”而是真的把它塞进了每天的日常工作流。从改 bug、补测试、查日志到跨仓库重构、写脚本处理数据它现在就像终端里的第二个脑子。用得越多越发现一个事实——这工具强不强很大程度上取决于你知不知道该跟它说什么、怎么控制它、怎么让它按照你想要的方式干活。这篇文章我准备把每天实际在用的那些指令、参数、技巧全部摊开讲按功能模块整理成一份可以直接照着用的清单。标题既然叫“100 条”那这 100 条就不是 100 个孤立的命令而是覆盖了启动、会话、权限、上下文、子代理、MCP、配置、排查等一整套路数的组合拳。新手可以把它当入门地图老手也能从里面翻出一些平时没注意的细节。咱直接开始。1. 先搞清楚 Claude Code 是什么指令才有意义1.1 它把“写代码”变成了“和代码对话”Claude Code 是 Anthropic 出的命令行 AI 编程工具跑在终端里基于 Claude 模型跟你对话协作。它不是那种聊天框里问一句答一句的玩具而是能真正读取你的项目文件、执行命令、修改代码、运行测试、提交 commit 的“协作者”。你可以把它理解成终端里多了一个随叫随到的结对程序员你说需求它动手改每一步你都能看到、能打断、能回滚。关键点是它工作在“你的真实项目环境”里不是沙盒。它能调用 shell 命令、读写文件、git 操作、跑测试、看报错所以它做的事和你在命令行里做的事是同一套。这也是为什么指令要学清楚——你用自然语言跟它聊它能懂七八成但你如果用上结构化的指令和参数它干活的准确率、可控性和效率完全是另一个级别。我从 v1.0 左右开始用到现在版本迭代了很多轮界面和指令体系已经稳定了不少。最早大家只知道claude进去开始聊现在光启动参数就有一大堆模式切换、权限控制、子代理、MCP 工具、自定义技能skills功能越来越重。如果不是系统过一遍很容易只用到一个皮毛。1.2 “100 条”到底指什么先把概念捋清楚。很多人以为的“常用指令”就是一行命令其实 Claude Code 的指令体系分四层第一层是启动命令也就是你在 shell 里敲的那些比如claude、claude -p xxx、claude --continue。第二层是斜杠命令也就是在 Claude Code 对话界面里敲的/xxx比如/clear、/compact、/agents、/mcp。第三层是权限和模式控制比如ShiftTab切换权限模式或者启动时用--permission-mode指定模式。第四层是配置文件和上下文规则比如CLAUDE.md、.claude/settings.json、set指令设置会话内变量。我在实际使用中每天反复用的满打满算其实也就三四十条但配合不同的参数、场景、组合方式就能演化出上百种用法。“100 条”这个说法更多是一种覆盖面你把这四层都吃透了日常开发里 99% 的操作都能找到对应的指令去完成。这次整理我会把每一层都拆开讲重点标出哪些是我实测下来最高频、最救命的。2. 上手必会的核心指令模块2.1 安装与启动不同平台的差异先聊怎么装。Claude Code 最主流的安装方式是用 Node.js 的 npm 全局安装官方推荐这样npm install -g anthropic-ai/claude-code安装完成后在任意项目目录里执行claude就会进入对话界面。首次启动会让你登录 Anthropic 账号完成认证后就能直接用了。如果你用 VS Code官方扩展装好之后快捷键CtrlShiftP输入 “Claude Code” 就能在集成终端里拉起同一个工具两边共享会话和配置。macOS 和 Linux 基本都是这条路。Windows 用户建议用 WSL2然后在 WSL 的 Linux 环境里装兼容性会好很多。原生 Windows 终端PowerShell/CMD不是说不能用但有些 shell 命令的兼容性、路径处理、权限交互会出现意想不到的小问题。我自己在 Windows 上绕了一圈之后最后还是老老实实回到了 WSL2体验完全不一样。还有个细节安装之后建议先跑一下claude --version确认版本号。因为 Claude Code 迭代很快很多老帖子写的指令在不同版本下行为不一样尤其是权限模式和子代理的用法版本差异很明显。2.2 会话管理让每一次对话都有“存档”进入界面之后最容易被忽略但最该先会的是会话管理。你每一次跟 Claude Code 的对话都算一个 session它可以在后台保存、恢复、延续。这太重要了——因为一个大任务往往不是一次对话能干完的你可能今天让 Claude 帮你看一个 bug明天还要继续同一个上下文往下查。先记这几个/clear清空当前会话上下文但不会退出工具。当你准备切换到一个全新任务时用这个比重新打开程序快得多。/compact把当前对话压缩成摘要保留关键信息节省上下文窗口。当对话太长、响应变慢的时候用属于“续命”操作。claude --continue直接接着最近一次会话继续聊这是我最常用的启动参数之一。第二天上班第一件事基本就是claude --continue把昨天的活接上。claude --resume会列出历史会话列表让你选择从哪一个恢复。比--continue更可控适合同时推进多个任务的人。--session-id id指定恢复某个具体的会话 ID适合在脚本里精确控制。我自己的习惯是一个任务开一个会话任务结束时用/compact压一遍然后在CLAUDE.md里记录任务关键结论。这样即使过了两周翻回来看也完全接得上。2.3 启动参数把任务在入口处就交代清楚很多人以为启动 Claude Code 就是敲claude然后开始聊其实启动参数才是把效率拉满的第一个关键。因为你完全可以在启动时就把任务、模型、权限全指好省掉进入界面之后一步一步交互的时间。几个我天天在用的# 直接给一个任务非交互式执行 claude -p 分析一下 src/utils 目录下所有函数的依赖关系 # 带模型参数启动 claude --model sonnet claude --model opus # 指定权限模式 claude --permission-mode acceptEdits # 继续上次会话 claude --continue-p这个参数特别适合脚本化和自动化。比如我写了个 shell 脚本批量处理多个文件处理逻辑由 Claude Code 完成我只需要在循环里调用claude -p 处理 xxx 文件就行。非交互模式下输出是纯文本可以被管道、重定向捕获方便集成到自己的工作流里。模型选择上我的经验日常小任务用sonnet速度快、成本低复杂架构设计、跨文件大规模重构这种换opus会更稳。Claude Code 默认走的是你账号对应的模型配置但有需要的时候用--model手动覆盖自由度很高。权限模式这个必须单独拿出来讲它是控制 Claude Code“手能伸多长”的关键。3. Agent 模式下真正高频的指令权限、上下文、工具3.1 三种权限模式省心和安全怎么平衡Claude Code 干活的时候会执行各种操作——改文件、跑命令、调 API。这里就有个灵魂问题这些操作要不要每次都问我如果每次问很烦如果全自动可能它乱来。这时就需要权限模式出场。在对话界面里用快捷键ShiftTab可以循环切换三种权限模式模式效果适用场景default每一次文件修改、命令执行都要你确认刚接触、项目重要、想完全掌控acceptEdits文件编辑自动接受但命令执行仍需确认日常开发主力模式plan只分析和出方案不实际改任何东西设计评审、任务规划bypassPermissions所有操作自动执行完全不问你完全信任它且任务很明确时我的主力是acceptEdits。理由很简单改文件是高频操作每次确认手都快断了但跑命令这个动作风险更高尤其像git push、rm这种破坏性强的命令保留确认机会更安心。真正需要全程无人值守的时候比如跑一个批处理任务、做数据清洗我再切bypassPermissions。还有更细的控制方法如果不想全局切模式你可以在对话里直接下指令让它“别问我”。比如你刚跟它说“帮我把这三个文件重构一下”后面加一句“编辑时不要逐个确认全部接受”它就会在当前任务里按接受编辑来干不会影响全局设置。这是我在实际使用中很喜欢的一种方式——大方向我控制细节上给它放权。3.2 /agents 子代理并行干活的关键接下来聊一个高阶功能子代理subagents。Claude Code 允许你同时启动多个子代理每个子代理有独立的上下文窗口负责不同的子任务互不干扰。这对大型任务来说简直是质变——以前是“一条道走到黑”现在是“多条流水线并行跑”。进对话界面后敲/agents会进入子代理管理界面你可以创建新代理、查看已有代理的状态、给每个代理指定不同的任务。每个代理有自己的会话历史和上下文所以你不用担心理 A 任务的代理被 B 任务的信息“污染”。我举一个实战场景有一次我要给一个老项目补全单元测试项目里有几十个模块。以前的做法是让 Claude 一个模块一个模块慢慢搞上下文越来越长后面它甚至会把前面模块的结论记混。用了/agents之后我一次开了 5 个代理每个负责 5 个模块各自独立跑我只需要定期检查它们的输出。最后共用了一个下午全项目的补测就完成了而且互不干扰质量很稳定。需要注意子代理本质上还是同一个账号下的模型调用成本是叠加的并行开太多要注意 token 消耗。但论效率这个功能是实打实的“真香”。3.3 MCP 和工具调用相关指令MCP 是 Claude Code 很核心的一个扩展机制全称 Model Context Protocol简单理解就是给 Claude 接外部工具和数据源的“通用插座”。通过 MCPClaude 可以查数据库、调内部 API、访问文档站、操作浏览器等等。在对话里/mcp命令打开 MCP 工具管理面板你可以查看当前接入了哪些工具、哪些可用、哪些报错了。MCP 服务器的配置文件在.claude.json或项目级配置文件里维护用的是 JSON 格式。实际用下来MCP 最值得接的有几类数据库查询工具、公司内部接口文档、日志平台的查询入口。接了之后你就不用把数据贴进对话里了直接让 Claude 自己去查然后基于真实的返回值分析这比“喂资料”准得多。但别贪多接太多工具反而会让 Claude 在选择时“犯迷糊”建议按项目需求精简到 2~3 个高频工具即可。4. 工程化配置把个人习惯变成默认规则4.1 CLAUDE.md给 Claude 写“项目说明书”用 Claude Code 时间越长我越意识到一个核心原则它的表现上限很大程度取决于你给了它多少“项目背景”。这里就要提到CLAUDE.md——这是 Claude Code 最该用好的文件没有之一。CLAUDE.md放在项目根目录Claude Code 每次启动都会自动读取它。你可以把它理解成给 Claude 的“入职手册”项目是什么、技术栈是什么、目录结构怎么组织、代码风格有什么偏好、有哪些不能碰的东西。我自己的模板大概长这样# 项目说明 这是一个基于 Python 3.11 的电商后台服务使用 FastAPI PostgreSQL Redis。 # 目录结构 - src/api/ —— 接口层路由都在这 - src/services/ —— 业务逻辑层 - src/models/ —— 数据库模型 - tests/ —— 单元测试必须跑通才能提交 # 开发规范 - 变量命名用 snake_case - 所有接口必须有类型注解 - 修改 models 后必须生成对应的 migration # 禁忌事项 - 不要直接修改 production 数据库 - 不要使用 git push --force - 不要删除 tests/ 下任何文件把这个文件维护好之后Claude 干活的“常识”会显著提升。比如你让它写一个新接口它会自动遵循项目的路由风格、用你项目的模型命名习惯而不是生成一堆“看起来很对但跟项目格格不入”的代码。CLAUDE.md 还支持按层级覆盖项目根目录的CLAUDE.md给全项目生效子目录里也可以放CLAUDE.md局部覆盖全局规则。对于 monorepo 项目来说这个太有用了我可以给前端目录、后端目录分别写各自的规范Claude 进入哪个目录干活就自动遵循哪套规则。4.2 settings.json权限、钩子、环境变量的集中地如果说CLAUDE.md是给 Claude 看的“说明书”那.claude/settings.json就是给 Claude Code 这个工具本身看的“配置文件”。权限默认值、环境变量、钩子脚本、模型设置都可以在这里统一管理。我实际项目中比较常用的配置{ permissions: { allow: [ Bash(npm run lint), Bash(git status), Read(src/**) ], deny: [ Bash(git push --force), Write(deploy/**) ] }, hooks: { PostToolUse: [ { matcher: Edit, hooks: [{ type: command, command: npm run lint }] } ] }, env: { NODE_ENV: development } }你注意看这个结构permissions里我可以精确到“某个命令的某个参数”允许或拒绝这个比全局模式精细得多。hooks则可以在某个事件发生后自动触发命令——比如 Claude 每次编辑完代码自动跑一遍 lint有问题当场就能暴露。这个机制帮我养成了一种“实时校验”的节奏代码质量肉眼可见地提高了。一个小建议settings.json的配置结构是分层的用户级配置在~/.claude/settings.json项目级配置在项目根目录。两边同时存在时项目级会覆盖用户级。所以通用偏好放用户级项目专属限制放项目级各管各的互不清净。4.3 接入第三方模型与自定义适配Claude Code 官方默认连接的是 Anthropic 的服务但它的架构本身是支持通过环境变量替换 API 端点的。如果你有特定的网关服务或者需要接入其他兼容模型重点看这几个环境变量ANTHROPIC_BASE_URLhttps://your-custom-endpoint ANTHROPIC_AUTH_TOKENyour-token ANTHROPIC_MODELyour-model-name设置这些环境变量之后再启动claude请求就会走到你指定的端点去。很多团队用这个方式接入自己内部的模型网关统一管理密钥和用量也方便做审计。但我建议普通个人用户优先用官方默认配置毕竟稳定性、功能兼容性、后续升级的平滑度都更有保障。自定义端点有时候会遇到某些高级功能不可用的情况比如一些 Agent 特性或 MCP 工具的支持程度和官方不完全一致。5. 日常踩坑与排查实录5.1 连接不上服务的常见原因我最早用的时候被unable to connect to anthropic services这个报错折磨过好几次。后来总结下来这类问题的来源大概是这几种情况网络环境不稳定导致请求超时或者被中断。某些网络代理工具干扰了终端里的请求。我处理的办法是关闭或调整终端会话中的网络代理设置保留可用的网络环境。当前版本与服务端不兼容升级一下 Claude Code 版本往往就解决了。认证过期了重新登录一次即可。排查路径可以参考这个顺序先claude --version确认本地版本再跑一个最简单的claude -p hi测试连通性如果还是不行检查环境和认证状态最后再考虑升级或重装。不要一上来就重装浪费时间。5.2 权限确认弹窗频繁怎么办很多人刚用时最大的痛点是Claude 每改一个文件、每跑一个命令都弹确认窗口打断思路不说还特别磨耐心。这时候不要硬抗用我前面说的ShiftTab切到acceptEdits模式立刻解决 80% 的弹窗。剩下的“命令确认”弹窗可以在settings.json里用permissions.allow把高频命令白名单化。比如npm run lint、git status、pytest tests/这些你确定安全且经常要跑的命令直接允许省得每次问。但我也要提醒一句白名单不是越宽越好。涉及删除、推送、数据库变更这类高风险操作的命令宁可保留确认别图省事出事就是大事。5.3 上下文太长导致执行变慢项目任务复杂时对话上下文会越来越长Claude 的响应速度会肉眼可见地变慢甚至开始“忘事”。这是上下文窗口逼近上限的典型表现。两个解法一个是当初就控制范围一个大任务拆成多个阶段一个阶段一个会话。另一个是在会话中途用/compact压缩历史把次要内容摘要化保住关键信息为后面的操作腾出空间。我自己一般在对话超过 30 轮、或者明显感觉响应变慢时就会主动/compact一次。另外提醒一下别在同一个会话里塞太多无关任务会让上下文里塞满噪音影响质量。6. 关于“100 条”的一点个人体会老实说我刚接触 Claude Code 那阵子面对满屏幕的指令是有点懵的。但用到现在我的体会是真正牛逼的用法不是把这些命令背下来而是理解每一层指令在解决什么层面的问题——启动参数解决“入口怎么进”斜杠命令解决“会话怎么管”权限模式解决“怎么让它放手干又不失控”配置文件和 CLAUDE.md 解决“怎么让它懂我的项目、懂我的规矩”。这 100 条覆盖的其实就是这么一套完整的能力模型。你按这个框架去学不需要死记硬背每天用着用着就全记住了。最后分享一个我的个人习惯每接触一个新项目我第一件事不是急着让 Claude 写代码而是先花 20 分钟把CLAUDE.md写好把项目背景、技术栈、目录结构、编码规范写得明明白白。这 20 分钟省下来的是后面几十个小时的来回沟通成本。Claude Code 是个很强的执行者但你才是那个定方向的人你交代得越清楚它干得越漂亮。
觉得有用,分享给同行:

为您的企业打造数字门面

稳重轻奢商务风格,端正雅致视觉,长效耐看不易过时。

立即咨询 →