📊 页面导航

    适用角色与上手难度

    角色推荐度上手难度
    🛠️ 开发★★★★★★☆☆☆☆
    🧪 测试★★★★☆★★☆☆☆
    📦 产品★★★☆☆★★☆☆☆

    🎯 学习产出： 掌握 Claude Code 的安装和配置，能成功完成首次启动

    🚀 AI 能力提升： 上下文管理

    安装与配置

    预计阅读时间: 3 分钟

    系统要求

    • Node.js 18 或更高版本
    • 操作系统：macOS、Linux 或 Windows (WSL)
    • 终端：任意终端模拟器（推荐 iTerm2、Windows Terminal）

    安装

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

    验证安装：

    claude --version

    认证

    首次运行时，Claude Code 会引导你完成认证。支持两种方式：

    方式一：Anthropic API Key

    从 Anthropic Console 获取 API Key，然后设置环境变量：

    export ANTHROPIC_API_KEY=your-api-key
    Tip

    将环境变量添加到 ~/.bashrc 或 ~/.zshrc 中，避免每次启动都要设置。

    Tip

    如果你需要在多个 API Provider 之间切换（如 Anthropic API、AWS Bedrock 等），可以使用 CC-Switch 一键切换，无需手动修改配置文件。

    方式二：Claude Pro/Max 订阅

    如果你有 Claude Pro 或 Max 订阅，可以直接登录使用，无需 API Key：

    claude
# 首次运行时会提示登录

    基本配置

    Claude Code 的配置文件位于 ~/.claude/settings.json：

    {
  "model": "claude-sonnet-4-20250514",
  "permissions": {
    "allow": ["Bash(npm run *)", "Bash(git *)"]
  }
}

    常用配置项

    配置项说明默认值
    model使用的模型claude-sonnet-4-20250514
    permissions.allow自动允许的工具列表[]
    Tip

    模型 ID 可能随版本更新而变化。使用 claude --version 查看当前支持的模型，或在 Anthropic 文档 中查找最新模型 ID。

    项目级配置

    在项目根目录创建 CLAUDE.md 文件，为 Claude Code 提供项目上下文：

    # CLAUDE.md

本项目使用 TypeScript + React 构建。

## 常用命令

- `npm run dev` — 启动开发服务器
- `npm run build` — 构建生产版本
- `npm test` — 运行测试
    Info

    CLAUDE.md 的内容会在每次对话开始时自动加载，相当于给 Claude Code 一份项目说明书。

    下一步

    :::tip 进阶阅读 配置完成后，推荐继续阅读：