唯元智创 Claude Code 配置指南

适用范围：使用 Claude Code CLI、VS Code 插件或 Cursor 插件接入唯元智创 AI 网关平台。

项目	配置值
更新时间	2026-06-04
推荐 CLI 版本	Claude Code 2.1.152
唯元智创平台接口	https://token.wy.cn/v1
Claude Code 配置值	ANTHROPIC_BASE_URL 使用 https://token.wy.cn
默认模型	claude-4-6-sonnet

重要说明唯元智创平台对外 Base URL 为 https://token.wy.cn/v1；但 Claude Code 会自动拼接 /v1/messages，因此 settings.json 中 ANTHROPIC_BASE_URL 必须填写 https://token.wy.cn，不能带 /v1。

一、安装

通过 npm 安装 Claude Code。建议固定安装 stable 版本 2.1.152，以获得更稳定的唯元智创网关兼容性。

npm install -g @anthropic-ai/claude-code@2.1.152
claude --version

期望输出：

2.1.152 (Claude Code)

![图片](唯元智创 Claude Code 配置指南.assets/image-983d13139c-1.png)

图 1：安装并固定 Claude Code 版本

二、启动与访问

2.1 配置前注意点

Claude Code 2.x 在首次启动时会检查 onboarding 状态。为避免卡在登录或验证环节，可在用户主目录的 .claude.json 中写入 hasCompletedOnboarding。

项目	配置值
macOS 路径	~/.claude.json
Windows 路径	C:\Users\用户名.claude.json

{
  "hasCompletedOnboarding": true
}

![图片](唯元智创 Claude Code 配置指南.assets/image-5e961994a3-1.png)

图 2：确认 onboarding 配置

2.2 配置唯元智创 AI 网关平台

在用户级 settings.json 中配置唯元智创 AI 网关平台。

配置项包括 token、接口地址和默认模型。

VS Code/Cursor 插件也会读取这份配置。

项目	配置值
macOS 路径	~/.claude/settings.json
Windows 路径	C:\Users\用户名.claude\settings.json

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-4-6-sonnet",
  "availableModels": [
    "claude-4-6-sonnet",
    "claude-4-6-opus",
    "claude-4.5-haiku",
    "sonnet",
    "opus",
    "haiku"
  ],
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{AIGateway_Token}",
    "ANTHROPIC_BASE_URL": "https://token.wy.cn",
    "ANTHROPIC_MODEL": "claude-4-6-sonnet",
    "ANTHROPIC_REASONING_MODEL": "claude-4-6-sonnet",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-4-6-sonnet",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-4-6-opus",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-4.5-haiku",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

![图片](唯元智创 Claude Code 配置指南.assets/image-e35fcbb4c1-1.png)

图 3：配置唯元智创 AI 网关平台 settings.json（token 已脱敏）

Token 管理提醒文档不包含真实 token。请从唯元智创平台控制台或管理员处获取 AI 网关 token，并将 {AIGateway_Token} 替换为实际凭据。

2.3 一键写入示例

macOS / Linux

如需在 macOS 或 Linux 上快速生成配置，可参考以下命令。

mkdir -p ~/.claude
cat > ~/.claude.json <<'JSON'
{
  "hasCompletedOnboarding": true
}
JSON

cat > ~/.claude/settings.json <<'JSON'
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-4-6-sonnet",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{AIGateway_Token}",
    "ANTHROPIC_BASE_URL": "https://token.wy.cn",
    "ANTHROPIC_MODEL": "claude-4-6-sonnet",
    "ANTHROPIC_REASONING_MODEL": "claude-4-6-sonnet",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-4-6-sonnet",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-4-6-opus",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-4.5-haiku",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
JSON

chmod 600 ~/.claude.json ~/.claude/settings.json

Windows PowerShell

如需在 Windows 上快速生成配置，可在 PowerShell 中执行以下命令。

$ClaudeDir = Join-Path $HOME ".claude"
New-Item -ItemType Directory -Force -Path $ClaudeDir | Out-Null

@'
{
  "hasCompletedOnboarding": true
}
'@ | Set-Content -Encoding UTF8 (Join-Path $HOME ".claude.json")

@'
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-4-6-sonnet",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{AIGateway_Token}",
    "ANTHROPIC_BASE_URL": "https://token.wy.cn",
    "ANTHROPIC_MODEL": "claude-4-6-sonnet",
    "ANTHROPIC_REASONING_MODEL": "claude-4-6-sonnet",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-4-6-sonnet",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-4-6-opus",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-4.5-haiku",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
