Windows 快速开始

本教程用于在 Windows 上接入 HK 模型 API。参考站的核心内容已覆盖:前置安装、获取 Key、推荐工具、Claude Code 极速配置、一键/手动配置和客户端接入。

Base URL: https://api.claudeurl.cc/v1
控制台: https://ai.claudeurl.cc/console

前置安装

1. 安装 Node.js

前往 Node.js 官网下载 LTS 版本,推荐 v18 或 v20+。安装后打开 PowerShell 验证:

node --version
npm --version

2. 安装 Git for Windows

Claude Code、OpenCode 等 CLI 工具通常依赖 Git。建议安装 Git for Windows,安装过程保持默认选项即可。

git --version

获取 API Key

打开 HK 控制台,完成登录或注册。
进入 令牌 / Token 页面,点击添加令牌。
按用途命名,例如 claude-code-windows、cursor-work。
复制生成的 API Key,格式通常为 sk-xxxx。

推荐工具

类型工具说明
CLIClaude Code / OpenCode / Aider适合终端开发和自动化任务。
IDE 插件Cursor / Roo Code / Cline / Continue.dev适合 VS Code、Cursor 与插件式编码。
独立客户端Cherry Studio / Chatbox / NextChat适合桌面聊天和多模型切换。
Web 框架LobeChat / Dify / FastGPT适合团队知识库和 Web 应用。

Claude Code 极速配置

方式一:命令行安装

npm install -g @anthropic-ai/claude-code
claude
如果你没有 HK 专用一键配置包,不要运行来源不明的 npx 命令。当前推荐先使用下方手动配置,最稳。

方式二:手动配置

编辑或新建 C:\Users\你的用户名\.claude\settings.json:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-替换成你的HK_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.claudeurl.cc",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

保存后重新打开 PowerShell,运行:

claude

客户端配置

Cursor、Cline、Roo Code、Cherry Studio 等客户端统一选择 OpenAI Compatible,填写:

API Key:  sk-替换成你的HK_API_KEY
Base URL: https://api.claudeurl.cc/v1

测试连接

$env:HK_API_KEY="sk-替换成你的key"
curl.exe https://api.claudeurl.cc/v1/models `
  -H "Authorization: Bearer $env:HK_API_KEY"
如果返回模型列表,说明 API Key 与 Base URL 配置正确。