Skip to content

快速开始 ​

本指南将帮助你在 5 分钟内完成配置,开始使用 Claude Code 等 AI 编程工具。

第一步:注册并获取 API Key ​

  1. 访问 https://1xm.ai,点击「注册」
  2. 使用邮箱完成注册并登录
  3. 进入控制台 → 「令牌管理」 → 「创建令牌」
  4. 输入令牌名称,选择分组,复制生成的 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 /你的项目
claude
powershell

# 安装
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系列分组的令牌

CAUTION

Claude code的base_url是 https://1xm.ai ,不要后面带‘/v1’,否则会出现无法链接的异常

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"

# 启动
codex

NOTE

复制上述代码时请把“你的-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"

# 启动
gemini

NOTE

复制上述代码时请把“你的-API-Key”换成你在1XM后台-「令牌管理」创建好的openai系列分组的令牌


第三步:充值额度 ​

  1. 登录「控制台」 → 「钱包管理」
  2. 选择充值金额,支持支付宝 / 微信支付
  3. 充值后在控制台「使用日志」页面可查看每次调用的消耗

常见问题 ​

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 的上下文。

1XM.AI - 专为国内开发者打造的 AI API 中转服务