不仅是聊天机器人：Claude Code 部署全指南 (保姆级教程)

📢 前言：为什么你需要 Claude Code？

你是不是也经历过这样的崩溃时刻：

1. 1. 在 IDE 里写代码，遇到 Bug。
2. 2. 复制报错信息 -> 切换浏览器 -> 粘贴给 AI。
3. 3. AI 给出一堆代码 -> 复制 -> 切换回 IDE -> 粘贴覆盖。
4. 4. 结果：少复制了一个括号，或者上下文丢失，AI 开始胡言乱语。

如果 AI 就住在你的终端里呢？ 如果它能自己运行 ls 看文件，自己跑 npm test 测代码，甚至自己修改文件呢？

这就是 Claude Code (Anthropic 官方 CLI 工具)。它不是一个简单的对话框，它是你终端里的结对编程专家。

今天，我们开启《Claude Code 进化论》专栏的第一篇，手把手带你完成环境搭建

🛠️ 第一步：基石搭建 (Node.js 环境)

Claude Code 是基于 Node.js 运行的，所以我们需要先准备好地基。

1.检查 Node.js 版本

Claude Code 需要较新的 Node.js 版本（建议 v20.19 或更高）。打开你的终端（Terminal/iTerm2/PowerShell），输入：

1

node -v

如果是 v20.x.x 以上，恭喜你，直接跳到第二步！ 如果是 v14、v16 或者报错，请继续看。

2.安装/升级 Node.js (推荐使用 nvm)

强烈不建议直接去官网下载安装包！使用版本管理工具 nvm (Node Version Manager) 是最优雅的方式。

Mac/Linux 用户：

1
2
3
4
5
6

# 安装 nvm
curl -o- [https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh](https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh) | bash
 
# 安装最新版 Node
nvm install node
nvm use node

Windows 用户： 推荐使用 nvm-windows 或者 fnm (Fast Node Manager)。

🚀 第二步：召唤神兵 (安装 Claude Code)

地基打好后，安装 Claude Code 只需要一行命令。

1.全局安装

在终端执行：

1

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

• • npm: Node 的包管理器
• • -g: 全局安装 (Global)，这样你在任何文件夹都能呼叫 Claude。

npm config set registry https://registry.npmmirror.com

2.验证安装

输入以下命令，如果出现版本号，说明安装成功：

1

claude --version

*(注：如果提示 command not found，请检查你的 npm 全局路径是否在环境变量 PATH 中。)*

🧩 第三步：装上义肢 (安装扩展工具)

Claude Code 本身已经很强，但如果配合以下两个神器，它将从“代码助手”进化为“全栈工程师”。

1. 安装 OpenSpec (规范驱动开发)

安装命令：

1

npm install -g @fission-ai/openspec@latest

2.安装 Claude Code Router (智能任务路由)

安装命令：

1

npm install -g @musistudio/claude-code-router

添加供应商

🎮 第四步：IDEA 实战

一切就绪，让我们来试一试！

1. 1. 找一个你现有的代码仓库，启动 ccr：

1. 2. 输入你的第一个指令：
2. 1. "请解释一下当前目录下的 index.js 是做什么的？"

你会发现，它自动识别了目录下的文件，读取了内容，并给出了回答。这比复制粘贴快多了！

❓ FAQ：避坑指南

在使用过程中，你可能会遇到以下问题，我都帮你总结好了：

Q1: 报错 Error: 403 Forbidden** 或 Connection Timeout****？**

A: 99% 是网络问题。Claude Code 是 CLI 工具，它不走你浏览器的插件代理。请务必在终端设置 https_proxy 环境变量（参考第三步）。

Q2: 提示 x509: certificate signed by unknown authority****？

A: 这是 SSL 证书问题，常见于公司内网或使用了某些抓包工具。尝试临时设置 export NODE_TLS_REJECT_UNAUTHORIZED=0 (仅限测试环境，生产环境不建议)。

Q3: 它的 Token 消耗快吗？

A: Claude Code 默认使用 Claude 3.5 Sonnet 模型。它会读取你的文件上下文，如果项目很大，Token 消耗会很快。

• • 省钱技巧：使用 /compact 命令压缩上下文，或者在启动时指定忽略大文件夹（如 node_modules 它是默认忽略的）。

Q4: 什么是 Approved Tools？

A: 这是 Claude 的安全白名单。你可以通过配置 .clauderc.json 文件，告诉 Claude 哪些命令（如 ls, grep）可以直接运行，不用每次都问你。我们将在后续的**【进阶篇】**详细讲解。

🔮 下期预告

安装只是第一步。 你现在只能和它聊天，但你知道如何用 斜杆命令 (Slash Commands) 像指挥官一样操控它吗？ 你知道怎么用 /add 把整个架构喂给它，然后让它画出架构图吗？

下期：《掌控指挥棒——Claude Code 斜杆命令全解》