VSCode + Claude Code + OpenCode Go + DeepSeek API 配置部署手册 (Windows)

需要pro会员才能接入one-api转发的后续

一、概述

本文档说明在 Windows 环境下配置 VSCode + Claude Code 自驱编程环境。

核心理念：利用本地中转代理（one-api），让 Claude Code CLI 将推理请求转发到你自购的 OpenCode Go / DeepSeek 套餐，不使用 Anthropic 的付费算力。

架构示意：

claude CLI  →  one-api (localhost:3000)  →  OpenCode Go / DeepSeek API
(仅首次认证需翻墙)  (协议转换)              (你的自购套餐)

二、前置条件

  • Windows 10/11（64位）
  • 翻墙代理工具（Clash / v2ray 等，仅首次认证需要）
  • Claude.ai 账号（Pro / Max 皆可）
  • OpenCode Go API Key 和 Base URL
  • DeepSeek API Key（可选）

三、安装 Node.js 与 Claude Code CLI

3.1 安装 Node.js

从 nodejs.org 下载 Windows LTS 版（下载 .msi 安装包），安装时勾选「添加到 PATH」。

安装后验证：

node --version
npm --version

如 npm 下载慢，设淘宝镜像：

npm config set registry https://registry.npmmirror.com

3.2 安装 Claude Code CLI

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

验证：

claude --version

四、安装 one-api 中转（exe 方式，无需 Docker）

4.1 下载 one-api

  1. 打开浏览器访问 one-api GitHub Releases：
    https://github.com/songquanpeng/one-api/releases
  2. 找到最新版本（如 v0.6.x），在 Assets 中找到 one-api-windows-amd64.exe 下载
  3. 将 exe 放到一个固定目录，例如 D:\tools\one-api\
  4. 如有需要，可重命名为 one-api.exe 方便操作

⚠️ Windows 安全提示： 如果 Windows Defender / SmartScreen 拦截，点击「仍然运行」或在杀毒软件中添加排除项。这是开源项目，源码可查。

4.2 启动 one-api

打开 PowerShell 或 CMD，运行：

D:\tools\one-api\one-api.exe

首次启动会：

  • 在当前目录自动创建 one-api.db（SQLite 数据库）
  • 监听 http://localhost:3000
  • 默认管理员账号: root，密码: 123456

看到类似输出说明启动成功：

Listening on :3000
one-api started

保持此终端窗口开着（最小化即可），下一步打开浏览器操作。

开机自启（可选）：

  1. 创建文件 D:\tools\one-api\start-one-api.bat：
@echo off
start /B "" "D:\tools\one-api\one-api.exe"
  1. 按 Win + R → shell:startup → 将 .bat 文件拖入打开的启动文件夹

五、配置 one-api 管理后台（详细截图指引）

5.1 登录后台

  1. 浏览器打开 http://localhost:3000
  2. 使用默认管理员账号登录：root / 123456
  3. 首次登录后，点击右上角头像 → 设置 → 修改默认密码

5.2 添加渠道（Channel）—— OpenCode Go

  1. 左侧菜单点击 渠道 → 添加渠道
  2. 填写以下字段：
字段名值说明
类型OpenAIOpenCode Go 是 OpenAI 兼容协议
名称OpenCode-Go随意取名，便于识别
API Key你的 OpenCode Go Key从 OpenCode Go 平台复制的 API Key
Base URLOpenCode Go 的 API 地址如 https://api.opencode-go.com/v1
模型（模型重定向）deepseek-v4-flash你购买的模型名称
  1. 其他字段保持默认，点击 提交

5.3 添加渠道 —— DeepSeek 官方（可选）

  1. 再次点击 添加渠道
  2. 填写：
字段名值
类型DeepSeek（内置支持，无需填 Base URL）
名称DeepSeek-Official
API Key你的 DeepSeek API Key
模型deepseek-chat,deepseek-reasoner
  1. 点击 提交

5.4 配置令牌（Token）—— 关键步骤

  1. 左侧菜单点击 令牌 → 添加令牌
  2. 填写以下字段：
字段名值说明
名称Claude-Code-Token随意取名
渠道勾选刚才创建的渠道（OpenCode-Go 和/或 DeepSeek-Official）关联哪些渠道可使用此令牌
IP 白名单（可选）留空 或 127.0.0.1⚠️ 留空=不限制。如需限制：只填 127.0.0.1（本机）即可。
❌ 不要填 192.168.1.1/0（格式错误）
❌ 不要填 localhost（不会解析）
额度留空不限制
  1. 点击 提交
  2. 提交后，在令牌列表中找到刚才创建的令牌，点击令牌值复制（格式如 sk-xxxxxxxxxxxx）

