本文汇总了 Windows 环境下 Claude Code 从零安装到高级配置的全流程，涵盖 Claude Code 安装、DeepSeek 模型对接、Skill 技能系统管理等三大模块。

摘要

本文面向在 Windows 11 环境下使用 Claude Code 的开发者，系统梳理从基础环境搭建到高级定制的完整配置流程。内容分为三部分：（一）前置依赖（Node.js、Git、Python）的安装与验证，Claude Code 本体安装路径及 PowerShell 命令兼容性修复，解决终端无法直接运行 claude 的常见问题；（二）通过环境变量将 Claude Code 重定向至 DeepSeek 模型（deepseek-v4-pro），涵盖 API Key 获取、变量永久配置、模型角色分配及配置验证方法，并说明费用查看、模型切换等实用操作；（三）Skill 技能系统的触发原理（启动时全量加载，上限约 30 个）、基于符号链接的“源码仓库—激活目录”分离管理架构，以及 skill-mgr 管理工具的详细命令速查表，帮助用户实现技能的按需激活与停用。全文聚焦实际操作，无额外扩展内容，适合需要定制 AI 模型后端和管理技能集的 Claude Code 用户参考。

核心结论：通过上述三部分配置，实现了从终端命令修复、第三方模型接入、技能按需激活到微信消息桥接的完整工作流闭环。

第一部分：基础环境搭建

1.1 前置依赖

依赖 最低版本 验证命令 说明
Node.js ≥ 18.0.0 node --version Claude Code 运行环境
Git 任意版本 git --version Windows 上 Claude Code 依赖 Git
Python ≥ 3.10 python --version Skill 脚本及 QR 工具依赖

未安装请前往官网： Node.js | Git | Python

1.2 安装 Claude Code

以管理员身份打开终端（PowerShell 或 CMD），执行全局安装：

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

安装位置：C:\Users\<用户名>\AppData\Roaming\npm\，生成三个文件：

  • claude（无扩展名）—— Unix shell 脚本，供 Git Bash 使用
  • claude.cmd —— Windows 批处理脚本，CMD/PowerShell 调用
  • claude.ps1 —— PowerShell 脚本

1.3 PowerShell 命令兼容性修复

问题：PowerShell 中输入 claude 报错"无法识别"，但 CMD 中 claude.cmd 正常。

原因：PowerShell 优先匹配无扩展名的 claude（Unix 脚本），无法执行，且不会自动回退到 claude.cmd。

方案一：创建永久别名（推荐）

以管理员 PowerShell 执行：

if (!(Test-Path -Path $PROFILE)) {
    New-Item -Type File -Path $PROFILE -Force
}
Add-Content -Path $PROFILE -Value 'Set-Alias -Name claude -Value claude.cmd'

方案二：解决"禁止运行脚本"报错

若重启 PowerShell 后出现 无法加载配置文件，因为在此系统上禁止运行脚本，以管理员执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

输入 Y 确认后重启终端。

方案三（备选）：直接使用完整文件名 claude.cmd，或删除 claude 无扩展名文件（将影响 Git Bash）。

第二部分：DeepSeek 模型对接

2.1 背景

Anthropic 官方对国内用户存在 IP 限制和账号风控。Claude Code v2.0.0 起支持通过环境变量接入第三方兼容接口，可将请求重定向至 DeepSeek。

2.2 获取 API Key

前往 DeepSeek 开放平台 注册并充值（建议 10 元起），在 API Keys 页面创建密钥（格式 sk-xxxxxxxxxxxxxxxxxxxxxxxx）。

2.3 环境变量配置（永久生效）

以管理员 PowerShell 执行（替换 sk-你的DeepSeek密钥 为真实 Key）：

