Claude Code 国内使用完全指南：从安装到精通

为什么一定要试 Claude Code？

Claude Code 堪称当下顶尖的编程工具，其优势显著，值得每一位编程从业者尝试。

在代码重构方面，它实现了真正的端到端重构。有国外用户实际测试，让 Claude Code 独立重写一份 10 年前的劣质代码，它自主投入 6 小时进行处理，最终一次性运行成功。而目前市面上的 Cursor、Copilot 等同类工具，面对同级别的任务还难以做到这一点。
从效率与成本来看，编写代码不应是机械的 "搬砖"。使用 Claude Code，能为你节省实实在在的工作时间，而这些省下的工时，本质上就是金钱。
对于中文用户而言，上手毫无压力。它配备了汉化文档和专属上手指南，只需 5 分钟，就能让你搞懂提示的写法。
与 Cursor 相比，Claude Code 有着断档领先的优势，称 Cursor 为 "玩具" 也不为过。作为目前最强的编程助手，即便它只是一个命令行工具，其能力也无可匹敌。这得益于它的三大特点：一是不会压缩或截取代码片段，能让工具一次性阅读和处理多个文件，实现一次性改好；二是面对复杂任务，能像 manus 一样进行出色的拆解和记录，形成待办项并逐项处理；三是可以实现自动化构建和测试，甚至能调用自动查看浏览器完成测试。
它能干什么？
浏览你的文件系统
运行本地命令
截取网页截图
进行网页搜索
访问 GitHub 查看需求状态
检查 CI/CD流程

传统工具的问题：

只专注写代码
需要各种快捷键和按钮
局限在代码编辑器内

Claude Code 的优势：

参与整个开发流程
纯文本交互，简单直接
能持续工作，调用更多工具

如何安装使用Claude Code？

一、环境准备与安装

1. 前置环境要求

需先安装 Node.js，版本要求 v18 及以上。

Linux/Mac 系统：Node.js下载安装。
Windows 系统：需先安装 WSL（推荐 Ubuntu 或 Centos），通过 WSL 环境运行。

2. 安装方式

官方安装

Windows 安装

bash 复制代码

npm install -g @anthropic/claude-code
#验证安装
claude --version

进行验证，若成功安装，会显示具体的版本号信息。

Linux/ macOS 安装

bash 复制代码

# 全局安装 Claude Code
sudo npm install -g @anthropic/claude-code
# 验证安装
claude --version

环境配置

由于Claude Code暂不支持大陆用户使用，需要使用**ClaudeYY**

获取 API Key然后连接到镜像服务器：

bash 复制代码

# 设置镜像服务器地址
export ANTHROPIC_BASE_URL=https://www.claudeyy.com/api

# 验证配置
echo $ANTHROPIC_BASE_URL

这一步非常重要，否则无法使用

常见问题

安装失败怎么办？

请检查以下几点：

确保 Node.js 版本 ≥ 18.0.0
检查网络连接是否正常
在 Windows 上以管理员身份运行
清除 npm 缓存：npm cache clean --force

镜像服务器连接失败？

请确认：

镜像服务器地址设置
网络防火墙允许访问该地址
如果在企业网络中，可能需要配置公司代理

Windows 上权限错误？

解决方法：

以管理员身份运行终端
设置执行策略：Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

二、基础操作核心技巧

1. 项目初始化与启动

启动后，通过 /ide 命令绑定编辑器（VSCode/Idea/Xcode 等），实现类似 Cursor 的流畅开发体验。
Windows + WSL 环境：需先通过 cd /mnt/e/claude-project/ 进入 Windows 目录，同时用 VSCode 打开相同目录，确保文件操作实时同步（但图形化 Ubuntu/Centos 才能使用 /ide 绑定）。

2. 任务规划与记忆管理

