接入指南

接入 Claude Code

在 Claude Code 中把模型调用切换到 UWCode 统一网关。

接入 Claude Code

Claude Code 支持通过环境变量将请求路由到代理或网关。接入 UWCode 后，企业可以按员工、项目或部门分配 Key，并在控制台查看 Claude Code 的调用量、Token 消耗、失败率与审计日志。

重要前提

Claude Code 使用 Claude / Anthropic API 形态，不是普通 OpenAI chat/completions 客户端。上线前请确认：

  1. UWCode 已为租户开启 Claude Code 兼容通道。
  2. 管理员已在控制台为员工或项目创建独立 Key。
  3. 该 Key 已授权可用于 Claude Code 所需模型。

配置步骤

  1. 在 控制台 创建一个面向研发的 API Key。
  2. 在 UWCode 控制台复制 Claude Code 接入地址。公共云示例为：
export ANTHROPIC_BASE_URL=https://api.uwcode.com/v1
export ANTHROPIC_API_KEY=uwc-xxxxxxxx
  1. 如需在终端长期生效，可写入 ~/.zshrc、~/.bashrc 或企业统一终端配置。
  2. 重新打开终端并启动 Claude Code。
claude

可选模型配置

如果企业在 UWCode 中使用了自定义模型别名，可以通过 Claude Code 的模型环境变量固定默认模型。

export ANTHROPIC_MODEL=claude-sonnet-4-5

如果使用网关转发后需要继续启用 MCP 工具搜索，请确认 UWCode 兼容并转发对应工具引用字段，再按 Claude Code 官方说明启用相关开关。

验证

claude --version
claude -p "用一句话说明当前项目用途"

调用完成后，在 UWCode 控制台检查：

  • 调用日志 出现员工 Key 的请求。
  • 用量统计 中有对应 Token 消耗。
  • 状态码 为成功，失败率没有异常升高。

常见问题

  • 看不到用量？ 确认 Base URL 已指向 UWCode，且 Key 未被禁用。
  • 被限流？ 检查该 Key 所属项目的预算与限额设置。
  • MCP 工具搜索不可用？ Claude Code 在非官方主机下会对部分能力采取更保守策略，应确认网关支持并转发相关字段。
  • 仍使用个人订阅额度？ 确认启动终端中存在 ANTHROPIC_API_KEY，并已重新启动 Claude Code。

官方依据