开始使用

配置相关环境变量

1. 使用远程登录软件或通过CloudShell登录服务器。
   图1 远程登录服务器
   

2. 将以下内容写入 /root/.bashrc（替换 your-maas-api-key 为实际值）：

   cat >> /root/.bashrc << 'EOF'
    export ANTHROPIC_AUTH_TOKEN="your-maas-api-key"
    export ANTHROPIC_BASE_URL="http://localhost:8787"
    export ANTHROPIC_TARGET_API_URL="https://api.modelarts-maas.com/anthropic"
    export ANTHROPIC_MODEL="deepseek-v3.2"
    EOF
    source /root/.bashrc

   表1 .bashrc参数配置

   变量	作用	默认值
   `ANTHROPIC_AUTH_TOKEN`	MaaS API Key，Claude Code 发请求时携带	your-maas-api-key（修改为您获取的API Key）
   `ANTHROPIC_BASE_URL`	Claude Code 的请求发到本地代理Headroom `localhost:8787`	http://localhost:8787
   `ANTHROPIC_TARGET_API_URL`	Headroom 代理把压缩后的请求转发到 MaaS的anthropic接口URL	https://api.modelarts-maas.com/anthropic
   `ANTHROPIC_MODEL`	使用的模型Model参数	deepseek-v3.2

   图2 环境变量写入
   

启动ClaudeCode

在服务器内输入以下指令，启动Claudecode。

claude

图3 Claudecode启动

使用Enter选择合适的主题，确定完成即可完成ClaudeCode启动，Claude Code 会从环境变量读取 ANTHROPIC_BASE_URL，自动连接本地 Headroom 代理。

验证解决方案

1. Claude Code 中发送任意消息（如"你好"）。
   图4 Claude Code 中发送任意消息
   

2. 新建一个终端，在终端命令行中输入以下指令进行检查：

   curl -s http://localhost:8787/stats | grep -o '"api_requests":[0-9]*'

   如果出现“api_requests > 0”，说明请求经过了 Headroom 代理。

   图5 检查是否经过Headroom代理

   

3. （可选）验证tokens节省量，输入：

   headroom pref

   图6 查看tokens节省量
   

   常用命令

   # 启动 Claude Code（需先 source /root/.bashrc）
    claude
   
    # 查看代理状态
    curl http://localhost:8787/health
   
    # 查看代理统计（api_requests 应 >0）
    curl http://localhost:8787/stats
   
    # 查看代理日志
    tail -f /var/log/headroom-proxy.log
   
    # 重启代理
    pkill headroom
    export ANTHROPIC_TARGET_API_URL=https://api.modelarts-maas.com/anthropic
    nohup headroom proxy --host 0.0.0.0 --port 8787 > /var/log/headroom-proxy.log 2>&1 &

   

   Headroom主要应用场景为超长上下文进行代码开发，若仅单轮对话或简答可能tokens效果不佳。Headroom更多操作请参考Headroom官方仓库。