彭河森先聊点实际的。我大概从 Claude Code 发布初期就开始用，一路从“这玩意是不是个高级玩具”用到“离了它我写代码效率直接腰斩”。但说实话，网上的教程要么是官方文档的翻译腔，要么是“教你三分钟配置出高级 AI 编程环境”那种标题党。这篇东西我不会写成官方文档，也不会写成营销号软文，就是把我在真实项目里用 Claude Code 干活时的那些操作、参数、踩坑、心得全倒出来。标题叫“不完全使用指南”，是因为我确实不敢说把它玩透了，但下面这些内容，每一行都是实测过、在真实项目里跑过、并且现在还在用的东西。
如果你正打算装一个 Claude Code 试试水，或者已经装了但感觉用起来不顺手，这篇文章能帮你省下大量自己摸索的时间。我会从最基础的安装开始讲，然后说清楚它在 VSCode 里到底该怎么配、日常写代码时有哪些真正高频好用的操作、进阶一点有哪些命令和权限管理技巧，最后用一整段记录我实际踩过的坑和排查思路。哪怕你之前完全没接触过命令行 AI 编程工具，跟着这篇文章走一遍，也基本能把它跑起来、用起来、用顺手。
1. 先把 Claude Code 装好：从环境准备到安装完成
1.1 安装前必须确认的三件事
很多人装 Claude Code 失败，根本不是工具的问题，而是前置环境没弄对。我列一下最基础、也是最重要的检查项，这三条不满足，后面全是白折腾。
第一，操作系统。Claude Code 目前对 macOS 和 Linux 的支持最稳定，Windows 下面也能跑，但需要 WSL（Windows Subsystem for Linux）环境。我自己的主力机是 macOS，另一台 Windows 笔记本上也装了，实测下来 macOS 的体验会流畅很多，尤其是在权限管理和路径处理这些环节。如果你只有 Windows 机器，我强烈建议你先花半小时把 WSL 配好，直接在 WSL 的 Ubuntu 终端里操作，别在 PowerShell 或者 CMD 里硬搞，否则后面会遇到各种奇奇怪怪的路径分割符问题。
第二，Node.js 版本。Claude Code 是跑在 Node.js 上的命令行工具，官方要求 Node.js 18 以上。这里要提醒一句，很多人机器上装的 Node.js 是老版本，尤其是公司统一配发的电脑，Node 可能还停在 14 或者 16。你可以在终端里先跑一下 node -v 看版本，如果低于 18，建议用 nvm（Node Version Manager）装一个新的 LTS 版本，尽量不要直接去官网下安装包覆盖，那样容易把环境搞乱。nvm 的方式随时切换版本，对后面跑别的 Node 项目也更友好。
第三，网络环境。Claude Code 装好后要连接 Claude 的服务端，这就意味着你需要能稳定访问它的服务。国内网络环境下，这一步可能会遇到连接超时或者请求被中断的情况。这里我不展开讲任何网络工具的事，只提醒一点：尽量在网络稳定的环境下使用，保证 npm 安装依赖以及后面 Claude Code 连接服务的过程顺畅，不然你排查问题排查半天，最后发现是网络不通，很耽误时间。
1.2 npm 安装命令与权限处理
确认完上面三条，安装其实就一条命令的事。打开终端，输入：
bash复制npm install -g @anthropic-ai/claude-code
我加了 -g 参数，表示全局安装，这样你在任何目录下都能直接调用 claude 命令。如果你之前没全局装过 npm 包，可能会碰到权限报错，提示类似 EACCES: permission denied。官方的建议是不要直接用 sudo npm install -g，因为用 sudo 装全局包有安全风险，一旦包被恶意更新，它会拥有你整个系统的权限。更稳妥的做法是修复 npm 的全局目录权限，说白了就是让当前用户拥有那个目录的所有权。你只需要执行：
bash复制mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
然后把 ~/.npm-global/bin 加到环境变量 PATH 里，再重新打开一个终端，claude --version 能看到版本号就说明装好了。
装完之后，在项目目录下直接输入 claude，它会引导你完成登录。这一步需要你有一个 Claude 的账号，并且建议订阅了 Claude Pro 或者 Max 计划，因为免费用户在这个工具上能用到的配额非常有限，基本只够体验几分钟。登录完成后，它会生成一个凭证文件放在本地的 ~/.claude 目录下，这个文件就是你的身份凭证，要小心保管，别把它提交到 Git 仓库里去，我后面会专门讲这个问题。