Claude Code 入门基础
Claude Code 是 Anthropic 推出的命令行 AI 编程工具，入门核心是“准备账号环境→安装工具→登录授权→开始对话”。国内用户需额外注意网络代理与支付订阅问题，建议先在本地创建工作区再开始使用 。
怎么安装和登录
- 环境准备：电脑需提前安装 Node.js，这是运行 Claude Code 的基础环境 。
- 网络配置：使用前需设置终端代理，确保能访问 Anthropic 官网，否则无法下载或登录 。
- 安装命令：在终端输入安装命令（如 npm 安装方式），等待安装成功后显示版本号即表示完成 。
- 账号登录：输入登录命令后会跳转浏览器授权，需拥有Pro 会员或更高权限账号，免费版无法使用该工具 。
- 支付建议：国内用户订阅会员时，建议通过美区或尼日利亚区 App Store 礼品卡支付，直接绑定国内银行卡可能失败 。
大家好！今天咱们一起学学怎么用 Claude Code 提高效率。
不管你是技术岗还是非技术岗，都能用得上。咱们不讲虚的，直接上干货。
先问一下：之前用过 Claude Code 的举个手？
好，没关系，今天咱们从零开始，包教包会！
二、Claude Code 到底是什么？能帮我们干啥？
简单说，Claude Code 就是 Anthropic 官方的 AI 编程 CLI 工具，在终端中直接理解代码仓库、编辑文件、运行命令、搜索代码。
它能帮我们做什么？
| 岗位 | 它能帮你 |
|---|---|
| 售前/文档 | 写方案、整理资料、翻译文档 |
| 项目经理 | 写周报、记会议纪要、做计划 |
| 设计师 | 写设计文档、整理需求 |
| 开发 | 写代码、找 bug、写技术文档、代码审查 |
| 测试 | 写测试用例、测试报告 |
演示一下：打个招呼
（打开 Claude Code，输入）
“你好！简单介绍一下你自己，你能帮我做什么？”
看，这样就开始用了。很简单吧？
三、基础操作：5 分钟上手
第一步：启动
方式一：命令行（推荐）
# 进入你的工作目录
cd my-project
# 启动
claude
# 指定模型启动
claude --model opus
# 指定工作模式启动
claude --mode plan # Plan 模式：只规划不执行
claude --mode auto # Auto 模式：自动执行
方式二：VS Code 扩展
打开 VS Code，点左边的 Claude Code 图标就行。
第二步：说话
在输入框打字，按 Enter 发送，Shift+Enter 换行。
就这么简单！
第三步：让它帮你写个自我介绍
（演示）
“帮我写一段 100 字左右的自我介绍，我是项目经理，来公司 3 年了。”
（等 Claude 回复）
看，这样就写好了。
第四步：不满意？直接说
“再短一点，50 字就行。”
看，它就改了。不用客气，直接说你要什么。
第五步：保存
“把这个保存为 ‘自我介绍.md'”
搞定！
四、常用命令速查
在对话中输入 / 即可触发命令，以下是常用的：
| 命令 | 说明 | 使用场景 |
|---|---|---|
/help | 显示帮助信息 | 忘了命令时 |
/init | 初始化 CLAUDE.md | 新项目开始时 |
/config | 打开配置界面 | 调整设置 |
/mode | 切换工作模式 | Plan/Code/Auto |
/compact | 压缩对话上下文 | 对话太长时 |
/clear | 清空对话 | 开始新任务 |
/cost | 查看 token 消耗 | 关注费用 |
/undo | 撤销文件修改 | 改错了 |
/review | 代码审查 | 技术岗 |
/doctor | 诊断配置问题 | 遇到问题时 |
演示：几个常用命令
/cost # 看看花了多少钱
/compact # 对话太长了，压缩一下
/clear # 开始新任务
五、三种工作模式
| 模式 | 行为 | 适用场景 |
|---|---|---|
| Plan | 只规划不执行，输出分析和建议 | 复杂改动先看方案 |
| Code | 标准模式，规划后执行 | 日常开发 |
| Auto | 自动执行，减少确认步骤 | 信任度高的重复性操作 |
切换模式
/mode plan # 切换到 Plan 模式
/mode code # 切换到 Code 模式（默认）
/mode auto # 切换到 Auto 模式
演示：Plan 模式
/mode plan
帮我重构这个项目的数据库连接模块。
看，Plan 模式下它只给你方案，不会直接改代码。确认后再切回 Code 模式执行。
六、实战演练：写一份周报
这个最实用，咱们一起来写一份周报。
输入这些信息：
帮我写一份周报，信息如下：
项目：智能客服系统
时间：2026-04-08 到 2026-04-15
项目经理：张三
本周干了啥：
1. 开了需求评审会
2. 定了开发计划
3. 协调了团队资源
遇到的问题：
1. 客户那边的接口文档还没给，可能影响进度
下周打算：
1. 开始开发
2. 安排每日站会
3. 准备中期汇报
要求：500 字左右，中文。
（等 Claude 生成）
看，一份像模像样的周报就出来了！
再调整一下
“把接口文档那个部分写具体点，说说打算怎么跟进。”
（展示调整后的结果）
最后检查并保存
“检查一下有没有错别字，然后保存为 ‘周报-2026-04-15.md'”
查看费用
/cost
完美！一份周报就搞定了，比自己写快多了吧？
七、轮到你们了：自己试试看
现在大家自己动手试试：
- 启动 Claude Code
- 让它帮你写一段自我介绍
- 试着调整一下：改短点、改长点、或者换个语气
- 保存成文件
- 试试
/cost看看花了多少 token
有问题随时喊我，我就在旁边！
八、总结和问答
今天学了啥？
- Claude Code 是什么 – Anthropic 官方 AI 编程 CLI 工具
- 基础操作 – 启动、说话、调整、保存
- 常用命令 – /help, /init, /mode, /compact, /cost, /undo 等
- 三种工作模式 – Plan（只规划）、Code（标准）、Auto（自动执行）
- 实战 – 写周报，这个流程可以套用在很多地方
下次培训讲什么？
- 售前文档怎么写
- 项目管理文档（会议纪要、项目计划）
- 技术岗的同学：怎么让它帮你写代码
- CLAUDE.md 项目指令
- MCP 服务器配置
课后作业
- 自己电脑上装好 Claude Code（如果还没装）
- 试着用它帮你写一份简单的文档
- 试试
/init给你的项目生成 CLAUDE.md - 想想你工作中有啥活想让它帮忙的，下次分享
有问题吗？
现在可以提问，或者下次培训早点来，我帮你弄。
实战练习
第1次培训：实战练习
练习一：写自我介绍
目标：熟悉基本对话方式
步骤：
- 启动 Claude Code
- 输入以下提示词（根据你的情况修改）：
帮我写一段 100 字左右的自我介绍，要求：
- 我是一名【你的岗位，如：项目经理/前端开发/售前工程师】
- 在公司工作了【时长】
- 主要负责【你的主要职责】
- 风格：正式一点
- 看看 Claude 生成的内容
- 如果不满意，可以继续调整：
- “再简短一点”
- “把语气改得更活泼一些”
- “加上我的兴趣爱好：读书和跑步”
完成标准：得到一份你满意的自我介绍
练习二：整理笔记
目标：学习让 Claude 处理现有内容
步骤：
- 找一段你的工作笔记或会议记录（100-300字）
- 输入：
帮我整理以下笔记，要求：
1. 分成 3-5 个要点
2. 每个要点用一句话概括
3. 语言简洁明了
笔记内容：
【粘贴你的笔记内容】
- 如果要点太多，可以说：”合并成 3 个要点”
- 如果需要更详细：”每个要点再展开说明一下”
完成标准：得到一份整理好的要点清单
练习三：翻译文档片段
目标：体验多语言能力
步骤：
- 找一段英文文档（或用下面的示例）：
Welcome to our project! This guide will help you get started.
First, make sure you have Node.js installed. Then run:
npm install
npm start
- 输入：
把下面这段英文翻译成中文，要求：
- 技术术语准确
- 语言通顺自然
【粘贴英文内容】
- 如果需要调整：
- “用更口语化的中文”
- “保持英文术语，比如 Node.js 不用翻译”
完成标准：得到一份准确通顺的中文翻译
练习四：创建一个简单文件
目标：学习文件操作
步骤：
- 输入：
帮我创建一个文件叫 "test.md"，内容是：
# 测试文件
这是我用 Claude Code 创建的第一个文件！
创建时间：2026-04-15
- Claude 会告诉你文件已创建
- 你可以问：”读取 test.md 文件看看”
- 然后修改它：”在文件末尾加上一行：作者：[你的名字]”
完成标准：成功创建并修改了 test.md 文件
练习五：试用常用命令
目标：熟悉常用斜杠命令
步骤：
- 输入
/help查看帮助信息 - 输入
/cost查看当前会话的 token 消耗 - 输入
/status查看当前会话状态 - 试试
/compact压缩对话上下文 - 试试
/mode切换工作模式
完成标准：能熟练使用常用命令
练习六：体验三种工作模式
目标：理解 Plan/Code/Auto 三种模式的区别
步骤：
- 切换到 Plan 模式：
/mode plan
帮我写一份简单的项目计划。
观察：Claude 只给出方案，不执行
- 切换到 Code 模式：
/mode code
帮我写一份简单的项目计划，然后保存为 "计划.md"。
观察：Claude 规划后执行
- 切换到 Auto 模式：
/mode auto
帮我创建一个简单的 README.md 文件。
观察：Claude 自动执行，减少确认
完成标准：理解三种模式的区别和适用场景
练习七：探索技能（可选）
目标：了解可用的技能
步骤：
- 输入：
/help或/skills - 看看有哪些可用的技能
- 尝试一个简单的：
/superpowers:brainstorming
帮我想几个提高工作效率的点子
完成标准：成功调用一个技能
挑战任务（进阶）
如果你已经完成了上面的练习，可以试试这个：
任务：让 Claude 帮你写一封邮件
提示：
帮我写一封邮件给团队成员，内容是：
- 主题：关于下周会议安排
- 时间：下周三下午 2 点
- 地点：3 号会议室
- 议题：讨论项目进度和问题
- 请大家准备好各自的进度更新
要求：
- 语气友好但专业
- 开头称呼"各位同事："
- 结尾署名"【你的名字】"
写完后，可以让 Claude 调整语气：”再正式一点” 或 “更活泼一些”
常见问题
Q: 我输入错了怎么办？
A: 没关系，直接说”重新来”或”刚才不对，应该是…”，或者用 /undo 撤销。
Q: 生成的内容太长/太短？
A: 直接告诉它：”再简短一点”或”写得更详细些”
Q: 可以让它保存文件吗？
A: 可以！说”把这个保存为 xxx.md”就行
Q: 它会忘记之前的对话吗？
A: 长对话中早期内容会被自动压缩。关键信息建议写在 CLAUDE.md 中，或用 /compact 管理。
Q: 怎么查看花了多少钱？
A: 输入 /cost 即可查看。
常见问题
第1次培训：常见问题解答
安装相关
Q: 安装时提示权限不足怎么办？
A:
Windows:
- 以管理员身份运行命令提示符
Mac/Linux:
sudo npm install -g @anthropic-ai/claude-code
或者使用 nvm（Node Version Manager）来管理 Node.js，这样就不需要 sudo 了。
Q: npm 安装太慢怎么办？
A: 可以使用国内镜像源：
# 临时使用淘宝镜像
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
# 或者永久设置镜像
npm config set registry https://registry.npmmirror.com
Q: 安装成功了但输入 claude 提示找不到命令？
A: 需要确保 npm 的全局安装路径在系统 PATH 中：
# 查看 npm 全局安装路径
npm config get prefix
# Windows: 把上面的路径添加到系统环境变量 PATH
# Mac/Linux: 在 ~/.bashrc 或 ~/.zshrc 中添加
export PATH="$(npm config get prefix)/bin:$PATH"
Q: 安装后遇到配置问题怎么办？
A: 运行诊断命令：
claude /doctor
这个命令会自动检查：
- Node.js 版本是否满足要求
- API Key 是否配置正确
- 网络连接是否正常
- 配置文件是否有效
API Key 相关
Q: API Key 安全吗？会泄露吗？
A: 很安全！API Key 只保存在你本地的配置文件中，不会上传到任何地方。
配置文件位置：
- Windows:
C:\Users\你的用户名\.claude\settings.json - Mac/Linux:
~/.claude/settings.json
Q: API Key 填错了能改吗？
A: 可以！有几种方式：
- 用
/config命令修改 - 用环境变量覆盖
- 直接编辑
settings.json文件 - 用 cc-switch 切换到其他模型
Q: 没有 Anthropic API Key 能用吗？
A: 可以！用 cc-switch 配置国内模型（豆包、智谱等），详见 04-国内模型配置.md。
配置相关
Q: 配置文件在哪？
A: Claude Code 有三层配置：
| 文件 | 位置 | 作用范围 |
|---|---|---|
| 全局设置 | ~/.claude/settings.json | 所有项目 |
| 项目设置 | .claude/settings.json | 当前项目共享 |
| 项目本地 | .claude/settings.local.json | 当前项目不提交 |
Q: 怎么让 Claude 自动了解我的项目？
A: 使用 /init 命令：
claude /init
会自动分析项目结构，生成 CLAUDE.md 文件。以后每次对话都会自动加载这个文件。
Q: CLAUDE.md 是什么？怎么用？
A: CLAUDE.md 是 Claude Code 的”项目说明书”，每次对话开始时自动加载。
你可以放：
- 项目说明和技术栈
- 开发规范
- 常见注意事项
- 文档模板偏好
有4个位置可以放：
~/.claude/CLAUDE.md– 全局指令项目根目录/CLAUDE.md– 项目指令.claude/CLAUDE.md– 项目指令（优先）.claude/rules/*.md– 规则文件（可按匹配条件加载）
工作模式相关
Q: 三种工作模式有什么区别？
A:
| 模式 | 行为 | 适用场景 |
|---|---|---|
| Plan | 只规划不执行 | 复杂改动先看方案 |
| Code | 规划后执行（默认） | 日常开发 |
| Auto | 自动执行，减少确认 | 简单重复性操作 |
用 /mode 命令切换。
Q: 什么时候用 Plan 模式？
A: 以下场景建议用 Plan 模式：
- 需要重构代码，先看看方案
- 复杂的架构变更
- 不确定怎么做，先让 Claude 分析
- 需要多种方案对比
使用相关
Q: Claude 会修改我的文件吗？能撤销吗？
A:
- Claude 会先问你确认才会修改文件
- 可以用
/undo撤销上次文件修改 - 可以用
/rewind回退到之前的对话状态 - 如果是 git 仓库，可以用
git checkout撤销
Q: 对话历史能保存吗？
A: 可以！使用 claude-mem 插件可以记录重要对话：
/skill:claude-mem
把这次对话的要点记录下来
也可以用 claude --resume 继续上次对话。
Q: 能同时打开多个项目吗？
A: 可以！每个终端窗口/标签页可以运行一个 Claude Code 实例，分别在不同的项目目录中。
Q: 处理大文件时提示上下文不够怎么办？
A: 几种解决方法：
- 只读取文件的一部分： “只读取 README.md 的前 50 行”
- 分多次处理： “先处理文件的第一部分”
- 使用
/compact压缩对话上下文 - 配置自动压缩：
{ "autoCompactEnabled": true, "autoCompactWindow": 200000 }
Q: 怎么让 Claude 用中文回复？
A: 直接用中文提问就行！Claude 会自动用中文回复。如果它用英文回复了，可以说：”请用中文回复”。
也可以在 settings.json 中设置：
{
"language": "zh-CN"
}
Q: 怎么查看当前花了多少 token？
A: 输入 /cost 即可查看当前会话的 token 消耗和费用。
技能相关
Q: 技能太多了记不住怎么办？
A: 没关系！用 /help 或 /skills 查看所有可用技能。常用的几个记住就行：
/superpowers:brainstorming– 头脑风暴/superpowers:writing-plans– 写计划/superpowers:systematic-debugging– 系统化调试/review– 代码审查/cost– 查看费用/compact– 压缩上下文
Q: 安装了技能但用不了？
A: 检查：
- 技能是否正确安装
- 输入
/skills查看列表 - 重启 Claude Code
- 运行
claude /doctor诊断
性能相关
Q: 响应太慢怎么办？
A: 几个优化建议：
- 使用更快的模型（如 Claude Haiku 或豆包 Lite）
- 减少上下文长度（只读取必要的文件）
- 使用
/compact压缩对话 - 检查网络连接
Q: 为什么有时候会卡住？
A: 可能的原因：
- 网络问题 – 检查网络连接
- API 服务暂时不可用 – 稍后重试
- 任务太复杂 – 拆分成多个小任务
- 上下文太长 – 用
/compact压缩
VS Code 扩展相关
Q: VS Code 扩展和命令行版本有什么区别？
A:
- 功能相同 – 核心能力一样
- 界面不同 – VS Code 有图形界面，更直观
- 集成更好 – 可以直接在编辑器中操作文件
- IDE 诊断 – IDE 扩展提供 MCP 工具，让 Claude 获取 IDE 的诊断信息
Q: VS Code 中怎么打开 Claude Code？
A:
- 按
Ctrl+Shift+X打开扩展面板，确保已安装 - 点击左侧活动栏的 Claude Code 图标
- 或按
Ctrl+Shift+P，输入 “Claude Code: Open Panel”
更多帮助
如果以上都没有解决你的问题：
- 输入
/help查看帮助 - 输入
/doctor诊断配置 - 运行
claude /doctor检查环境 - 访问 Claude Code 官方文档
- 问团队里已经会用的同事
原创文章，作者：AI下载网站，如若转载，请注明出处：https://www.qidm.com/Ai/58
