XC Tokens 帮助中心
返回文档首页

XC Tokens 帮助中心 / 教程大全

06：Claude Code 环境配置 · 小白操作指南（Windows）

Claude Code 环境配置 · 小白操作指南（Windows）

更新于 2026-08-08

Claude Code 环境配置 · 小白操作指南（Windows）

原则：能少一步就少一步，能不装就不装

一、先确认一件事：你的电脑有没有 Chocolatey

Chocolatey 是 Windows 的安装工具，有就直接用，没有才安装

第 1 步：以管理员身份打开 PowerShell

  1. 点击 开始菜单
  2. 搜索：PowerShell
  3. 右键 → 选择 “以管理员身份运行”
✅ 成功标志：窗口标题显示 Administrator: Windows PowerShell

第 2 步：检查是否已经安装 Chocolatey

在 PowerShell 中输入：
choco -v

情况 A：有输出版本号（例如 2.x.x）

🎉 说明你已经装过 Chocolatey
👉 直接跳到「三、安装 Node.js」

情况 B：提示不是命令 / 找不到

类似：
choco : 无法将“choco”项识别为 cmdlet
👉 说明没装，需要安装 Chocolatey 继续下面步骤 👇

二、仅在“没有 choco”时，才执行本步骤（安装 Chocolatey）

⚠️ 这一段 只做一次，以后都不用再碰

第 3 步：安装 Chocolatey