'@ | Set-Content -Encoding UTF8 (Join-Path $ClaudeDir "settings.json")

三、Claude 使用

打开命令行终端，cd 进入需要 Claude Code 读取和修改的工作目录。

运行 claude 启动交互式会话。

首次执行文件读取、编辑或 shell 命令时，根据团队安全要求授权对应权限。

如需临时指定模型，可使用 --model claude-4-6-sonnet。

cd 你的工作目录路径
claude

# 非交互验证
claude -p 'Reply with OK only.' --model claude-4-6-sonnet

验证成功时应返回：

OK

![图片](唯元智创 Claude Code 配置指南.assets/image-d5b95a3d77-1.png)

图 4：验证唯元智创 AI 网关平台连通性

模型切换：进入 Claude Code 后可输入 /model，并选择唯元智创平台已开放的模型。

四、VS Code / Cursor 插件配置及使用

在 VS Code 或 Cursor 插件市场中搜索 Claude Code 并安装官方插件，扩展 ID 为 anthropic.claude-code。建议将插件版本固定到 2.1.152。

code --install-extension anthropic.claude-code@2.1.152 --force
cursor --install-extension anthropic.claude-code@2.1.152 --force

![图片](唯元智创 Claude Code 配置指南.assets/image-8da26c8063-1.png)

图 5：VS Code 扩展页与 Claude Code 面板

如果本机没有 code 或 cursor 命令，可使用应用内置 CLI，或在插件市场中手动选择对应版本安装。

用户设置建议如下。

插件会优先使用 Claude Code 的全局 settings.json。

environmentVariables 可作为编辑器启动时的备用配置。

项目	配置值
VS Code settings	~/Library/Application Support/Code/User/settings.json
Cursor settings	~/Library/Application Support/Cursor/User/settings.json

"claudeCode.disableLoginPrompt": true,
"claudeCode.useTerminal": true,
"claudeCode.preferredLocation": "panel",
"extensions.autoUpdate": false,
"extensions.autoCheckUpdates": false

打开方式：重启编辑器后，通过命令面板运行 Claude Code: Open。若提示检测到自定义 API key，请选择 Yes。

五、可用性汇总

测试场景	测试方式	验证能力	唯元智创平台
启动连接	配置 API 后启动 claude	API 认证、基础连通	YES
基础对话	发送“你好”或简单问题	流式响应、SSE 格式	YES
阅读文件	读取某个代码文件	Tool Use 单工具调用	YES
编辑文件	修改已有文件	Tool Use + 多轮交互	YES
执行命令	执行 shell 命令	Bash 工具调用	YES
复杂任务	读取、分析、修改多步骤任务	多工具连续调用、长上下文	YES
IDE 插件	VS Code / Cursor 中打开 Claude Code	编辑器内启动和对话	YES

六、常见问题

6.1 为什么 settings.json 里不是 https://token.wy.cn/v1？

因为 Claude Code SDK 会自动拼接 /v1/messages。如果配置为 https://token.wy.cn/v1，实际请求会变成 https://token.wy.cn/v1/v1/messages，从而返回 404。

6.2 为什么推荐 2.1.152？

2.1.152 为当前推荐的 stable 版本，已完成 CLI 与 VS Code/Cursor 插件场景验证。若后续需要升级版本，建议先在测试环境验证网关兼容性。

6.3 VS Code 插件仍返回 API Error: 400 怎么办？

确认全局 claude --version 为 2.1.152。

确认 VS Code/Cursor 插件版本为 anthropic.claude-code@2.1.152。

执行 Developer: Reload Window 或完全退出编辑器后重新打开。

确认旧的 anthropic.claude-code-2.1.162 扩展目录已移除或未被加载。

Claude Code 配置指南

唯元智创 Claude Code 配置指南#

一、安装#

二、启动与访问#

2.1 配置前注意点#

2.2 配置唯元智创 AI 网关平台#

2.3 一键写入示例#

macOS / Linux#

Windows PowerShell#

三、Claude 使用#

四、VS Code / Cursor 插件配置及使用#

五、可用性汇总#

六、常见问题#

6.1 为什么 settings.json 里不是 https://token.wy.cn/v1？#

6.2 为什么推荐 2.1.152？#

6.3 VS Code 插件仍返回 API Error: 400 怎么办？#