Claude Code 绿色便携版安装教程

📑 目录

这是什么
目录结构
快速开始
模型选择
权限说明
进阶玩法
常见问题
版本信息
从零制作教程

1. 这是什么

一套绿色免安装的 Claude Code 环境，开箱即用：

不需要安装 Node.js — 内置 Node.js v24.15.0 便携版
不需要安装 Git — 内置 Git 便携版
不需要登录 Anthropic — 后端走 DeepSeek API，国内网络直连
不需要科学上网 — DeepSeek 提供 Anthropic 兼容 API，直接访问
U 盘即用 — 放 U 盘里，换电脑/换盘符自动适配

2. 目录结构

ClaudePortable/
  ├── start.bat              ← 双击启动，唯一入口
  ├── config.ini             ← 配置工作目录
  ├── claude-code/           ← Claude Code CLI (v2.1.148)
  │   ├── node_modules/
  │   │   └── .bin/
  │   │       ├── claude      ← 核心命令
  │   │       ├── claude.cmd
  │   │       └── claude.ps1
  │   └── package.json
  ├── node-portable/         ← Node.js v24.15.0 便携版
  ├── git-portable/          ← Git 便携版
  ├── config/                ← Claude 配置中心
  │   └── settings.json     ← API 配置、权限等
  └── workspace/            ← 默认工作目录

3. 快速开始

3.1 下载

📦

ClaudePortable.zip

百度网盘下载，解压即用，无需安装

下载 (提取码: cbcy)

📌 推荐搭配使用

🖥️

远程指令助手 — 手机远程操控终端

支持 Windows 10/11 x64，扫码绑定微信小程序，出门也能看 Claude 进度

下载

将整个 ClaudePortable 文件夹拷贝到你想要的位置（本地硬盘、U 盘均可）。搭配远程指令助手教程。

3.2 配置工作目录

编辑 config.ini：

          ini
          [PATH]
WORK_DIR=E:\work
        

可设为绝对路径：E:\work
可设为相对路径：workspace（相对于 ClaudePortable 所在位置）
设为本机的工作代码目录即可，启动后会自动 cd 过去

3.3 配置 DeepSeek API Key

编辑 config/settings.json，将 ANTHROPIC_AUTH_TOKEN 替换为你自己的 DeepSeek API Key：

          json
          {

            "env": {

              "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",

              "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek密钥",

              "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",

              "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",

              "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",

              "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",

              "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",

              "CLAUDE_CODE_EFFORT_LEVEL": "max",

              "DISABLE_AUTOUPDATER": "1"

            },

            "permissions": {

              "defaultMode": "bypassPermissions"

            },

            "theme": "dark-ansi"

          }

如何获取 DeepSeek API Key？

打开 platform.deepseek.com
注册 / 登录
点击左侧菜单「API Keys」→「创建 API Key」
复制生成的 sk- 开头的密钥
充值后即可使用

当前使用模型 deepseek-v4-pro[1m]，1M 上下文窗口，千行代码随便吃。

3.4 启动

双击 start.bat 即可。

启动后会看到：

          ====== 工作目录: E:\work

           *** Claude + deepseek + U盘  免安装、免登录、免云梯 ***

          ============================================================

           环境已就绪。可用命令: node / git / claude

           - 用 cd /d 路径   切换到任意工作目录

           - 输入 claude      在当前目录启动 Claude Code

           - 输入 exit        关闭并退回 U 盘目录

          ============================================================

输入 claude 回车，开始使用。

4. 模型选择

settings.json 中的模型配置说明：

配置项	默认值	用途
`ANTHROPIC_MODEL`	`deepseek-v4-pro[1m]`	默认模型
`ANTHROPIC_DEFAULT_OPUS_MODEL`	`deepseek-v4-pro[1m]`	Opus 级别任务（复杂推理）
`ANTHROPIC_DEFAULT_SONNET_MODEL`	`deepseek-v4-pro[1m]`	Sonnet 级别任务
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	`deepseek-v4-flash`	Haiku 级别任务（轻量快速）
`CLAUDE_CODE_SUBAGENT_MODEL`	`deepseek-v4-flash`	子代理模型

可选 DeepSeek 模型：

模型	说明
`deepseek-v4-pro[1m]`	V4 Pro，1M 上下文，最强推理
`deepseek-v4-flash`	V4 Flash，快速轻量
`deepseek-chat`	V3 经典模型

