🪟 Windows 安装教程

📺 点击查看视频教程

系统要求:Windows 10 (版本 1809 / build 17763) 及以上

第1步:安装 Node.js

前提条件:您需要安装 Node.js 18 或更新版本环境(如果已安装请忽略)。

Windows10/11 X64 下载地址(蓝奏云):

Node.js v24.12.0: https://wwbri.lanzoub.com/iViOk3egtmlg 密码:hkbm
Node.js v22.21.1: https://wwbri.lanzoub.com/i9i8P3egw6bi 密码:1o79

第2步:安装 Git for Windows

Windows 用户还需安装 Git for Windows(安装时全部点击下一步,请勿修改路径)。

Git-2.52.0-64-bit: https://wwbri.lanzoub.com/i03633eh2jsj 密码:8517

第3步:验证安装

打开Windows PowerShell(使用管理员身份打开),执行以下命令:

node -v
npm -v
📷 点击查看图片

第4步:安装 Claude Code

卸载已安装的 Claude Code(如果未安装过可忽略此步骤):

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

安装 Claude Code:

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

查看安装结果:

claude --version

如果出现以下权限报错:

📷 点击查看图片

执行以下命令:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine

第5步:解决报错

📷 点击查看图片

替换以下文件到 .claude.json,下载链接在下方,记得改名!!!

  • Windows 用户一般位于 用户/.claude/ 文件夹的上层目录,也就是 用户/.claude.json
  • macOS 用户一般位于 ~ 目录下,即 ~/.claude.json
下载链接:https://wwaue.lanzouv.com/iTLAr3fdlrhc
密码:5yds
文件下载后要改名,claude.txt改名为.claude.json

替换后执行 claude,如果继续报错,新建或修改 settings.json 配置文件:

文件位置:C:\Users\你的用户名\.claude\settings.json

打开文件资源管理器,在地址栏输入 %USERPROFILE%\.claude 回车,找到或新建 settings.json 文件,写入以下内容(只需修改 key 值,其余直接复制):

点击查看 settings.json 完整配置 ▼
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "填入你在面板生成的key",
    "ANTHROPIC_BASE_URL": "https://api.xstx.info",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4.6",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "permissions": {
    "allow": [
      "Bash(stat *)",
      "Bash(ls *)",
      "Bash(cat *)",
      "Bash(head *)",
      "Bash(tail *)",
      "Bash(find *)",
      "Bash(grep *)",
      "Bash(rg *)",
      "Bash(wc *)",
      "Bash(file *)",
      "Bash(which *)",
      "Bash(echo *)",
      "Bash(pwd)",
      "Bash(cd *)",
      "Bash(python3 *)",
      "Bash(python *)",
      "Bash(pip *)",
      "Bash(pip3 *)",
      "Bash(node *)",
      "Bash(npm *)",
      "Bash(npx *)",
      "Bash(git *)",
      "Bash(docker *)",
      "Bash(mkdir *)",
      "Bash(cp *)",
      "Bash(mv *)",
      "Bash(touch *)",
      "Bash(chmod *)",
      "Bash(curl *)",
      "Bash(wget *)",
      "Bash(brew *)",
      "Bash(open *)",
      "Bash(diff *)",
      "Bash(sort *)",
      "Bash(uniq *)",
      "Bash(sed *)",
      "Bash(awk *)",
      "Bash(cut *)",
      "Bash(tr *)",
      "Bash(xargs *)",
      "Bash(tee *)",
      "Bash(env *)",
      "Bash(export *)",
      "Bash(source *)",
      "Bash(kill *)",
      "Bash(ps *)",
      "Bash(lsof *)",
      "Bash(pytest *)",
      "Bash(java *)",
      "Bash(javac *)",
      "Bash(mvn *)",
      "Bash(gradle *)",
      "Bash(cargo *)",
      "Bash(go *)",
      "Bash(make *)",
      "Bash(cmake *)",
      "Bash(gcc *)",
      "Bash(g++ *)",
      "Bash(tar *)",
      "Bash(unzip *)",
      "Bash(zip *)",
      "Bash(gh *)",
      "Read",
      "Edit",
      "Write",
      "Glob",
      "Grep",
      "WebFetch",
      "WebSearch",
      "Task",
      "NotebookEdit",
      "mcp__puppeteer__puppeteer_navigate",
      "mcp__puppeteer__puppeteer_screenshot",
      "mcp__puppeteer__puppeteer_click",
      "mcp__puppeteer__puppeteer_fill",
      "mcp__puppeteer__puppeteer_evaluate",
      "mcp__puppeteer__puppeteer_select",
      "mcp__puppeteer__puppeteer_hover",
      "mcp__filesystem__*",
      "mcp__memory__*",
      "mcp__duckduckgo__*",
      "mcp__sequential-thinking__*",
      "mcp__local-rag__*"
    ],
    "deny": []
  },
  "model": "opus[1m]",
  "hooks": {
    "Notification": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "afplay ~/.claude/notification.m4a"
          }
        ]
      }
    ]
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline-mac.sh"
  },
  "enabledPlugins": {
    "ralph-loop@claude-plugins-official": true
  },
  "alwaysThinkingEnabled": true
}

注意:将 "填入你在面板生成的key" 替换为你在 api.xstx.info 面板创建的实际 API Key(以 sk- 开头)

