---
title: 快速开始
description: 注册 1折AI、创建 API 密钥、用一条 curl 调通 Claude，再接到 Claude Code 等工具里。
---

目标：5 分钟内拿到一个 API 密钥（API key），并亲眼看到 Claude 的回包。

<Steps>
<Step title="注册并充值">

打开 [1zheai.com/register](https://1zheai.com/register) 注册。调用是按量扣余额的，所以要先充值，最低 ¥100，支持微信、支付宝、Stripe（银行卡）和 USDT。7 天内没用完的额度可以原路退回，规则见[充值、退款与发票](/docs/billing/)。

</Step>
<Step title="创建 API 密钥">

进入[控制台](https://1zheai.com/console)，左侧菜单点「API 密钥」，再点右上角「创建 API 密钥」，填个名字后保存。API 密钥以 `sk-` 开头，在列表里点复制图标复制下来存好。细节见[获取与管理 API 密钥](/docs/api-keys/)。

</Step>
<Step title="发出第一条请求">

把 API 密钥放进环境变量，再用 curl 调一次 Anthropic 原生接口：

<CodeGroup>
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"

curl https://1zheai.com/v1/messages \
  -H "x-api-key: $ONEZHE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 128,
    "messages": [{"role": "user", "content": "用一句话解释什么是 HTTP"}]
  }'
```
```powershell title="Windows PowerShell"
$env:ONEZHE_API_KEY = "sk-你的Key"

$body = @{
  model      = "claude-sonnet-5-5"
  max_tokens = 128
  messages   = @(@{ role = "user"; content = "用一句话解释什么是 HTTP" })
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Uri "https://1zheai.com/v1/messages" -Method Post `
  -Headers @{ "x-api-key" = $env:ONEZHE_API_KEY; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json; charset=utf-8" `
  -Body ([System.Text.Encoding]::UTF8.GetBytes($body))
```
</CodeGroup>

`ONEZHE_API_KEY` 只是示例变量名，用什么名字都行。

</Step>
<Step title="看回包">

成功时返回 HTTP 200，结构和官方一致。重点看两处：`model` 是不是你请求的模型，`usage` 里的 token 数。下面是 2026-10-15 实测的回包：

```json
{
  "model": "claude-sonnet-5-5",
  "id": "msg_011Cg3G8HQmyTrnqSBX6o6Pw",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "HTTP(超文本传输协议)是一种基于请求-响应模式的应用层协议,用于在客户端(如浏览器)和服务器之间传输网页、图片、API 数据等内容。"
    }
  ],
  "container": null,
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "stop_details": null,
  "usage": {
    "input_tokens": 530,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "cache_creation": {
      "ephemeral_5m_input_tokens": 0,
      "ephemeral_1h_input_tokens": 0
    },
    "output_tokens": 69,
    "output_tokens_details": {"thinking_tokens": 0},
    "service_tier": "standard",
    "inference_geo": "global"
  },
  "input_transformations": [],
  "diagnostics": null,
  "context_management": {"applied_edits": []}
}
```


`input_tokens` 比这句提问本身多出几百，是这类客户端（curl、SDK、第三方工具）每次请求附带的系统提示，按输入计费，Claude Code 不附带，见[系统提示的计费](/docs/pricing-explained/#系统提示的计费)。

再去控制台左侧的「使用日志」，能看到刚才这一笔：时间、所用 API 密钥（「令牌」列）、模型、输入 / 输出 token、缓存读写和费用。

</Step>
</Steps>

## 下一步

接到你常用的工具里：

<CardGroup cols={2}>
  <Card title="Claude Code" href="/docs/quickstart-claude-code/">
    两个环境变量就够。
  </Card>
  <Card title="CC Switch" href="/docs/quickstart-cc-switch/">
    不想手改配置文件就用它。
  </Card>
  <Card title="Cursor" href="/docs/quickstart-cursor/">
    自定义 Base URL 的写法和限制。
  </Card>
  <Card title="OpenAI SDK" href="/docs/quickstart-openai-sdk/">
    已有 OpenAI 代码，只改 base_url。
  </Card>
</CardGroup>

请求失败的话，先看[错误码与排错](/docs/troubleshooting/)。想核对返回的字段和用量，看[核对模型和用量](/docs/verify-model/)。
