Claude Code 使用及命令指南

各位编程初学者们，在我的上一篇文章已经简述了claude code的安装及进入,那么今天我们来聊点不一样的——如何借助 AI 力量，让你的编程学习效率和开发速度提升数倍。

Claude Code 是 Anthropic 官方推出的一款运行在终端里的 AI 编程助手。它不止可以作为 IDE 插件，而且是直接“住”在你的终端里，能读代码、写代码、运行命令、提交 Git，是你 24 小时在线的“AI 结对编程搭档”。

为了让哪怕零基础的小白也能快速上手，我写了这篇详细的入门指南，从基础命令到实战操作，一步步带你玩转 Claude Code。

---

一、Claude Code 是什么？它能帮你做什么？（详细版）

在正式敲命令之前，我们先花 一分钟 分钟彻底搞清楚：Claude Code 到底是个什么东西，以及它能在哪些场景下实实在在地帮到你。

1.1 它不是一个普通的“聊天机器人”

你可能用过 ChatGPT 网页版，或者 Cursor 里的 AI 对话。它们通常是你问一句，AI 答一句。如果你有一些编程经验,你可能已经用过codex,或者trae这样的哎编程助手,那么我们为什么要选择这个使用如此"复杂的"工具.

具The Pragmatic Engineer的文章显示,在同类型工具中,claude code在中小型公司的使用率高达75%,虽在大型公司的使用仍不及微软的GitHub Copilot,但是在一年以前可还没有claude code工具,claude的大模型在国区被限制使用导致使用claude code的难度进一步升级,但他仍是最受欢迎的ai编程工具,足以可见claude code有多么的特别了.他不是一个普通的"聊天机器人",而是一名行业专家,能够帮助你处理各种复杂事物.具体内容:https://newsletter.pragmaticengineer.com/p/ai-tooling-2026?trk=article-ssr-frontend-pulse_x-social-details_comments-action_comment-text

他具体能做的大致有以下四件事:

1. 读：它先用 ls 或直接读取目录，确认有哪些 .txt 文件。

2. 写：它生成一个 Bash 脚本或 Python 脚本，并询问你是否允许它直接在你的电脑上创建这个文件。

3. 跑：文件创建好之后，它询问你是否允许它直接执行 python merge.py 这条命令。

4. 验：命令跑完，它会读取生成的 output.txt 前几行给你看，确认合并成功。

你全程只需要做一件事：点头 Yes（按 y）或者摇头 No（按 n）。

1.2 它能帮你解决的 5 大痛点

作为编程初学者，下面这些场景你应该深有体会：

你遇到的麻烦	Claude Code 如何帮你
环境报错，无从下手	把报错信息贴给它，它会分析原因，并直接帮你修改配置文件或重装依赖。
写重复的代码块	告诉它“我要一个 Flask 的 Hello World 模板”，它立刻生成好文件。
不熟悉 Git 命令	告诉它“帮我把改动提交一下，commit 信息写 add new feature”，它会帮你执行 git add . 和 git commit -m。
看不懂祖传代码	进入项目文件夹，问它“这个项目入口在哪里？主要逻辑是什么？”，它会像导游一样给你讲解。
写文档、写注释	让它“给这个 Python 文件里的所有函数加上中文 Docstring”，几秒钟搞定。

1.3 Claude Code 的核心机制：Agentic Loop

在专业术语里，Claude Code 是一个 Agent（智能体）。它的工作方式遵循一个循环：

感知（观察环境） → 思考（分析需求） → 行动（执行命令/修改文件） → 验证（检查结果）

理解了这个循环，你就能明白为什么有时候它会连续执行好几步操作——因为它自己在闭环解决问题，不需要你一步步推着走。

---

二、基础启动与交互方式（保姆级教学）

2.1 三种启动模式

打开你的终端（Terminal），准备开始。

模式	命令示例	说明
交互聊天模式	claude	进入一个全屏的对话界面，适合长时间、多轮次的复杂任务。
单次问答模式	claude -p "解释一下这个脚本"	输出结果直接显示在终端里，问完即止，适合写进自动化脚本。
指定文件问答	claude -p "重构这段代码" < app.py	把文件内容通过管道喂给 AI，不用开启交互界面。

新手推荐：刚开始一律用 claude 进入交互模式，看着界面操作更安心。

2.2 交互界面布局介绍

