Claude Code 一键脚本(macOS / Linux / Windows)

(Unofficial)

Dieser Leitfaden wird unabhängig von der Community gepflegt. Er steht in keiner Verbindung zum Anbieter des hier behandelten Drittanbieter-Tools und wird von ihm weder unterstützt noch gesponsert. Alle Marken Dritter sind Eigentum ihrer jeweiligen Inhaber.

一条命令完成 Claude Code 与 CodeGateway 的配置,支持 macOS、Linux 和 Windows。

一句话:5 分钟跑起 Anthropic Claude Code——一行 curl 命令配置 CodeGateway 端点,新用户绑定支付方式后可获得体验额度(具体金额以注册/定价页实时展示为准),按 token 计费。

用 Claude Code 更快的路径之一是 CodeGateway 一键脚本——一条命令搞定,不用改 Anthropic SDK 配置。下面是 macOS / Linux / Windows 三个平台的命令清单,跑完直接 claude 启动。

这是简版命令参考。如果你想看完整故事 + 实测数据 + 进阶用法,看博客深度版:开发者 Claude Code 快速接入指南。

一、获取 API 密钥(30 秒)

注册前需要先有一个 CodeGateway API 密钥:

  1. 登录 CodeGateway Dashboard
  2. 进入 API 密钥 页面
  3. 点击 创建密钥,复制以 sk-cg- 开头的字符串
没账号?注册并绑定支付方式后可获得免费起步额度,具体金额与模型折算以注册/定价页实时展示为准,够你跑通配置 + 试几个真实任务。

二、一键脚本(macOS / Linux)

打开终端,把 YOUR_KEY 换成你的密钥后执行:

bash
curl -s https://codegateway.dev/setup.sh | bash -s -- --key sk-cg-YOUR_KEY

脚本做了 3 件事:

  • 安装 Claude Code(如未安装,调用 pip install 或 brew install)
  • 写入 ~/.claude/settings.json 配 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN
  • 备份原有 shell 配置(防止冲突)

跑完直接 claude 命令启动,看到欢迎界面就成功。


三、一键脚本(Windows / PowerShell)

以管理员身份打开 PowerShell:

powershell
& { $key='sk-cg-YOUR_KEY'; iwr -useb https://codegateway.dev/setup.ps1 | iex }

如果提示权限不足,先执行:

powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

四、手动配置(如果你不想跑脚本) 对比 Claude Code / Cursor / Copilot

在 ~/.claude/settings.json 写入:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.codegateway.dev",
    "ANTHROPIC_AUTH_TOKEN": "sk-cg-YOUR_KEY"
  }
}

或者直接设环境变量(适合临时试用):

bash
export ANTHROPIC_BASE_URL="https://api.codegateway.dev"
export ANTHROPIC_AUTH_TOKEN="sk-cg-YOUR_KEY" 

五、验证配置

bash
claude --version    # 确认 Claude Code 已安装
claude              # 进入项目目录后启动 REPL

启动后随便问一句“你好,简单介绍下自己”。如果返回 Claude 的中文回复,说明 CodeGateway 接入链路已通。

链路细节:你的请求经 Cloudflare 全球边缘节点路由到 Anthropic 官方 API,全程 TLS 加密。延迟跟你的网络环境相关——你可以在 Dashboard 用量页 看每次调用的实际响应时间。

六、1M 上下文与模型选择

CodeGateway 上的这些 Claude 模型原生就跑在 1M 上下文窗口上——不需要申请 beta,网关侧也不需要给模型名加任何后缀:

模型(/v1/models 返回的精确 id)

上下文窗口

claude-sonnet-5-5

1M

claude-opus-5-5

1M

claude-sonnet-5

1M

claude-opus-5

1M

claude-fable-5-1 / claude-fable-5

1M

但客户端不知道这件事。 Claude Code 读不到网关的上下文窗口,它默认按 200K 估算——除非模型 id 里带 [1m]。所以要让 Claude Code 真的按 1M 用,需要三步(都在客户端做):

1. 打开网关模型发现(一次性):

bash
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

2. 重启 Claude Code。 发现只在启动时跑一次,结果缓存在 ~/.claude/cache/gateway-models.json。

3. 在 `/model` 里选带 `(1M context)` 的那一行。 CodeGateway 会在 /v1/models 里为这些模型多返回一组 [1m] 拼写,选择器里显示成「Sonnet 5.5 (1M context)」等;选中后该会话就按 1M 估算,不会再在 200K 附近提前压缩。

