制作 Windows 懒人版 Claude Code 包 (开箱即用,支持右键菜单)

发布于 2025-9-9 07:18
浏览
0收藏

前言:为什么需要这个“懒人版”?

官方的 Claude Code 是一个强大的本地开发工具,但其在 Windows 上的安装过程对新手并不友好:需要手动安装 Node.js 和 Git,配置复杂环境变量,还可能遇到网络连接问题。

本教程旨在解决以上所有痛点,带您打造一个真正“懒人化”的 Claude Code 环境,它具备以下优点:

• 开箱即用: 所有依赖打包在一起,解压即可使用,无需安装。

• 绿色便携: 可存放在U盘中,在任何 Windows 电脑上运行,不留系统垃圾。

• 网络无忧: 集成国内大模型API作为代理,告别网络连接烦恼。

• 极致便捷: 不仅有一键启动脚本,更支持在任意文件夹点击右键直接启动!

让我们开始吧!

第一步:准备核心组件

我们需要下载 Node.js 和 Git 的“免安装版”,这是实现便携化的基石。

1.1 下载 Node.js

访问 Node.js 官方下载页面:https://nodejs.org/en/download

关键操作: 请务必选择 Standalone Binary (.zip) 版本,而不是 .msi 安装包。

制作 Windows 懒人版 Claude Code 包 (开箱即用,支持右键菜单)-AI.x社区

选择 Node.js Standalone Binary (.zip) 的界面

1.2 下载 PortableGit

访问 Git 官方下载页面:https://git-scm.com/downloads/win

关键操作:选择Portable ("thumbdrive edition")版本。

制作 Windows 懒人版 Claude Code 包 (开箱即用,支持右键菜单)-AI.x社区

选择 Git for Windows/x64 Portable 的界面

1.3 创建我们的“懒人包”目录

这是非常重要的一步,一个清晰的目录结构能让后续工作事半功倍。

1. 创建一个总文件夹,例如 ClaudeCodePortable。

2. 将下载的 Node.js zip 文件解压到 ClaudeCodePortable 中,并可以将其重命名为一个简洁的名字,如 node。

3. 将下载的 PortableGit .exe 文件(它是一个自解压程序)也放到 ClaudeCodePortable 目录下,双击运行,将 Git 解压到当前目录下。它会自动创建一个名为 PortableGit 的文件夹。

ClaudeCodePortable/
├── node/             <-- 解压后的 Node.js
└── PortableGit/      <-- 解压后的 PortableGit

第二步:安装与配置 Claude Code

2.1 安装 Claude Code 本体

1. 在 ClaudeCodePortable 文件夹内,按住 Shift 键并点击鼠标右键,选择“在此处打开 Powershell 窗口”或“在此处打开命令提示符”。

2. 在打开的命令行窗口中,输入以下命令并回车。这会利用我们刚刚准备的 node 环境来安装 Claude Code。

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

等待安装完成。

2.2 解决网络问题 & 获取 API Key

直接运行Claude Code可能会因为网络问题连接失败。

制作 Windows 懒人版 Claude Code 包 (开箱即用,支持右键菜单)-AI.x社区

连接 Anthropic services 失败的报错信息

幸运的是,我们可以通过配置国内大模型厂商提供的兼容接口来解决。本教程以智谱 AI (Bigmodel) 为例:

1. 注册账号: 访问 https://open.bigmodel.cn/ 并注册。

2. 创建 API Key: 进入 API 密钥管理页面 (https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys) 创建一个新的 API Key 并复制保存好。这个 Key 就是我们之后连接服务的凭证。

第三步:一键启动!打造懒人脚本

现在,我们将所有繁琐的命令封装成一个双击即可运行的脚本。

3.1 创建配置文件 (config.cmd)

在 ClaudeCodePortable 文件夹中,新建一个文本文档,将其命名为 config.cmd,并用记事本打开,粘贴以下内容:

@echo off
:: --- 请在这里配置你的 API Key ---
set ANTHROPIC_AUTH_TOKEN=你的API_KEY放这里

:: --- API 代理地址 (一般无需修改) ---
set ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic

关键操作: 将 你的API_KEY放这里 替换为你刚刚从智谱获取的真实 API Key。将配置独立出来,未来更换 Key 或代理地址时,无需修改主启动脚本。

3.2 创建主启动脚本 (start_claude.cmd)

