[PR #318] Add Grok Build integration guide #338

Open
opened 2026-10-26 09:48:12 +00:00 by bsakaguchi · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/deepseek-ai/awesome-deepseek-agent/pull/318
Author: @Lawrie890201
Created: 7/27/2026
Status: 🔄 Open

Base: main ← Head: add-grok-build-guide


📝 Commits (1)

  • c1ad2ac Add Grok Build integration guide

📊 Changes

4 files changed (+342 additions, -0 deletions)

View changed files

📝 README.md (+1 -0)
📝 README.zh-CN.md (+1 -0)
➕ docs/grok_build.md (+170 -0)
➕ docs/grok_build.zh-CN.md (+170 -0)

📄 Description

This PR adds a guide for integrating DeepSeek models with Grok Build, xAI's terminal-based AI coding assistant.

What's included:

  • docs/grok_build.md — English guide
  • docs/grok_build.zh-CN.md — Chinese guide
  • Updated README.md and README.zh-CN.md with Grok Build entry (inserted in alphabetical order)

Guide covers:

  • Installation via curl script
  • Both Anthropic Messages API and OpenAI Chat Completions API backends
  • 1M context window configuration
  • Max reasoning effort (high)
  • Model switching via /model slash command or Ctrl+M picker
  • Headless mode for CI/CD
  • Troubleshooting (401 auth errors, connection issues, debug logging)

Key configuration detail: Grok Build requires an explicit api_key or env_key field in the model config — otherwise it falls back to the xAI session token, which DeepSeek rejects with a 401. This is documented prominently in the guide with a dedicated troubleshooting section.

All checks from CONTRIBUTING.md are satisfied:

  • ✅ Bilingual (EN + ZH) in a single PR
  • ✅ Model names use deepseek-v4-pro / deepseek-v4-flash
  • ✅ 1M context window configured (context_window = 1000000)
  • ✅ Max reasoning effort enabled (default_reasoning_effort = "high")
  • ✅ README entries in alphabetical order

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/deepseek-ai/awesome-deepseek-agent/pull/318 **Author:** [@Lawrie890201](https://github.com/Lawrie890201) **Created:** 7/27/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `add-grok-build-guide` --- ### 📝 Commits (1) - [`c1ad2ac`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/c1ad2acff085de13ed33b77f2673984de8e75195) Add Grok Build integration guide ### 📊 Changes **4 files changed** (+342 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+1 -0) 📝 `README.zh-CN.md` (+1 -0) ➕ `docs/grok_build.md` (+170 -0) ➕ `docs/grok_build.zh-CN.md` (+170 -0) </details> ### 📄 Description This PR adds a guide for integrating DeepSeek models with [Grok Build](https://grok.com/cli), xAI's terminal-based AI coding assistant. **What's included:** - `docs/grok_build.md` — English guide - `docs/grok_build.zh-CN.md` — Chinese guide - Updated `README.md` and `README.zh-CN.md` with Grok Build entry (inserted in alphabetical order) **Guide covers:** - Installation via curl script - Both Anthropic Messages API and OpenAI Chat Completions API backends - 1M context window configuration - Max reasoning effort (`high`) - Model switching via `/model` slash command or `Ctrl+M` picker - Headless mode for CI/CD - Troubleshooting (401 auth errors, connection issues, debug logging) **Key configuration detail:** Grok Build requires an explicit `api_key` or `env_key` field in the model config — otherwise it falls back to the xAI session token, which DeepSeek rejects with a 401. This is documented prominently in the guide with a dedicated troubleshooting section. All checks from CONTRIBUTING.md are satisfied: - ✅ Bilingual (EN + ZH) in a single PR - ✅ Model names use `deepseek-v4-pro` / `deepseek-v4-flash` - ✅ 1M context window configured (`context_window = 1000000`) - ✅ Max reasoning effort enabled (`default_reasoning_effort = "high"`) - ✅ README entries in alphabetical order --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
Sign in to join this conversation.
No labels
pull-request
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
deepseek-ai/awesome-deepseek-agent#338
No description provided.