目录
Claude Code 安装配置指南
Claude Code 是 Anthropic 官方推出的终端 AI 编程助手，让您可以直接在终端中与 AI 协作编程。
系统要求
- 支持的操作系统：macOS 10.15+、Ubuntu 20.04+/Debian 10+ 或 Windows 10+（带 WSL 或 Git for Windows）
- 硬件：4GB+ RAM
- 软件：Git（Windows 安装需要）、Node.js 18+（仅 NPM 安装需要）
第一部分：安装 Claude Code
Windows 系统
步骤1：安装 Git For Windows
在 Windows 上原生安装 Claude Code 需要 Git Bash。
下载地址：https://git-scm.com/install/windows
下载系统对应版本默认选项安装即可，验证安装：
git --version
步骤2：安装 Claude Code
打开 PowerShell 或 CMD 终端运行以下命令：
PowerShell 安装命令：
irm https://claude.ai/install.ps1 | iex
CMD 安装命令：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Winget 安装命令（备选）：
winget install Anthropic.ClaudeCode
步骤3：添加 PATH 环境变量
Claude 可执行文件所在的目录需要加入系统 PATH，参考路径：
C:\Users\你的用户名\.local\bin
添加方法：打开系统属性 → 环境变量 → 编辑用户 PATH → 新建 → 添加上方路径。
完成后重启 PowerShell 终端或电脑即可。
macOS / Linux 系统
curl 安装（推荐）：
curl -fsSL https://claude.ai/install.sh | bash
Homebrew 安装：
brew install --cask claude-code
NPM 安装（需要 Node.js 18+）：
npm install -g @anthropic-ai/claude-code
验证安装
claude --version
第二部分：配置
配置文件位置
| 系统 | 配置文件路径 |
|---|---|
| Windows | C:\Users\用户名\.claude\settings.json |
| macOS | ~/.claude/settings.json |
| Linux | ~/.claude/settings.json |
如果配置文件不存在，需要手动创建。
获取 API Key
API Key 需要在 本站控制台 的令牌页面自行生成创建（以 sk- 开头）。
配置示例
新建或修改 settings.json 文件，写入以下配置：
{
"env": {
"ANTHROPIC_API_KEY": "sk-你的API密钥",
"ANTHROPIC_BASE_URL": "https://api.huanyuf.top",
"API_TIMEOUT_MS": "300000",
"ANTHROPIC_MAX_TOKENS": "16384",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-6-thinking",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-6-thinking",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6-thinking"
},
"model": "claude-opus-4-6-thinking",
"skipDangerousModePermissionPrompt": true
}
注意： 将 sk-你的API密钥 替换为你在令牌页面生成的 API Key。
配置字段说明
| 字段 | 说明 |
|---|---|
ANTHROPIC_API_KEY | 你的 API 密钥（在令牌页面生成，以 sk- 开头） |
ANTHROPIC_BASE_URL | API 服务地址，填本站地址 |
API_TIMEOUT_MS | 请求超时时间（毫秒），建议 300000（5分钟） |
ANTHROPIC_MAX_TOKENS | 最大输出 token 数 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | Haiku 默认模型 |
ANTHROPIC_DEFAULT_SONNET_MODEL | Sonnet 默认模型 |
ANTHROPIC_DEFAULT_OPUS_MODEL | Opus 默认模型 |
model | 默认使用的模型 |
skipDangerousModePermissionPrompt | 跳过危险模式确认提示 |
Ubuntu/macOS 快速配置
通过终端直接创建或修改配置文件：
vim ~/.claude/settings.json
第三部分：开始使用
在您的项目目录下输入 claude 即可启动：
cd /path/to/your/project claude
初次运行配置
启动后，您将看到以下配置步骤：
- 选择主题 → 选择您喜欢的主题 + 按 Enter
- 安全须知 → 确认安全须知 + 按 Enter
- Terminal 配置 → 使用默认配置 + 按 Enter
- 工作目录信任 → 信任当前目录 + 按 Enter
配置完成即可开始使用！
常见问题
Q: 遇到 “Invalid API Key - Please run /login” 错误？
A: Claude Code 未检测到环境变量。请检查：
- 是否正确设置了
ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL - 密钥是否以
sk-开头 - 配置文件保存后是否重启了终端
Q: PowerShell 无法安装脚本，遇到执行策略报错？
A: 以管理员身份运行 PowerShell，执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
Q: 为什么显示 “offline” 状态？
A: Claude Code 通过连接 Google 来判断网络状态。显示 “offline” 不影响正常使用。
Q: 请求总是显示 “fetch failed”？
A: 可能是网络环境导致的问题。解决方案：
- 退出 Claude Code（Ctrl+C）
- 重新运行
claude命令 - 如果问题持续，请稍后再试
Q: 代理/VPN 环境下无法连接？
A: 设置环境变量：
# Linux/macOS export HTTP_PROXY=http://127.0.0.1:7890 export HTTPS_PROXY=http://127.0.0.1:7890 # Windows PowerShell $env:HTTP_PROXY="http://127.0.0.1:7890" $env:HTTPS_PROXY="http://127.0.0.1:7890"
官方资源