在 PowerShell 中 整段复制并回车：
Set-ExecutionPolicy Bypass -Scope Process -Force; `
[System.Net.ServicePointManager]::SecurityProtocol = `
[System.Net.ServicePointManager]::SecurityProtocol -bor 3072; `
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
⏳ 等待 1～3 分钟，不要关闭窗口。

第 4 步：再次确认安装成功

choco -v
看到版本号 → 说明安装成功 ✅ 如果还不行 → 关闭 PowerShell，重新以管理员身份打开再试一次

三、使用 Chocolatey 安装 Node.js（必须步骤）

Claude Code 依赖 Node.js，没有这一步一定用不了
在 PowerShell 中输入：
choco install nodejs -y
⏳ 安装时间：2～5 分钟

验证 Node.js 是否安装成功

依次输入：
node -v
npm -v
两条命令 都有版本号输出 → 这一关通过 ✅

四、安装 Claude Code（核心步骤）

npm install -g @anthropic-ai/claude-code
等待安装完成（一般 30 秒～2 分钟）

五、最终验证（确认没白折腾）

claude.cmd --version
如果看到类似：
claude-code x.x.x
🎉 恭喜：Claude Code 已可用（到这里就算安装成功了）

六、最常见问题兜底（给小白的安全网）

❌ 提示 claude 不是命令

👉 解决方式：
  1. 关闭 PowerShell
  2. 重新 以管理员身份 打开
  3. 再运行：
claude.cmd --version

❌ node / npm 没有版本号

👉 直接重来这一句：
choco install nodejs -y
然后 重启 PowerShell

Claude Code 安装指南 (MacOS 小白版)

这份指南将带您一步步在 Mac 上安装并运行 Claude Code。Claude Code 是一个能直接在您的终端（Terminal）里帮您写代码、修 Bug 的 AI 助手。

🟢 第一步：检查准备工作

在开始之前，我们需要确保您的 Mac 已经安装了必要的运行环境（Node.js）。
  1. 打开“终端” (Terminal)
    1. 按 Command ⌘ + Space 空格键，输入 Terminal 或 终端，然后回车打开。
  2. 检查是否安装了 Node.js
    1. 在终端窗口中输入以下命令并回车：
      2. node -v
    2. 情况 A： 如果出现类似 v18.x.x, v20.x.x, v22.x.x 的数字：
      • 🎉 恭喜，您已准备就绪！可以直接跳到 第二步。
    3. 情况 B： 如果出现 command not found 或者版本号低于 18：
      • 您需要先安装 Node.js。
      • 推荐做法：去 Node.js 官网 下载 LTS (长期支持版) 并像安装普通软件一样安装它。

🔵 第二步：安装 Claude Code

这是最关键的一步，我们将把 Claude Code 下载到您的电脑里。
  1. 运行安装命令
    1. 复制下面这行代码，粘贴到您的终端里，然后按回车：
      2. npm install -g @anthropic-ai/claude-code
    2. 解释：npm 是安装工具，-g 表示安装到全局（哪里都能用），后面是软件的名字。
  2. 等待安装完成
    1. 终端会跑一堆代码，等待它停止滚动。
    2. 如果看到 permission denied (权限被拒绝) 的错误，请在命令前加 sudo 再次尝试（输入 sudo npm install -g @anthropic-ai/claude-code，然后输入电脑开机密码，密码输入时不会显示）。

🟣 第三步：启动与授权

安装好后，我们需要“叫醒”它，并告诉它你是谁（登录账号）。
  1. 启动 Claude
    1. 在终端输入以下命令并回车：
      2. claude
  2. 同意协议
    1. 如果是第一次运行，它会显示隐私政策和服务条款。
    2. 按 Enter (回车键) 继续。
  3. 登录账号 (OAuth)
    1. 屏幕上会出现提示，问您是否进行认证。
    2. 按 Enter (回车键)。
    3. 浏览器会自动弹出一个网页，是 Anthropic 的登录页面。
    4. 在网页上：登录您的 Claude 账号，并点击 "Allow" (允许) 授权。
    5. 回到终端：您会看到显示 "Login successful" (登录成功)。

🟠 第四步：初次项目配置

登录成功后，Claude Code 会问您一些关于当前项目的问题（它需要知道在哪里工作）。
  1. 选择项目目录
    1. 它可能会列出您当前的文件夹，或者建议您运行 cd <您的项目路径> 来进入特定文件夹。
    2. 如果您只是想测试，可以直接在当前目录开始。
  2. 它能做什么？
    1. 此时，您会看到一个 >> 提示符。这就是 Claude Code 的对话框了！
    2. 您可以直接用自然语言跟它下指令。

💡 常用指令速查 (小白必看)

在 >> 提示符后面，您可以尝试输入这些中文指令：
  • 让它了解你的项目：
  • "请在这个文件夹里运行 summary 命令，帮我总结一下这个项目的结构。" (它会自动执行 /summary)
  • 让它修 Bug：
  • "运行 test，并修复所有失败的测试用例。" (它会先运行测试，看到报错后，自动尝试修改代码)
  • 退出程序：
    • 输入 /exit 或者按 Ctrl + C。

⚠️ 常见问题与避坑指南

根据图片提示，这里有几个特别注意点：
  1. 关于权限：
    1. Claude Code 是一个代理 (Agent) 工具，这意味着它可以在您的电脑上真的执行命令（比如删除文件、安装软件）。
    2. 虽然它通常会请求您的许可，但在使用 sudo (管理员权限) 命令时要格外小心，清楚它要干什么再批准。
  2. 保持更新：
    1. Claude Code 更新很快，如果想升级到最新版，重新运行一遍第二步的安装命令即可： npm install -g @anthropic-ai/claude-code
祝您使用愉快！如果有任何报错信息，可以直接复制报错内容再次提问。

🔧 进阶设置：配置 API Key 和 代理地址 (环境变量)

如果您需要配置 API Key 或者修改 API 请求地址 (Base URL)（例如使用中转服务），请按照以下步骤将其添加到您的配置文件中，这样设置就会永久生效。
  1. 确定您的终端类型 在终端输入：echo $SHELL 如果结果是 /bin/zsh (MacOS Catalina 及之后版本的默认)，您需要修改 ~/.zshrc 文件。 如果结果是 /bin/bash，您需要修改 ~/.bash_profile 文件。
  2. 编辑配置文件 在终端输入以下命令（以 zsh 为例）：nano ~/.zshrc，结果是 /bin/bash，您需要修改 ~/.bash_profile 文件。 这时候终端会变成一个简易的文本编辑器。
  3. 添加环境变量 (关键步骤) 使用键盘的 向下箭头 ↓ 将光标移动到文件的最底部。 复制并修改以下内容粘贴进去（根据您的实际情况填写）：
      # 1. 设置 API Key (必填)
export ANTHROPIC_API_KEY="您的sk-开头的密钥"
# 2. 设置接口地址/Base URL (选填，仅当您使用代理或中转时需要)
# 注意：地址通常以 /v1 结尾，请咨询您的服务提供商
export ANTHROPIC_BASE_URL="比如 https://xctokens.com/"
    1. 保存并退出 按 Ctrl + O (写入保存)，然后按 Enter (确认文件名)。 按 Ctrl + X (退出编辑器)。
    2. 让设置立即生效 回到终端界面后，输入以下命令并回车：source ~/.zshrc 或者 source ~/.bash_profile 现在，您的环境变量就已经配置完成并生效了！