Skip to content

在 Claude Code 中使用

Claude Code 是 Anthropic 官方的命令行编码助手。本网关原生兼容 Anthropic /v1/messages 协议,把环境变量指过来就能直接用。

前置要求

  • Node.js 18+
  • 已经在网关后台拿到 API Token(参考 快速开始

1. 安装 Claude Code

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

或用 Homebrew:

bash
brew install --cask claude-code

验证:

bash
claude --version

2. 配置网关地址

Claude Code 通过两个环境变量决定请求发到哪:

bash
export ANTHROPIC_BASE_URL="https://api.geoq.help"
export ANTHROPIC_AUTH_TOKEN="sk-你的Token"

放到 ~/.zshrc / ~/.bashrc 让它持久化:

bash
echo 'export ANTHROPIC_BASE_URL="https://api.geoq.help"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的Token"' >> ~/.zshrc
source ~/.zshrc

注意:用 ANTHROPIC_AUTH_TOKEN 而不是 ANTHROPIC_API_KEY。前者会被当作自定义 Token 直接透传,后者会触发官方账号校验流程。

3. 选择模型

在终端切到任一项目目录,跑:

bash
claude

进入交互模式后输入 /model,选你想用的 Claude 系列模型,例如:

  • claude-sonnet-4-5
  • claude-opus-4-5
  • claude-haiku-4-5

也可以直接用别名:sonnetopushaiku。模型名以网关后台 模型 页面实际配置为准。

4. 验证

随便起个对话:

> 解释下这个项目的目录结构

如果 Claude Code 正常返回响应,且后台 日志 页面能看到这条调用记录,就接通了。

5. 常见问题

报错:Invalid API key 检查 ANTHROPIC_AUTH_TOKEN 是否真的导出到了当前 shell:echo $ANTHROPIC_AUTH_TOKEN 应该有内容。

报错:404 / model not found 当前分组没绑这个 Claude 模型。回后台后台 模型 页面确认可用模型,或换一个 /model 选项。

Claude Code 显示官方账号登录界面 说明环境变量没被读到。Claude Code 启动时会优先读 ANTHROPIC_BASE_URL,确认它在 claude 命令的进程里可见。env | grep ANTHROPIC 自查。

想在不同项目用不同 Token 在项目根目录放一份 .envrc(配合 direnv),按目录隔离:

bash
# .envrc
export ANTHROPIC_BASE_URL="https://api.geoq.help"
export ANTHROPIC_AUTH_TOKEN="sk-项目专属Token"

进阶

  • 切回官方 Anthropic:unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN 后再用 /login
  • 走代理:HTTPS_PROXY=http://127.0.0.1:7890 claude
  • 限制单次调用花费:在网关后台给该 Token 设额度上限

基于 new-api 二次开发,AGPL-3.0 协议