Claude Code 安装使用完整教程（2026最新版）
在本教程中，我会一步步带你从零开始安装 Claude Code，配置好 API，跑通第一个命令。教程基于 2026 最新版，特点是：
- 图文结合：文字描述清晰，关键步骤配模拟图或示意（文字格式限制，无法插入图片，但你执行时可截图）。
- 踩坑提醒：包括常见问题和解决方法。
- 完整流程：从环境检查到第一个命令成功运行。
一、前言：为什么要装 Claude Code？
最近有朋友问我："在 VS Code 里装 Copilot 不是挺好吗，为啥还要折腾命令行版的 Claude Code？"其实，Claude Code 和 Copilot不是替代关系，而是互补关系。下面是我使用后发现的真香理由，对比一目了然：
| 维度 | Claude Code（CLI） | Copilot（IDE 插件） |
|---|---|---|
| 工作方式 | 终端里直接对话，可读写整个项目 | IDE 内联补全 |
| 适用场景 | 重构项目、写脚本、批量处理 | 单文件快速补全 |
| 上下文 | 整个仓库级 | 当前文件为主 |
| 自动化 | 适合接 CI / 脚本流水线 | 主要靠人触发 |
| 模型 | 支持 Opus/Sonnet/Haiku | GitHub 模型 |
简单说：
- Claude Code适合大范围工程任务，比如"让 AI 帮我重构整个项目"。
- Copilot适合编写时的精细化补全。
- 两者结合，生产力 double 📈。
二、系统要求（先确认再动手）
动手前先查环境，确保达标：
✅ 必选项
- 操作系统：macOS / Linux / Windows（WSL），不推荐原生 Windows（兼容差）。
- Node.js 版本 ≥$18.0$（必须！旧版会报错）。
- 网络稳定：能稳定访问 Anthropic API 或转发服务。
- 磁盘空间 ≥ $200 , \text{MB}$（安装包和应用缓存）。
💡 提示
- Windows 用户建议用WSL（Ubuntu 子系统），避免 PowerShell 兼容问题。
- macOS/Linux 用户开箱即用，可跳过烦琐步骤。
三、安装 Node.js
步骤：验证或安装。如果已有 Node.js 18+，跳过本节。
(1) 验证安装：
node --version输出应是v18.x.x或更高，确保版本数 $≥ 18.0$。
若不达标，按系统安装：
(2) Ubuntu / Debian 安装：
# 1. 添加最新 LTS 源 curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash - # 2. 安装 sudo apt-get install -y nodejs # 3. 验证版本（输出 ≥ v18.0） node --version(3) macOS 安装：
# 1. 装 Xcode 工具（确保已装） sudo xcode-select --install # 2. Homebrew（若未装） /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # 3. 通过 Homebrew 装 brew install node # 4. 验证 node --version(4) Windows 安装：
- 下载Node.js LTS 版安装包（官网链接）。
- 运行安装程序，一路点 Next。
- 完成后开 PowerShell 跑：
node --version
四、安装 Claude Code（4种官方方式）
挑一种顺手的就行（我推荐方式一）。
方式一：官方脚本（Linux/macOS）
curl -fsSL https://claude.ai/install.sh | bash方式二：官方脚本（Windows PowerShell）
irm https://claude.ai/install.ps1 | iex方式三：Homebrew 安装（只限 macOS）
brew install --cask claude-code方式四：Winget 安装（只限 Windows）
winget install Anthropic.ClaudeCode⚠️ 安装后 fix PATH
如果终端报claude: command not found，说明 PATH 异常。手动加路径：
Linux / macOS（bash/zsh）：
# 加到 .bashrc（或 .zshrc） echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc source ~/.bashrc验证安装：
claude --version # 输出应类似：claude v2.0.0（2026）五、获取 API 令牌（最关键步骤，易踩坑）
API 令牌是核心，没它就跑不起来。你需要两个东西：
| 配置项 | 说明 | 备注 |
|---|---|---|
ANTHROPIC_AUTH_TOKEN | API 认证令牌 | 以sk-开头 |
ANTHROPIC_BASE_URL | API 服务地址 | 查你的服务商地址 |
5.1 创建令牌步骤
- 进入令牌管理页面点「添加令牌」。
- 设置关键选项：
- 名称：方便自己识别（如
claude-code-mac）。 - 额度：设为无限额度（否则长任务会被截断）。
- 分组：选以下之一：
- Claude Code 专属
- 特价 Claude Code
- 官转克劳德 1 及以上
- 建议值：优先 Claude Code 专属。
- 名称：方便自己识别（如
🚨 踩坑警告：不要选这些分组！
default分组：不支持通工具调用，会卡死。逆向分组：API 响应慢。- 原因：Claude Code 依赖工具调用（读写文件），错选分组将报错
Function not permitted。
- 复制令牌粘贴到安全文本（页面关闭后它不可见）。
六、配置 settings.json（最易出错处）
配置文件路径按系统不同：
| 系统 | 路径 |
|---|---|
| Linux / macOS | ~/.claude/settings.json |
| Windows (PowerShell) | %USERPROFILE%\.claude\settings.json |
| Windows (WSL) | ~/.claude/settings.json |
| 项目级 | <项目目录>/.claude/settings.json（优先级更高） |
6.1 完整配置示例
{ "env": { "ANTHROPIC_BASE_URL": "https://selltoken.top/", "ANTHROPIC_AUTH_TOKEN": "sk-粘贴令牌定值", "ANTHROPIC_MODEL": "claude-opus-4-6", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-6", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-6", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6", "API_TIMEOUT_MS": "300000", "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1" } }6.2 配置项说明（每个都很重要）
| 配置键 | 作用 | 建议值 |
|---|---|---|
ANTHROPIC_BASE_URL | API 接入点 | 你的服务商提供的地址 |
ANTHROPIC_AUTH_TOKEN | 认证令牌 | sk-xxx（一步获取的值） |
ANTHROPIC_MODEL | 主对话模型 | claude-opus-4-6（效果好！） |
ANTHROPIC_DEFAULT_HAIKU_MODEL | 轻任务模型 | claude-haiku-4-5或claude-opus-4-6 |
ANTHROPIC_DEFAULT_SONNET_MODEL | 执行阶段模型 | claude-sonnet-4-6或claude-opus-4-6 |
ANTHROPIC_DEFAULT_OPUS_MODEL | 规划阶段模型 | claude-opus-4-6 |
API_TIMEOUT_MS | 请求超时（毫秒） | 设置为 $300000$（5分钟） |
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS | 关闭 beta 协议 | 1（防崩溃） |
6.3 一行命令快速生成配置（Linux/macOS/WSL）
# 新建配置文件（替换占位符） cat > ~/.claude/settings.json << 'EOF' { "env": { "ANTHROPIC_BASE_URL": "https://selltoken.top/", "ANTHROPIC_AUTH_TOKEN": "sk-粘贴令牌", "ANTHROPIC_MODEL": "claude-opus-4-6", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-6", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-6", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6", "API_TIMEOUT_MS": "300000", "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1" } } EOF🔧 Windows 用户注意：
PowerShell 不支持<< EOF语法，直接用 VSCode 或记事本：
- 打开
%USERPROFILE%\.claude\settings.json。 - 粘贴 JSON 模板。
- 保存后重启终端。
七、初次启动和跑第一个命令
配置好后，启动 Claude Code！
(1) 初次启动向导
claude跟着提示一步步选（推荐设置）：
- 选主题：Dark / Light（我选 Dark），然后 Enter。
- 读安全须知：读完确认，Enter。
- Terminal 配置：默认就行，Enter。
- 工作目录信任？：选 Yes ✅。
(2) 跑第一个命令试手
初始界面中，输入：
帮我写一个 Python 快速排序等待几秒，看到输出包括：
- Python 代码。
- 测试结果解释（如图示）。
- 体验超顺滑！
八、常见问题 FAQ（踩坑合集）
❓ Q1：启动报Invalid API Key · Please run /login？
A：环境变量没生效，排查步骤：
- 重启终端：环境变量修改后必须关闭再打开。
- 检查配置文件：
确保 JSON 无额外逗号/引号。cat ~/.claude/settings.json - 确认令牌有效：换工具测试
sk-xxx。
❓ Q2：安装时报权限不足错误（Linux/macOS）？
A：加sudo：
sudo curl -fsSL https://claude.ai/install.sh | sudo bash❓ Q3：Windows WSL 中无法识别claude命令？
A：PATH 未同步：
# WSL 中运行 echo $PATH # 查看是否包含 ~/.local/bin export PATH=$PATH:$HOME/.local/bin # 临时加 # 长期解决：加到 .bashrc结语
恭喜！至此你已经从零配通了 Claude Code。记住：
- 配 API 令牌是关键，千万别选错分组。
- 配置文件中数值，如超时设置 $300000$，确保精度。
- 进阶：用 AI 处理复杂项目，如
claude predict流水线。