Claude Code

Claude Code 是一款运行在终端的 AI 编程智能体，它能够直接读取本地代码库，通过自然语言与开发者交互，并自主完成代码阅读、多文件修改、运行测试及执行命令等复杂开发任务。

当您安装 Claude Code 之后，无需登录 Anthropic 账号，按照如下操作配置自定义模型即可使用。

准备工作

• 已开通云开发环境，获取环境ID cloudBase环境ID
• 在 AI 控制台中开启所需模型
• 在 AI 控制台中获取 Base URL 和 API Key

Base URLhttps://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/cloudbase

配置步骤

我们以 Claude Code-v2.1.170 版本为例。

配置字段对照表

环境变量	解释
ANTHROPIC_BASE_URL	大模型 Base URL，在 AI 控制台中获取
ANTHROPIC_AUTH_TOKEN	调用大模型 API Key，在 AI 控制台中获取
ANTHROPIC_MODEL	主会话使用的大模型 ID，在 AI 控制台 模型列表复制已启用的大模型标识填入
ANTHROPIC_DEFAULT_OPUS_MODEL	Opus 大模型 ID，在 AI 控制台 模型列表复制已启用的大模型标识填入
ANTHROPIC_DEFAULT_SONNET_MODEL	Sonnet 大模型 ID，在 AI 控制台 模型列表复制已启用的大模型标识填入
ANTHROPIC_DEFAULT_HAIKU_MODEL	Haiku 大模型 ID，在 AI 控制台 模型列表复制已启用的大模型标识填入

CC Switch 配置

CC Switch 是一款开源的桌面应用，统一管理多个 AI 编程工具的供应商配置。安装方式参考 CC Switch 配置文档。

1. 打开 CC Switch，添加云开发供应商

字段	说明
API Key	在 AI 控制台 中获取
Base URL	https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase
API 格式	Anthropic Messages（默认）

2. 切换启用云开发供应商，启动 Claude Code 即可使用

文件配置（永久生效）

1. 打开或创建你的 Claude Code 配置文件

备注

如果通过您文件浏览器找到文件，文件浏览器默认会隐藏掉以"."开头的文件名的文件，您可能需要打开文件浏览器的隐藏文件选项才能看到。

Mac 通过访达快捷键 Command + Shift + . 打开。Windows 可以通过勾选 "文件资源管理器 - 查看 - 显示 - 隐藏项目"打开。如果找不到文件，请确认 Claude Code 已经安装并打开过一次。

Mac/Linux（~ 代表您当前的用户目录）

~/.claude/settings.json

Windows

C:\Users\你的用户名\.claude\settings.json

2. 新增或替换 env 字段，比如想简单任务使用 haiku 模式时使用 hy3 代替，sonnet 模式使用 deepseek-v4-pro[1m] 代替，opus 模式使用 glm-5.2[1m] 代替，配置示例如下：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase",
    "ANTHROPIC_AUTH_TOKEN": "eyJhbGciOiJSUzI1N...",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "hy3",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro-202606[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2[1m]"
  }
}

临时环境变量（临时生效）

如果您只想临时体验云开发大模型的能力，请优先选择在终端命令临时注入环境变量，关闭终端即配置失效。 当您同时通过 setting.json 配置 env 字段时，Claude Code 会优先读取临时注入的环境变量。

Mac/Linux 用法（当前窗口一直有效）

export ANTHROPIC_BASE_URL="https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase"
export ANTHROPIC_AUTH_TOKEN="eyJhbGciOiJSUzI1N..."
export ANTHROPIC_MODEL="hy3"

Windows CMD 用法（当前窗口一直有效）

set ANTHROPIC_BASE_URL=https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase
set ANTHROPIC_AUTH_TOKEN=eyJhbGciOiJSUzI1N...
set ANTHROPIC_MODEL=hy3

Windows PowerShell 用法（当前窗口一直有效）

$env:ANTHROPIC_BASE_URL = "https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase"
$env:ANTHROPIC_AUTH_TOKEN = "eyJhbGciOiJSUzI1N..."
$env:ANTHROPIC_MODEL = "hy3"

更多配置

您可以在 Claude Code 官网查询更多模型的配置指令

备注

接入第三方模型后，Claude Code 内置的联网搜索功能不可用。如需搜索能力，可通过 MCP 接入云开发 AI 搜索服务。

使用方式

终端切到指定目录下，输入 claude 命令即可使用配置的自定义云开发大模型，更多命令和功能，您可参考官方文档

claude

常见错误排查

报错信息	解决方法
429 Token usage exceeded quota limit	Token 消耗完，或者未启用
401 Credentials are invalid	API Key 填写错误，或者可能被删除
429 API Error: Request rejected	配置了错误的大模型名称，或者大模型未在 AI 控制台 中启用