从下载安装，到 API 第一次调用

先确认：你说的“KPI”大概率是 API

这份报告同时覆盖 Claude 普通聊天应用与 Claude API。二者不是同一个付费体系：聊天订阅不会自动变成 API 额度，API 充值也不会自动升级聊天套餐。

1. 先选对入口

2. 注册与登录：一步一步

3. 下载与安装 Claude

macOS

1. 进入官方下载页，点击 Download for macOS。
2. 打开下载的安装包，将 Claude 拖入 Applications（应用程序）或按安装器提示完成。
3. 从“应用程序”启动 Claude；若 macOS 提示来自互联网，核对开发者与下载来源后选择打开。
4. 使用注册时相同的 Google 账号或邮箱登录。

Windows

1. 根据设备选择 Windows x64 或 Windows ARM64。多数 Intel/AMD 电脑选普通 Windows；骁龙 Windows 电脑通常选 ARM64。
2. 双击安装程序，按提示完成安装。
3. 从开始菜单打开 Claude并登录。若要在 Code 标签运行本地项目，Windows 还需要 Git。

手机与 Linux

iOS 和 Android 请从官方下载页跳转至 App Store / Google Play。官方当前没有 Linux 桌面版；Linux 用户可用网页，开发者可使用 Claude Code CLI。

4. Claude 日常使用手册

第一次对话

在输入框中直接描述任务。高质量提示词可以用这个结构：

角色/背景：你是我的市场研究助手，我经营一家女性成长社群。
目标：比较 3 个课程选题，给出优先级。
材料：以下是用户访谈摘要……
要求：用表格输出；包含机会、风险、验证方法；不要编造数据。
验收标准：结论能直接用于本周选题会，每项都有下一步行动。

文件分析

点击附件按钮或拖入文件，然后明确告诉 Claude：要找什么、输出格式、是否需要引用页码。对于重要合同、财务与医疗材料，应人工复核，且不要上传无权处理的敏感数据。

持续迭代

• 回答太泛：补充受众、场景、限制和样例。
• 担心幻觉：要求“逐条标注事实来源；无法确认就写未知”。
• 输出不好用：指定表格字段、字数、语气、交付格式。
• 任务复杂：先让 Claude 给方案，再分步骤执行与验收。

跨设备

用同一账号登录网页、桌面与手机，普通对话、项目、记忆和偏好可跨设备同步；部分本地 Cowork 会话仍保存在设备上。

5. Claude API Key：完整开通流程

# macOS / Linux / WSL：仅对当前终端生效
export ANTHROPIC_API_KEY='粘贴你的真实Key'

# Windows PowerShell：仅对当前窗口生效
$env:ANTHROPIC_API_KEY='粘贴你的真实Key'

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 512,
    "messages": [{"role":"user","content":"用中文写一句开业祝福"}]
  }'

pip install anthropic

from anthropic import Anthropic

client = Anthropic()  # 自动读取 ANTHROPIC_API_KEY
message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=512,
    messages=[{"role": "user", "content": "给我三个品牌名"}],
)
print(message.content[0].text)

API 常见错误

6. Claude Code：可选的程序员工具

如果你只是聊天，不需要安装 Claude Code。若要让 Claude 在代码仓库里读文件、改代码、跑测试，可选择桌面端 Code 标签或 CLI。

CLI 安装（macOS / Linux / WSL）

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

也可用 Homebrew：

brew install --cask claude-code

首次运行 claude 后按浏览器提示登录；企业账号可运行 /login。官方还保留 Node 18+ 的 npm 安装方式，但不要使用 sudo npm install，以免产生权限问题。

7. 注册、登录与安装故障

8. 最后检查：安全与费用

• 只使用官方域名和官方应用商店。
• Chat 订阅与 API 费用分开理解，避免重复付费预期。
• API Key 不粘贴到网页聊天，不写入源码，不提交 Git。
• 按项目建立 Workspace 和 Key，命名清晰，设置到期时间并定期轮换。
• 在 Console 查看 Billing 与 Limits；自动充值设置小额阈值，防止意外支出。
• Key 一旦泄露，立即在 Console 撤销并创建新 Key。
• 重要输出必须人工核实，尤其是法律、医疗、财务与对外发布内容。