【干货】Claude Code 安装避坑指南：从下载到跑通项目

一、关于 Claude Code

谈到目前世界上最强大的编程 AI 编辑器，Claude Code 是绕不开的工具。根据我两个月的使用体验（完成 20 多个项目），它不仅功能强大、运行快速，生成的项目代码也非常精准。本文将详细介绍 Claude Code 的安装、部署及项目开发全流程，帮助你快速上手。

二、安装步骤

1. 获取官方文档
   搜索 “doc Claude Code”，第一个结果即为官方文档，所有安装和使用说明均以官方文档为准。
2. 安装 Node 环境
   使用 Claude Code 前需先安装 Node 环境，且版本必须≥18。官方文档提供了安装链接，按指引操作即可（傻瓜式流程，简单易上手）。
3. 全局安装 Claude Code
   打开终端，执行全局安装命令（注意-g代表 global 全局安装，即全电脑可用）。若安装时出现报错属正常现象，需按以下步骤处理：
   • 清空并指定国内开放镜像（需科学上网）；
   • 输入 Claude 启动命令，启动完成后会提示 “是否信任该文件夹”，选择 “信任” 即可进入编辑器界面，选择 “不信任” 则退出。

三、编辑器界面与基础使用

1. 提出开发需求
   直接在界面输入需求即可，例如 “开发 Python 两数之和（LeetCode 第一题）”。
   • 左侧橙色进度条代表任务执行中，会显示执行秒数和所用 Token 数量，可按ESC退出；
   • 系统会自动规划任务并创建文件（如two_sum.py），同时提供预览窗口展示文件内容。
2. 代码确认与操作
   代码生成后会询问 “是否满意”，有三个选项：
   • 满意：选 “yes”；
   • 满意且无需再询问：选第二个选项（可按SHIFT+TAB快捷执行）；
   • 不满意：选第三个选项并提供优化提示。
     此外，按ctrl+r可展开 / 折叠代码预览，方便查看完整程序。

四、常用命令与配置

1. 核心命令

• /clear：清空当前界面内容；
• /config：进入配置界面，可调整多项设置。

2. 配置选项（通过/config进入）

• 自动代码补全：选择True开启，False关闭；
• TodoList 规划：True会在操作前生成任务规划，False则直接执行；
• 自动更新：True开启自动更新，False关闭；
• 皮肤主题：可选择默认、亮细、暗细等编码风格（下方有预览）；
• 通知与编辑模式：可开启 / 关闭通知、调整编辑模式；
• 模型选择：支持切换 Claude Ops、Sonnet 等模型。
  配置完成后按ESC退出。

五、用户规则设置

1. 输入#+ 规则内容（例如 “总是用中文回答”“回答时需自主思考”）；
2. 系统会询问 “项目规则” 还是 “用户规则”：
   • 项目规则：仅应用于当前目录；
   • 用户规则：保存为通用规则（建议选择，适用于所有项目）；
3. 输入memory可查看已设置的规则（需选择 “用户记忆” 或 “项目记忆”）。

六、工作模式切换

1. 计划模式（Plan 模式）
   按住shift切换，系统会先对需求进行规划，再进入开发流程（不会直接执行开发）。
2. 托管模式（auto set 模式）
   全程无需手动干预（无需确认 yes/no），自动执行完整流程，适合信任 Claude Code 的场景。
3. 历史模式
   按两下ESC进入，展示所有历史提问记录，可通过方向键移动查看，切换到某条记录时会自动调整对话至该阶段（注意：不会回滚代码，需手动操作）。

七、注意事项

1. 安装时需确保 Node 版本≥18，全局安装需带-g参数；
2. 部分操作需科学上网，否则可能无法正常使用；
3. 历史模式仅展示对话记录，代码不会自动回滚，需手动处理；
4. 快捷键可提高效率：ESC退出、ctrl+r预览 / 折叠代码、SHIFT+TAB快速确认等。