本文提供了ClaudeCode终端AI编程助手的详细安装指南。

---

包含三种安装方案：

• 官方原生安装适合网络环境良好的用户；
• 国内网络适配安装推荐使用第三方API中转服务；
• 可视化安装适合新手。

---

文章还介绍了必备环境配置、API密钥获取方法、常见问题解决方案及进阶使用技巧，帮助开发者快速上手这一强大的AI编程工具。

---

关联阅读推荐

---

杭州前端AI开发工具组合与使用

---

拥抱 AI 原生 IDE，Cursor 我来了

---

Claude Code 新手安装指南

---

欢迎加入 Claude Code 的行列！这是一个非常强大的终端原生 AI 编程助手。

---

Claude Code 是 Anthropic 推出的终端智能编程助手。好消息是，现在 Windows 上不再必须安装 WSL 了——有更简单的方法！

---

对于新手来说，安装过程可能会因为网络环境（国内/国外）和操作系统（Windows/Mac）的不同而显得有些复杂。

---

为了让你少走弯路，我为你整理了一份2026年最新版的实操指南，涵盖了从“傻瓜式一键安装”到“国内网络适配”的多种方案。

---

🚀 第一步：准备工作（必做）

---

在开始安装之前，请确保你的电脑满足以下基础环境，这能避免 90% 的报错：

1. 硬件要求：普通电脑即可（Windows 需 64 位，macOS 12+，Linux 支持 x64/arm64）。
2. 核心依赖：必须安装 Node.js（推荐 v18 或 v20 以上 LTS 版本）。
   • 检查方法：在终端输入 node --version，若有版本号则说明已安装。
3. API Key（密钥）：Claude Code 需要 API 才能运行。
   • 海外用户：直接使用 Anthropic 官方账号。
   • 国内用户（推荐）：由于官方服务在国内访问受限，建议使用第三方中转服务（如 硅基流动 SiliconFlow、阿里云百炼 或 OpenRouter）。这些平台通常提供免费的体验额度，且连接速度更快。

---

Claude Code 需要 Node.js 18.0 或更高版本。

• 去 nodejs.org 下载 LTS 版本

• 安装时务必勾选 “Add to PATH”

• 安装完成后，打开 CMD 或 PowerShell，验证一下。

获取 API 密钥（必须）

• 访问 Anthropic Console，注册/登录账号

• 进入 “API Keys”，点击 “Create Key”

• ⚠️ 重要：生成后立即保存到安全地方（页面关闭就看不到了！）

• 新账号通常有 $5 免费额度，够新手体验一阵子了

---

🛠️ 第二步：选择安装方案

---

我为你准备了三种方案，请根据你的网络环境和操作习惯选择：

---

方案一：Windows 官方原生安装（适合网络环境较好）

---

安装 Git for Windows（可选但推荐）

虽然不是强制要求，但装了之后可以使用 grep、find、awk 等 Linux 命令，体验更完整。

• 去 git-scm.com 下载

• 安装时保持默认选项

如果你能顺畅访问外网，或者愿意配置代理，这是最标准的方法。

---

1. 打开 PowerShell 或 终端。
2. 复制以下命令并回车执行：
   1. cmd

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

   2. powershell

      irm https://claude.ai/install.ps1 | iex

3. 安装完成后，重启终端，输入 claude --version 验证，如果显示版本号，就搞定了。

   1. claude --version

---

--ignore-scripts 这个参数很关键——它能绕过 Windows 上的 bash 依赖检查。

配置 API 密钥

安装一个辅助工具来运行（这个工具会自动处理 Windows 兼容问题）：

cmd

npx win-claude-code@latest

第一次运行时会提示输入 API Key，按提示粘贴即可。

---

方案二：国内网络适配安装（强烈推荐国内用户）

如果直接运行上面的命令报错或卡住，请使用此方法。

---

我们需要通过 npm 进行安装，并配合国内可用的 API 服务。

---

1. 打开终端（PowerShell 或 CMD），输入以下命令安装：bash

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

2. 配置 API（关键步骤）：
   安装好后，你需要告诉 Claude Code 使用哪个 API 服务。
   • 找到配置文件：通常在 C:\Users\你的用户名\.claude\settings.json。
   • 用记事本打开，填入以下内容（以硅基流动为例）：json

     {
       "env": {
         "ANTHROPIC_AUTH_TOKEN": "你的API_KEY",
         "ANTHROPIC_BASE_URL": "https://api.siliconflow.cn"
       }
     }

   • 注意：将 "你的API_KEY" 替换为你从服务商处获取的真实密钥。

