客户端集成Windows

Claude Code

使用 Anthropic 原生协议接入 Claude Code

1安装 Claude Code

打开 PowerShell，安装 Claude Code。Windows 还需要提前安装 Git for Windows。

npminstall -g @anthropic-ai/claude-code

2创建 settings.json

个人配置放在用户目录中，对所有项目生效。如果目录还不存在，先创建目录，再用记事本打开配置文件。

mkdirC:\Users\<用户名>\.claude

notepadC:\Users\<用户名>\.claude\settings.json

先备份现有文件，将以下字段合并进去，保留原有 permissions、hooks 和其他设置。把 YOUR_API_KEY 换成控制台 API Key；JSON 不允许注释或尾逗号。

C:\Users\<用户名>\.claude\settings.json

{  "$schema": "https://json.schemastore.org/claude-code-settings.json",  "env": {    "ANTHROPIC_BASE_URL": "https://www.yunqiai.chat",    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-4-6"  },  "model": "claude-sonnet-4-6"}

示例模型仅用于展示字段；主模型、别名映射和子代理模型由客户确定。每个实际使用的型号都需要对应调用权限。

3启动 Claude Code

进入你的项目目录后启动 Claude Code。配置文件保存后，新的会话会自动读取 YunQi 地址与模型。

claude

VS Code、WSL 与远程环境

配置要放在实际运行 Claude Code 的环境。Windows 本机用户目录为 %USERPROFILE%；macOS、Linux、WSL 或 SSH 主机为该环境的 ~。WSL 不会自动使用 Windows 用户目录中的配置。

VS Code 使用 Remote SSH、WSL 或容器时，先确认扩展运行在本地还是远程，再修改对应环境的配置。更新环境变量后完全退出并重新启动 VS Code 和客户端；在集成终端中设置变量，不会反向更新已启动的扩展进程。

保留现有项目设置。检查项目级配置、系统环境变量和组织策略是否覆盖用户配置；不要为排查连接问题关闭工具权限或安全检查。

在新会话中用 /status 检查设置来源，用 /model 检查型号。ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_API_KEY 只保留一种 YunQi 鉴权来源，避免旧值冲突。Claude 网页版聊天不通过此本地配置接入。

配置字段参考：Claude Code 设置。