> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aioagi.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Windows

> 在 Windows 上安装 Claude Code，并通过 AIOAGI 接入 Claude 系列模型后集成到 VS Code。

Claude Code 原生面向 Anthropic 接口。你可以在 Windows 上使用 `Git Bash` 或 `WSL` 运行 Claude Code，再通过 AIOAGI API Key 调用平台支持的 Claude 系列模型。

<Info>
  界面、模型名、端点和支持策略可能变化，请以控制台、开发者指南和 Anthropic 官方文档的最新说明为准。
</Info>

<Card title="参考原文" icon="newspaper" href="https://blog.csdn.net/qq_36396104/category_13108723.html">
  查看 Claude Code 配置与使用相关的原文说明。
</Card>

## 准备条件

* Windows 10 或更高版本
* Node.js `18+`
* Git for Windows
* 可用的 AIOAGI API Key
* 一个本地代码项目，用于验证 Claude Code 是否可正常工作

<CardGroup cols={2}>
  <Card title="Anthropic 安装文档" href="https://docs.anthropic.com/en/docs/claude-code/getting-started">
    查看 Claude Code 的系统要求、Windows 支持方式和安装命令。
  </Card>

  <Card title="Anthropic Gateway 文档" href="https://docs.anthropic.com/en/docs/claude-code/llm-gateway">
    查看 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN` 的配置方式。
  </Card>

  <Card title="AIOAGI API Key 指南" href="/api-key-guide">
    如果你还没有创建 API Key，可以先完成控制台配置。
  </Card>

  <Card title="开发者指南" href="https://aiearthdev.apifox.cn/">
    核对当前端点、模型和接口说明。
  </Card>
</CardGroup>

## 运行方式

Anthropic 官方当前支持两种 Windows 运行方式：

1. 使用 `WSL` 运行 Claude Code
2. 使用 `Git Bash` 运行 Claude Code

下文采用 `Git Bash` 作为示例。若你使用 `WSL`，可沿用相同的 AIOAGI 接入参数。

## 安装步骤

<Steps>
  <Step title="安装 Node.js">
    安装 Node.js LTS 版本。安装完成后，在终端执行 `node --version` 和 `npm --version`，确认命令可以正常返回版本号。
  </Step>

  <Step title="安装 Git for Windows">
    安装 Git for Windows。完成后在 PowerShell 或 `Git Bash` 中执行 `git --version`，确认 Git 已可用。
  </Step>

  <Step title="安装 Claude Code">
    打开 `Git Bash`，执行下面的命令安装 Claude Code：

    ```bash theme={null}
    npm install -g @anthropic-ai/claude-code
    ```

    安装后执行下面两个命令确认安装结果：

    ```bash theme={null}
    claude --version
    claude doctor
    ```
  </Step>

  <Step title="创建 AIOAGI API Key">
    登录 AIOAGI 控制台，在 **令牌管理** 中创建可用于 Claude 模型的 API Key。确认令牌分组和额度设置满足当前模型调用需求。
  </Step>

  <Step title="写入 settings.json">
    使用用户级 `settings.json` 把 Claude Code 指向 AIOAGI。该配置会应用到当前用户的所有 Claude Code 会话。
  </Step>

  <Step title="启动 Claude Code">
    重新打开 `Git Bash`，进入你的项目目录，执行 `claude`。首次接入时先发一个简单问题，确认模型能正常返回内容。
  </Step>
</Steps>

## 安装界面示例

<Frame>
  <img src="https://mintcdn.com/aioagi/bRZH7qujHkk2cLE_/images/claude-code/nodejs-download.png?fit=max&auto=format&n=bRZH7qujHkk2cLE_&q=85&s=f5497bc6f37415623a97138ed45df70c" alt="Node.js 下载页面示例" width="1080" height="600" data-path="images/claude-code/nodejs-download.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/aioagi/bRZH7qujHkk2cLE_/images/claude-code/token-management.png?fit=max&auto=format&n=bRZH7qujHkk2cLE_&q=85&s=cbd223c267540b78626ca39ec116fd3a" alt="AIOAGI 控制台令牌管理界面示例" width="1080" height="305" data-path="images/claude-code/token-management.png" />
</Frame>

## Claude Code settings.json 配置

Claude Code 可以从 `settings.json` 读取环境变量和默认模型。Windows 中的用户级配置路径是 `%USERPROFILE%\.claude\settings.json`。在 `Git Bash` 或 `WSL` 中，它对应 `~/.claude/settings.json`。

先在 PowerShell 中创建配置目录并打开配置文件：

```powershell theme={null}
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null
notepad "$env:USERPROFILE\.claude\settings.json"
```

写入下面的内容，并把 `ANTHROPIC_AUTH_TOKEN` 改成你的 AIOAGI API Key：

```json theme={null}
{
  "env": {
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_BASE_URL": "https://api.aiearth.dev/",
    "ANTHROPIC_AUTH_TOKEN": "sk-",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  },
  "model": "sonnet[1m]"
}
```

保存后关闭所有已打开的 `Git Bash`、PowerShell 和 VS Code 终端，再重新打开项目目录执行 `claude`。

如果你的网络更适合 CDN 加速线路，也可以把 `ANTHROPIC_BASE_URL` 改成 `https://api.aiearth.vip/`。端点、模型名和支持策略可能变化，请以控制台和开发者指南显示的信息为准。

