Claude Code 安装使用完整教程（2026最新版）

原创已于 2026-06-29 14:58:54 修改 · 置顶 · 405 阅读

6 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#AI编程 #AIGC

话题

#AI编程·六月创作之星博客挑战赛

于 2026-06-29 14:52:15 首次发布

cloudecode 专栏收录该内容

1 篇文章

订阅专栏

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏，讲透 AI 如何接管脏活累活

一键订阅

在本教程中，我会一步步带你从零开始安装 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：环境变量没生效，排查步骤：

重启终端：环境变量修改后必须关闭再打开。
检查配置文件：
```
cat ~/.claude/settings.json
```
确保 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 流水线。