====== 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]]

下载系统对应版本默认选项安装即可，验证安装：

<code bash>
git --version
</code>

=== 步骤2：安装 Claude Code ===

打开 PowerShell 或 CMD 终端运行以下命令：

**PowerShell 安装命令：**

<code bash>
irm https://claude.ai/install.ps1 | iex
</code>

**CMD 安装命令：**

<code bash>
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
</code>

**Winget 安装命令（备选）：**

<code bash>
winget install Anthropic.ClaudeCode
</code>

=== 步骤3：添加 PATH 环境变量 ===

Claude 可执行文件所在的目录需要加入系统 PATH，参考路径：

''C:\Users\你的用户名\.local\bin''

添加方法：打开系统属性 → 环境变量 → 编辑用户 PATH → 新建 → 添加上方路径。

完成后重启 PowerShell 终端或电脑即可。

==== macOS / Linux 系统 ====

**curl 安装（推荐）：**

<code bash>
curl -fsSL https://claude.ai/install.sh | bash
</code>

**Homebrew 安装：**

<code bash>
brew install --cask claude-code
</code>

**NPM 安装（需要 Node.js 18+）：**

<code bash>
npm install -g @anthropic-ai/claude-code
</code>

==== 验证安装 ====

<code bash>
claude --version
</code>

----

===== 第二部分：配置 =====

==== 配置文件位置 ====

^ 系统 ^ 配置文件路径 ^
| Windows | ''C:\Users\用户名\.claude\settings.json'' |
| macOS | ''~/.claude/settings.json'' |
| Linux | ''~/.claude/settings.json'' |

如果配置文件不存在，需要手动创建。

==== 获取 API Key ====

API Key 需要在 [[https://huanyuf.top/|本站控制台]] 的令牌页面自行生成创建（以 ''sk-'' 开头）。

==== 配置示例 ====

新建或修改 ''settings.json'' 文件，写入以下配置：

<code 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
}
</code>

**注意：** 将 ''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 快速配置 ====

通过终端直接创建或修改配置文件：

<code bash>
vim ~/.claude/settings.json
</code>

----

===== 第三部分：开始使用 =====

在您的项目目录下输入 ''claude'' 即可启动：

<code bash>
cd /path/to/your/project
claude
</code>

==== 初次运行配置 ====

启动后，您将看到以下配置步骤：

  - **选择主题** → 选择您喜欢的主题 + 按 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，执行：

<code>
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
</code>

----

**Q: 为什么显示 "offline" 状态？**

A: Claude Code 通过连接 Google 来判断网络状态。显示 "offline" 不影响正常使用。

----

**Q: 请求总是显示 "fetch failed"？**

A: 可能是网络环境导致的问题。解决方案：
  * 退出 Claude Code（Ctrl+C）
  * 重新运行 ''claude'' 命令
  * 如果问题持续，请稍后再试

----

**Q: 代理/VPN 环境下无法连接？**

A: 设置环境变量：

<code>
# 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"
</code>

===== 官方资源 =====

  * [[https://docs.anthropic.com/|Claude Code 官方文档]]
  * [[https://claude.ai/|Claude 官网]]
  * [[https://claude.ai/download|Claude Code 下载]]
  * [[https://github.com/anthropics/claude-code|Claude Code GitHub]]
  * [[https://huanyuf.top/|本站 API 控制台（令牌页面）]]