当你输入 claude 并回车后，会看到一个类似聊天软件的界面。

• 顶部状态栏：显示当前模型（如 Claude Opus 4）、当前花费（/cost 可查详细）、会话长度。

• 中间对话区：你和 AI 的聊天记录。AI 执行的操作（如运行 npm install）会以特殊底色展示。

• 底部输入框：就是你打字的地方。支持多行输入（按 Enter 换行，Ctrl+Enter 或 Cmd+Enter 发送）。

---

三、入门必学的核心命令

在输入框里，以 / 开头的词是内置命令。掌握下面这 7 个，基本就能应对 80% 的日常需求。

3.1 /init - 最重要的命令（没有之一）

在项目根目录生成一个 CLAUDE.md 文件，并在里面写入项目记忆。推荐大家在项目刚开始就执行这个命令,如何后续更新也同步记录,方便后续的多轮对话.

Claude 生成的初始 CLAUDE.md 包含项目描述、技术栈、代码风格偏好和常见模式。

每次进入claude code都要重新跟他对话,解释,既然如此不如一次写进 CLAUDE.md 永久生效,每次读写都会节约大量时间和tokens.

/init 执行完毕后，可以立即追加具体规则,实现项目的自我定制实战示例：

以后只要在这个文件夹下启动 Claude Code，它会自动先读 CLAUDE.md 里的规矩，严格遵守你的代码规范。

3.2 /model-切换大模型(新手必须掌握)

如果你是claude code订阅会员,那么你会有以下三个模型

/model                 # Interactive picker  
/model sonnet          # Switch to Sonnet 4.6  
/model opus            # Switch to Opus 4.6  
/model haiku           # Switch to Haiku 4.5

会话中途在 Sonnet、Opus 和 Haiku 三个模型之间切换,

如果你能订阅,那么我也不必对这三个模型做解释了我以glm国产大模型为例来详细解释,具体接入请看智谱提供的教程https://docs.bigmodel.cn/cn/coding-plan/tool/claude里面有详细的将glm大模型接入的教程.

3.3 /plan

代码更改以计划形式提出，审批后才实际执行。

Claude Code 有三种模式。Normal 模式每次工具执行前要求确认；Auto-Accept 无需确认直接执行；Plan Mode 只展示方案等待审批。

3.4 /effort

切换大模型性能的工具,(只有官方订阅大模型才能选择max)其他模型若tokens充足可以选择到high.

3.5 /cost

可以查看你花费了多少钱,价格是按官网的API来算的,如果是接入其他大模型那这就这个指令就几乎用不到了

3.6 /context

大模型和智能体都会有上下文限制,一旦超出上下文就会出现你说的要求他转头就忘了的这种类似的"降智"情况,有些对话超出上下文限制这段对话就会强制停止,所以我们可以用/context来查看当前上下文剩余量，配合/compact和/clear使用才能保证对话质量

3.7 /compact

上下文窗口快满时，压缩对话历史并进行摘要以回收空间。

适合在以下时机使用：会话超过 30 分钟、出现"上下文过大"的警告，或者 Claude 开始遗忘先前的决策。压缩保留的内容：CLAUDE.md 内容；任务列表项 ；关键决策和模式

丢弃的内容：冗长的对话往返；已被替代的代码迭代

不要等到上下文满了才压缩。70-80% 时就该主动执行，应配合/context使用.

3.8 /clear

清除上下文,和/compact有相似之处,但是/compact适用于同一个功能模块的开发,与上下文联系紧密的情况下使用.而/clear适用于已经不需要上文内容了,可以直接使用/clear.

3.9 /rewind

可以撤销你不满意的内容,包括对话或者代码,十分好用的一个功能,如果claude code生成的代码不符合你的预期,可以选择/rewind或者双击esc.

3.10 /permissions —— 安全护栏

作用：调整 AI 执行命令时的权限策略。

可以调整到你需要的权限或者设立自己的规则.

3.11 /exit —— 聊胜于无

作用：退出 Claude Code 交互界面，回到普通终端。

---

四、普通文本指令进阶：如何把 AI 用得更顺手

除了斜杠命令，你大部分时间是在用自然语言下指令。可以参考下面内容来做到节约tokens的同时高效完成任务.

4.1 模糊需求 → 精确指令（对比教学）

