返回首页

Claude Code

Claude Code 是 Anthropic 官方的命令行 AI 编程助手。通过两个环境变量就能让它走 Picklyone 网关，一个 Key 就能用 Opus / Sonnet / Haiku 全系列。

💡 一键配置：到 API 密钥 页创建 Key 后，在 Key 右侧下拉里点 配置指南 → Claude Code，可复制已经填好真实 Key 的完整命令，比手抄不易出错。

安装

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

配置（macOS / Linux）

在 ~/.bashrc 或 ~/.zshrc 末尾追加：

export ANTHROPIC_BASE_URL=https://api.picklyone.com
export ANTHROPIC_API_KEY=pk_live_xxxxxxxxxxxxxxxx

执行 source ~/.zshrc 或新开一个终端让配置生效。

配置（Windows）

以 管理员身份 打开 PowerShell，执行：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.picklyone.com", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "pk_live_xxxxxxxxxxxxxxxx", "User")

重启 PowerShell / cmd 让新变量生效。

验证

claude --version
claude "Hello, introduce yourself"

收到正常回复即接入成功。

切换模型

默认模型是 claude-sonnet-4-6。在会话里输入 /model claude-opus-4-6 切到 Opus，所有模型共用一个 Key。

Picklyone 使用建议

  • 一定要开 Prompt Caching：Claude Code 每一轮都会重放项目结构这类很长的 system prompt，给 system 块加上 cache_control: { type: "ephemeral" } 后，Picklyone 会按 cache 价计费（约 1/10 原价），一个长项目每天能省下 70–90% 成本。详见 缓存 Token 计费。
  • 单独建 Key + 日限额：Agent 模式会连续自动调用，有时一个死循环就能烧几美元。建议在 API 密钥 页为 Claude Code 单独建一个 Key，把 日限额 设成你能接受的最大金额（例如 $5/天）。
  • 限定模型白名单：同一个 Key 在 允许模型 里只勾 claude-sonnet-4-6 / claude-opus-4-6，避免手滑切到非 Claude 模型。
  • 自动故障切换：Picklyone 内置多通道冗余，遇到故障会自动切换备用通道，不用你改配置。
  • 实时成本监控：API 日志 页可以按会话看到每轮的 prompt / completion / cache token 数和美元成本，方便优化。

常见问题

  • 401 Unauthorized：确认 ANTHROPIC_API_KEY 以 pk_live_ 开头，两端没空格
  • 404 / 超时：ANTHROPIC_BASE_URL 只填到 https://api.picklyone.com，不要加 /v1，Claude Code 会自己拼路径
  • 余额不足：到 充值页 补充额度