常见问题

🔑 账号与 API Key

Q：API Key 在哪里获取？

登录 控制台 → 「令牌」 → 「创建令牌」，输入名称后创建，复制保存。

Q：API Key 是什么格式？

格式为 sk-xxxxx，用于所有接入方式。

Q：API Key 泄露了怎么办？

立即在控制台「令牌」页面删除该 Key，重新创建。不要犹豫，新 Key 几秒即可生成。

---

🤖 Claude Code 使用

Q：Claude Code 如何配置使用 1XM.AI？

export ANTHROPIC_BASE_URL="https://1xm.ai/"
export ANTHROPIC_AUTH_TOKEN="你的-API-Key"

写入 ~/.zshrc 或 ~/.bashrc 后 source 生效，之后每次打开终端自动生效。

Q：Claude Code 连接失败怎么排查？

1. 在 Claude Code 中运行 /doctor 查看诊断结果
2. 确认环境变量已正确设置：echo $ANTHROPIC_BASE_URL
3. 确认 API Key 有效且账户余额充足
4. 关闭终端代理（代理可能干扰连接，直连 1xm.ai 速度更好）

Q：Claude Code 默认使用哪个模型？

默认使用 claude-sonnet-4-6。可以在对话中使用 /model 命令切换模型。

Q：响应很慢是什么原因？

• 上下文过长：使用 /clear 清除历史，或 /compact 压缩上下文
• 使用了 Thinking 模式（-thinking 后缀的模型）：推理需要更多时间
• 终端开了代理：建议关闭，直连速度更好

Q：macOS 提示"无法打开，因为它来自未知开发者"？

前往「系统设置」→「隐私与安全性」→「通用」，点击「仍要打开」。

---

🛠️ 接入配置

Q：OpenAI 兼容接口的 Base URL 是什么？

https://api.1xm.ai/v1

Q：Claude Code 和 OpenAI 兼容接口的区别？

	Claude Code	OpenAI 兼容接口
环境变量	ANTHROPIC_BASE_URL	OPENAI_BASE_URL
Base URL	https://1xm.ai/	https://api.1xm.ai/v1
适用工具	Claude Code 终端工具	Cursor、Continue、SDK、Codex CLI 等

Q：同一个 API Key 可以用于所有接口吗？

可以。在控制台创建的 API Key（格式 sk-xxxxx）可以同时用于 Claude Code 和 OpenAI 兼容接口。

Q：模型调用返回 503 错误？

使用了不支持的模型 ID。请参考支持的模型列表，使用准确的模型 ID。

---

💰 充值与计费

Q：支持哪些支付方式？

支持支付宝和微信支付。

Q：余额会过期吗？

不会，余额永不过期。

Q：支持发票吗？

支持。登录控制台进入「发票」页面，填写抬头、税号等开票信息后提交申请，3-5 个工作日内处理完成并通过邮件发送。

Q：Claude Code 一天大概消耗多少钱？

以 claude-sonnet-4-6 为例（$3/$15 per 1M tokens）：

• 轻度使用（几次简单问答）：¥0.1-0.5
• 中度使用（日常开发）：¥1-5
• 重度使用（大型项目重构）：¥5-20

---

🔒 安全与隐私

Q：代码内容会被保存吗？

不会。Claude Code 只将你主动选择的文件发送给 AI 处理，1XM.AI 不存储代码内容，对话记录保存在本地。

Q：数据传输安全吗？

全程 HTTPS 加密传输。

---

🆘 遇到问题

Q：调用 API 报错，如何排查？

1. 查看错误码说明
2. 在 Claude Code 中运行 /doctor
3. 确认 API Key 正确，余额充足
4. 确认模型 ID 在支持列表中

Q：如何联系支持？

在控制台提交工单，或参考故障排除指南。