当前环境基于windows 11,搭建Deep Code开发环境。

安装

确保已经安装 nodejsnpm

javascript 复制代码
npm install -g @vegamo/deepcode-cli

安装完成测试:

bash 复制代码
deepcode --version
# 输出
# PS C:\Users\Administrator> deepcode --version
# 0.1.26

如果找不到 deepcode 命令,可能是环境变量未配置,或没有权限,如报错: PowerShell 默认不让运行 .ps1 脚本(执行策略是 Restricted)。

bash 复制代码
deepcode : 无法将“deepcode”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写,如果包括路径,请确保路径正确,然后再试一次。
所在位置 行:1 字符: 1
+ deepcode --version
+ ~~~~~~~~
    + CategoryInfo          : ObjectNotFound: (deepcode:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

解决方案:

添加权限

bash 复制代码
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

出现提示,输入 Y 回车

含义:本地脚本可以跑,网上下载的脚本要签名,刚好适合你这种 npm 全局工具。

执行完关掉所有 PowerShell,重新打开应该就正常了。

PATH 环境变量配置

🔧 一次性解决办法

1. 先把路径临时加入当前 PowerShell 会话

直接在你当前窗口运行:

powershell 复制代码
$env:PATH += ";C:\Users\Administrator\.npm-global"

运行完马上测试命令:

powershell 复制代码
deepcode --version

如果能正常输出版本号,说明就是 PATH 的问题,接下来做永久配置即可。


2. 永久配置 PATH(推荐,一劳永逸)

在 PowerShell 里执行下面这条命令,直接把路径永久加入用户 PATH:

powershell 复制代码
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Users\Administrator\.npm-global", "User")

执行完 关闭所有 PowerShell 窗口,重新打开,再运行:

powershell 复制代码
deepcode --version

配置 settings.json

在用户目录或项目根目录配置 .deepcode/settings.json :

json 复制代码
{
  "env": {
    "MODEL": "deepseek-v4-pro",
    "BASE_URL": "https://api.deepseek.com",
    "API_KEY": "sk-..."
  },
  "thinkingEnabled": true,
  "reasoningEffort": "max"
}

然后在任何文件夹执行deepcode 即可。