保存后重新打开终端,执行 claude 即可。

第6步:启动 Claude Code

cd 您的工程目录名
claude

也可以带参数(跳过权限确认):

claude --dangerously-skip-permissions
📷 点击查看图片

🍎 macOS 安装教程

系统要求:macOS 10.15+ 系统

第1步:下载安装 Node.js

访问 https://nodejs.org/zh-cn/download,选择 macOS 系统。

  • M系列芯片选择ARM64
  • Intel系列芯片选择X64
📷 点击查看图片

或者使用蓝奏云下载:

Node.js v24.12.0: https://wwbri.lanzoub.com/igcv03egzd6d 密码:6z8w
Node.js v22.21.1: https://wwbri.lanzoub.com/iyMvU3eh6yej 密码:bmum

第2步:安装 Git

brew install git
# 或
xcode-select --install

第3步:安装 Claude Code

打开终端(Cmd+Space 搜索 "Terminal")。

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

第4步:解决报错

📷 点击查看图片

替换以下文件到 .claude.json,下载链接在下方,记得改名!!!

  • Windows 用户一般位于 用户/.claude/ 文件夹的上层目录,也就是 用户/.claude.json
  • macOS 用户一般位于 ~ 目录下,即 ~/.claude.json
下载链接:https://wwaue.lanzouv.com/iTLAr3fdlrhc
密码:5yds
文件下载后要改名,claude.txt改名为.claude.json

替换后执行 claude,如果继续报错,新建或修改 settings.json 配置文件:

文件位置:~/.claude/settings.json

在终端执行以下命令创建目录并编辑文件:

mkdir -p ~/.claude
open -e ~/.claude/settings.json

写入以下内容并保存(只需修改 key 值,其余直接复制):

点击查看 settings.json 完整配置 ▼
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "填入你在面板生成的key",
    "ANTHROPIC_BASE_URL": "https://api.xstx.info",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4.6",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "permissions": {
    "allow": [
      "Bash(stat *)",
      "Bash(ls *)",
      "Bash(cat *)",
      "Bash(head *)",
      "Bash(tail *)",
      "Bash(find *)",
      "Bash(grep *)",
      "Bash(rg *)",
      "Bash(wc *)",
      "Bash(file *)",
      "Bash(which *)",
      "Bash(echo *)",
      "Bash(pwd)",
      "Bash(cd *)",
      "Bash(python3 *)",
      "Bash(python *)",
      "Bash(pip *)",
      "Bash(pip3 *)",
      "Bash(node *)",
      "Bash(npm *)",
      "Bash(npx *)",
      "Bash(git *)",
      "Bash(docker *)",
      "Bash(mkdir *)",
      "Bash(cp *)",
      "Bash(mv *)",
      "Bash(touch *)",
      "Bash(chmod *)",
      "Bash(curl *)",
      "Bash(wget *)",
      "Bash(brew *)",
      "Bash(open *)",
      "Bash(diff *)",
      "Bash(sort *)",
      "Bash(uniq *)",
      "Bash(sed *)",
      "Bash(awk *)",
      "Bash(cut *)",
      "Bash(tr *)",
      "Bash(xargs *)",
      "Bash(tee *)",
      "Bash(env *)",
      "Bash(export *)",
      "Bash(source *)",
      "Bash(kill *)",
      "Bash(ps *)",
      "Bash(lsof *)",
      "Bash(pytest *)",
      "Bash(java *)",
      "Bash(javac *)",
      "Bash(mvn *)",
      "Bash(gradle *)",
      "Bash(cargo *)",
      "Bash(go *)",
      "Bash(make *)",
      "Bash(cmake *)",
      "Bash(gcc *)",
      "Bash(g++ *)",
      "Bash(tar *)",
      "Bash(unzip *)",
      "Bash(zip *)",
      "Bash(gh *)",
      "Read",
      "Edit",
      "Write",
      "Glob",
      "Grep",
      "WebFetch",
      "WebSearch",
      "Task",
      "NotebookEdit",
      "mcp__puppeteer__puppeteer_navigate",
      "mcp__puppeteer__puppeteer_screenshot",
      "mcp__puppeteer__puppeteer_click",
      "mcp__puppeteer__puppeteer_fill",
      "mcp__puppeteer__puppeteer_evaluate",
      "mcp__puppeteer__puppeteer_select",
      "mcp__puppeteer__puppeteer_hover",
      "mcp__filesystem__*",
      "mcp__memory__*",
      "mcp__duckduckgo__*",
      "mcp__sequential-thinking__*",
      "mcp__local-rag__*"
    ],
    "deny": []
  },
  "model": "opus[1m]",
  "hooks": {
    "Notification": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "afplay ~/.claude/notification.m4a"
          }
        ]
      }
    ]
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline-mac.sh"
  },
  "enabledPlugins": {
    "ralph-loop@claude-plugins-official": true
  },
  "alwaysThinkingEnabled": true
}

注意:将 "填入你在面板生成的key" 替换为你在 api.xstx.info 面板创建的实际 API Key(以 sk- 开头)

保存后重新打开终端,执行 claude 即可。

第5步:开始使用

进入你的工程目录:

cd 你的工程目录
claude
📷 点击查看图片