Windows：Claude Code

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

在 Windows 上使用 Claude Code

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

1. 确认适用方式

   适合希望在终端中使用 Claude Code 工作流，同时由悠然 AI 统一提供模型和用量管理的用户。

2. 安装 Claude Code

   打开 PowerShell，运行官方原生安装命令。Windows 建议同时安装 Git for Windows。

   PowerShell复制

   irm https://claude.ai/install.ps1 | iex

   查看 Claude Code 官方安装文档

3. 验证安装

   PowerShell复制

   claude --version

   如果提示命令不存在，请关闭并重新打开终端后再次验证。

4. 创建悠然 AI API Key

   前往控制台的访问密钥页面创建独立 Key。请勿把完整 Key 写入项目文件或提交到 Git。

   打开访问密钥页面

5. 查询可用模型

   替换命令中的 API Key，确认返回的 data[].id 包含 gpt-6.1-sol。

   PowerShell复制

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

6. 写入用户级配置

   将 API Key 占位符替换为真实值。所有 Claude Code 模型别名与子代理均使用 GPT-6.1 Sol，并显式声明支持推理强度。

   PowerShell复制

   $variables = @{
     ANTHROPIC_BASE_URL = "https://youran-ai.du-fu.com"
     ANTHROPIC_AUTH_TOKEN = "<YOURAN_API_KEY>"
     ANTHROPIC_MODEL = "gpt-6.1-sol"
     ANTHROPIC_DEFAULT_OPUS_MODEL = "gpt-6.1-sol"
     ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES = "effort"
     ANTHROPIC_DEFAULT_SONNET_MODEL = "gpt-6.1-sol"
     ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES = "effort"
     ANTHROPIC_DEFAULT_HAIKU_MODEL = "gpt-6.1-sol"
     ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES = "effort"
     CLAUDE_CODE_SUBAGENT_MODEL = "gpt-6.1-sol"
   }
   
   $variables.GetEnumerator() | ForEach-Object {
     [Environment]::SetEnvironmentVariable($_.Key, $_.Value, "User")
     Set-Item -Path "Env:$($_.Key)" -Value $_.Value
   }

7. 发起第一次请求

   PowerShell复制

   claude "请只回复：连接成功"

   收到模型回复后，可前往控制台的请求记录确认模型、Token 和状态。

8. 遇到问题

   优先检查 Base URL 是否为 https://youran-ai.du-fu.com、模型 ID 是否来自实时模型列表，以及终端是否已加载新环境变量。

   前往故障排查