老实说，第一次看到 ClaudeCode 这个词的时候，我以为是某个 VS Code 插件名。直到同事在终端里敲了一个claude，唰一下拉出命令行对话界面，我才反应过来：这东西不走 IDE，它直接住在你的终端里。作为 Anthropic 官方的命令行编程智能体，ClaudeCode 能读取整个 Git 仓库，用自然语言帮你改代码、跑测试、查报错、提 Pull Request，跟 OpenAI 的 Codex CLI 属于同一条赛道。这篇教程不绕弯子，Windows、Mac、Linux 三条安装路线各跑一遍，把 Node 环境坑、Homebrew 安装失败、服务器上没有浏览器怎么登录这类实际问题一次说清，适合所有想在本地或远程开发机上真正用起来的人直接照抄。
1. 装之前先搞清楚三件事：它不是 IDE 插件，而是你终端里的结对编程搭档
1.1 ClaudeCode 到底是什么，为什么要在终端里做这种事
很多人跟我一开始一样，默认把 ClaudeCode 归类成"编辑器插件"，其实它的核心是一个可执行文件claude，本质是跑在终端里的 AI 代理（Agent）。启动之后有两种工作方式：直接敲claude进入交互式对话界面，在里面来回沟通；或者用claude -c "把 src/utils.ts 里的越界错误修掉"这种单次执行模式，让它自主处理完一个任务再结束。
它不只是聊天框。ClaudeCode 会自己分析项目结构，读相关文件，规划修改方案，调用内置编辑工具改代码，还能帮你运行测试命令、看输出、根据报错继续修，最后给你一份可审查的 diff。这意味着你可以让它处理跨文件的重构，而不是一问一答地复制粘贴代码。
为什么不把它做成 IDE 插件？因为终端才是所有开发者的最小公分母。你用 VS Code、PyCharm、Neovim 还是纯 SSH 进服务器，只要有 shell 就能跑 ClaudeCode，不需要绑定任何编辑器。这一点在多人协作和远程开发场景里非常实用，也是我最终愿意花时间把三个平台都装一遍的原因。
1.2 安装前的基础检查清单
动手前先把这几项检查完，能省掉后面 80% 的报错。
- Node.js 环境：ClaudeCode 通过 npm 分发，底层跑在 Node 上。要求 Node.js 18 及以上，建议直接用 20 LTS 或更高版本。检查命令是
node -v和npm -v，如果提示找不到命令，说明还没装 Node。 - 终端工具：Windows 上强烈建议装 Windows Terminal（微软商店免费），默认 PowerShell 或 CMD 也能用，但体验和字体渲染差一截；macOS 用自带 Terminal 或 iTerm2 都行；Linux 端 bash 或 zsh 随意。
- 账号凭证：需要一个 Anthropic 账号或 API Key。之后本地开发机走浏览器授权登录，服务器上走 API Key，我们会在第 5 节详细展开。
- 磁盘空间：安装包只有几十 MB，加上缓存和配置也占不了多少，不用提前清理磁盘。
- npm 镜像状态：npm 官方源在部分地区访问速度不稳定，如果安装时卡在
ETIMEDOUT，可以先切换到 npmmirror（淘宝 npm 镜像）再装，后面章节有具体命令。
有一句忠告放在最前面：不要用 sudo 或者管理员权限去全局安装 npm 包。有些教程图省事让你sudo npm install -g，结果 npm 全局目录的归属权变成 root，后续更新、卸
)
