---
title: "安装 Snowflake Cortex Code CLI 集成"
summary: "先安装并配置 Cortex CLI，再运行 integrations/codex/install.sh 安装 cortexcode-tool。默认使用 RO 模式，按审批结果执行命令。"
category: skills
level: starter
surfaces: [cli, app]
tags: ["Skills", "Snowflake", "Cortex", "CLI"]
canonical: /tips/cortexcode-tool-codex/
---

# 安装 Snowflake Cortex Code CLI 集成

先安装并配置 Cortex CLI，再运行 integrations/codex/install.sh 安装 cortexcode-tool。默认使用 RO 模式，按审批结果执行命令。

Snowflake Labs 文档包含 Codex 配置说明，写在 `subagent-cortex-code` 仓库。Codex 集成使用独立 CLI `cortexcode-tool`。执行前按会话要求完成沙箱和网络授权，获得批准后使用 `--yes` 在前台执行。

先装 Cortex Code CLI（命令是 `cortex`），并确认有活动连接：

```bash
which cortex
cortex connections list
```

`which cortex` 必须返回路径。官方文档写 CoCo CLI 在中国大陆不可用。连接写在 `~/.snowflake/connections.toml`，和 Snowflake CLI 共用。尚未安装 CLI 时，请先参考 CoCo CLI 官方安装说明。

接着安装 Codex 集成工具：

```bash
git clone https://github.com/Snowflake-Labs/subagent-cortex-code.git
cd subagent-cortex-code
bash integrations/codex/install.sh
```

脚本把 `cortexcode-tool` 装到 `~/.local/bin/`，配置写到 `~/.local/lib/cortexcode-tool/config.yaml`，并自动读当前 Cortex 连接。需要 Python 3.8+。`~/.local/bin` 不在 PATH 就先加进去。

核对：

```bash
cortexcode-tool --version
cortexcode-tool --envelope RO "How many databases do I have in Snowflake?"
```

第一次在 Codex 会话里先跑 `which cortexcode-tool` 和 `cortexcode-tool --help`。之后问 Snowflake 问题，它应调这个命令。默认 envelope 是 `RO`。聊天里先批准计划，再让它带 `--yes` 重试同一条**前台**命令。命令应在前台执行，通常需要 30 到 90 秒。

`approval_mode` 应遵循组织策略。`NONE` 会在执行前被拒。`DEPLOY` 还要额外确认。

换连接就再跑一遍安装脚本，或改 `config.yaml` 里的 `connection_name`。卸：

```bash
bash integrations/codex/uninstall.sh
```

网页 Cloud 读不到这台本机 CLI。配置后重新打开会话，再问有哪些数据库。

## 来源

- [Snowflake-Labs/subagent-cortex-code](https://github.com/Snowflake-Labs/subagent-cortex-code)
- [Cortex Code for Codex](https://github.com/Snowflake-Labs/subagent-cortex-code/blob/main/integrations/codex/README.md)
- [Snowflake · CoCo CLI](https://docs.snowflake.com/en/user-guide/cortex-code/cortex-code-cli)