Claude Code 指南第 1 章入门

安装与接入十分钟跑起来

从安装 CLI 到第一次对话,三种接入方式与最常见的几个报错。

更新于 2026年10月17日 · 依据 Claude Code 2.1.301 官方文档核对 · AGI Dawn 编辑部 · 审定 kk

全部章节
本页

安装

推荐用 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-你的Key

Windows 用 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,开始交互式会话。

常见报错

现象原因处理
401Key 无效或已停用、这把 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请求过于频繁,或上游繁忙稍后重试;持续出现请联系商务

更多排查方法见 排错,接口细节见 接入文档。