快速开始

Claude Code 配置教程

通过环境变量和 settings.json，把 Claude Code 接到甜酒公开端点。

这篇文档讲的是“怎么把 Claude Code 指向甜酒”，并且和 `/dashboard/keys` 里的“使用密钥”示例保持同一套配置结构。

第一步：安装 Claude Code

先确保本地已经具备 Node.js 环境，然后再安装 CLI。工具安装成功后，再去写环境变量和配置文件。

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

第二步：准备甜酒 API Key

先在甜酒 `/dashboard/keys` 中选择一条可用于 Claude Code 的 Key。文档中的示例用的是占位值；你实际填写时，把 `YOUR_TIANJIU_API_KEY` 替换成自己的 Key。

Base URL 使用 `https://api.tianjiu.ai`。
如果某条 Key 的“使用密钥”弹窗里能看到 `Claude Code` 标签，说明这条 Key 可以直接按下面方式接入。
环境变量写完后，建议重新打开终端再启动 Claude Code。

第三步：写入终端环境变量

把环境变量写进终端，必要时再把同样的 env 写入 Claude Code 的 settings.json。

export ANTHROPIC_BASE_URL="https://api.tianjiu.ai"
export ANTHROPIC_AUTH_TOKEN="YOUR_TIANJIU_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

环境变量写入后，重开终端再启动 Claude Code。

第四步：按需写入 settings.json

如果你希望把同样的环境变量持久化，或者平时通过编辑器插件启动 Claude Code，可以继续把它们写入 `~/.claude/settings.json` 或 `%userprofile%\.claude\settings.json`。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tianjiu.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_TIANJIU_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

如果你用 VS Code 的 Claude Code，也可以把同样的环境变量写进 settings.json。

第五步：先跑一个低成本任务

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

如果报 401，优先检查 `ANTHROPIC_AUTH_TOKEN` 是否是当前有效的甜酒 Key。
如果看起来像没有读到配置，优先确认终端已经重开，或 settings.json 是否写在正确目录。
如果是超时或限流，记录请求时间和任务类型，再联系支持。