集成

快速配置你常用的 AI 编程工具——从 CLI 编程代理到 IDE 插件，几步即可接入 WisGate 模型。

Claude Code

Anthropic 官方 CLI 编程代理，支持 WisGate 作为 Anthropic 兼容端点。

Claude Code

Claude Code 是一个在终端中运行的智能编程代理。通过接入 WisGate，开发者可以在 Claude Code 中使用 WisGate 提供的 Anthropic 兼容接口完成代码生成、调试、重构、项目分析和自动化开发任务。

步骤一：安装 Claude Code

前提条件：

您需要安装 Node.js 18 或更新版本环境
MacOS 用户推荐使用 nvm 方式安装 Nodejs
Windows 用户还需安装 Git for Windows

进入命令行界面，安装 Claude Code：

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

运行如下命令，查看安装结果，若显示版本号则表示安装成功：

claude --version

步骤二：配置 WisGate

1. 注册账号

访问 WisGate 开放平台，完成账号注册流程。

2. 获取 API Key

在 WisGate 控制台中创建并获取您的 API Key。

3. 配置 Claude Code 环境变量

编辑或新增 settings.json 文件：

MacOS & Linux 为 ~/.claude/settings.json
Windows 为 用户目录/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_wisgate_api_key",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_BASE_URL": "https://api.wisgate.cn",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

其中 ANTHROPIC_BASE_URL 使用 WisGate 的 Anthropic 兼容入口 https://api.wisgate.cn，不要填写 OpenAI 兼容入口 https://api.wisgate.cn/v1。ANTHROPIC_API_KEY 建议显式置空，避免 Claude Code 继续读取旧的 Anthropic Key。

再编辑或新增 .claude.json 文件：

MacOS & Linux 为 ~/.claude.json
Windows 为 用户目录/.claude.json

{
  "hasCompletedOnboarding": true
}

如果您之前已经用 Anthropic 账号登录过 Claude Code，请先在 Claude Code 中执行一次 /logout，然后关闭当前会话并重新打开终端，避免缓存登录态与 WisGate API Key 冲突。

步骤三：开始使用 Claude Code

配置完成后，进入一个您的代码工作目录，在终端中执行 claude 命令即可开始使用。

若遇到「Do you want to use this API key」选择 Yes 即可。进入 Claude Code 后，可以执行 /status 检查当前连接状态，确认 Auth token 使用 ANTHROPIC_AUTH_TOKEN，Base URL 为 https://api.wisgate.cn。

WisGate 使用场景

代码生成：在 Claude Code 中描述需求，让模型生成函数、页面、脚本或配置文件。
代码调试：让 Claude Code 读取报错、定位原因，并通过 WisGate 模型辅助修复问题。
项目重构：在大型代码库中拆分模块、优化命名、整理依赖和减少重复逻辑。
测试补全：根据现有业务逻辑生成单元测试、集成测试或边界用例。
团队统一接入：团队成员统一使用 WisGate API Key 和模型配置，便于后续管理模型调用和成本。

常见问题

如何切换使用模型

直接通过调整配置文件的方式（位于 ~/.claude/settings.json）来指定不同任务使用的 WisGate 模型：

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8"
  }
}

Claude Code 对 Anthropic 系列模型兼容性最好。建议优先选择 WisGate 上支持 Anthropic Messages 格式的 Claude 模型。

如何验证 WisGate 是否接入成功

在 Claude Code 内执行：

/status

若状态中显示 ANTHROPIC_AUTH_TOKEN 和 https://api.wisgate.cn，说明 Claude Code 已经通过 WisGate 连接。

手工修改配置不生效

关闭所有 Claude Code 窗口，重新打开一个新的命令行窗口，再次运行 claude 启动
如果之前登录过 Anthropic 账号，请先执行 /logout 清理缓存登录态
确认系统环境中没有残留真实的 ANTHROPIC_API_KEY，或已在 settings.json 中设置为空字符串
确认配置文件的 JSON 格式是否正确