Documentation Index Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt
Use this file to discover all available pages before exploring further.
一、产品简介 Claude Code 是 Anthropic 官方推出的终端 AI 编程客户端。通过 GravitexAI （兼容 Anthropic 接口）你可以：
一键接入多家模型 通过同一接口使用 Claude 全系列、Kimi K2、GPT 等模型
双线程模型架构 主线程跑重任务，副线程跑轻量补全，节省成本
无需订阅 按 token 计费，不依赖 Claude Pro 订阅
二、安装 Node.js（已安装可跳过） 确保 Node.js 版本 ≥ 18.0 。
Windows
macOS
Ubuntu / Debian
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
四、获取 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 后在交互界面输入：
主线程会切换到 ANTHROPIC_DEFAULT_HAIKU_MODEL 指向的模型。
六、推荐模型组合（经 GravitexAI 使用） 场景 主线程 (ANTHROPIC_MODEL) 副线程 (ANTHROPIC_DEFAULT_HAIKU_MODEL) 生产级开发 （首选）claude-opus-4-7claude-haiku-4-5-20251001日常开发 （推荐）claude-sonnet-4-6claude-haiku-4-5-20251001性价比优先 kimi-k2-250905claude-haiku-4-5-20251001长上下文 claude-sonnet-4-5-20250929 (200K)claude-haiku-4-5-20251001快速验证 claude-haiku-4-5-20251001claude-haiku-4-5-20251001
完整模型 ID 请参考 GravitexAI 模型广场 。
七、常见问题
检查 ANTHROPIC_AUTH_TOKEN 是否完整、是否有多余空格或换行。
在 GravitexAI 控制台 确认 Key 未被禁用。
确保账户余额充足。
Claude Code 的 ANTHROPIC_BASE_URL 不要 加 /v1，使用 https://api.gravitex.ai 即可（与 OpenAI 协议不同）。
启动后，在交互界面输入： /model # 查看当前模型 /model haiku # 切换到 ANTHROPIC_DEFAULT_HAIKU_MODEL /model sonnet # 部分版本支持的快捷别名
或退出 CLI 修改环境变量后重新启动。
请使用 GravitexAI 模型列表 中的完整 ID ，例如：
✅ claude-sonnet-4-5-20250929
❌ claude-sonnet-4-5
版本日期后缀不可省略。
优先采用双模型配置 ，副线程交给 Haiku；
在 claude 启动时通过 --max-turns 等参数限制对话轮次；
在项目中维护 .claude/ 目录的项目记忆与上下文；
使用 /clear 清理冗余上下文。
把环境变量写入项目根目录的 .env、shell 启动脚本或 direnv，团队成员只需各自填入自己的 ANTHROPIC_AUTH_TOKEN 即可。
八、参考链接 