Claude Code 指南第 1 章入门
安装与接入十分钟跑起来
从安装 CLI 到第一次对话,三种接入方式与最常见的几个报错。
全部章节
本页
安装
推荐用 npm 安装,国内可以走镜像源。需要 Node.js 22 或更高版本(低版本会出现 EBADENGINE 警告,通常仍能运行)。
bash
npm install -g @anthropic-ai/claude-code能直接访问 claude.ai 的环境,也可以用官方安装脚本,它不依赖 Node:
bash
curl -fsSL https://claude.ai/install.sh | bash接入 AGI Dawn
注册后在控制台「API 密钥」创建一个 Key,然后写入两个环境变量。macOS 和 Linux 写进 ~/.zshrc 或 ~/.bashrc,然后重开终端:
bash
export ANTHROPIC_BASE_URL=https://agidawn.cc
export ANTHROPIC_AUTH_TOKEN=sk-你的KeyWindows 用 PowerShell 写入用户环境变量,然后重开 PowerShell:
powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://agidawn.cc", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User")不想改全局环境变量,可以写在 ~/.claude/settings.json:
json
{
"env": {
"ANTHROPIC_BASE_URL": "https://agidawn.cc",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}验证
bash
claude -p "你是哪个模型?"能回答就通了。进入项目目录运行 claude,开始交互式会话。
常见报错
| 现象 | 原因 | 处理 |
|---|---|---|
| 401 | Key 无效或已停用、这把 Key 的额度用完或已过期,或同时设置了 ANTHROPIC_API_KEY | 到控制台检查 Key 状态与额度;unset ANTHROPIC_API_KEY;用 claude auth status 看当前凭据 |
| 403 | 账户余额不足、这把 Key 剩余额度不够本次请求;或请求的模型不在这把 Key 允许的范围、IP 不在白名单,或账户被停用 | 先看返回的 message:额度问题就充值、使用兑换码或调高这把 Key 的额度;模型或 IP 不在允许范围就到控制台调整这把 Key 的设置;账户被停用请联系商务 |
| 启动后要求登录官方账号 | 这个终端没有读到 ANTHROPIC_AUTH_TOKEN | 重开终端,或改用 settings.json;用 claude auth status 确认当前凭据 |
| 429 | 请求过于频繁,或上游繁忙 | 稍后重试;持续出现请联系商务 |