Claude Code 是 Anthropic 推出的 AI 编程助手命令行工具能在终端里像同事一样和你协作写代码。目录一、快速入门二、基础对话与代码操作三、斜杠命令速查表四、进阶功能详解五、实战案例六、配置与技巧七、常见问题一、快速入门1.1 安装 Claude Code# 全局安装推荐npminstall-ganthropic-ai/claude-code安装完成后在终端输入claude即可启动claude首次使用会提示你登录 Anthropic 账号按提示完成即可。也可以使用cc-switch设置使用 国内的 大模型。1.2 启动后的样子 claude Claude Code v2.x Anthropic API · claude-fable-5 _ ← 在这里输入你的问题或指令1.3 常用 指令Claude Code 将 AI 编程助手从“对话框”升级为“终端智能体”。掌握以下指令即可覆盖日常开发的 90% 场景指令作用使用时机/init初始化项目手册进入新项目/clear清空对话切换任务/compact压缩上下文长对话后期/review代码审查提交前 / CR/pr-comments生成 PR 评论创建 PR/release-notes生成发布说明发版/memory管理长期记忆设定项目偏好/cost查看用量控制成本/mcp管理外部工具连接数据库等/permissions设置权限首次使用/doctor系统诊断出现异常!command执行 shell运行测试/构建file引用文件精确上下文1.4 常用 快捷键快捷键作用Ctrl C中断当前操作Ctrl D退出 Claude Code↑ / ↓浏览历史命令Ctrl L清屏Tab自动补全路径二、基础对话与代码操作2.1 直接对话你不需要任何特殊语法直接用自然语言描述你的需求示例 帮我写一个读取 CSV 文件的 Python 脚本 这个函数的命名不太好帮我改一个更表意的名字 解释一下这段正则表达式在做什么 为什么这里会出现 null pointer 错误Claude Code 会自动读取当前目录下的相关文件理解项目结构给出代码建议或直接修改文件2.2 让 Claude 帮你做事 vs 纯聊天你说的话Claude 会做什么“帮我写个登录页面”创建文件写入完整代码“这个文件里有个 bug”读取文件找到 bug修改代码“跑一下测试”执行测试命令分析结果“解释这段代码”读取代码给出解释三、斜杠命令速查表以/开头的命令是 Claude Code 的内置指令。以下是所有常用命令3.1 会话管理命令作用示例/clear清空当前对话上下文聊了很多轮之后想重置话题时用/compact压缩对话上下文释放 token对话太长开始变慢时用/resume恢复之前的会话不小心关掉终端后恢复 /clear ✓ 对话已清空开始新的上下文 /compact ✓ 上下文已压缩将之前的对话做了摘要3.2 工作模式命令作用示例/plan进入计划模式先设计方案确认后再写代码做复杂功能前先进计划模式/fast切换快速模式用 Opus 快速输出简单任务想快点出结果时用/loop循环执行某个指令按间隔重复/loop 5m 跑一遍测试/ultracode开启多智能体并行模式大型审计、全面重构时用 /plan ✓ 进入计划模式 — Claude 会先设计方案让你确认后再动手 /fast ✓ 已切换到快速模式Claude Opus /loop 10m 帮我检查一下 http://localhost:3000 是否还活着 ✓ 每隔 10 分钟执行一次健康检查3.3 代码审查命令作用示例/review审查当前分支的改动提交前让别人AI帮你看一遍/code-review同上审查工作区变更PR Review 前自检/security-review安全审查当前变更检查是否有安全漏洞 /review 审查结果 ⚠️ src/auth.js:42 — 密码明文存入日志有泄露风险 ⚠️ src/api.js:18 — SQL 查询使用了字符串拼接有注入风险 ✓ 其余文件变更无明显问题3.4 项目管理命令作用示例/init为当前项目生成 CLAUDE.md项目说明书新项目让 Claude 了解你的项目/tasks查看当前后台任务列表检查并行任务状态/workflows查看多智能体工作流进度看并行 agent 跑得怎么样了 /init ✓ 已生成 CLAUDE.md涵盖 - 项目结构说明 - 构建/测试命令 - 代码风格约定3.5 配置与帮助命令作用示例/config打开/修改 Claude Code 配置切换模型、改主题、设置权限/help查看帮助忘记命令时用/status查看当前会话状态看当前模型、模式等信息/cost查看当前会话的 token 消耗关心成本时用 /config 打开配置面板可以设置 - model: 默认模型 - theme: 终端主题 (dark/light) - permissions: 各类操作是否需要确认 /cost 本次会话消耗 - 输入 token: 45,230 - 输出 token: 12,100 - 预估费用: ~$0.853.6 权限与输出命令作用示例/permissions管理权限设置允许/禁止某类操作自动执行/output-style切换输出风格调整 Claude 回复的详细程度 /permissions 当前权限规则 - Bash 命令每次执行前询问 - 文件写入每次确认 - 网络请求每次确认 /permissions allow Bash npm test ✓ 下次执行 npm test 不再询问3.7 IDE / 集成命令作用/ide查看 IDE 集成状态/mcp管理 MCP 服务器连接四、进阶功能详解4.1 计划模式 —— 复杂任务的利器当你说的需求比较大Claude 会建议进入计划模式。你也可以主动用/plan。场景你要给网站加一个用户权限系统。 /plan 进入计划模式Claude 开始调研 我先看看你的项目结构…… 了解当前路由、数据模型、现有认证方式…… --- 实现方案 一、数据层 - 新增 roles 表admin / editor / viewer - users 表加 role_id 外键 二、中间件 - 创建 auth middleware 检查角色 - 在路由定义上加 requireRole(admin) 三、前端 - 无权限页面显示 403 - 侧边栏根据角色动态渲染菜单 四、涉及文件 - migrations/add_roles.sql新建 - src/middleware/auth.js修改 - src/routes/*.js修改 - src/components/Sidebar.jsx修改 是否按此方案执行你确认后Claude 开始逐个文件修改。这就避免了 AI 一顿乱改然后你全删掉的惨剧。4.2 后台任务 —— 边跑边聊耗时操作可以放到后台不影响继续聊天 帮我跑完整的测试套件 Claude 在后台跑测试你可以继续问其他问题 对了顺带帮我看下 utils.js 里的那个函数 同时进行互不干扰 /tasks 后台任务 ⏳ #1 运行完整测试套件 — 进行中 (32/156)4.3 多代理工作流 —— 大型项目的神器当你需要同时做很多事比如全面代码审查Claude Code 可以派出多个分身并行工作 用 ultracode 帮我全面审查 src/ 下所有代码Claude Code 会自动派出多个 agent 各自审查不同模块汇总所有发现去重后给出最终报告适合场景大规模代码审计全面重构代码迁移多模块同步开发4.4 定时任务 —— 让 Claude 帮你盯梢# 每 5 分钟检查一次部署状态 /loop 5m 检查 https://my-app.com 是否返回 200 # 每小时拉一下最新 PR 并做 review /loop 1h /review # 每天早上 9 点跑一遍测试注意每天每24小时 /loop 24h 跑一遍 npm test 并告诉我结果Claude 会在后台按间隔唤醒并执行你指定的任务。4.5 内存记忆 —— 让 Claude 记住你的习惯 记住我们这个项目的 Go 版本是 1.21不要用 1.22 的新特性 ✓ 已记录到项目记忆 记住我偏爱用 async/await 而不是 .then() ✓ 已记录Claude Code 有持久的记忆系统会把你的偏好、项目约定存下来下次对话自动加载。五、实战案例案例 1从零写一个 REST API 帮我用 Express 写一个 Todo API包含增删改查数据存到 SQLiteClaude 会初始化package.json安装依赖创建server.js主文件创建db.jsSQLite 初始化脚本写好 GET/POST/PUT/DELETE 四条路由提醒你npm start启动案例 2修 Bug 用户反馈登录之后偶尔跳回登录页帮我看下什么原因Claude 会搜索登录相关代码auth、login、token找到 token 刷新的逻辑发现 token 过期后没有正确刷新返回 401 时前端直接跳登录页修复在 axios 拦截器里加入静默刷新逻辑告诉你改了哪里为什么案例 3重构老代码 src/utils.js 有 800 行了帮我按功能拆分成几个小文件Claude 会分析utils.js里的函数分类提出拆分方案string-utils.js、date-utils.js、validate.js等逐个创建新文件迁移函数更新所有引用跑测试确认一切正常案例 4写单元测试 src/api/user.js 的覆盖率不够帮我补测试Claude 会读取user.js分析哪些分支没被覆盖在tests/user.test.js里补上边界条件和异常路径的测试用例运行测试确认通过案例 5学习不熟悉的代码库 我刚接手这个项目帮我梳理一下整体架构Claude 会浏览目录结构读取关键入口文件画出模块依赖关系给出一份结构说明 项目结构一览 ├── src/ │ ├── pages/ — 页面组件Next.js │ ├── components/ — 通用 UI 组件 │ ├── hooks/ — 自定义 React Hooks │ ├── services/ — API 调用层 │ ├── stores/ — Zustand 状态管理 │ └── utils/ — 工具函数 数据流 页面 → hooks → services → API ↕ stores全局状态六、配置与技巧6.1 CLAUDE.md —— 项目说明书在项目根目录放一个CLAUDE.mdClaude 每次启动都会自动读取。强烈建议写清楚# CLAUDE.md — 项目速查 ## 常用命令 - 开发: npm run dev端口 3000 - 测试: npm test - 构建: npm run build ## 技术栈 - 前端: React 18 TypeScript - 后端: Express Prisma - 数据库: PostgreSQL ## 代码约定 - 使用函数组件不用 class - 优先使用 async/await - 组件文件用 PascalCase - 工具函数文件用 kebab-case ## 注意事项 - 不要修改 src/legacy/ 下的文件那是旧系统 - API 请求统一走 src/services/request.js 封装用/init命令可以自动生成一份初稿。6.2 配置文件位置文件作用~/.claude/settings.json全局设置对所有项目生效.claude/settings.json项目级设置只对当前项目生效.claude/CLAUDE.md项目说明书~/.claude/memory/Claude 的记忆文件6.3 权限控制// .claude/settings.json{permissions:{Bash:{npm test:allow,// 自动允许跑测试npm install *:deny// 禁止安装新包要手动确认},WebFetch:{https://docs.my-company.com/*:allow// 允许访问公司文档}}}6.4 常用组合技巧# 1. 快速查文件 改src/components/ 下面哪些文件用了 useState# 先查把上面找到的文件里的 useState 都改成 useReducer# 再改# 2. 分步做复杂任务/plan# 先进计划模式实现用户权限系统# 描述需求确认方案后自动执行# 3. 并行干活帮我同时做A) 修登录 bug B) 补 utils 测试 C) 更新 README# 4. 先审后修/review# 审查改动修复上面报告的所有高危问题# 一键修复七、常见问题Q1: Claude Code 和 ChatGPT / Copilot 有什么区别对比维度Claude CodeGitHub CopilotChatGPT运行方式终端独立运行IDE 插件网页/App操作能力✅ 读写文件、执行命令、Git⚠️ 仅代码补全/聊天❌ 手动复制粘贴上下文整个项目当前文件单次对话多步骤任务✅ 自动规划执行❌ 需逐步引导❌ 需逐步引导简单理解Copilot 是你的代码补全助手ChatGPT 是聊天顾问Claude Code 是能直接帮你干活的同事。Q2: 怎么让 Claude 写出更好的代码说清楚上下文“这是 Express 项目用 TypeScript数据库是 PostgreSQL”给具体约束“不要用第三方库”、“要兼容 Node 16”用 CLAUDE.md把项目约定写进去一劳永逸复杂任务先进化用/plan让 Claude 先想清楚再做不满意就让它改“太复杂了简化一下”、“加点注释”、“按 xxx 风格重构”Q3: 为什么 Claude 有些操作要问我确认出于安全考虑以下操作默认需要确认执行 Shell 命令写入/删除文件发送网络请求你可以通过/permissions为信任的操作开绿灯。Q4: token 消耗很快怎么办用/compact压缩长对话长对话中定期/clear重置上下文具体问题具体问不要闲聊复杂任务用/plan减少来回修改