用 Shift+Tab 扩展执行计划：生成 ToDo 列表，可不断补充内容，默认追加到末尾，清晰把控任务步骤。
用 # 设定记忆：
- 用户记忆：对所有项目生效；
- 项目记忆：仅对当前项目有效；两种记忆默认存于 Claude.md 文件，方便复用。
3.清除聊天上下文
- 使用 /clear 清除聊天上下文，避免累积过多历史信息影响效率。
4.快捷键操作
- / 查看命令
- 方向键翻历史
- Tab 补全
- Option+Enter 换行
- Ctrl+C 退出等。
5.中断操作
- 输错指令时，按 ESC 键立即停止 AI 当前任务。
6.恢复历史会话
- 在启动的时候，执行claude -c，可以继续上次对话
- 执行claude -r，可以选择历史对话继续。如果你已经打开了某个对话，你也可以输入 /resume 来切换到其他会话中。
7.上下文压缩
- Claude Code提供了/compact ，它的作用是压缩对话历史，只保留上下文摘要，从而减少 token 占用。
- 这样 Claude 就不会因为上下文太杂而卡壳或跑偏。
8.自定义命令
markdown 复制代码
```
  - 用户级命令：`~/.claude/commands/`，前缀 `/user:`。
  - 项目级命令：`.claude/commands/`，前缀 `/project:`。
  - 示例：创建 `optimize.md` 文件后，输入 `/project:optimize` 自动执行"分析性能并提出优化建议"。
```
- 如果有一些经常用到的工作流程，你可以将流程设置为自定义指令。自定义指令分为两种：
- 用户级命令：放在 ~/.claude/commands/ 目录下，适合所有项目通用的命令。触发方式是输入 /user:命令名。
- 项目级命令：放在项目根目录下的 .claude/commands/ 目录中，适合这个项目专用的命令。触发方式是 /project:命令名。
- 设在 .claude/commands/ 文件夹里新建了一个 optimize.md 文件，里面写上：
markdown 复制代码
```
  请分析并修复这个GitHub Issue：$ARGUMENTS。
  按照以下步骤操作：
  1. 使用`gh issue view`命令查看Issue详情
  2. 理解Issue描述
  3. 在代码库中搜索相关文件
  4. 实施必要的修改来解决Issue
  5. 编写并运行测试来验证修复
  6. 确保代码通过代码风格检查和类型检查
  7. 创建描述性的提交信息
  8. 推送代码并创建PR
  请记住所有GitHub相关操作都使用GitHub CLI工具(`gh`)来完成。
```
- 保存后，你就可以在 Claude Code 中执行 /project:fix-github-issue 1234 ，让 Claude 自动修复指定的 GitHub issue。其中1234是Issue的ID，而指令中的ARGUMENTS会被自动替换成1234
- 你还可以把其他需求封装成命令，比如：
- /user:write-tests → 生成测试用例
- /project:lint → 按团队规范格式化代码
- /user:explain → 把复杂代码解释成人话

三、环境配置优化

1. 关键文件：CLAUDE.md

这是自动载入上下文的特殊文件，建议记录这些内容：

常用 bash 命令（如 npm run build 构建项目、npm run typecheck 类型检查）；
代码风格指南（如用 ES 模块 import/export 而非 CommonJS 的 require）；
项目规范（分支命名、测试说明、开发环境设置等）。

放置位置：

项目根目录（推荐，可纳入 git 共享）；
运行目录的父/子目录（适合 monorepo 项目）；
主文件夹 ~/.claude/CLAUDE.md（对所有会话生效）。

执行 /init 命令可自动生成该文件。

2. 工具权限管理

默认情况下，修改系统的操作（文件写入、bash 命令等）需手动授权，可通过以下方式自定义允许列表：

会话中选择"始终允许"；
用 /permissions 命令添加工具（如允许 Edit 工具、git commit:* 命令）；
编辑配置文件：.claude/settings.json（团队共享）或 ~/.claude.json（个人使用）；
启动时用 --allowedTools 标志指定会话权限。

四、高效开发工作流程

1. 标准开发流程：探索→规划→编码→提交

先让工具阅读相关文件、URL 或图像，明确需求（暂不编码）；
用"think"系列指令（think/think hard/think harder/ultrathink）触发深度思考，生成详细计划（可存入文档或 GitHub Issue）；
按计划编码，过程中验证方案合理性；
提交代码并创建 PR，同步更新 README 或变更日志。

2. 测试驱动开发（TDD）

让工具基于预期输入/输出写测试（明确说明"测试驱动开发"，避免生成模拟实现）；
运行测试并确认失败（此阶段不写实现代码）；
提交测试到 git；
让工具编写代码通过测试（不修改测试），反复迭代至测试全部通过。

3. 代码库与版本控制协作

代码库问答：直接提问如"日志系统如何工作？""如何创建新 API 端点？"，工具会自动搜索代码库解答，加速新代码库上手。
git 交互：查询历史（如"v1.2.3 包含哪些更改？"）、生成提交消息、处理变基冲突等。
GitHub 协作：创建 PR、修复代码审查意见、处理构建失败、整理开放 Issues 等，无需记忆 gh 命令细节。

4. 多任务并行处理

多实例协作：一个实例写代码，另一个审查/测试；或在不同终端启动多个实例，分别处理不同任务（如重构认证系统、开发可视化组件）。

git 工作树：轻量管理多任务的方案

bash 复制代码

  # 创建工作树
  git worktree add ../project-feature-a feature-a
  # 在工作树中启动工具
  cd ../project-feature-a && claude
  # 完成后清理
  git worktree remove ../project-feature-a

无头模式集成 ：用 claude -p 编程式集成到工作流

扇出（处理大规模任务）：

scss 复制代码

  claude -p "迁移 foo.py 到 Vue，成功返回 OK，失败返回 FAIL" --allowedTools Edit Bash(git commit:*)

管道（集成现有流程）：
css 复制代码
```
  claude -p "<提示>" --json | your_command
```

五、体验优化技巧

1. 指令与信息传递

