AI Study Online

Claude Code完全实战教程：掌握所有核心操作

5 min read
📚 AI 教程 🕒 阅读约10分钟 📅 2026年7月7日 🎯 中级

引言

Claude Code 凭借强大的文件阅读、项目重构、调试和自主运行能力，已成为大多数开发者首选的 AI 编程助手。这篇完整实战教程逐步覆盖每一项核心操作，帮助新手快速上手，也帮助资深开发者最大化其生产力。所有操作都配有可执行的代码片段和命令行，可直接复制使用。

1. 基础环境准备与项目导入

1.1 安装并启动 Claude Code CLI

打开本地终端，运行安装命令：

npm install -g @anthropic-ai/claude-code

安装后验证是否成功：

claude-code --version

1.2 导入本地项目文件夹

先在终端中切换到项目根目录：

cd /Users/yourname/Desktop/my-project

启动 Claude Code 工作区绑定：

claude-code init

该命令会生成隐藏的 .claude/ 配置文件夹，自动存储项目规则、对话记录和权限设置。

1.3 配置 API Key

运行登录命令绑定 Anthropic API 密钥：

claude-code login

按提示粘贴 API Key，工具会自动在本地保存凭证，无需重复输入。

2. 核心文件阅读与批量分析功能

Claude Code 能扫描整个项目，而非像普通聊天机器人那样只能看单个文件。

2.1 阅读整个项目代码库

在 Claude Code 对话框中输入自然语言指令：

扫描 src 文件夹下所有 .js 和 .ts 文件，梳理出所有未使用的函数并输出格式化列表

2.2 针对性单文件深度分析

通过终端分析特定文件的命令：

claude-code analyze ./src/utils/request.ts

输出将包含代码逻辑解释、潜在 Bug、优化建议和冗余代码提取。

3. 一键代码重构操作

3.1 批量重构旧语法

在 Claude Code 面板中输入提示词：

将项目中所有 var 声明重构为 const/let，为所有导出函数添加标准化 JSDoc 注释，修改后自动运行格式化

Claude Code 会遍历所有目标文件，自动修改代码并用 ESLint/Prettier 格式化。

3.2 组件结构优化（前端示例）

React 项目重构任务提示词示例：

将 monolithic 的 Home 页面组件拆分为 PageHeader、ContentList 和 Footer 子组件，将重复样式提取到独立的 css module 文件

4. 自动调试与报错修复

4.1 上传错误日志让 AI 智能修复

复制项目崩溃日志，搭配这个固定提示词模板发送：

检查以下错误日志，在项目文件中定位根本原因，写出完整修改代码并解释修复逻辑：
[在此粘贴你的错误日志]

4.2 自动运行测试脚本验证修复

代码修改后，直接在 Claude Code 对话中执行测试命令：

运行 npm test 并检查所有单元测试是否通过，自动修复失败的测试用例

终端快捷执行命令：

claude-code run-test

5. 通过 claude.md 自定义项目规则

在项目根目录创建 claude.md 文件锁定统一开发规范，示例内容：

# 本项目全局代码规则
1. 所有新函数必须携带类型注解
2. 不使用任何已弃用的 npm 包
3. 每次代码变更需编写对应单元测试
4. 每次修改后自动生成 git commit 信息

保存后，后续每次对话任务都会严格遵循此文件中的规则，无需手动重复提醒。

6. Git 联动与自动化提交工作流

6.1 自动生成规范提交信息

Claude Code 完成代码修改后，输入指令：

检查所有变更文件，生成简洁规范的 commit message，自动执行 git add 和 git commit

6.2 终端 Git 操作命令集

# 查看 Claude Code 扫描到的所有修改文件
claude-code git-diff
# 自动提交变更并生成 AI 提交信息
claude-code git-commit

7. 多步骤复杂任务规划模式

对于大规模跨文件重构，先启用 Plan Mode 避免修改混乱：

启用 plan mode，将"原生 JS 项目改造为 Vue3 + Vite 项目"任务拆分为详细可执行步骤，先确认方案再执行任何代码变更

Claude Code 会输出完整的分步计划列表，等待你手动批准后再操作项目文件。

8. 权限控制与安全设置

8.1 调整文件操作权限

在终端输入设置命令：

claude-code config permission

三种可选权限模式：

  1. 每次文件写入前提示（推荐新手使用）
  2. 仅自动批准安全的读写操作
  3. 完全访问模式（仅限可信的本地私有项目）

8.2 阻止敏感文件访问

在 .claude/config.json 中添加黑名单路径，防止误改配置文件：

{
  "fileBlacklist": [".env", "package-lock.json", "database/config.js"]
}

9. 常见提效实用技巧

  1. 快捷方式：使用 claude-code chat 快速打开对话窗口，无需启动完整桌面客户端
  2. 上下文清理命令避免溢出：claude-code clear-context
  3. 导出对话记录备份：claude-code export-log chat_record.json
  4. 大型项目超出 token 限制：按文件夹拆分任务，不要一次性扫描整个项目

总结

Claude Code 的核心优势在于深度本地项目交互能力，远超普通网页 AI 聊天工具。掌握以上终端命令、文件操作逻辑和 Plan/Refactor 工作流，你可以砍掉 70% 的重复编码、调试和整理工作。建议新手从基础文件分析和单文件重构开始，熟悉权限和规则配置后再逐步尝试多步骤复杂改造任务。

常见问题

Claude Code CLI 和桌面版该选哪个？

CLI 版更强大灵活——是开发者做正经工作的首选。桌面版 UI 更好看但缺少一些 CLI 功能，如 claude-code git-commit 和 claude-code analyze。如果你习惯终端，选 CLI。如果你是新手或偏好可视化界面，从桌面版开始，需要更强能力时逐步学 CLI 命令。好消息：两者共享同一套项目配置（.claude/ 文件夹和 claude.md 规则），可自由切换。

claude.md 和 Codex 的 agent.md 有什么区别？

它们功能相同——都是 AI 在每次对话中遵循的项目级指令——但文件名不同。Claude Code 读取项目根目录的 claude.md（或 CLAUDE.md）。Codex 读取 agent.md。如果你同时使用两个工具，可以创建两个文件内容相同，或创建软链接。格式完全一致：纯 Markdown 写规则、约定和偏好。两个工具不会读取对方的文件，所以双工具用户两个都需要。

Plan Mode 和直接让 Claude Code 做任务有什么区别？

普通模式下，Claude Code 立即开始执行——边读文件、边改代码、边跑命令。小任务没问题，但复杂多文件重构容易跑偏。Plan Mode 强制 Claude Code 先想再做：输出完整分步计划，等你批准后才会碰任何文件。这对"JS 迁移到 TypeScript"或"重构整个组件树"这类任务至关重要——第一步错了会连锁反应，清理成本数小时。

Claude Code 能用 Claude 以外的模型吗？

可以，通过 CC Switch（社区工具）。它能将 Claude Code 的 API 调用路由到替代模型，包括国产中文模型。体验不会完全一致——Claude Code 的 Harness 工程为 Claude 模型优化——但基础编码任务差异通常可忽略。很多开发者的策略：复杂重构和调试用 Claude 模型，加注释、格式化等常规任务切换到更便宜的模型。这种混合方案可削减 50%+ 的 API 成本，同时关键工作质量不受影响。

📖 下一步

掌握了 Claude Code 操作？升级你的开发工作流：

分享这篇文章