Claude Code Guide

Claude Code 配置

Claude Code 一般使用 Claude/Anthropic 风格的根地址。接入 PionicAI 时，根地址填写 https://api.pionicai.com，不要在末尾加 /v1。

创建令牌兑换额度

先确认三件事

PionicAI 钱包里有可用额度。
已经创建一个给 Claude Code 使用的 API Key。
你要填写的是根地址 https://api.pionicai.com，不是 https://api.pionicai.com/v1。

推荐方式：settings.json

Claude Code 的配置位置会随系统和版本变化。常见做法是在 Claude Code 的用户配置中写入环境变量。下面是建议结构：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.pionicai.com",
    "ANTHROPIC_API_KEY": "sk-your-pionicai-key"
  }
}

环境变量方式

如果你习惯用终端环境变量，也可以直接设置。设置后需要重新打开终端。

# macOS / Linux
export ANTHROPIC_BASE_URL="https://api.pionicai.com"
export ANTHROPIC_API_KEY="sk-your-pionicai-key"

# Windows PowerShell
setx ANTHROPIC_BASE_URL "https://api.pionicai.com"
setx ANTHROPIC_API_KEY "sk-your-pionicai-key"

验证方法

重启 Claude Code 或重新打开终端。
先让它执行一个只读任务，例如解释当前文件，不要修改项目。
打开日志页面确认请求成功：https://api.pionicai.com/usage-logs。
确认余额扣费符合预期后，再执行长上下文或自动修改任务。

常见问题

认证失败：检查 API Key 是否完整、是否误填登录密码。
请求打到错误地址：Claude/CC 根地址不要加 /v1。
余额不足：先去钱包兑换额度。
长任务消耗高：Claude Code 读取项目和多轮修改会增加 token 消耗，建议先限额。