修改模型名称后无需重启，重新输入 claude 即生效。

5. 权限说明

当前配置了 "defaultMode": "bypassPermissions"，所有权限自动放行。如果你希望每次操作都手动确认，可以改为：

          json
          "permissions": {

            "defaultMode": "default"

          }

6. 进阶玩法

6.1 在任意终端使用（非 start.bat）

如果想在 Windows Terminal / PowerShell 中直接使用，手动设置两个环境变量即可：

CMD：

          cmd
          set PATH=你的路径\ClaudePortable\node-portable;你的路径\ClaudePortable\git-portable\bin;你的路径\ClaudePortable\claude-code\node_modules\.bin;%PATH%

          set CLAUDE_CONFIG_DIR=你的路径\ClaudePortable\config
        

PowerShell：

          powershell
          $env:Path = "你的路径\ClaudePortable\node-portable;你的路径\ClaudePortable\git-portable\bin;你的路径\ClaudePortable\claude-code\node_modules\.bin;$env:Path"

          $env:CLAUDE_CONFIG_DIR = "你的路径\ClaudePortable\config"
        

6.2 VSCode / JetBrains 终端集成

在 IDE 的终端设置中，将上述环境变量设为启动时自动注入即可。

6.3 更新 Claude Code 版本

          bash
          # 在 start.bat 启动的控制台中

          cd /d 你的路径\ClaudePortable\claude-code

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

6.4 配置 Claude Code 记忆文件

在 config/ 目录下创建 CLAUDE.md 文件，写入项目说明、编码规范等，Claude Code 会自动读取作为系统提示。

7. 常见问题

Q: 启动后输入 claude 报错？

确认 claude-code/node_modules/.bin/ 目录下有 claude.cmd，如果没有，运行：

              cd /d 你的路径\ClaudePortable\claude-code
npm install
            

Q: API 调用报错 / 连接失败？

检查 config/settings.json 中 API Key 是否正确
检查 DeepSeek 账户余额是否充足
确认 ANTHROPIC_BASE_URL 为 https://api.deepseek.com/anthropic

Q: DeepSeek 和官方 Claude 有什么区别？

能力：DeepSeek V4 Pro 在代码任务上表现优秀
费用：按量计费，性价比高
速度：国内直连，延迟低（~1-3s 首 token）
上下文：1M token 窗口，超大容量

Q: 能换回 Anthropic 官方 API 吗？

可以。修改 settings.json：

              json
              "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
"ANTHROPIC_AUTH_TOKEN": "sk-ant-你的Anthropic密钥",
            

但需要科学上网才能访问 Anthropic API。

Q: 能同时连其他兼容 Anthropic 协议的 API 吗？

可以。任何兼容 Anthropic Messages API 的服务都能用，只需修改 ANTHROPIC_BASE_URL 和对应 API Key 即可。例如：

阿里云百炼
硅基流动 (SiliconFlow)
OpenRouter

8. 版本信息

Claude Code CLI

v2.1.148

Node.js

v24.15.0

DeepSeek 模型

v4-pro / v4-flash

兼容平台

Windows 10/11 x64

9. 从零制作教程

提示：以下为从零开始的 DIY 制作教程，实际操作请以第 2 节目的目录结构为准。不想折腾可直接下载上方 3.1 节的成品压缩包。

9.1 硬件与 U 盘准备

U 盘	USB 3.0/3.1，≥64GB，格式化为 NTFS 或 exFAT（支持 4GB 以上文件）
内存	目标电脑 ≥16GB（跑本地 DeepSeek 8B+）
系统	Windows 10/11 x64

9.2 U 盘目录结构

X:\
  ├── NodePortable\      ← 便携 Node.js
  ├── GitPortable\        ← 便携 Git
  ├── ClaudeCode\         ← Claude Code 本体
  ├── DeepSeek\           ← DeepSeek 模型/程序
  ├── OllamaPortable\    ← 本地模型管理器（可选）
  └── Start-Claude.bat    ← 一键启动脚本

9.3 制作便携环境（需联网电脑操作）

① 便携 Node.js（必须）

官网下载 Windows x64 Standalone Binary (.zip)（不要 msi），解压到 U 盘 X:\NodePortable\。

          shell
          X:\NodePortable\node.exe -v
X:\NodePortable\npm.cmd -v
        

② 便携 Git（必须）

官网下载 Portable ("thumbdrive edition") 64-bit，自解压到 X:\GitPortable\。

          shell
          X:\GitPortable\bin\git.exe --version
        