如需只让某个项目使用独立配置，可在项目目录写入 `.claude/settings.local.json`。不要把包含真实 API Key 的 `.claude/settings.json`、`.claude/settings.local.json` 或截图提交到公开仓库。

<Warning>
  `ANTHROPIC_MODEL` 和 `model` 应填写控制台当前可用的 Claude 系列模型 ID 或别名。模型名会随平台策略变化，请先在控制台或开发者指南中确认后再配置。
</Warning>

## 启动和验证

进入你的代码项目后，执行：

```bash theme={null}
claude
```

你可以先用下面这类简单提示词验证接入是否成功：

```text theme={null}
请先阅读当前仓库结构，再总结主要目录和入口文件。
```

如果 Claude Code 能正常读取仓库并返回结果，说明 CLI 安装、环境变量和 API Key 已基本可用。

## 集成到 VS Code

安装好 Claude Code CLI 后，你可以在 VS Code 中安装 Claude Code 扩展。

<Steps>
  <Step title="打开扩展面板">
    在 VS Code 中点击 **Extensions**，搜索 `Claude Code`。
  </Step>

  <Step title="安装扩展">
    安装 Claude Code 官方扩展，然后重载 VS Code。
  </Step>

  <Step title="打开项目">
    在 VS Code 中打开你的项目目录，并确认本机 `Git Bash` 和 Claude Code CLI 都已安装完成。
  </Step>

  <Step title="验证集成">
    先在 VS Code 集成终端里执行 `claude`，再使用扩展入口检查是否能正常调用 Claude Code。
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/aioagi/bRZH7qujHkk2cLE_/images/claude-code/vscode-extension.png?fit=max&auto=format&n=bRZH7qujHkk2cLE_&q=85&s=de59a9fa312ff565013e2a2f357c890f" alt="VS Code 中安装 Claude Code 扩展示例" width="1080" height="644" data-path="images/claude-code/vscode-extension.png" />
</Frame>

## 常见问题

<AccordionGroup>
  <Accordion title="执行 `claude` 提示命令不存在" icon="terminal">
    关闭并重新打开 `Git Bash`。如果问题仍在，检查 `npm install -g @anthropic-ai/claude-code` 是否成功，再执行 `npm prefix -g` 和 `claude --version` 确认全局安装路径是否生效。
  </Accordion>

  <Accordion title="Claude Code 启动后认证失败或返回 403" icon="key">
    检查 `~/.claude/settings.json` 是否是合法 JSON，并确认 `ANTHROPIC_BASE_URL`、`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_MODEL` 和 `model` 是否填写正确。再检查 Token 组是否支持当前模型，并确认是否需要切换网络线路。你也可以继续参考 [常见问题](/faq) 中的 Claude Code 排障条目。
  </Accordion>

  <Accordion title="配置后仍未生效" icon="gear">
    如果配置后仍未生效，或仍返回 Anthropic 官方接口的认证、验证错误，请先完全关闭并重新打开 `Git Bash`、`WSL` 终端和 VS Code。再执行 `claude` 重新测试。如果仍不生效，请重启当前主机后再测试。问题仍存在时，可以通过微信或 QQ 联系平台管理员协助排查。
  </Accordion>

  <Accordion title="Windows 原生终端里行为异常" icon="laptop">
    Anthropic 官方更推荐在 Windows 上使用 `WSL` 或 `Git Bash`。如果你使用的是便携版 Git，可按官方说明设置 `CLAUDE_CODE_GIT_BASH_PATH` 指向 `bash.exe`。
  </Accordion>

  <Accordion title="模型名不生效或不可用" icon="sparkles">
    先到控制台确认当前 API Key 可访问的 Claude 模型列表，再核对模型 ID 是否完全一致。如果平台近期调整了模型别名或支持策略，请以控制台和开发者指南最新信息为准。
  </Accordion>
</AccordionGroup>

## 使用建议

* 先用小额度 API Key 完成安装和连通性测试，再切换到正式使用的 Token 组
* 第一次接入时优先测试读取仓库、解释文件和生成简单补丁
* 长期在 Windows 上开发时，建议固定使用同一种终端方案
* 如果你更关注稳定性，可以直接改用 `WSL`

## 相关文档

* [Anthropic: Set up Claude Code](https://docs.anthropic.com/en/docs/claude-code/getting-started)
* [Anthropic: LLM gateway configuration](https://docs.anthropic.com/en/docs/claude-code/llm-gateway)
* [Anthropic: Claude Code settings](https://docs.anthropic.com/en/docs/claude-code/settings)