同样,在 ClaudeCodePortable 文件夹中,新建一个名为 start_claude.cmd 的文件,粘贴以下内容:

@echo off
setlocal

:: 设定窗口标题
title Claude Code

:: 1. 加载用户配置
call "%~dp0config.cmd"

:: 检查 API Key 是否已配置
if not defined ANTHROPIC_AUTH_TOKEN (
    echo.
    echo [错误] 未在 config.cmd 中找到 API Key!
    echo 请先修改 config.cmd 文件,填入你的 ANTHROPIC_AUTH_TOKEN。
    echo.
    pause
    exit /b
)

:: 2. 设置便携化环境变量
set "CLAUDE_CODE_PATH=%~dp0"
set "NODE_PATH=%CLAUDE_CODE_PATH%node"
set "CLAUDE_CODE_GIT_BASH_PATH=%CLAUDE_CODE_PATH%PortableGit\bin\bash.exe"

:: 3. 检查是否通过拖拽文件夹方式启动
if "%~1" neq "" (
    echo 正在切换工作目录到: %~1
    cd /d "%~1"
)

:: 4. 执行 Claude Code 命令
echo 正在启动 Claude Code...
"%NODE_PATH%\node.exe" "%NODE_PATH%\node_modules\@anthropic-ai\claude-code\cli.js" %*

endlocal

脚本说明:这个脚本会自动加载配置、设置所有需要的临时环境变量(不会污染你的系统),并支持将文件夹拖拽到它图标上,直接在该文件夹内启动 Claude Code!

现在,双击 start_claude.cmd,你应该能看到 Claude Code 成功启动了!

制作 Windows 懒人版 Claude Code 包 (开箱即用,支持右键菜单)-AI.x社区

主题风格可以默认(回头可修改)

制作 Windows 懒人版 Claude Code 包 (开箱即用,支持右键菜单)-AI.x社区

安全提示

制作 Windows 懒人版 Claude Code 包 (开箱即用,支持右键菜单)-AI.x社区

运行Claude Code 访问当前目录

制作 Windows 懒人版 Claude Code 包 (开箱即用,支持右键菜单)-AI.x社区

可以开始干活了

第四步:终极形态!集成到 Windows 右键菜单

想在任何文件夹里快速启动 Claude Code?让我们把它添加到右键菜单里!

4.1 创建“添加右键菜单”脚本

为了解决便携包路径不固定的问题,我们用一个脚本来动态生成注册表文件。

在 ClaudeCodePortable 文件夹中,

1. 新建generate_reg.js,黏贴以下内容:

const fs = require('fs');
const path = require('path');

// 获取当前脚本所在的目录,也就是我们的懒人包根目录
const basePath = __dirname;
// 将单斜杠替换为注册表需要的双反斜杠
const escapedBasePath = basePath.replace(/\\/g, '\\\\');

// 定义要生成的两种注册表文件的内容
const regFiles = {
'add_claude_context.reg': `Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\\Directory\\Background\\shell\\OpenWithClaude]
@="在此处打开 Claude Code"
"Icon"="${escapedBasePath}\\\\claude.ico"

[HKEY_CLASSES_ROOT\\Directory\\Background\\shell\\OpenWithClaude\\command]
@="cmd.exe /c \\"cd /d \\"%V\\" && start \\"Claude Code\\" \\"${escapedBasePath}\\\\start_claude.cmd\\"\\""

[HKEY_CLASSES_ROOT\\Directory\\shell\\OpenWithClaude]
@="在此处打开 Claude Code"
"Icon"="${escapedBasePath}\\\\claude.ico"

[HKEY_CLASSES_ROOT\\Directory\\shell\\OpenWithClaude\\command]
@="cmd.exe /c \\"cd /d \\"%1\\" && start \\"Claude Code\\" \\"${escapedBasePath}\\\\start_claude.cmd\\"\\""
`,
'remove_claude_context.reg': `Windows Registry Editor Version 5.00

[-HKEY_CLASSES_ROOT\\Directory\\Background\\shell\\OpenWithClaude]

[-HKEY_CLASSES_ROOT\\Directory\\shell\\OpenWithClaude]
`
};

const action = process.argv[2]; // 获取命令行的第三个参数 (add 或 remove)

if (!action || !regFiles[`${action}_claude_context.reg`]) {
console.error('Usage: node generate_reg.js <add|remove>');
  process.exit(1);
}

