Claude Code 完全指南

AI AGENT 完全指南

Claude Code
从零到一的进阶笔记

持续爆火且实用的 AI Agent
程序员与脑力工作者都值得拥有

它不只是编程工具——法律、财务、市场、内容创作，几乎所有知识工作都能用 CC 提效。

重点在于习惯跟 AI 协作：从一问一答到构建系统、组织 AI 让它自己干。

—— 视频核心观点

01 基础认知

什么是 Claude Code？

Anthropic 于 2025 年 2 月发布的终端 Agent 程序，被网友昵称为「CC」。它原本为编程而生，如今已远超编程边界。

核心原理：大模型循环（LM Loop）

输入提示词 + 工具说明 → 发给大模型
大模型思考 → 输出要用的工具
程序执行工具 → 返回结果给模型
再思考再执行 → 循环直到完成任务

它凭什么更强？

① 本地运行

读写本地文件、使用终端、执行命令、下载东西到电脑上。

② Harness 优秀

除模型外一切让 Agent 表现更好的设计，CC 是集大成者。

能做什么？

编程开发——零基础也能做出可用的应用
写文案 / 查资料 / 整理信息
分析数据 / 做表格 / 生成报告
Anthropic 内部用它处理法律、财务、市场等各类任务

02 快速上手

安装与配置

安装方式（二选一）

命令安装：官网复制安装命令 → 终端粘贴回车 → 输入 claude --version 验证成功
AI 帮你装：让 AI agent 执行安装，遇到依赖或网络问题它会想办法解决

配置模型

使用 Claude 订阅会员：在 CC 内输入 /login 登录
使用 国产模型 / API：通过 Claude Switch 管理多模型切换
在 Claude Switch 中填写 API Key 和 Base URL，保存后即可在 CC 中调用

小提示：建议在打开 CC 之前先完成 Claude Switch 配置。输入 claude 启动后，按上下键选主题色，安全性确认选 recommended 即可。

03 权限体系

四种权限模式

按 Shift+Tab 循环切换，非常重要。

🛡️ Plan Mode 计划模式

不直接动手，先输出详尽计划，等你确认后才执行。

⚖️ 默认模式

自己判断哪些操作要经过你确认，哪些直接执行。

✦ 自动编辑模式

改文件不再询问，但执行终端命令仍需征求同意。

�pass 完全自动模式

启动时加 --dangerously-skip-permissions，全程无需确认。

建议：新手先从默认模式起手，熟练后再尝试自动模式，效率与风险兼顾。CC 极少做高风险操作，比例约 93% 的用户会直接同意。

04 互动技巧

与 CC 交互的四种方式

文字对话 @文件拖拽图片斜杠命令

文字——最基础的对话方式，适合下达简单指令
@文件——精确定位指定文件，节省上下文消耗。项目大了 CC 不会把所有文件载入上下文，主动 @ 是在帮它、也帮你省 token
拖图片——利用多模态能力，如「按这张图的配色做主题」
斜杠命令——快速调出内置功能

常用斜杠命令

/model 切换高中低档模型
/btw 插入无关对话，与项目上下文隔离
/simplify 派 3 个 agent 审核代码质量、效率、复用性并自动优化
/help 查看全部命令说明

冷知识：指令越短，CC 探索本地文件消耗的 token 反而越多。描述越具体，效果越精准、越省钱。

换行技巧：macOS 用 Option+Enter；Windows 用 Ctrl+Enter。

05 掌控术

管住它：回滚 / Git / 上下文

后悔药 ①：快速回滚

双击 ESC 或输入 /rewind 进入回滚界面
可回滚对话 + 文件，或仅回滚其一
局限：只能回滚 CC 编辑的文件，执行过的命令（如安装包）无法撤回

后悔药 ②：Git 版本管理

Git = 游戏存档，可随时回退到任意版本
安装、登录 GitHub、提交、回滚——全部用自然语言让 CC 帮你做
建议每完成一步就存档，有 Git 兜底后会更放心让 CC 尝试方案

上下文管理

/compact —— 压缩上下文，保留关键信息
/clear —— 彻底清空，重开对话
/context —— 查看各技能、文件占用详情
可设置底部常驻显示上下文余量百分比
个人习惯：余量 低于 60% 就主动压缩

06 让它懂你

三层记忆体系

① CLAUDE.md —— 最高优先级，全文注入上下文

全局级：~/.claude/CLAUDE.md，所有项目通用，写个人原则
项目级：项目根目录，团队共享，写明技术栈/规范
文件夹级：子文件夹内部规则，按需加载
用 /init 自动初始化项目级配置；用 /memory 打开全局配置

② Auto Memory 自动记忆

后台 agent 自动记录偏好、反馈、项目决策与资源索引
按需注入，不长期占用上下文
存于 .claude/memory 目录，可用 /memory 查看
记忆不对可直接说「忘掉刚才说的 XX」

③ 自建记忆文档

自行编写规范文件（如视觉规范、语言风格），在 CLAUDE.md 中注明何时参考
本质：在适当时候向模型注入提炼后的上下文

建议：CLAUDE.md 内容不要贪多，只写最稳定的原则。随着使用逐步积累踩坑经验，它的价值会越来越大。

07 进阶能力

Skill · MCP · CLI · 子Agent · Hook · 插件

🎯 Skill 技能

给 AI 的专业说明书 / 操作手册。分为：知识型、流程型、工具型、混合型。

通过 /skills 查看，可自动加载或手动调用
安装：放入全局或项目级 .claude/skills 文件夹
用 Find Skill 技能搜索并安装社区好用的 Skill
用 Skill Creator 创建自己的专用技能

🔌 MCP 与 CLI（连接外部工具）

MCP：AI 与外部工具之间的「转接头」，可连接飞书文档、设计稿等
CLI：厂商为 AI 打造的命令行接口，如飞书 CLI、常用社交媒体工具集，AI 操作精准高效

👥 子 Agent（Subagent）

有独立的上下文空间，可并行干多种任务
自动派生：CC 自己判断任务可并行时自动派发
手动创建：输入 /agent 按引导创建
典型场景：调研竞品、数据分析——主 agent 不用停下来

⚡ Hook 触发器 & 插件

Hook：条件反射，如「任务完成发提示音」「提交前做格式检查」
插件：把 Skill、Subagent、MCP、Hook 打包为一个整体，/plugin 管理

❝

「重要的是习惯跟 AI 的协作方式——从一问一答到构建系统、组织 AI 让它自己干。」

—— Claude Code 核心心法

由 CuteNote.app 颜值笔记生成

Claude Code从零到一的进阶笔记