Claude Code

一、产品简介

Claude Code 是 Anthropic 官方推出的终端 AI 编程客户端。通过 GravitexAI（兼容 Anthropic 接口）你可以：

一键接入多家模型

通过同一接口使用 Claude 全系列、Kimi K2、GPT 等模型

双线程模型架构

主线程跑重任务，副线程跑轻量补全，节省成本

无需订阅

按 token 计费，不依赖 Claude Pro 订阅

国内可用

分布式节点 + 自动故障转移，网络稳定

二、安装 Node.js（已安装可跳过）

确保 Node.js 版本 ≥ 18.0。

Windows
macOS
Ubuntu / Debian

下载安装包：https://nodejs.org/dist/v22.18.0/node-v22.18.0-x64.msi

sudo xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node
node --version

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs
node --version

卸载其他中转客户端（可选）

如果之前安装过其他中转版本的 @anthropic-ai/claude-code，建议先卸载干净：

# 检查安装位置
npm ls @anthropic-ai/claude-code
npm ls -g @anthropic-ai/claude-code

# 执行卸载
npm uninstall @anthropic-ai/claude-code
npm uninstall -g @anthropic-ai/claude-code

三、安装 Claude Code

全局安装

npm install -g @anthropic-ai/claude-code

验证安装

claude --version

四、获取 GravitexAI 密钥

登录控制台

访问 GravitexAI 控制台。

创建密钥

进入密钥管理 → 创建新令牌。

记录信息

base_url = "https://api.gravitex.ai"
api_key  = "sk-zbTYx*******************************fceTvn5"

注意：Claude Code 的 ANTHROPIC_BASE_URL 不需要带 /v1 后缀，直接使用 https://api.gravitex.ai 即可。

五、配置环境变量

1. 基础配置示例（单模型）

Mac / Linux
Windows CMD
Windows PowerShell

export ANTHROPIC_BASE_URL="https://api.gravitex.ai"
export ANTHROPIC_AUTH_TOKEN="sk-zbTYx*******************************fceTvn5"
export ANTHROPIC_MODEL="kimi-k2-250905"
cd your-project-folder
claude

set ANTHROPIC_BASE_URL=https://api.gravitex.ai
set ANTHROPIC_AUTH_TOKEN=sk-zbTYx*******************************fceTvn5
set ANTHROPIC_MODEL=kimi-k2-250905
cd your-project-folder
claude

$env:ANTHROPIC_BASE_URL="https://api.gravitex.ai"
$env:ANTHROPIC_AUTH_TOKEN="sk-zbTYx*******************************fceTvn5"
$env:ANTHROPIC_MODEL="kimi-k2-250905"
cd your-project-folder
claude

2. 双模型架构说明

Claude Code 默认使用 双线程模型架构，可有效节省成本：

线程	环境变量	用途
主线程模型	`ANTHROPIC_MODEL`	主要代码生成、对话、复杂任务处理
副线程模型	`ANTHROPIC_DEFAULT_HAIKU_MODEL`	文件监控、Linter 检查、自动补全等轻量任务

典型搭配：主线程使用 claude-opus-4-7 或 claude-sonnet-4-6 处理重活，副线程使用 claude-haiku-4-5-20251001 处理后台任务，可在保证质量的同时大幅降低 token 成本。

3. 推荐配置（双模型）

Mac / Linux
Windows CMD
Windows PowerShell

export ANTHROPIC_BASE_URL="https://api.gravitex.ai"
export ANTHROPIC_AUTH_TOKEN="sk-zbTYx*******************************fceTvn5"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001"
cd your-project-folder
claude

set ANTHROPIC_BASE_URL=https://api.gravitex.ai
set ANTHROPIC_AUTH_TOKEN=sk-zbTYx*******************************fceTvn5
set ANTHROPIC_MODEL=claude-sonnet-4-6
set ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001
cd your-project-folder
claude

$env:ANTHROPIC_BASE_URL="https://api.gravitex.ai"
$env:ANTHROPIC_AUTH_TOKEN="sk-zbTYx*******************************fceTvn5"
$env:ANTHROPIC_MODEL="claude-sonnet-4-6"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001"
cd your-project-folder
claude

4. 单模型配置（可选）

如果只想使用一个模型，有两种方式： 方法一：两个环境变量配置为同一个模型