const fileName = `${action}_claude_context.reg`;
const fileContent = regFiles[fileName];
const filePath = path.join(basePath, fileName);

try {
// 使用 'utf16le' 编码写入文件,这至关重要!
  fs.writeFileSync(filePath, "\uFEFF" + fileContent, { encoding: 'utf16le' });
console.log(`Successfully generated: ${fileName}`);
console.log('File is located at:', filePath);

// 返回成功码,以便批处理脚本知道可以继续
  process.exit(0); 

} catch (error) {
console.error(`Failed to generate ${fileName}:`, error);
// 返回失败码
  process.exit(1); 
}

2. 新建 _setup_right_click_menu.cmd,粘贴以下内容:

@echo off
setlocal

echo.
echo [1/3] 准备调用 Node.js 生成注册表文件...
echo.

:: 调用 Node.js 脚本来生成 add_claude_context.reg 文件
"%~dp0\node\node.exe" "%~dp0\generate_reg.js" add

:: 检查 Node.js 脚本是否成功执行 (errorlevel 0 代表成功)
if %errorlevel% neq 0 (
    echo.
    echo [错误] 生成注册表文件失败!请检查 generate_reg.js 脚本。
    echo.
    pause
    exit /b
)

echo.
echo [2/3] 注册表文件 'add_claude_context.reg' 已成功生成!
echo.
echo [3/3] 即将自动打开该文件,请在弹出的确认窗口中点击“是”完成导入。
echo.

timeout /t 2 >nul
start "" "%~dp0\add_claude_context.reg"

endlocal
pause

4.2 创建“移除右键菜单”脚本(可选,但推荐)

提供一个“卸载”选项总是好的。新建 _remove_right_click_menu.cmd,粘贴以下内容:

@echo off
setlocal

echo.
echo [1/3] 准备调用 Node.js 生成注册表文件...
echo.

:: 调用 Node.js 脚本来生成 remove_claude_context.reg 文件
"%~dp0\node\node.exe" "%~dp0\generate_reg.js" remove

:: 检查 Node.js 脚本是否成功执行
if %errorlevel% neq 0 (
    echo.
    echo [错误] 生成注册表文件失败!请检查 generate_reg.js 脚本。
    echo.
    pause
    exit /b
)

echo.
echo [2/3] 注册表文件 'remove_claude_context.reg' 已成功生成!
echo.
echo [3/3] 即将自动打开该文件,请在弹出的确认窗口中点击“是”以移除菜单项。
echo.

timeout /t 2 >nul
start "" "%~dp0\remove_claude_context.reg"

endlocal
pause

如何使用:

1. 所有的cmd文件记得以BG18030编码保存。

2. 双击运行 _setup_right_click_menu.cmd。它会自动生成一个 .reg 文件并打开它。

3. 在弹出的注册表编辑器确认框中,点击“是”。

4. 大功告成!现在你在任意文件夹或桌面空白处点击右键,就能看到“在此处打开 Claude Code”的选项了!

制作 Windows 懒人版 Claude Code 包 (开箱即用,支持右键菜单)-AI.x社区

在此处打开 Claude

总结与使用

至此,您已经拥有了一个功能完整、极致方便的便携式 Claude Code 环境。

最终目录结构:

ClaudeCodePortable/
├── node/
├── PortableGit/
├── config.cmd                  <-- 你的API Key在这里配置
├── start_claude.cmd            <-- 主启动脚本
├── _setup_right_click_menu.cmd   <-- (首次运行)添加右键菜单
└── _remove_right_click_menu.cmd  <-- 需要时)移除右键菜单

制作 Windows 懒人版 Claude Code 包 (开箱即用,支持右键菜单)-AI.x社区

日常使用:

• 方法一: 将项目文件夹拖拽到 start_claude.cmd 图标上。

• 方法二(推荐): 在任意项目文件夹内,点击鼠标右键,选择“在此处打开 Claude Code”。

享受高效、无拘无束的 AI 编码之旅吧! 

不想自己制作的,可以关注公众号并私信:Claude Code Portable 获取最新下载链接

最新代码请访问:https://github.com/alitrack/claudecodeportable

本文转载自alitrack  ,作者: alitrack

已于2025-9-9 07:18:31修改
收藏
回复
举报
回复
相关推荐