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

(no oficial)

Esta guía la mantiene la comunidad de forma independiente. No está afiliada, respaldada ni patrocinada por el proveedor de la herramienta de terceros que trata. Todas las marcas de terceros son propiedad de sus respectivos titulares.

一条命令完成 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 官方文档

参考资料

Convierte esta página en una llamada de API real

¿Sin clave oficial o con problemas para pagar con tarjeta internacional? Crea una clave sk-cg- al registrarte, apunta tu URL base a CodeGateway y conserva tu SDK o CLI actual. Pago por token; al vincular una tarjeta obtienes crédito gratis.

Crear cuenta gratis
Author:CodeGateway TeamReviewed on:2026-09-05