PowerShell执行策略修复与OpenCode/ClaudeCode安装配置指南

文档日期：2026-02-16
适用系统：Windows 10/11

—

一、PowerShell执行策略问题修复

问题现象

运行 opencode 或 claude 等命令时，可能出现如下错误提示：

“
opencode : 无法加载文件 C:\Users\xxx\AppData\Roaming\npm\opencode.ps1，
因为在此系统上禁止运行脚本。
`

这是由于Windows PowerShell的默认执行策略为 Restricted，该策略禁止运行任何脚本。

解决方案

方法一：临时放宽策略（推荐，最安全）
此方法仅对当前PowerShell窗口生效，关闭窗口后策略将恢复原状：

`powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
`

执行后，即可重新运行 opencode 或 claude 命令。

方法二：为当前用户永久放宽策略

`powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
`

执行后，该用户的所有PowerShell会话均可运行本地脚本。

方法三：绕过策略运行单次命令

`powershell
powershell -ExecutionPolicy Bypass -Command opencode
`

每次需要时使用此命令即可临时绕过策略限制。

执行策略说明

| 策略值 | 说明 |
|——–|——|
| Restricted | 默认策略，禁止运行任何脚本 |
| RemoteSigned | 本地脚本可运行，网络下载的脚本需签名 |
| Bypass | 不限制，所有脚本均可运行 |

—

二、OpenCode安装与运行

OpenCode是一款开源的AI编程助手，支持超过75种大模型，可作为Claude Code的替代方案。

安装方式（Windows）

方式A：npm全局安装（推荐）

`powershell
npm install -g opencode-ai
`

方式B：使用Bun安装

`powershell
bun add -g opencode-ai
`

方式C：官方安装脚本（需Git Bash或WSL）

`bash
curl -fsSL https://opencode.ai/install | bash
`

方式D：桌面版（Beta）
从 [OpenCode官网](https://opencode.ai/download) 下载Windows安装包（.exe）进行安装。

首次运行前：修复PowerShell执行策略

`powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
`

配置API密钥

`powershell
opencode auth login
`

按提示选择提供商（如Anthropic、OpenAI等）并配置API密钥，配置信息将保存在 ~/.local/share/opencode/auth.json。

运行方式

| 命令 | 说明 |
|——|——|
| opencode | 启动交互式终端界面（TUI） |
| opencode run “任务描述” | 非交互模式执行单次任务 |
| opencode web | 启动Web界面 |
| opencode serve | 启动无界面API服务 |
| opencode models | 查看可用模型列表 |
| opencode auth list | 查看已配置的API提供商 |

示例

`powershell
进入项目目录后启动
cd D:\Kama\RunMan.AI\WebSites
opencode

或直接执行任务
opencode run “解释JavaScript闭包的工作原理”
`

—

三、Claude Code安装与运行

Claude Code是Anthropic官方推出的终端AI编程工具。

安装方式（Windows）

方式A：npm全局安装

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

方式B：官方PowerShell安装脚本（推荐）

`powershell
irm https://claude.ai/install.ps1 | iex
`

⚠️ 若提示无法运行脚本，需先执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

首次运行前：修复PowerShell执行策略

`powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
`

验证安装

`powershell
claude –version
claude doctor
`

配置API密钥

首次运行 claude 时，会提示粘贴API密钥。可从 [Anthropic Console](https://console.anthropic.com/) 获取。

运行方式

| 命令 | 说明 |
|——|——|
| claude | 启动Claude Code交互界面 |
| claude doctor | 检查环境和配置 |

示例

`powershell
cd D:\Kama\RunMan.AI\WebSites
claude
`

—

四、完整安装流程（推荐顺序）

修复PowerShell执行策略
`powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
`

安装OpenCode（可选）
`powershell
npm install -g opencode-ai
opencode auth login
`

安装Claude Code（可选）
`powershell
npm install -g @anthropic-ai/claude-code
# 或使用官方脚本
irm https://claude.ai/install.ps1 | iex
`

验证安装
`powershell
opencode –version
claude –version
`

—

五、常见问题

Q1：执行策略修改后仍报错？
若组策略锁定了执行策略，可改用当前会话临时生效的方式（每次新开终端需执行一次）：

`powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
`

或尝试以管理员身份打开PowerShell后执行：

`powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
`

Q2：命令找不到（command not found）？
检查npm全局路径是否在PATH中：

`powershell
npm config get prefix
`

将该路径下的 node_modules 和根目录加入系统环境变量PATH。

Q3：OpenCode与Claude Code如何选择？

| 工具 | 特点 |
|——|——|
| OpenCode | 开源、支持多模型、可自托管，适合需要灵活切换模型或注重隐私的用户 |
| Claude Code | Anthropic官方、与Claude深度集成，适合主要使用Claude的用户 |

—

六、快速启动脚本（执行策略被组策略锁定时的方案）

若 Set-ExecutionPolicy -Scope CurrentUser 因组策略无法修改，可在每次打开新终端时先执行：

`powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
`

或创建快捷方式/批处理，使用以下命令启动：

`powershell
powershell -ExecutionPolicy Bypass -NoExit -Command “cd D:\Kama\RunMan.AI\WebSites; opencode”
`

—

七、当前安装状态（2026-02-16验证）

| 工具 | 版本 | 状态 |
|——|——|——|
| OpenCode | 1.2.5 | ✅ 已安装可用 |
| Claude Code | 2.1.42 | ✅ 已安装可用 |

⚠️ 运行前请确保：在新PowerShell窗口中先执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process`，再运行 opencode 或 claude。

—

八、参考链接

[OpenCode官网](https://opencode.ai/)
[OpenCode CLI文档](https://open-code.ai/docs/en/cli)
[OpenCode下载页](https://opencode.ai/download)
[Claude Code官方文档](https://docs.anthropic.com/en/docs/claude-code/setup)
[PowerShell执行策略说明](https://go.microsoft.com/fwlink/?LinkID=135170)