快速开始

Claude Code 配置教程

安装并配置 Claude Code,让它通过甜酒的 OpenAI Compatible 接口访问可用模型。

这篇文档讲的是“怎么把 Claude Code 指向甜酒”,不是解释 Claude Code 本身的全部能力。

开始前建议先完成 Node.js 环境安装教程

第一步:安装 Claude Code

先确保本地已经具备 Node.js 环境,然后再安装 CLI。工具安装成功后,再去做 Base URL 与密钥配置。

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

第二步:配置兼容接口

甜酒对外暴露的是 OpenAI Compatible 风格接口。实际配置方式取决于你当前使用的 Claude Code 版本与封装方式,但核心信息只有三项:Base URL、API Key、模型名。

  • Base URL 使用 `https://api.tianjiu.ai/v1`。
  • 鉴权使用你在甜酒控制台或对接流程中拿到的 API Key。
  • 模型名使用平台实际开放的映射名称,不要直接假设第三方默认模型都可用。
如果你的团队对 Claude Code 做了二次封装,把真正读取配置的位置先确认清楚,再写入对应字段。

第三步:先跑一个低成本任务

第一条请求不需要很复杂。先让它读取一个小目录、回答一段简单问题或生成一段说明,目的是确认连通性、鉴权和模型映射都正常。

  • 如果报 401,优先检查密钥格式与读取路径。
  • 如果报 404 或模型不可用,优先检查模型名。
  • 如果是超时或限流,记录请求时间和任务类型,再联系支持。