③ 安装 Claude Code 到 U 盘

打开 PowerShell（管理员），进入 U 盘，用 U 盘里的 node/npm 安装：

          powershell
          cd X:\ClaudeCode
X:\NodePortable\npm.cmd config set registry https://registry.npmmirror.com
X:\NodePortable\npm.cmd install -g @anthropic-ai/claude-code --prefix .
        

验证：

          shell
          X:\ClaudeCode\node_modules\.bin\claude.cmd --version
        

④ DeepSeek 两种方案（选一种）

方案 A：本地 DeepSeek（Ollama 便携版，推荐）

下载 Ollama Windows 便携版或解压官方安装包到 X:\OllamaPortable\

              shell
              X:\OllamaPortable\ollama.exe run deepseek-r1:8b
            

首次自动下载模型到 U 盘

方案 B：DeepSeek API（无需本地模型）

拿到 DeepSeek API Key，在 Claude 配置里指向 DeepSeek API（见下方），推荐此方案，本教程提供的成品包即采用此方案。

9.4 一键启动脚本

在 U 盘根目录新建 Start-Claude.bat：

          batch
          @echo off
set "UDIR=%~d0"
set "PATH=%UDIR%\NodePortable;%UDIR%\GitPortable\bin;%PATH%"
set "CLAUDE_HOME=%UDIR%\ClaudeCode"
set "OLLAMA_HOME=%UDIR%\OllamaPortable"

:: 启动 Ollama（本地 DeepSeek）
start "" "%OLLAMA_HOME%\ollama.exe" run deepseek-r1:8b

:: 启动 Claude Code
"%UDIR%\ClaudeCode\node_modules\.bin\claude.cmd"
        

以上为参考脚本，实际成品包中的 start.bat 已经过优化，推荐使用成品包中的版本。

9.5 Claude 绑定 DeepSeek 配置

在 U 盘对应目录下新建配置文件：

          json
          {

            "models": {

              "deepseek-local": {

                "type": "ollama",

                "model": "deepseek-r1:8b",

                "host": "http://localhost:11434"

              },

              "deepseek-api": {

                "type": "openai",

                "apiKey": "你的 DeepSeek API Key",

                "baseUrl": "https://api.deepseek.com/v1",

                "model": "deepseek-chat"

              }

            },

            "defaultModel": "deepseek-local"

          }

注意：以上配置文件格式为通用的理论参考，实际配置格式请以 3.3 节的 settings.json 为准。

9.6 插到任意电脑使用

关闭所有杀毒 / 防火墙（避免拦截）
双击 X:\Start-Claude.bat
首次会自动下载 DeepSeek 模型（约 5GB，仅第一次）
输入 /model deepseek-local 切换本地模型

9.7 常见问题

Q: 报错找不到 node/git？

检查 Start-Claude.bat 里 PATH 路径是否正确。

Q: 模型下载慢？

换国内源，或提前在联网电脑下好模型文件拷贝到 U 盘对应目录。

Q: 内存不足？

本地跑 8B 至少 16GB 内存，4-bit 量化可降到 8GB。推荐普通用户直接使用 API 方案。

9.8 最终效果

一个 U 盘，插到任意 Windows 电脑
双击即用：Claude Code + 本地或云端 DeepSeek
所有数据（聊天记录 / 配置）都在 U 盘，不写本地硬盘

Claude Code 绿色便携版 — 安装教程

📑 目录

1. 这是什么

2. 目录结构

3. 快速开始

3.1 下载

3.2 配置工作目录

3.3 配置 DeepSeek API Key

3.4 启动

4. 模型选择

5. 权限说明

6. 进阶玩法

6.1 在任意终端使用（非 start.bat）

6.2 VSCode / JetBrains 终端集成

6.3 更新 Claude Code 版本

6.4 配置 Claude Code 记忆文件

7. 常见问题

8. 版本信息

9. 从零制作教程

9.1 硬件与 U 盘准备

9.2 U 盘目录结构

9.3 制作便携环境（需联网电脑操作）

① 便携 Node.js（必须）

② 便携 Git（必须）

③ 安装 Claude Code 到 U 盘

④ DeepSeek 两种方案（选一种）

9.4 一键启动脚本

9.5 Claude 绑定 DeepSeek 配置

9.6 插到任意电脑使用

9.7 常见问题

9.8 最终效果