1. 启动 opencode 报错先看清 PowerShell 到底拦了什么如果你在 Windows 上敲下opencode之后终端没有进入交互界面而是甩出一段红字大意是「无法加载文件……因为在此系统上禁止运行脚本」那你遇到的就是 PowerShell 执行策略Execution Policy拦截。opencode 在 Windows 下的启动入口本质是一个.ps1脚本PowerShell 默认策略是Restricted也就是完全不允许任何脚本运行所以它连启动的机会都没有直接就被挡在门外。这个报错和 opencode 本身没关系也不是安装坏了更不是网络问题。它属于 Windows 的安全默认值微软为了防止用户误点恶意脚本把脚本执行卡在了最严的一档。你要做的不是重装而是把当前用户的执行策略调到RemoteSigned让本地脚本可以跑、网上下载的脚本仍需签名。这一步做完opencode 就能正常启动。这篇内容适合两类人一是刚在 Windows 装完 opencode、第一次运行就撞上红字的新手二是已经能启动 opencode但想把模型请求统一走 TaoToken 的 Key/API 通道、需要一份能直接抄的config.toml骨架的开发者。下面从查策略、改策略、配 config.toml 到验证请求一步步走通命令都可以直接复制。2. 前置准备TaoToken 的 Key 与 API 通道opencode 启动之后要能真正干活得有一个模型服务入口。TaoToken 在这里扮演的是统一 Key 和 API 通道的角色你不需要在 opencode 里分别填各家模型的地址和密钥而是拿一个 TaoToken 的 Key把请求统一发到它的 API 端点由它去对接后面的模型。这样配置文件里只需要维护一份凭证换模型时改模型名就行不用动 Key。你需要提前准备两样东西。第一是 TaoToken 的 API Key在控制台的 API Keys 页面创建创建后立刻复制保存页面刷新后就看不到完整值了。第二是确认 API 基地址TaoToken 的 API 端点是https://taotoken.net/api注意这个地址不带任何查询参数配置里填的就是它。如果你还没创建 Key可以先去控制台把 Key 建好如果你对模型对话能力还不确定也可以先在模型对话页面试一下同一个 Key 能不能正常出结果确认通道没问题再写进 opencode 配置。长期做编码和 Agent 任务的可以关注 Coding Plan它更适合高频调用场景。这几个入口分别是控制台https://taotoken.net/console、API Keyshttps://taotoken.net/api-keys、模型对话https://taotoken.net/model-chat、Coding Planhttps://taotoken.net/coding-plan、接入文档https://taotoken.net/doc。官网首页是https://taotoken.net/。注意Key 只创建时可见务必当场保存。不要把它写进会提交到 Git 的文件里后面配置我会用环境变量或本地文件的方式规避。3. 可复制配置从执行策略到 config.toml 骨架3.1 查看当前执行策略先别急着改先看清楚现在是什么状态。打开 PowerShell普通窗口即可不需要管理员执行Get-ExecutionPolicy如果你看到输出是Restricted那就对上了这就是 opencode 被拦的原因。也可以顺带看一下所有作用域的设置Get-ExecutionPolicy -List输出会列出MachinePolicy、UserPolicy、Process、CurrentUser、LocalMachine几个作用域。优先级从高到低通常CurrentUser是空的或者Undefined最终生效的是LocalMachine的Restricted。3.2 给当前用户放行脚本改策略时把作用域限定在CurrentUser这样只影响你自己不动系统全局也不需要管理员权限Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned执行后 PowerShell 可能会问你是否确认输入Y回车。RemoteSigned的含义是本地自己写的、本地安装的脚本可以直接运行不需要数字签名从网上下载的脚本必须带合法签名才能跑。opencode 是本地安装的.ps1正好落在放行范围内既解决了问题又没有把安全档位降得太低。改完再确认一次Get-ExecutionPolicy -Scope CurrentUser看到RemoteSigned就说明生效了。这时候回到你的项目目录重新执行opencode应该能正常进入界面不再报「禁止运行脚本」。3.3 opencode 的 config.toml 骨架opencode 能启动之后接下来把模型通道接上。它的配置文件是config.tomlWindows 下一般放在用户目录的.config/opencode/里也就是C:\Users\你的用户名\.config\opencode\config.toml。如果目录不存在就手动建一个。下面是一份可以直接改的骨架# opencode 配置文件骨架 # 路径C:\Users\你的用户名\.config\opencode\config.toml # 默认使用的模型格式为 提供方/模型名 model taotoken/claude-sonnet-4-20250514 # 模型提供方配置 [providers.taotoken] # TaoToken 统一 API 端点不带查询参数 baseURL https://taotoken.net/api # 从环境变量读取 Key避免明文写死在文件里 apiKey {env:TAOTOKEN_API_KEY} # 可选为不同任务指定不同模型 [providers.taotoken.models] # 编码任务用能力更强的模型 coding claude-sonnet-4-20250514 # 轻量对话用响应更快的模型 chat claude-haiku-4-20250514这里有两个关键点。第一baseURL填的是https://taotoken.net/api不要在后面加斜杠或路径opencode 会自己拼接具体接口。第二apiKey用{env:TAOTOKEN_API_KEY}的写法从环境变量读取这样配置文件本身不含密钥可以放心备份或同步。3.4 设置环境变量在 PowerShell 里给当前会话设置 Key把你的Key换成实际值$env:TAOTOKEN_API_KEY 你的Key如果想让它在每次开新窗口时都生效写进用户级环境变量[Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY, 你的Key, User)设置完关掉 PowerShell 重开一次让新变量加载。可以用下面这行确认变量读到了$env:TAOTOKEN_API_KEY能打印出你的 Key 就说明配置到位。4. 验证请求确认 opencode 真的连上了配置写完不代表通了得实际发一次请求验证。最直接的方式是在项目目录里启动 opencode然后让它做一件小事比如解释一段代码或生成一个函数。cd C:\你的项目目录 opencode进入交互界面后输入一句简单的指令例如「用 Python 写一个读取 CSV 并打印前五行的函数」。如果配置正确你会看到模型正常返回代码而不是报鉴权失败或连接超时。如果 opencode 有非交互模式也可以用一次性命令验证opencode run print hello返回内容说明整条链路通了PowerShell 放行了脚本opencode 读到了 config.tomlconfig.toml 从环境变量拿到了 Key请求发到了 TaoToken 的 API 端点并成功返回。想单独确认 Key 和通道是否有效可以先用模型对话页面测一下同一个 Key能出结果就说明 Key 没问题问题只可能在 opencode 的配置格式上。接入细节和字段说明可以对照接入文档里面有完整的参数列表。5. 本篇常见错排查5.1 改了策略还是报禁止运行脚本先确认你改的是CurrentUser作用域并且用Get-ExecutionPolicy -Scope CurrentUser复查过。如果显示还是Restricted可能是组策略MachinePolicy/UserPolicy在更高优先级上锁死了这种情况下Set-ExecutionPolicy会被覆盖。可以执行Get-ExecutionPolicy -List看哪个作用域是Restricted如果是策略级需要联系机器管理员处理个人机器一般不会遇到。5.2 报「无法识别 opencode 命令」这不是执行策略问题而是 opencode 没在 PATH 里或者安装目录没加进环境变量。先确认安装路径再把该路径加到用户 PATH重开 PowerShell 再试。执行策略的报错关键词是「禁止运行脚本」和「无法识别」是两回事别混。5.3 config.toml 不生效最常见的原因是路径放错了。Windows 下要放在C:\Users\用户名\.config\opencode\config.toml注意.config前面有个点资源管理器里可能被隐藏。另一个原因是 TOML 语法写错比如字符串没加引号、表头拼错。可以用在线 TOML 校验工具过一遍或者把配置精简到只剩model和baseURL先跑通再逐步加回。5.4 报鉴权失败 401说明请求到了 TaoToken 但 Key 不对。检查三件事环境变量名是否和配置里的{env:TAOTOKEN_API_KEY}完全一致大小写敏感Key 是否复制完整、有没有多余空格设置环境变量后是否重开了 PowerShell。如果都正常去 API Keys 页面确认这个 Key 还在、没有被删除。5.5 报连接超时或无法解析主机先确认baseURL写的是https://taotoken.net/api没有多余路径。然后在 PowerShell 里单独测一下连通性Invoke-WebRequest -Uri https://taotoken.net/api -Method Head能返回状态码说明网络可达问题在 opencode 配置如果这里就失败检查本机网络和代理设置是否影响了正常 HTTPS 请求。6. 把 Key 和通道固定下来下次直接开工整套流程走下来真正花时间的其实只有两步把CurrentUser的执行策略改成RemoteSigned以及把config.toml的baseURL和 Key 引用写对。剩下的都是验证。我自己的习惯是环境变量用用户级设置一次之后所有项目共用同一个 Key换项目只改model字段不动通道配置。如果你后面要长期跑编码和 Agent 任务建议把 Key 管理集中到控制台需要轮换时只改一处接入参数有疑问就翻接入文档字段含义写得很清楚。想先确认某个模型在当前通道下的表现用模型对话页面快速试一句最省事。把这些固定下来之后下次在 Windows 上开新项目opencode敲下去就能直接进界面不会再被那段红字打断。