# 清除可能残留的旧认证变量（防止冲突）
[Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', $null, 'User')

# 设置核心变量
[Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.deepseek.com/anthropic', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-你的DeepSeek密钥', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'deepseek-v4-pro[1m]', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_OPUS_MODEL', 'deepseek-v4-pro[1m]', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_SONNET_MODEL', 'deepseek-v4-pro[1m]', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_HAIKU_MODEL', 'deepseek-v4-flash', 'User')
[Environment]::SetEnvironmentVariable('CLAUDE_CODE_SUBAGENT_MODEL', 'deepseek-v4-flash', 'User')
[Environment]::SetEnvironmentVariable('CLAUDE_CODE_EFFORT_LEVEL', 'max', 'User')
变量名 推荐值 作用
ANTHROPIC_BASE_URL https://api.deepseek.com/anthropic API 端点
ANTHROPIC_API_KEY sk-xxx 认证密钥
ANTHROPIC_MODEL deepseek-v4-pro[1m] 默认模型（100万上下文）
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 子代理模型
CLAUDE_CODE_EFFORT_LEVEL max 努力程度

关键提醒：只设置 ANTHROPIC_API_KEY，不要同时设置 ANTHROPIC_AUTH_TOKEN，否则启动时会报 Auth conflict 错误。

执行后必须完全关闭所有 PowerShell 窗口再重新打开，环境变量才会生效。

2.4 验证配置

# 检查环境变量
Get-ChildItem Env: | Where-Object { $_.Name -like '*ANTHROPIC*' }

# 在 Claude Code 中验证模型
claude
# 提问："你是什么模型？" → 应返回 deepseek-v4-pro

如果仍是官方 Claude 模型，说明环境变量未生效或变量名有误。可用 claude --debug 查看启动日志中的 base_url 和 model 字段。

2.5 其他实用操作

  • 查看费用：对话中输入 /cost
  • 切换模型：单独修改对应环境变量，重启终端即生效
  • 安全警告：API Key 等同于钱包，切勿明文分享。怀疑泄露立即前往 DeepSeek 开放平台重置
  • 环境变量修改建议：后续修改单个值推荐使用图形界面（Win+R → rundll32.exe sysdm.cpl,EditEnvironmentVariables），比命令行更高效

第三部分：Skill 技能系统

3.1 触发原理

Claude Code 启动时扫描 ~/.claude/skills/ 目录下所有 SKILL.md 文件，全部加载到上下文中。每个 Skill 的 YAML 前置元数据中 description 字段决定"何时被使用"，但 Skill 本身已经占用了上下文窗口。上限约 30 个，超出后末尾的技能将被截断而不生效。

3.2 管理架构

采用"源码仓库—激活目录"分离设计：

D:\xxx\skills\                                               ← 所有 Skill 源码（26 个）
~/.claude/skill-library/                                     ← 符号链接 → ai-skills/
~/.claude/skills/                                            ← 已激活的 Skill（符号链接，指向 library）
~/.claude/bin/skill-mgr                                      ← 管理脚本
  • skills/ 为唯一权威存储位置
  • ~/.claude/skill-library/ 通过 Windows 符号链接指向 ai-skills/
  • ~/.claude/skills/ 中存放已激活 Skill 的符号链接，Claude Code 启动时扫描此目录
  • skill-mgr 管理激活/停用，不动 library 中的源码

3.3 skill-mgr 命令速查

命令 作用
skill-mgr 进入交互菜单模式
skill-mgr list 列出全部 Skill，[*] 标记已激活
skill-mgr enable <名> 激活指定 Skill（创建符号链接）
skill-mgr disable <名> 停用指定 Skill（删除链接，源码保留）
skill-mgr enable-all 激活全部（上限 30，超出时警告）
skill-mgr disable-all 停用全部
skill-mgr status 查看当前激活数量和列表
skill-mgr info <名> 查看 Skill 描述详情

使用时机：必须在启动 Claude Code 之前运行 skill-mgr 选好所需 Skill。启动后无法动态加载或卸载。

注意：~/.bashrc 已追加 export PATH="$HOME/.claude/bin:$PATH"，新终端可直接输入 skill-mgr。

# windows # java # python # 人工智能 # 语言模型
Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

cover

阿里云代理商：阿里云 GPU 服务器部署 DeepSeek V4指南

avatar DeepSeek技术社区
cover

周一上线｜Hexo 一夜丢了 40K Star，DeepSeek TUI 遭遇假仓库；AI 公司一边裁员一边融资

avatar DeepSeek技术社区
cover

2026实测教程 | 科研党福音：用 Gemini 3.1 Pro 徒手拆解学术论文图表与复杂公式

avatar DeepSeek技术社区