错误的指令（AI 会瞎猜）	正确的指令（AI 精准干活）
“帮我修一下 Bug。”	“运行 python main.py 报错 KeyError: 'name'，请读取 main.py 和 config.json，找出原因并直接修改文件修复。”
“写个登录功能。”	“用 Python Flask 写一个简单的登录接口，不需要数据库，用户密码硬编码在代码里。要求有 /login 路由，返回 JSON。”
“把代码优化一下。”	“utils.py 里的 process_data 函数太长了，在不改变输入输出类型的前提下，请把它拆分成 3 个更小的辅助函数。”

口诀：给路径、给现象、给预期。

4.2 利用 Bash 模式做“脏活累活”(新手的话慎重执行脚本命令)

如果你不想让 AI 写代码，只想让它帮你跑命令，可以明确指令：

“请在 Bash 模式下，帮我把当前文件夹下所有 .jpg 文件重命名为 image_001.jpg 开始的序列。”

AI 会识别这是纯 Shell 操作，直接生成并执行命令，不会尝试去写 Python 代码，速度更快。

4.3 善用“先问后做”模式（Plan Mode）

如果你的任务很复杂（比如重构整个模块），怕 AI 乱改，可以在指令开头加一句：

“请先不要修改任何代码，只告诉我你的修改计划和步骤。我确认后你再动手。”

这就是所谓的 Plan Mode。先看计划，再执行，避免返工。

---

五、实战演练：从 0 搭建一个网页爬虫（手把手带教）

理论知识讲完了，我们来一个真实的动手案例。假设你连爬虫库都没装过，我们看看 Claude Code 怎么带你飞。

任务：写一个 Python 脚本，爬取豆瓣电影 Top 250 的片名和评分，保存为 movies.csv。

步骤 1：创建空文件夹并进入

bash

mkdir douban-crawler
cd douban-crawler

步骤 2：启动 Claude Code 并下达总指令

bash

在聊天框输入：

“我要写一个 Python 爬虫，抓取豆瓣电影 Top 250 的标题和评分，保存为 CSV。请帮我初始化项目：创建 requirements.txt 并安装依赖库，然后生成 crawler.py 文件写代码。”

步骤 3：观察 AI 的行动链

Claude Code 会依次询问你是否执行以下操作：(可能不完全一样,注意甄别)

1. 创建 requirements.txt：内含 requests 和 beautifulsoup4。（你按 enter）

2. 执行 pip install -r requirements.txt：安装依赖。（你按 enter）

3. 创建 crawler.py：生成包含完整爬虫逻辑的代码。（你按 enter）

步骤 4：运行与排错

“请帮我运行 python crawler.py，看看有没有报错。”

如果因为反爬机制报 418 错误，AI 会主动分析并在 crawler.py 里加上 headers 伪装浏览器头，然后重新运行，直到成功生成 movies.csv。

全程你只做了三件事：描述需求、按 enter 确认、喝咖啡。

---

六、新手安全红线与避坑指南（必须读三遍）

🚨 红线一：永远不要盲目 y 掉 rm -rf 命令(尽管claude code对安全权限有着极高的管理,但仍不可完全避免出现这种情况)

当屏幕上出现 Do you want to run: rm -rf / 或者 git push --force origin main 时，请立刻停下来，看清路径再确认。

• 正确做法：看不懂就按 n (No)，然后把命令复制出来问问上网查一下。

🚨 红线二：.env 文件里的密码是禁区

AI 在读取项目文件时，如果你把数据库密码、API 密钥写在了代码里（硬编码），它可能会把它们写进日志或者提交记录里。

• 正确做法：使用 .env 文件存储敏感信息，并确保 .gitignore 包含了 .env。

参考文章

https://developer.aliyun.com/article/1718322(阿里云的一篇很详细的指令文章);

https://code.claude.com/docs/zh-CN/commands(官网给出的指令解释,其他内容也可以在上面找到)

https://cloud.tencent.cn/developer/article/2546599?from=15425&frompage=seopage

https://newsletter.pragmaticengineer.com/p/ai-tooling-2026?trk=article-ssr-frontend-pulse_x-social-details_comments-action_comment-text

(这篇文章有许多技术人员对这些新技术的看法及使用习惯,文章的数据来源也大多来源于此处)

https://docs.bigmodel.cn/cn/coding-plan/learning-resources/how-coding-agent-works