跳转到主要内容
Claude Code 是 Anthropic 出的编码 agent CLI。开箱即用时它打到 Anthropic 自家网关；把它重定向到 ByteSpike 之后，整套模型目录都能 用一把 key 拿到（Claude，加上 DeepSeek-Anthropic，加上经 Anthropic-via-Gemini 翻译的等等）。

​
前置条件

  • 一个 ByteSpike 账号 + 一把绑到 claude-default 分组的 key （或任何包含 Claude/DeepSeek-Anthropic 的分组）。详见 注册账号。
  • 装好 Claude Code： 
    npm install -g @anthropic-ai/claude-code
# 或
brew install claude-code

​
配置

两个环境变量。加到你的 shell profile（~/.zshrc、~/.bashrc，或者 ~/.config/fish/config.fish）： 
export ANTHROPIC_BASE_URL="https://llm.bytespike.ai"
export ANTHROPIC_API_KEY="sk-byts-..."
重新加载 shell（exec $SHELL 或开个新 tab）。完事 —— claude 现在 所有 Messages-API 调用都走 ByteSpike。
想只对单个项目生效，不影响整个 shell？放一个 .envrc（配合 direnv）或者一个 project-local 脚本，让变量只在仓库内导出：
# .envrc
export ANTHROPIC_BASE_URL="https://llm.bytespike.ai"
export ANTHROPIC_API_KEY="sk-byts-..."

​
验证

claude --version
然后开个 session： 
claude
在 session 里跑一个小任务： 
> what model are you?
你应该看到模型自报家门（例如 “I’m Claude Sonnet 4.6 served via ByteSpike”）。如果是鉴权错误，回头检查 ANTHROPIC_API_KEY；如果是 400 model_not_allowed，说明你 key 绑定的分组里没有 Claude Code 默认用的那个模型 —— 切到包含该模型的分组，或者用 --model 覆盖。

​
切换模型

Claude Code 会按命令挑合适的工具。按 session 覆盖： 
claude --model claude-opus-4-8    # 本次 session 用 Opus
或者在 session 内按工具切： 
> /model claude-haiku-4-5
你 key 绑定的 claude-default（或其他分组）里任意一个 model id 都能用。完整目录见 Models。

​
常见配置

在 Console → API keys 给每个 项目生成单独的 key，配独立的 quota（USD 累计上限）和 rate_limit_* 速率窗口。把每个项目的 .envrc 接到对应的 key。 在 /api/v1/me/usage 里消费 仍按 api_key_id 归因。
端到端都能直接跑通 —— 不用额外配置。网关原样保留 tool_use 块、cache_control 标记，以及 thinking 块（Opus / Sonnet 4.x）。
Claude Code 的 MCP server（mcp__* 工具）全部跑在客户端 —— 它们不在乎 CLI 和模型之间是哪一个网关。设好环境变量，已有的 MCP 配置直接继续用。
Claude Code 会读 HTTPS_PROXY / NO_PROXY。如果你的代理会 切碎 SSE 流，把 llm.bytespike.ai 加到 NO_PROXY；否则正常 设 HTTPS_PROXY=https://proxy.corp:443 即可。

​
排错

症状原因处理
401 invalid x-api-keykey 值错了或者已经被吊销在 Console → API keys 重新复制；必要时轮换
402 insufficient_balance账户没 credits 了，或者 key 触发了自己的 quota在 Console → 账单 充值；或提高 key 的 quota
403 permission_denied（模型）模型不在 key 的路由分组里换 key，或用 --model 切模型
503 api_errorkey 的分组当下没有容量能服务该模型在 Console → Models 点该模型旁的 Test 确认；如果分组不匹配就换分组
流式中途卡住（SSE）企业代理缓冲把 llm.bytespike.ai 加到 NO_PROXY
实时响应结构见 /v1/messages。

​
下一步

Codex CLI

OpenAI 的编码 CLI —— 同样思路，OpenAI 那边的环境变量。

Models

Claude Code 实际能调的模型。

鉴权

分组绑定、quota、速率限制。

DOSIA Agent 模式

构建在 Claude Code Messages 结构之上的 agent 集成。