Claude Code 安装教程

什么是 Claude Code？

Claude Code 是 Anthropic 官方推出的命令行工具，让你可以在终端中直接与 Claude 进行交互，完成代码编写、调试、重构等任务。

系统要求

操作系统: macOS 10.15+、Windows 10/11、Linux (Ubuntu 20.04+/Debian 10+)
Node.js: 18.0 或更高版本
内存: 建议 4GB 以上

一键安装（推荐）

复制以下命令到终端运行，即可自动完成安装和配置：

macOS / Linux / WSL

1	source <(curl -fsSL https://claude-zh.cn/scripts/install.sh)

Windows (PowerShell)

1	& ([scriptblock]::Create((New-Object Net.WebClient).DownloadString("https://claude-zh.cn/scripts/install.ps1")))

脚本功能

一键安装脚本会自动：

检测并安装 Node.js（如未安装）
安装 Claude Code
配置 ~/.claude/settings.json（跳过引导 + 禁用非必要流量 + 禁用 co-authored-by）
引导配置 API 密钥
配置 claude 别名，默认启用 --dangerously-skip-permissions 免确认模式

手动安装

1. 安装 Node.js

如果你还没有安装 Node.js，可以从 Node.js 官网下载安装，或使用包管理器：

macOS

1	brew install node

Windows

# 方法一：从官网下载安装包
# 访问 https://nodejs.org/ 下载 LTS 版本安装包

# 方法二：使用 winget（Windows 包管理器）
winget install OpenJS.NodeJS.LTS

Linux/WSL

1
2
3

# 适用于 Ubuntu/Debian 以及 Windows 的 WSL 环境
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

2. 安装 Claude Code

# 设置国内镜像源（推荐，加速下载）
npm config set registry https://registry.npmmirror.com

# 安装最新版本
npm install -g @anthropic-ai/claude-code

3. 配置 API

Claude Code 需要配置 API 密钥才能使用。访问 LuckyAPI 注册并创建令牌。

永久配置（推荐）

将以下内容添加到 ~/.bashrc 或 ~/.zshrc：

macOS/Linux/WSL

# 1. 设置中转站的 API 地址
export ANTHROPIC_BASE_URL="https://cn.luckyapi.chat"

# 2. 设置你的中转 API Key
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxx"

# 3. 非常重要：清空官方 Key 变量，防止冲突
export ANTHROPIC_API_KEY=""

# 4. (可选) 指定模型
export ANTHROPIC_MODEL="claude-sonnet-4-6"

# 5. 免确认模式：启动 claude 时默认跳过权限确认
claude() { command claude --dangerously-skip-permissions "$@"; }
export -f claude

Windows (PowerShell)

# 设置用户级环境变量（永久生效）
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cn.luckyapi.chat", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "", "User")
# (可选) 指定模型
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-6", "User")
# 重启终端后生效

注意

ANTHROPIC_AUTH_TOKEN 是中转站的密钥，不要填到 ANTHROPIC_API_KEY 中

ANTHROPIC_API_KEY 必须设为空字符串，否则会与中转站冲突

配置完成后，运行 source ~/.bashrc（或 source ~/.zshrc）使配置生效。

4. 配置 Claude Code 设置

创建或编辑 ~/.claude/settings.json，添加以下配置：

{
  "hasCompletedOnboarding": true,
  "env": {
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "includeCoAuthoredBy": false
}

这些配置的作用：

hasCompletedOnboarding: 跳过首次启动的引导流程
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 禁用非必要的网络请求
includeCoAuthoredBy: 禁用 commit 信息中的 co-authored-by 标记

一键配置命令

mkdir -p ~/.claude && cat > ~/.claude/settings.json << 'EOF'
{
  "hasCompletedOnboarding": true,
  "env": {
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "includeCoAuthoredBy": false
}
EOF

5. 启动 Claude Code

在任意项目目录下运行：

claude

首次运行会进入交互式配置，按提示完成即可。

提示: 在 Claude Code 中按 Shift+Tab 可随时切换权限确认模式。

常用命令

命令	说明
`claude`	启动交互式会话
`claude "你的问题"`	直接提问
`claude --help`	查看帮助信息

Windows 用户须知

Claude Code 完全支持 Windows 原生环境，无需安装 WSL。只需确保：

使用 PowerShell 或 Windows Terminal（推荐）
Node.js 已正确安装并添加到 PATH
如遇到脚本执行限制，在 PowerShell 中运行：

1	Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

卸载和重新安装

如果遇到问题需要重新安装 Claude Code：

# 卸载
npm uninstall -g @anthropic-ai/claude-code

# 重新安装
npm install -g @anthropic-ai/claude-code

提示: 重新安装后，环境变量配置和 ~/.claude/settings.json 会保留，无需重新配置。

常见问题

Q: 提示 “API key not found”？

确保已正确设置 ANTHROPIC_AUTH_TOKEN 环境变量，并且 ANTHROPIC_API_KEY 设为空字符串。

Q: 连接超时？

检查网络连接，确保 ANTHROPIC_BASE_URL 设置为 https://cn.luckyapi.chat。

安装完成后，你就可以在终端中体验 Claude Code 带来的 AI 编程体验了！快去试试吧。

更新 Claude Code

再次执行安装命令即可更新 Claude Code。

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

1	claude --version