准备工作

本文示例里的模型名称 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 的用户配置文件,这样每次打开终端都会自动生效。文件位置:

文件不存在就新建一个,写入下面的内容(把 Key 和模型名称换成你自己的):

settings.json
{
  "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 后台轻量任务用的模型(如生成标题、摘要)。可以填同一个模型,也可以填更便宜、更快的模型。

临时使用:只在当前终端生效

如果只想试一试,也可以不改配置文件,直接在终端里设置环境变量。关闭终端后失效。

macOS / Linux
export ANTHROPIC_BASE_URL="https://api.gxxai.cn"
export ANTHROPIC_AUTH_TOKEN="sk-你的API Key"
export ANTHROPIC_MODEL="deepseek-v3.2"
claude
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.gxxai.cn"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的API Key"
$env:ANTHROPIC_MODEL="deepseek-v3.2"
claude

两种方式只选一种。如果之前用 export 设置过同名变量,又改了配置文件,两处的值不一样时容易混乱。

3启动并验证

  1. 在终端进入你的项目目录,例如 cd ~/my-project。
  2. 输入 claude 启动。
  3. 输入一个简单的问题,比如“用一句话介绍这个项目”,能正常回答就说明接通了。
  4. 回到零点数据控制台的使用日志,可以看到这次调用的模型和 Token 用量。

4模型怎么选

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 计费,不同模型单价不同。每次调用的用量和费用都能在控制台的使用日志里查到。