⚠️ IP 白名单注意事项：

  • one-api 和 Claude Code CLI 都在同一台电脑上运行，只需放行 127.0.0.1
  • localhost 不被 one-api 解析为 IP 地址
  • CIDR 格式示例：192.168.1.0/24（允许整个 192.168.1.x 网段）
  • 不知道用什么就留空——本机访问不需要白名单限制

六、配置 Claude Code CLI 连接本地中转

6.1 首次认证（需翻墙，仅需一次）

  1. 打开 PowerShell，先设代理：
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"

（7890 是 Clash 默认端口，v2ray 通常用 10809/10810，请根据你实际翻墙工具的端口调整）

  1. 启动 Claude Code：
claude

首次运行会自动打开浏览器，跳转到 claude.ai 完成 OAuth 授权。登录成功后终端会恢复。按 Ctrl+C 退出。

6.2 切换为本地中转模式

登录成功后，设置本地中转：

# 取消翻墙代理（推理请求走本地，不需要出墙）
Remove-Item Env:HTTP_PROXY, Env:HTTPS_PROXY

# 将 API 地址指向本地 one-api
$env:ANTHROPIC_BASE_URL = "http://localhost:3000"

# 设置 one-api 生成的令牌
$env:ANTHROPIC_API_KEY = "sk-你在one-api后台复制的token"

# 启动 Claude Code
claude

此时所有推理请求走本地 one-api → OpenCode Go / DeepSeek，不花 Anthropic 一分钱。

6.3 持久化配置（写入 PowerShell Profile）

notepad $PROFILE

在打开的记事本中添加：

$env:ANTHROPIC_BASE_URL = "http://localhost:3000"
$env:ANTHROPIC_API_KEY = "sk-你在one-api后台复制的token"

保存后关闭，在 PowerShell 中执行使生效：

. $PROFILE

注意：翻墙代理 HTTP_PROXY / HTTPS_PROXY 不要写入 Profile，只在需要重新认证时手动设。

七、验证配置

  1. 在任意项目目录中运行：
cd D:\GitRepo\git.atibm.com\atdemo\hermes-oracle-at
claude
  1. 在 one-api 后台左侧菜单点击 日志，查看是否有请求记录
  2. 检查日志中的 渠道名 是否命中了你的 OpenCode-Go 或 DeepSeek-Official
  3. 确认日志中显示的是你的自购模型（如 deepseek-v4-flash），而非 Anthropic 的模型

八、完整流程速查

┌─────────────────────────────────────────────────────────┐
│ 第一次配置：                                              │
│ 1. 下载 one-api.exe → 双击运行                            │
│ 2. 浏览器打开 localhost:3000 → root/123456 登录           │
│ 3. 渠道 → 添加渠道 → 填 OpenCode Go（类型选 OpenAI）       │
│ 4. 令牌 → 添加令牌 → 关联渠道 → 留空IP白名单 → 提交        │
│ 5. 复制令牌值（sk-...）                                   │
│ 6. PowerShell 设翻墙代理 → 运行 claude 首次认证             │
│ 7. 取消代理 → 设 ANTHROPIC_BASE_URL + API_KEY → 开用      │
│                                                          │
│ 日常使用：                                                │
│ 1. 启动 one-api（或已开机自启）                             │
│ 2. 打开 PowerShell → cd 项目目录 → claude                  │
│ 3. 所有推理走本地中转 → 用你的 OpenCode Go / DeepSeek 套餐  │
└─────────────────────────────────────────────────────────┘

九、常见问题

  • ERR_BAD_REQUEST：网络问题。首次认证需要翻墙代理；日常使用不需要代理
  • one-api 无法启动：端口 3000 被占用，netstat -ano | findstr :3000 查占用进程
  • one-api 日志没有请求：检查 ANTHROPIC_BASE_URL 是否设置正确，$env:ANTHROPIC_BASE_URL 确认
  • claude 命令找不到：npm global 路径 C:\Users\用户名\AppData\Roaming\npm 是否在系统 PATH 中
  • npm 安装慢：npm config set registry https://registry.npmmirror.com
  • PowerShell 执行策略阻止：管理员模式运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  • IP 白名单报错：格式不对就留空，本地使用不需要限制 IP