Windows：Claude Code

本页使用原生 Windows PowerShell，不要求 WSL。建议同时安装 Git for Windows。

在 Windows 上使用 Claude Code

Claude Code 在这里作为编码客户端，通过 Anthropic Messages 协议调用悠然 AI 提供的 GPT 模型。

确认适用方式
适合希望在终端中使用 Claude Code 工作流，同时由悠然 AI 统一提供模型和用量管理的用户。
安装 Claude Code
打开 PowerShell，运行官方原生安装命令。Windows 建议同时安装 Git for Windows。
PowerShell
```
irm https://claude.ai/install.ps1 | iex
```
查看 Claude Code 官方安装文档
验证安装
PowerShell
```
claude --version
```
如果提示命令不存在，请关闭并重新打开终端后再次验证。
创建悠然 AI API Key
前往控制台的访问密钥页面创建独立 Key。请勿把完整 Key 写入项目文件或提交到 Git。
打开访问密钥页面

查询可用模型

替换命令中的 API Key，执行后从返回的 data[].id 中选择一个模型 ID。

$headers = @{ Authorization = "Bearer <YOURAN_API_KEY>" }
(Invoke-RestMethod -Uri "https://youran-ai.du-fu.com/api/models" -Headers $headers).data |
  Select-Object -ExpandProperty id

写入用户级配置

将占位符替换为真实 API Key 和模型 ID。所有 Claude Code 模型别名与子代理都映射到同一 GPT 模型。

$variables = @{
  ANTHROPIC_BASE_URL = "https://youran-ai.du-fu.com/api"
  ANTHROPIC_AUTH_TOKEN = "<YOURAN_API_KEY>"
  ANTHROPIC_MODEL = "<MODEL_ID>"
  ANTHROPIC_DEFAULT_OPUS_MODEL = "<MODEL_ID>"
  ANTHROPIC_DEFAULT_SONNET_MODEL = "<MODEL_ID>"
  ANTHROPIC_DEFAULT_HAIKU_MODEL = "<MODEL_ID>"
  CLAUDE_CODE_SUBAGENT_MODEL = "<MODEL_ID>"
}

$variables.GetEnumerator() | ForEach-Object {
  [Environment]::SetEnvironmentVariable($_.Key, $_.Value, "User")
  Set-Item -Path "Env:$($_.Key)" -Value $_.Value
}

发起第一次请求
PowerShell
```
claude "请只回复：连接成功"
```
收到模型回复后，可前往控制台的请求记录确认模型、Token 和状态。
遇到问题
优先检查 Base URL 是否包含 /api、模型 ID 是否来自实时模型列表，以及终端是否已加载新环境变量。
前往故障排查