准备工作
- Node.js 18 或更高版本:在终端输入
node -v查看版本。 - 零点数据 API Key:登录控制台,在「令牌」页面新建一个,以
sk-开头。 - 模型名称:在控制台的模型列表里复制你要用的模型名称。
本文示例里的模型名称 deepseek-v3.2 只是示例,请换成控制台模型列表里显示的准确名称。
Claude Code 是 Anthropic 公司的软件,下载和使用受其许可条款约束。本教程只介绍如何让它调用零点数据接入的国产模型; 零点数据不提供 Claude 模型,与 Anthropic 不存在合作或授权关系。
1安装 Claude Code
在终端运行:
npm install -g @anthropic-ai/claude-code
国内网络下载慢的话,可以临时换成国内镜像源:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
安装完成后运行 claude --version,能看到版本号就说明安装成功。
2写入配置
推荐把配置写进 Claude Code 的用户配置文件,这样每次打开终端都会自动生效。文件位置:
- macOS / Linux:
~/.claude/settings.json - Windows:
C:\Users\你的用户名\.claude\settings.json
文件不存在就新建一个,写入下面的内容(把 Key 和模型名称换成你自己的):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.gxxai.cn",
"ANTHROPIC_AUTH_TOKEN": "sk-你的API Key",
"ANTHROPIC_MODEL": "deepseek-v3.2",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v3.2"
}
}
| 配置项 | 含义 |
|---|---|
ANTHROPIC_BASE_URL |
接口地址。填 https://api.gxxai.cn,末尾不要加 /v1,Claude Code 会自己拼上。 |
ANTHROPIC_AUTH_TOKEN |
你的零点数据 API Key。 |
ANTHROPIC_MODEL |
主力模型,负责写代码、改文件。 |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
后台轻量任务用的模型(如生成标题、摘要)。可以填同一个模型,也可以填更便宜、更快的模型。 |
临时使用:只在当前终端生效
如果只想试一试,也可以不改配置文件,直接在终端里设置环境变量。关闭终端后失效。
export ANTHROPIC_BASE_URL="https://api.gxxai.cn"
export ANTHROPIC_AUTH_TOKEN="sk-你的API Key"
export ANTHROPIC_MODEL="deepseek-v3.2"
claude
$env:ANTHROPIC_BASE_URL="https://api.gxxai.cn"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的API Key"
$env:ANTHROPIC_MODEL="deepseek-v3.2"
claude
两种方式只选一种。如果之前用 export 设置过同名变量,又改了配置文件,两处的值不一样时容易混乱。
3启动并验证
- 在终端进入你的项目目录,例如
cd ~/my-project。 - 输入
claude启动。 - 输入一个简单的问题,比如“用一句话介绍这个项目”,能正常回答就说明接通了。
- 回到零点数据控制台的使用日志,可以看到这次调用的模型和 Token 用量。
4模型怎么选
Claude Code 会频繁让模型“调用工具”:读文件、搜索代码、执行命令、修改文件。所以选模型时重点看两点:
- 工具调用能力:模型能否稳定地按要求调用工具,直接决定 Claude Code 好不好用。
- 上下文长度:项目越大,一次要看的代码越多,上下文长的模型更不容易“忘事”。
国产模型里,Kimi、GLM、DeepSeek 的新版本都在编程场景上做过专门优化,可以分别试用后再定。 具体有哪些版本、价格多少,以控制台的模型列表为准。
Claude Code 每一步都会把相关代码发给模型,Token 消耗比普通聊天大得多。建议在控制台给这个 Key 单独设置额度上限,避免意外超支。
常见问题
启动后还是要求登录 Anthropic 账号怎么办?
先确认 ANTHROPIC_AUTH_TOKEN 已经生效:配置文件要放在正确位置,并且 JSON 格式正确(逗号、引号不能少)。
如果配置无误、首次启动仍停在登录引导页,可以打开用户目录下的 .claude.json 文件,
加入 "hasCompletedOnboarding": true 后重新启动。不同版本的 Claude Code 行为可能略有差异。
提示 401 或无效的令牌
API Key 填错了,或复制时多带了空格。回控制台「令牌」页面重新复制即可。
提示 404
检查 ANTHROPIC_BASE_URL:应该是 https://api.gxxai.cn,末尾不要带 /v1,
否则请求地址会变成 /v1/v1/messages。
提示模型不存在或无可用渠道
模型名称拼错了,或这个 Key 没有开放该模型。从控制台模型列表直接复制名称,注意大小写和连字符。
改了配置文件但没生效
完全退出 Claude Code 后重新启动;如果终端里还留着旧的 export 变量,关掉这个终端窗口重新打开。
费用怎么算?
按实际消耗的 Token 计费,不同模型单价不同。每次调用的用量和费用都能在控制台的使用日志里查到。