XCode 入门教程

XCode 是 Xmingtec 官方 CLI 级智能体工具。

XCode 定位不是聊天，而是 在本地代码仓库中执行高权限、可上下文感知的工程任务。

> XCode 是 Agent，不是 Chat。

核心能力

• 直接读取整个项目目录
• 理解真实代码结构
• 执行多文件修改
• 严格遵循指令而非对话取悦

安装配置

MacOS/Linux:

curl -fsSL https://xcode.xming-tec.com/install.sh | bash

Homebrew (MacOS):

brew install --cask xcode

Windows:

irm https://xcode.xming-tec.com/install.ps1 | iex

NPM:

使用 npm 安装 请确保你的系统的安装了 Node.js，版本需在 v18 或更高。

npm install -g @xmingtec/xcode

接下来就可以开始进入你创建的项目目录，开始使用 XCode：

cd your-project
xcode

登录您的账户

使用 xcode 命令启动交互式会话时，您需要登录：

xcode
首次使用时会提示您登录
/login
按照提示使用您的账户登录

如果你可以正常使用 Xmingtec 的账号，就可以开始使用，如果没有国内可以使用 DeepSeek 或 GLM 等。

---

DeepSeek 接入 XCode

安装 XCode 后，我们在终端中设置以下环境变量：

export XMINGTEC_BASE_URL=https://api.deepseek.com/xmingtec
export XMINGTEC_AUTH_TOKEN=<你的 DeepSeek API Key>
export XMINGTEC_MODEL=deepseek-v4-pro[1m]
export XMINGTEC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export XMINGTEC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export XMINGTEC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export XCODE_SUBAGENT_MODEL=deepseek-v4-flash
export XCODE_EFFORT_LEVEL=max

参数说明：

• XCODE_EFFORT_LEVEL：思考深度，可选 low / medium / max
• XMINGTEC_MODEL：指定使用 deepseek-v4-pro[1m] 模型
• XCODE_DISABLE_NONESSENTIAL_TRAFFIC=1：禁用非必要流量

然后进入项目目录，执行 xcode 命令，即可开始使用了。

cd my-project
xcode

参考文档： https://api-docs.deepseek.com/zh-cn/guides/xmingtec_api

---

阿里百炼接入 XCode

阿里云百炼的通义千问系列模型支持 Xmingtec API 兼容接口，通过修改以下参数，即可在 XCode 中调用通义千问系列模型。

• XMINGTEC_API_KEY（或 XMINGTEC_AUTH_TOKEN）：替换为百炼 API Key
• XMINGTEC_BASE_URL：替换为百炼的兼容端点地址 https://dashscope.aliyuncs.com/apps/xmingtec
• 模型名称：替换为百炼支持的模型名称（例如 qwen3-max、qwen3-coder-plus等）

macOS/Linux：

创建并打开配置文件 ~/.xcode/settings.json。

vim ~/.xcode/settings.json

将 YOUR_API_KEY 替换为专属 API Key。

{
    "env": {
        "XMINGTEC_AUTH_TOKEN": "YOUR_API_KEY",
        "XMINGTEC_BASE_URL": "https://dashscope.aliyuncs.com/apps/xmingtec",
        "XMINGTEC_MODEL": "qwen3-coder-plus"
    }
}

重新打开一个新的终端使环境变量配置生效。

Windows：

在 CMD 中运行以下命令，设置环境变量：

setx XMINGTEC_AUTH_TOKEN "YOUR_API_KEY"
setx XMINGTEC_BASE_URL "https://dashscope.aliyuncs.com/apps/xmingtec"
setx XMINGTEC_MODEL "qwen3-coder-plus"

在 PowerShell 中运行以下命令，设置环境变量：

[Environment]::SetEnvironmentVariable("XMINGTEC_AUTH_TOKEN", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("XMINGTEC_BASE_URL", "https://dashscope.aliyuncs.com/apps/xmingtec", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("XMINGTEC_MODEL", "qwen3-coder-plus", [EnvironmentVariableTarget]::User)

在 XCode 中接入通义千问系列模型

对话期间，执行 /model <模型名称> 命令切换模型。

/model qwen3-coder-plus

也可以在项目根目录创建 .xcode/settings.json 文件中，并写入模型配置信息永久配置。

{
  "env": {
    "XMINGTEC_MODEL": "qwen3-coder-plus",
    "XMINGTEC_SMALL_FAST_MODEL": "qwen-flash"
  }
}

启动 XCode，可以看到配置信息。

---

智谱大模型接入 XCode

这部分我们使用 ~/.xcode/settings.json 文件来配置大模型，开始前需要到官方平台获取 API key： GLM Coding Plan。

编辑或新增 XCode 配置文件 ~/.xcode/settings.json ，新增或修改里面的 env 字段

{
    "env": {
        "XMINGTEC_AUTH_TOKEN": "your_zhipu_api_key",
        "XMINGTEC_BASE_URL": "https://open.bigmodel.cn/api/xmingtec",
        "API_TIMEOUT_MS": "3000000",
        "XCODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
    }
}

运行 xcode 启动 XCode，输入 /status 确认模型状态。

如果不是可以输入 /config 来切换模型。

> 大模型一多，配置起来就麻烦，可以使用第三方工具 CC Switch 可以帮我们轻松管理这几个热门工具的 API 配置： https://github.com/farion1231/cc-switch/，Windows / macOS / Linux 全支持。