---

方案三：可视化“零代码”安装（小白首选）

如果你不想碰命令行，可以使用开源社区封装的可视化工具，如 CodePilot。

1. 前往 CodePilot 的 GitHub 发布页下载 Windows 安装包（.exe）。
2. 双击安装，软件会自动检测并安装 Node.js 和 Claude Code 依赖。
3. 在软件界面的“设置”中，填入你的 API Key（支持阿里云、硅基流动等），即可通过图形界面直接开始对话。

---

⚙️ 第三步：进阶配置（解决报错与优化）

很多新手在安装后会遇到 thinking type should be enabled or disabled 这类报错，或者想切换不同的模型（如 MiniMax、Qwen 等）。

---

神器推荐：CC Switch

---

这是一个专为 Claude Code 设计的代理管理工具，强烈建议安装。

---

1. 安装：在终端输入 npm install -g cc-switch。
2. 启动：输入 cc-switch 启动界面。
3. 功能：
   • 模型切换：可以在界面中一键切换到底层模型（如从 Claude 切换到 MiniMax-M2.5）。
   • 请求整流：必开功能！ 它能自动修复 API 参数格式错误（即解决上述的 thinking 报错），确保兼容性。

---

🎯 第四步：开始使用

---

一切配置就绪后，你就可以开始使用了：

---

安装并配置好 API Key 后，进入你的项目目录，输入 claude 启动：

---

1. 打开终端，进入你的项目文件夹（例如：cd D:\MyProject）。
2. 输入命令：bash

   claude

3. 首次运行会询问是否信任该文件夹，输入 y 或选择 Trust This Folder。
4. 现在，你可以像和同事对话一样给它下指令了，例如：“帮我分析当前目录下的 Python 文件，找出可能的语法错误”。

---

可以在终端里直接用自然语言跟它对话，比如：

• “帮我写一个 React 登录组件”

• “给这段代码加一下错误处理”

• “解释一下这个函数的作用”

---

常用命令速查

命令	作用
claude "任务描述"	执行一次性任务并退出
claude -p "问题"	执行单次查询（不进入交互模式）
/clear	清空对话历史
/model 模型名	切换模型（如 sonnet/opus）
/status	查看当前配置状态
/help 或 ?	查看帮助
Ctrl + C	中断当前操作
Ctrl + D	退出会话

---

计划模式（Plan Mode）

处理复杂重构任务时，建议先开启计划模式——AI 会先分析并给出方案，不会直接修改代码，等确认后再执行。

---

快捷键：按两次 Shift + Tab 切换。

---

引用文件

---

用 @ 符号可以快速引用项目中的文件，AI 会自动读取并理解内容：

@src/utils/auth.js 帮我优化一下这个文件的登录逻辑

常见问题与踩坑提醒

---

❌ “npm 不是内部或外部命令”

• 安装 Node.js 时没勾选 “Add to PATH”，重装一下或者手动配环境变量

❌ “Claude Code package is not installed globally”

• 运行 npm install -g @anthropic-ai/claude-code --ignore-scripts 重新安装

❌ API Key invalid / 密钥无效

• 检查复制时有没有多带空格（我因为这个卡了10分钟）

• 确认密钥没有被泄露/重置过

❌ 网络超时或连接失败

• Claude Code 需要访问 Anthropic 的 API，如果网络环境特殊，可能需要配置代理

• 可以试试：export ANTHROPIC_BASE_URL=你的代理地址（如果用的是国内镜像/中转站）

💡 省钱小贴士

• 日常编码用 Sonnet 模型就够了，Opus 虽然更强但更贵

• 新用户免费额度用完后，考虑订阅 Claude Pro（$20/月，有使用限制）或继续按 API 用量付费

---

总结

---

新手首选：方案一（免WSL安装）

• 步骤少，不用折腾虚拟机

• 5-10分钟就能跑起来

• 配合 win-claude-code 工具，体验很丝滑

如果想深入用：

• 装个 Git for Windows，体验完整 Unix 命令

• 在项目根目录创建 CLAUDE.md 文件，写清楚项目规范，AI 会自动读取并遵循

• 试试 MCP 和 Skills 扩展能力

---

📊 方案对比总结

方案	适用人群	优点	缺点
官方原生	海外/网络极佳用户	官方原版，更新最快	国内直连易失败，配置繁琐
npm + 中转API	国内开发者	稳定，可自定义 API	需要手动修改配置文件
CodePilot	纯新手/不想敲命令	全可视化，自动装依赖	占用额外软件资源