Claude Code 安装指南:终端 AI 编程助手
最近在终端里使用 Claude Code 进行结对编程。与 GitHub Copilot 不同,它不仅能补全代码,还能理解整个项目上下文,帮助编写功能、修复 Bug 或重构。
环境要求
- Node.js 18.0 以上(推荐最新 LTS)
- 系统:macOS、Linux、Windows(需要 WSL)
安装步骤
第一步:安装 Node.js
Ubuntu / Debian:
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs
macOS:
brew install node
node --version
未安装 Homebrew 请先安装:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
第二步:安装 Claude Code
npm install -g @anthropic-ai/claude-code
第三步:配置 API
Claude Code 需要配置两个环境变量:
| 配置项 | 说明 |
|---|---|
| ANTHROPIC_AUTH_TOKEN | API 密钥,sk- 开头 |
| ANTHROPIC_BASE_URL | API 地址 |
Linux / macOS 设置:
export ANTHROPIC_AUTH_TOKEN=sk-你的 token
export ANTHROPIC_BASE_URL=https://api.anthropic.com/v1
export API_TIMEOUT_MS=300000
claude
Windows PowerShell:
$env:ANTHROPIC_BASE_URL = "https://api.anthropic.com/v1"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的 token"
$env:API_TIMEOUT_MS = "300000"
claude
Windows CMD:
set ANTHROPIC_BASE_URL=https://api.anthropic.com/v1
set ANTHROPIC_AUTH_TOKEN=sk-你的 token
set API_TIMEOUT_MS=300000
claude
第四步:首次启动配置
启动后会有几个配置步骤:
- 选主题 → 选你喜欢的,回车
- 安全提示 → 确认,回车
- 终端配置 → 默认就行,回车
- 信任工作目录 → 确认,回车
常见问题
报错 'Invalid API Key · Please run /login' → 环境变量没设对,检查 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL → 如果是写在配置文件里的,重启终端再试

