🪟 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