在 Grok Build 中接入 APIArc 的 GPT 模型

Grok Build 支持自定义 OpenAI 兼容模型。只要服务商提供兼容的接口地址、模型 ID 和 API Key，就能在不改动其他工作流的情况下，把第三方模型加入 Grok Build。 本文使用 APIArc 的 gpt-5.6-luna 演示完整配置。

grok -m apiarc-luna
grok -p "用三句话介绍这个项目" -m apiarc-luna

安装 Grok Build

macOS 用户可以通过 Homebrew 安装，然后确认命令可用：

brew install --cask grok-build
grok --version

准备 APIArc 接口信息

配置中会用到以下三项信息：

接口地址  https://apiarc.ai/v1
模型 ID   gpt-5.6-luna
密钥变量  APIARC_API_KEY

APIArc 提供 OpenAI 兼容接口。Grok Build 使用 Chat Completions 协议，因此 base URL 应填写 APIArc 的 /v1 地址，而不是完整的 /chat/completions 地址。 真实 API Key 应保存在环境变量中，不要写进公开教程或代码仓库。

新建 Grok Build 配置

如果目录或文件不存在，先执行：

mkdir -p ~/.grok
touch ~/.grok/config.toml
nano ~/.grok/config.toml

加入下面这段模型配置：

[model.apiarc-luna]
model = "gpt-5.6-luna"
base_url = "https://apiarc.ai/v1"
name = "APIArc GPT-5.6 Luna"
description = "GPT-5.6 Luna through APIArc"
env_key = "APIARC_API_KEY"
api_backend = "chat_completions"
context_window = 200000

apiarc-luna 是 Grok Build 在本机使用的别名，可以自行修改；model 必须填写 APIArc 的真实模型 ID。env_key 指定密钥变量名，context_window 帮助 Grok Build 判断何时压缩上下文。

安全设置 API Key

在当前终端设置 APIArc Key，把占位内容替换成自己的密钥：

export APIARC_API_KEY="你的_APIArc_API_Key"

这条命令只在当前终端会话生效。如果写入 ~/.zshrc，请保护好文件和设备。 检查变量是否存在时，不要打印完整密钥，只检查它是否非空：

test -n "$APIARC_API_KEY" && echo "APIARC_API_KEY 已设置"

确认 Grok Build 已识别模型

运行模型列表；如果别名没有出现，再运行检查命令：

grok models
grok inspect

正常情况下列表中会出现 apiarc-luna。如果没有出现，检查 Grok Build 是否读取了 ~/.grok/config.toml，以及 TOML 的段名、引号和字段名是否正确。

执行一次端到端测试

先用短且确定的提示词测试，排查会更简单：

grok \
  -p "只回复 APIARC_LUNA_OK" \
  -m apiarc-luna \
  --max-turns 1 \
  --disable-web-search \
  --no-subagents

如果终端返回 APIARC_LUNA_OK，说明 Grok Build 已经通过 APIArc 成功调用gpt-5.6-luna。本机 MCP 服务的无关警告可以单独排查，不一定表示 APIArc 接入失败。

配置其他 APIArc GPT 模型

同一个文件可以加入更多别名，并共用同一个密钥变量：

[model.apiarc-sol]
model = "gpt-5.6-sol"
base_url = "https://apiarc.ai/v1"
name = "APIArc GPT-5.6 Sol"
env_key = "APIARC_API_KEY"
api_backend = "chat_completions"
context_window = 200000

[model.apiarc-terra]
model = "gpt-5.6-terra"
base_url = "https://apiarc.ai/v1"
name = "APIArc GPT-5.6 Terra"
env_key = "APIARC_API_KEY"
api_backend = "chat_completions"
context_window = 200000

保存后可以直接选择对应别名启动：

grok -m apiarc-sol
grok -m apiarc-terra

准备新增模型前，可以先请求模型接口确认准确的模型 ID：

curl https://apiarc.ai/v1/models \
  -H "Authorization: Bearer $APIARC_API_KEY"

常见错误

Grok Build 还可能报告本机 MCP 或插件配置产生的警告。为了进行干净的模型测试，可以保留 --disable-web-search 和 --no-subagents。

完整配置示例

最小可用的 ~/.grok/config.toml 如下：

[model.apiarc-luna]
model = "gpt-5.6-luna"
base_url = "https://apiarc.ai/v1"
name = "APIArc GPT-5.6 Luna"
env_key = "APIARC_API_KEY"
api_backend = "chat_completions"
context_window = 200000

设置密钥后，用别名启动 Grok Build。以后切换 APIArc 模型，只需复制一个配置段并修改别名与模型 ID。

查看 APIArc 模型目录，确认最新的模型 ID 与定价。