Claude Code
Claude Code 是一款运行在终端的 AI 编程智能体,它能够直接读取本地代码库,通过自然语言与开发者交互,并自主完成代码阅读、多文件修改、运行测试及执行命令等复杂开发任务。
当您安装 Claude Code 之后,无需登录 Anthropic 账号,按照如下操作配置自定义模型即可使用。
准备工作

配置步骤
我们以 Claude Code-v2.1.170 版本为例。
配置字段对照表
| 环境变量 | 解释 |
|---|---|
| ANTHROPIC_BASE_URL | 大模型 Base URL,在 AI 控制台中获取 |
| ANTHROPIC_AUTH_TOKEN | 调用大模型 API Key,在 AI 控制台中获取 |
| ANTHROPIC_MODEL | 大模型 ID,在 AI 控制台 模型列表复制已启用的大模型标识填入 |
- 文件配置(永久生效)
- 临时环境变量(临时生效)
- 打开或创建你的 Claude Code 配置文件
备注
如果通过您文件浏览器找到文件,文件浏览器默认会隐藏掉以"."开头的文件名的文件,您可能需要打开文件浏览器的隐藏文件选项才能看到。
Mac 通过访达快捷键 Command + Shift + . 打开。Windows 可以通过勾选 "文件资源管理器 - 查看 - 显示 - 隐藏项目"打开。如果找不到文件,请确认 Claude Code 已经安装并打开过一次。
Mac/Linux(~ 代表您当前的用户目录)
~/.claude/settings.json
Windows
C:\Users\你的用户名\.claude\settings.json
- 新增或替换
env字段如下
{
"env": {
"ANTHROPIC_BASE_URL": "https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase",
"ANTHROPIC_AUTH_TOKEN": "eyJhbGciOiJSUzI1N...",
"ANTHROPIC_MODEL": "hy3-preview"
}
}
如果您只想临时体验云开发大模型的能力,请优先选择在终端命令临时注入环境变量,关闭终端即配置失效。
当您同时通过 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-preview"
Windows CMD 用法(当前窗口一直有效)
set ANTHROPIC_BASE_URL=https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase
set ANTHROPIC_AUTH_TOKEN=eyJhbGciOiJSUzI1N...
set ANTHROPIC_MODEL=hy3-preview
Windows PowerShell 用法(当前窗口一直有效)
$env:ANTHROPIC_BASE_URL = "https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase"
$env:ANTHROPIC_AUTH_TOKEN = "eyJhbGciOiJSUzI1N..."
$env:ANTHROPIC_MODEL = "hy3-preview"
更多配置
您可以在 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 控制台 中启用 |