Appearance
快速开始
本指南将帮助你在 5 分钟内完成配置,开始使用 Claude Code 等 AI 编程工具。
第一步:注册并获取 API Key
- 访问 https://1xm.ai,点击「注册」
- 使用邮箱完成注册并登录
- 进入控制台 → 「令牌管理」 → 「创建令牌」
- 输入令牌名称,选择分组,复制生成的 API Key(格式:
sk-xxxxx),参考令牌管理
⚠️ 安全提醒
- 不要将 API Key 提交到公开代码仓库(GitHub 等)
- 推荐通过环境变量传递,避免硬编码
- 如果 Key 泄露,立即在控制台删除并重新创建
第二步:选择你的工具
Claude Code(推荐)
Claude Code 是 Anthropic 官方出品的终端 AI 编程助手,能理解整个项目上下文,支持代码生成、调试、重构,是目前最强大的 AI 编程工具之一。
bash
# 第一步,安装(需要 Node.js 18+)
npm install -g @anthropic-ai/claude-code
# 第二步,推荐写入 shell 配置(zsh 用户)
echo 'export ANTHROPIC_BASE_URL="https://1xm.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的-API-Key"' >> ~/.zshrc
source ~/.zshrc
# 第三步,进入项目目录,启动
cd /你的项目
claudepowershell
# 安装
npm install -g @anthropic-ai/claude-code
# 永久配置(重启 PowerShell 后生效)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://1xm.ai", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的-API-Key", "User")
# 启动
cd C:\你的项目
claude验证配置正常:在 Claude Code 内运行 /doctor 诊断连接状态。
NOTE
复制上述代码时请把“你的-API-Key”换成你在1XM后台-「令牌管理」创建好的cc系列分组的令牌
Codex CLI
OpenAI 推出的命令行 AI 编程工具。
bash
# 安装
npm install -g @openai/codex
# macOS/Linux 配置
export OPENAI_API_KEY="你的-API-Key"
export OPENAI_BASE_URL="https://api.1xm.ai/v1"
# 启动
codexNOTE
复制上述代码时请把“你的-API-Key”换成你在1XM后台-「令牌管理」创建好的openai系列分组的令牌
CAUTION
Codex 的base_url是 https://1xm.ai/v1 ,这里跟CC不一样,必须带“/v1”,否则会出现无法链接的异常
Gemini CLI
Google 的 AI 编程助手,支持多模态。
bash
# 安装
npm install -g @google/gemini-cli
# macOS/Linux 配置
export GEMINI_API_KEY="你的-API-Key"
export GEMINI_BASE_URL="https://api.1xm.ai/gemini"
# 启动
geminiNOTE
复制上述代码时请把“你的-API-Key”换成你在1XM后台-「令牌管理」创建好的openai系列分组的令牌
第三步:充值额度
常见问题
Q:API Key 格式是什么?
控制台「令牌管理」页创建的 Key 格式为 sk-xxxxx,是用来验证调用权限的
Q:Claude Code 连接失败怎么办?
运行 claude /doctor 检查配置,确认 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 都已正确设置。也可检查是否开启了终端代理(建议关闭,直连速度更好)。
Q:调用返回 503 错误?
请检查使用的模型 ID 当前key分组下的可用是否在模型广场中。使用列表外的模型 ID 会返回此错误。
Q:响应速度慢?
不建议在终端中开启代理,直连 1xm.ai 速度更好。上下文越长响应越慢,可用 /clear 清理 Claude Code 的上下文。