指令要具体：例如"用 Python 写一个斐波那契数列函数，含输入验证，返回前 10 项"，避免模糊描述。
提供视觉信息：粘贴截图、拖放图像或提供文件路径，辅助工具理解 UI 设计、图表需求。
传递数据：复制粘贴内容、管道输入（cat foo.txt | claude）、让工具通过命令拉取数据等。

2. 上下文管理与方向修正

用 /clear 重置上下文：避免长时间会话中无关内容占用资源。
及时调整方向：
- 编码前要求工具出计划，确认后再执行；
- 按 Escape 中断操作，保留上下文修改指令；
- 双击 Escape 回退历史，编辑提示词尝试新方向；
- 要求工具撤销更改，重新尝试其他方案。

3. 复杂任务管理

用 Markdown 清单或 GitHub Issue 作为草稿板，例如批量修复代码检查错误：

让工具运行检查命令，将错误（含文件名、行号）写入清单；
指示工具逐一解决，修复并验证后标记完成，提升可控性。

通过以上技巧，可充分发挥 Claude Code 的高效编程能力，无论是单任务开发还是复杂项目协作，都能显著提升效率。

使用Claude code 的注意事项

保持控制，避免 AI 陷阱

我们在整个过程中都有涉及这一点，但值得强调的是：即使 Claude Code 可以自动化很多工作，你仍然是主导者。

保持"人在回路中"对质量和安全都至关重要。

以下是一些友好的提醒和技巧，确保顺畅的体验：

要时刻留意 Claude 给出的建议

尤其是在正常模式下，仔细查看那些差异对比和相关描述，这些内容通常都不难理解。要是 Claude 提到 "我将运行 rm -rf /"（当然，它肯定不会这么做），你显然要拒绝。更实际的情况是，当它说 "删除数据库文件来重建它" 时，在同意之前，一定要认真确认这样做是否合理。

要是有不确定的地方，别犹豫，直接问！可以大胆地质疑 Claude，比如 "你为什么要在这里创建一个新库？""这个命令是做什么的？" 它会很乐意解释背后的思路。这不仅能让它承担起应有的责任，也能帮助你学到知识。

要做好备份或者使用版本控制

如果你熟悉 Git，那就用起来 ------Claude 甚至能和 Git 无缝配合（比如提交更改、创建分支等）。如果不熟悉 Git，至少在频繁使用 Claude 之前，给重要文件留个副本。虽然我个人从没遇到过 Claude 搞砸项目的情况，但这是个好习惯，就像有个撤销按钮一样让人安心。

作为新手，要避开 " YOLO " 模式

Claude Code 有个 --dangerously-skip-permissions 标志，顾名思义，它会跳过所有确认步骤，本质上就是完全自主模式。这听起来可能很吸引人（"哇，不会被打断！"），但除非你是在一个可以随意丢弃的环境里做实验，否则千万别用。Anthropic 明确警告过，这种模式有风险 ------ 要是 AI 误解了你的请求，可能会执行有害操作或者删除数据。作为新手，你需要这些安全保障，常规流程通常已经足够快了。

给出的 指令 要具体，避免模糊不清

歧义是得到理想结果的绊脚石。比如，说 "让它变得更好" 就太笼统了 ------Claude 可能会优化错地方。相反，"通过减小图像大小让页面加载更快" 就很明确。具体的指令能带来更好的结果。如果你发现 Claude 的操作出乎你的意料，很可能是它误解了模糊的请求。

要知道什么时候该亲自介入

有那么一两次，我让 Claude 陷入了困惑（特别是在处理一个非常大的项目时），它就开始原地打转，甚至越弄越乱。这时候别害怕中止它（在终端按 Ctrl+C），然后手动处理。你可以自己修复一下，或者干脆理清思路重新开始会话。

可以利用问答模式来理解代码。Claude 能回答关于代码库的问题，比如 "用户登录检查在哪里进行？" 或者 "函数 X 是如何工作的？"。用这种方式能让自己始终了解项目情况，掌控项目的走向。

Claude Code 国内使用完全指南：从安装到精通

为什么一定要试 Claude Code？

如何安装使用Claude Code？

一、环境准备与安装

1. 前置环境要求

2. 安装方式

官方安装

环境配置

常见问题

安装失败怎么办？

镜像服务器连接失败？

Windows 上权限错误？

二、基础操作核心技巧

1. 项目初始化与启动

2. 任务规划与记忆管理

3.清除聊天上下文

4.快捷键操作

5.中断操作

6.恢复历史会话

7.上下文压缩

8.自定义命令

三、环境配置优化

1. 关键文件：CLAUDE.md

2. 工具权限管理

四、高效开发工作流程

1. 标准开发流程：探索→规划→编码→提交

2. 测试驱动开发（TDD）

3. 代码库与版本控制协作

4. 多任务并行处理

五、体验优化技巧

1. 指令与信息传递

2. 上下文管理与方向修正

3. 复杂任务管理

使用Claude code 的注意事项

保持控制，避免 AI 陷阱