AI 工具配置

工具

Codex

位置:~/.codex/config.toml

内容

model = "gpt-5" model_reasoning_effort = "high" # 执行工具时是否要求确认:never - 不要求;on-request - 沙箱内的操作不要求 approval_policy = "never" #approval_policy = "on-request" # 沙箱模式:workspace-write - 可在工作区内写;danger-full-access - 不使用沙箱 #sandbox_mode = "danger-full-access" sandbox_mode = "workspace-write" [sandbox_workspace_write] # sandbox_mode = "workspace-write" 时是否允许访问网络 network_access = true

具体文档在 https://github.com/openai/codex/blob/main/codex-rs/config.md

Claude Desktop

位置:~/Library/Application Support/Claude/claude_desktop_config.json

内容(主要为 MCP 配置):

{ "globalShortcut": "", "mcpServers": { ... }, "isUsingBuiltInNodeForMcp": false }

Claude Code

位置: ~/.claude/settings.json

内容:

{ "env": { "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" }, "model": "opus", "statusLine": { "type": "command", "command": "bunx ccusage statusline", "padding": 0 }, "$schema": "https://json.schemastore.org/claude-code-settings.json" }

位置: ~/.claude.json

内容:(主要是 MCP 配置)

{ "mcpServers": { ... } }

值得一提的是,Claude Code 哪怕是全局配置也可以存在于很多地方,具体可以参考 https://docs.anthropic.com/en/docs/claude-code/settings

MCP

MCP 配置基本都是顶层一个 mcpServers key,然后用 Record<string, Config> 的形式声明对应 MCP 服务的配置

{ "mcpServers": { "mui": { "command": "npx", "args": [ "-y", "@mui/mcp@latest" ] }, "convex": { "command": "npx", "args": [ "-y", "convex@latest", "mcp", "start" ] }, "context7": { "command": "npx", "args": [ "-y", "@upstash/context7-mcp" ] }, "sentry": { "type": "http", "url": "https://mcp.sentry.dev/mcp" }, "atlassian": { "type": "sse", "url": "https://mcp.atlassian.com/v1/sse", "headers": {} }, "clickup": { "type": "stdio", "command": "npx", "args": [ "-y", "@hauptsache.net/clickup-mcp" ], "env": { "CLICKUP_API_KEY": "YOUR_KEY", "CLICKUP_TEAM_ID": "YOUR_ID" } } } }

更多的 MCP 服务可以看 https://lobehub.com/mcp

MCP 基本有三种类型,包括 stdio, httpsse

  • stdio 形式是最早的,一般所有实现都支持;这个有的也叫「本地」模式

  • http 是现在官方最推荐的方案、 sse 方案官方已弃用;这两个一般统称「远程」模式

在配置时

  • 对于 stdio 的形式,通常只指定 command args env 即可

  • 对于 httpsse 形式,通常只指定 url headers 即可;部分实现要求指定 typetransport

Claude Desktop

对于 stdio 形式的 MCP 通过 ~/Library/Application Support/Claude/claude_desktop_config.json 文件配置

对于远程 MCP 则需要从 Settings → Connectors 添加

Claude Code

https://docs.anthropic.com/en/docs/claude-code/mcp

Claude Code 支持多层级的 mcp 配置,包括用户层级(user)和项目(project / local)层级

它的 MCP 配置文件位于 ~/.claude.json 下(注意:不是在 ~/.claude/settings.json 下,网传的 ~/.claude/mcp_servers.json 也不生效)

如果是项目维度,则位于项目目录的 .claude/settings.json.claude/settings.local.json

项目维度的 mcp 位置也可以位于 .mcp.json 文件中,在启动 Claude Code 时会让你确认是否加载项目所配置的 MCP 工具(这个确认信息会存储到 .claude/settings.local.json 中)

Claude Code 的 MCP 是可以利用 claude mcp 命令行修改的,不过注意这个的 scope(-s)默认是 local 即当前路径,可以利用 -s user 改成全局或 -s project 改成项目维度

  • -s user-s local 都是修改 ~/.claude.json 的(只是改的层级不一样;user 是顶层直接改全局 mcpServers、local 是改的是项目配置 projects.{path}.mcpServers

  • -s project 修改的是 .mcp.json

另外,可以利用 claude mcp add-from-claude-desktop 导入在 Claude Desktop 中配置的 MCP 服务

Codex

https://github.com/openai/codex/tree/main?tab=readme-ov-file#model-context-protocol-mcp

Codex 的 MCP 配置位于 ~/.codex/config.toml,格式是

[mcp_servers.mui] command = "npx" args = [ "-y", "@mui/mcp@latest" ] [mcp_servers.convex] command = "npx" args = [ "-y", "convex@latest", "mcp", "start" ] [mcp_servers.context7] command = "npx" args = [ "-y", "@upstash/context7-mcp" ]

即:采用 TOML 形式表述;顶层 key 是 mcp_servers 而不是 mcpServers;需要时可以利用 https://transform.tools/json-to-toml 简单转换后修改得到

Codex 目前只支持 stdio 类型 https://github.com/openai/codex/issues/2129

Cursor

https://docs.cursor.com/en/context/mcp

Cursor 的 mcp 配置位于 ~/.cursor/mcp.json,其内容就是标准的 MCP json

{ "mcpServers": { ... } }

除了全局配置,Cursor 也支持项目维度的配置,位于 .cursor/mcp.json

ChatGPT

https://help.openai.com/en/articles/11487775-connectors-in-chatgpt

ChatGPT 当前仅 Team / Pro / Enterprise 配置远程 MCP 服务;Free / Plus 用户完全不支持

Junie

https://www.jetbrains.com/help/junie/model-context-protocol-mcp.html

Junie 的 mcp 配置位于 ~/.junie/mcp/mcp.json,其内容就是标准的 MCP json

{ "mcpServers": { ... } }

除了全局配置,Junie 也支持项目维度的配置,位于 .junie/mcp/mcp.json

Rule

Claude Code

项目目录下的 CLAUDE.md,可以在 Claude Code 中用 /init 生成

Codex

项目目录下的 AGENTS.md,可以在 Codex 中用 /init 生成

Cursor

项目根目录下的 .cursorrules.cursor/rules 目录下的所有 .mdc 文件

Cursor 另外存在全局规则配置,在 UI 中设置,对所有项目生效

Junie

项目目录下的 .junie/guidelines.md,可以在 Junie 中选择「Create project guidelines」让 AI 自动创建