macOS / Linux 快速开始

适用于 macOS、Linux、服务器和终端环境。参考站的 Node.js、获取 Key、推荐工具、Claude Code 一键/手动配置结构已覆盖并扩展。

前置安装

1. 安装 Node.js

推荐使用 nvm 管理 Node.js 版本:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install --lts
nvm use --lts
node --version
npm --version

获取 API Key

1. 进入 HK 控制台。
2. 打开 令牌 / Token 页面。
3. 创建新令牌,复制 sk-xxxx 格式 API Key。

配置 OpenAI Compatible 环境变量

export OPENAI_API_KEY="sk-替换成你的key"
export OPENAI_BASE_URL="https://api.claudeurl.cc/v1"

写入 shell 配置长期生效:

echo 'export OPENAI_API_KEY="sk-替换成你的key"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.claudeurl.cc/v1"' >> ~/.zshrc
source ~/.zshrc

Claude Code 极速配置

方式一:安装 CLI

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

方式二:手动配置

编辑 ~/.claude/settings.json:

mkdir -p ~/.claude
cat > ~/.claude/settings.json <<'EOF'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-替换成你的HK_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.claudeurl.cc",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
EOF

重新打开终端后运行:

claude

curl 测试

curl https://api.claudeurl.cc/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

curl https://api.claudeurl.cc/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role":"user","content":"你好,请用一句话介绍 HK 模型 API"}]
  }'

常见问题

Base URL 要不要带 /v1?

OpenAI Compatible 客户端通常填写 https://api.claudeurl.cc/v1。Claude Code 的 Anthropic Base URL 通常填写不带 /v1 的 https://api.claudeurl.cc。

模型名怎么确认?

以控制台可见模型和 /v1/models 返回为准。