export ANTHROPIC_BASE_URL="https://api.gravitex.ai"
export ANTHROPIC_AUTH_TOKEN="sk-zbTYx*******************************fceTvn5"
export ANTHROPIC_MODEL="kimi-k2-250905"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2-250905"
cd your-project-folder
claude

方法二：启动后用命令切换主线程 保持「双模型」配置，启动 Claude Code 后在交互界面输入：

/model haiku

主线程会切换到 ANTHROPIC_DEFAULT_HAIKU_MODEL 指向的模型。

六、推荐模型组合（经 GravitexAI 使用）

场景	主线程 (`ANTHROPIC_MODEL`)	副线程 (`ANTHROPIC_DEFAULT_HAIKU_MODEL`)
生产级开发（首选）	`claude-opus-4-7`	`claude-haiku-4-5-20251001`
日常开发（推荐）	`claude-sonnet-4-6`	`claude-haiku-4-5-20251001`
性价比优先	`kimi-k2-250905`	`claude-haiku-4-5-20251001`
长上下文	`claude-sonnet-4-5-20250929` (200K)	`claude-haiku-4-5-20251001`
快速验证	`claude-haiku-4-5-20251001`	`claude-haiku-4-5-20251001`

完整模型 ID 请参考 GravitexAI 模型广场。

七、常见问题

401 / API Key 无效

检查 ANTHROPIC_AUTH_TOKEN 是否完整、是否有多余空格或换行。
在 GravitexAI 控制台确认 Key 未被禁用。
确保账户余额充足。

404 / endpoint 错误

Claude Code 的 ANTHROPIC_BASE_URL 不要加 /v1，使用 https://api.gravitex.ai 即可（与 OpenAI 协议不同）。

如何在 Claude Code 中切换模型？

启动后，在交互界面输入：

/model              # 查看当前模型
/model haiku        # 切换到 ANTHROPIC_DEFAULT_HAIKU_MODEL
/model sonnet       # 部分版本支持的快捷别名

或退出 CLI 修改环境变量后重新启动。

模型 ID 报错 not found

请使用 GravitexAI 模型列表中的完整 ID，例如：

✅ claude-sonnet-4-5-20250929
❌ claude-sonnet-4-5

版本日期后缀不可省略。

如何减少 token 消耗？

优先采用双模型配置，副线程交给 Haiku；
在 claude 启动时通过 --max-turns 等参数限制对话轮次；
在项目中维护 .claude/ 目录的项目记忆与上下文；
使用 /clear 清理冗余上下文。

如何统一团队配置？

把环境变量写入项目根目录的 .env、shell 启动脚本或 direnv，团队成员只需各自填入自己的 ANTHROPIC_AUTH_TOKEN 即可。

八、参考链接

Claude Code 官方文档：https://docs.anthropic.com/en/docs/claude-code
GravitexAI 控制台：https://maas.gravitex.ai
模型广场：https://maas.gravitex.ai/#/models
密钥管理：https://maas.gravitex.ai/#/keys

对话型 AI

编程开发

AI Agent

技术工程

翻译场景

一、产品简介

一键接入多家模型

双线程模型架构

无需订阅

国内可用

二、安装 Node.js（已安装可跳过）

卸载其他中转客户端（可选）

三、安装 Claude Code

四、获取 GravitexAI 密钥

五、配置环境变量

1. 基础配置示例（单模型）

2. 双模型架构说明

3. 推荐配置（双模型）

4. 单模型配置（可选）

六、推荐模型组合（经 GravitexAI 使用）

七、常见问题

八、参考链接

​一、产品简介

一键接入多家模型

双线程模型架构

无需订阅

国内可用

​二、安装 Node.js（已安装可跳过）

​卸载其他中转客户端（可选）

​三、安装 Claude Code

​四、获取 GravitexAI 密钥

​五、配置环境变量

​1. 基础配置示例（单模型）

​2. 双模型架构说明

​3. 推荐配置（双模型）

​4. 单模型配置（可选）

​六、推荐模型组合（经 GravitexAI 使用）

​七、常见问题

​八、参考链接

一、产品简介

二、安装 Node.js（已安装可跳过）

卸载其他中转客户端（可选）

三、安装 Claude Code

四、获取 GravitexAI 密钥

五、配置环境变量

1. 基础配置示例（单模型）

2. 双模型架构说明

3. 推荐配置（双模型）

4. 单模型配置（可选）

六、推荐模型组合（经 GravitexAI 使用）

七、常见问题

八、参考链接