THQLLM

Claude Code 接入 THQ API

本页介绍如何把 Claude Code 接入 THQ API 的 Claude 中转站入口。Claude Code 通过 Anthropic Messages 协议连接网关。THQ 推荐使用 Bearer 认证，并通过 ANTHROPIC_AUTH_TOKEN 提供 Key。

配置前准备

  • 在 THQ API 控制台创建 API Key。
  • 从控制台复制适用于 Claude Code 的完整模型 ID。
  • 确认当前用户可以创建或修改 Claude Code 配置目录。

模型 ID 和可用能力以控制台当前显示为准。

安装

在 macOS 或 Linux 上可使用官方安装脚本：

curl -fsSL https://claude.ai/install.sh | bash
claude --version

其他系统、更新方式和安装要求见 Anthropic Claude Code 官方文档。

配置文件路径

Claude Code 会从用户级 settings.json 读取持久化设置。如果 .claude 目录或 settings.json 尚不存在，请先创建。

系统Claude Code 用户配置
macOS / Linux~/.claude/settings.json
Windows%USERPROFILE%\.claude\settings.json

Windows 可以在文件资源管理器地址栏输入 %USERPROFILE%\.claude 打开该目录。

不要把 Key 写入项目目录中的 .claude/settings.json。该文件通常会提交到仓库并共享给协作者。 如果只想让配置对单个项目生效，可以改用 .claude/settings.local.json，但必须确认它已写入 .gitignore；本指南仍推荐将个人 THQ Key 保存在当前用户目录下的 settings.json。

settings.json

编辑上表中对应系统路径下的 settings.json。若文件已经包含其他 Claude Code 设置，请保留 原有内容，只合并或更新其中的 env 对象：

settings.json
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.thqllm.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_THQ_API_KEY",
    "ANTHROPIC_MODEL": "CONTROL_PANEL_MODEL_ID"
  }
}

将 YOUR_THQ_API_KEY 替换为控制台创建的 Key，并将 CONTROL_PANEL_MODEL_ID 替换为 控制台显示的完整模型 ID。ANTHROPIC_MODEL 可选；不设置时，应在 Claude Code 中选择当前 可用且适配该协议的模型。

Base URL 末尾不要添加 /v1。Claude Code 会自动追加 Anthropic Messages 路径，最终请求 发送到 /v1/messages。手动写成 https://api.thqllm.com/v1 可能造成路径重复。

THQ 推荐示例使用 ANTHROPIC_AUTH_TOKEN，它会以 Bearer 方式认证。若某个网关明确要求 x-api-key，才使用 ANTHROPIC_API_KEY；配置 THQ 时不要同时设置两者，以免凭据优先级导致 请求使用了错误认证方式。

settings.json 必须是合法 JSON：字段名和字符串值使用双引号，最后一个字段后不要加逗号， 并且 JSON 不支持注释。

保存后在 Claude Code 中运行 /status，确认其中显示 Anthropic base URL 和 Auth token。Claude Code 会监视配置文件并重新加载大多数设置；如果仍有冲突或显示旧值，新开 一个 Claude Code 会话后再检查。

启动并验证

先执行一次非交互请求：

claude -p "请只回复：Claude Code 已连接 THQ API"

随后可运行 claude 进入交互模式，并使用 /status 检查当前模型、登录方式和配置来源。最后 到控制台核对是否出现对应请求记录。

若 claude -p 与交互模式表现不同，检查两者是否使用同一个系统用户，以及是否有项目级设置 覆盖用户级 env 配置。

模型与能力

ANTHROPIC_MODEL 必须填写控制台中的完整模型 ID。不要根据模型展示名称猜测 ID，也不要假设 所有模型都支持 Claude Code 使用的 Anthropic Messages 协议。

Claude Code 的工具调用、上下文处理和其他能力还取决于模型与网关当前支持情况。配置成功只 说明请求链路可用，不代表每个客户端功能都由所选模型实现；以控制台和实际最小验证结果为准。

常见问题

404 或请求路径异常

确认 ANTHROPIC_BASE_URL 是 https://api.thqllm.com，末尾没有 /v1 或 /v1/messages。客户端负责追加最终路径。

401 或认证方式不正确

确认使用 ANTHROPIC_AUTH_TOKEN，并清除当前进程中可能冲突的 ANTHROPIC_API_KEY。修改后 重新启动 Claude Code，再用 /status 检查当前认证来源。

修改 settings.json 后仍使用旧配置

运行 /status 查看 Setting sources、Anthropic base URL 和认证来源。确认用户级 settings.json 是合法 JSON，并新开一个 Claude Code 会话后再检查。

项目内配置覆盖了用户配置

检查当前项目是否存在 .claude/settings.json 或 .claude/settings.local.json。两者中的同名 env 配置优先级高于用户配置；如有冲突项，请移除、更新或按团队安全规则统一配置。

模型不存在或不可用

从控制台重新复制完整模型 ID，确认它适用于 Anthropic Messages。不要使用其他客户端页面中 的示例模型值。

更多排查顺序见客户端接入总览和 常见问题。

密钥安全

  • 不要把真实 Key 写入项目文件、脚本、日志或命令历史。
  • 需要持久化时使用受控的用户环境或密钥管理工具，并限制文件读取权限。
  • 为不同设备、项目和自动化用途创建不同 Key。
  • 怀疑泄露时立即在控制台撤销旧 Key，并重启所有仍可能持有旧环境变量的进程。
  • 提交诊断信息时移除完整 Key 和敏感请求内容。