想让它成为新会话的默认,把默认模型钉成带后缀的拼写:

bash
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5-5[1m]'
# 同理 ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL

也可以写进 ~/.claude/settings.json 的 "model": "claude-sonnet-5-5[1m]"。

`[1m]` 是客户端的「按 1M 估算」标记,不是网关的扩容开关。 我们这些模型本来就是 1M:不选那一行不会被上游截断,只是 Claude Code 会在 200K 附近就提前压缩上下文。客户端发请求前会把后缀去掉,网关收到的是 claude-sonnet-5-5。

硬规则:只有本来就是 1M 的模型才认这个后缀——标错不会静默降级,而是直接报错:

请求的 model

结果

claude-sonnet-5-5[1m]

✅ 200,按 claude-sonnet-5-5 处理

claude-sonnet-4-6[1m]

❌ 400(Sonnet 4.6 是 200K 窗口,标 1M 属配置错误)

想把选择器里的几行固定下来、并起个好记的名字,用 ~/.claude/settings.json 的 modelPicker:

json
{
"modelPicker": {
"options": [
{ "model": "claude-sonnet-5-5[1m]", "label": "Sonnet 5.5(1M)", "description": "日常编码,1M 上下文" },
{ "model": "claude-opus-5-5[1m]", "label": "Opus 5.5(1M)", "description": "复杂重构与长程任务" }
]
}
}
model 会被原样使用;建议填 /v1/models 返回的完整 id(例如 claude-sonnet-5-5[1m]),这样能锁定版本并拿到 1M 变体。裸族别名 sonnet / opus / haiku / fable(含 [1m] 形态)也会受理,但它们跟随目录里的最新版本。Claude Desktop 的配置方式见「Claude Desktop 接入 CodeGateway」。

七、常见问题

Q:我应该用 Claude 哪个模型?

A:日常代码用 Sonnet 4.6(性价比最高);复杂架构 / 重构用 Opus 4.7。详见 模型对比与选择指南。

Q:CodeGateway 怎么计费?

A:按 Anthropic 原价 + 统一的 1.07× 倍率,不随消耗变化。详见 统一倍率说明 和 充值与费用指南。

Q:密钥格式要求?

A:必须以 sk-cg- 开头,在 Dashboard → API 密钥页面创建。一个账号可以建多个密钥(按项目隔离)。

Q:安装脚本安全吗?

A:脚本不开源,但你可以下载后本地审完再跑——把单行命令拆成两步:

bash
# 1. 先下载脚本,本地查看内容
curl -s https://codegateway.dev/setup.sh -o setup.sh
less setup.sh   # 或 cat setup.sh,确认你接受脚本里的所有动作

# 2. 确认无问题后再执行
bash setup.sh --key sk-cg-YOUR_KEY 充值和余额管理

脚本不收集任何个人信息,只动 ~/.claude/settings.json 和 shell 配置(备份原文件)。

Q:脚本修改了哪些文件?

A:只动两个:~/.claude/settings.json 和 shell 配置(~/.zshrc 或 ~/.bashrc),都会先备份。

Q:Windows 提示权限不足怎么办?

A:以管理员身份运行 PowerShell,或先执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force。

Q:报错 “401 Unauthorized” 怎么办?

A:检查 API 密钥是否过期 / 是否复制完整。完整排错指南看 常见报错排查 常见报错排查。


八、下一步

  • ✅ 跑通了 → 看 博客深度版 学进阶用法(斜杠命令 / Plan 模式 / Hooks 自动化)
  • 💰 想看花费 → 充值与费用指南
  • ⚖️ 选模型 → Claude 模型选哪个
  • 📚 想看 Claude Code 官方文档 → Anthropic 官方文档

参考资料

Machen Sie aus dieser Doku einen echten API-Aufruf

Kein offizieller Key oder Probleme mit Kartenzahlungen aus dem Ausland? Erstellen Sie nach der Registrierung einen sk-cg- Key, richten Sie Ihre Base URL auf CodeGateway und behalten Sie Ihr bestehendes SDK oder CLI unverändert. Abrechnung pro Token; nach dem Verknüpfen einer Karte erhalten Sie kostenloses Guthaben.

Kostenlos registrieren
Author:CodeGateway TeamReviewed on:2026-09-05
Claude Code 一键脚本配置 | macOS / Linux / Windows 命令清单