這篇只寫 Mac。

之前寫 Windows 的時候我發(fā)現(xiàn)，教程一旦把 Windows、Mac、Linux 都塞在一起，讀起來就很累。尤其是剛接觸 Codex 的朋友，本來就不熟終端，再看到一堆系統(tǒng)命令混在一起，很容易直接關掉。

所以這一篇就單獨寫 macOS。

我會按自己實際折騰的順序來，不講太多大概念。能復制的命令直接貼出來，哪里容易卡也順手寫上。

Codex 是干嘛的

Codex 可以理解成一個放在本地項目里的 AI 編程助手。

它不是只能聊天。你在某個項目目錄里啟動 Codex 后，它可以看項目文件，幫你分析目錄結構、解釋代碼、定位報錯，也可以在你確認后修改文件。

剛開始可以先把它當成這幾種工具：

• 幫你讀項目目錄
• 幫你看項目用了什么技術
• 幫你分析報錯
• 幫你改一點小功能
• 幫你寫一點測試

不要一上來就讓它“幫我重構整個項目”。這個范圍太大，新手也不好判斷它改得對不對。

我自己的習慣是：先讓它看，再讓它分析，最后才讓它改。

安裝前準備一下

Mac 上這篇只走 npm 安裝。

你需要準備兩個東西：

1. 終端
   Mac 自帶，不用額外安裝。

2. Node.js
   npm 是跟著 Node.js 一起安裝的。后面安裝 Codex 要用 npm。

如果你不知道自己有沒有 Node.js，也沒關系，下面會檢查。

第一步：打開終端

按 Command + 空格，搜索：

Terminal

或者直接打開端口

打開以后，后面的命令都在這個窗口里輸入。

第二步：檢查 Node.js 和 npm

先輸入：

node -v 回車
npm -v 回車

如果都能看到版本號，比如：v22.x.x、10.x.x
說明 Node.js 和 npm 已經(jīng)有了，可以直接看下一步。

如果提示：

command not found: node
或者
command not found: npm

說明還沒裝 Node.js。

這時候打開 Node.js 官網(wǎng)：

https://nodejs.org

下載 LTS 版本安裝就行。安裝過程基本一路繼續(xù)，不用改太多設置。

安裝完之后，關閉終端，重新打開一次，再輸入：

node -v
npm -v

能看到版本號，就說明這一步好了。

第三步：用 npm 安裝 Codex

在終端輸入：

npm install -g @openai/codex

然后等它安裝。

如果這里長時間不動，大概率是 npm 包源訪問不順?？梢該Q個網(wǎng)絡環(huán)境，或者晚點再試。

安裝完成后，輸入：

codex --version

如果能看到版本號，比如：

codex 0.x.x

說明 Codex 已經(jīng)裝好了。

如果提示：

command not found: codex

先關閉終端，重新打開一次，再試：

codex --version

如果還不行，重新執(zhí)行：

npm install -g @openai/codex

第四步：建一個測試文件夾

第一次別直接拿重要項目試。
我們先建一個測試文件夾,我習慣了命令創(chuàng)建,你也可以隨意位置新建或者訪達進入文件夾直接新建文件夾

mkdir -p ~/code/codex-test
cd ~/code/codex-test

現(xiàn)在你已經(jīng)進入 codex-test 這個目錄了。

可以先放一個簡單文件進去：

vim README.md

復制一句話進去：

這是我第一次在 Mac 上測試 Codex。

保存方式：

1. 按 i 進入編輯模式
2. 粘貼文字
3. 按 Esc
4. 輸入 :wq
5. 按回車

第五步：先啟動一次 Codex

在 codex-test 目錄里輸入：

codex

第一次啟動可能會讓你登錄。

如果你能正常登錄官方賬號，可以先按提示登錄。

如果你準備用 API Key 接入，也可以繼續(xù)往下看配置。

因為我電腦已經(jīng)使用了.所以這步就無法截圖了。

國內用戶怎么接 API

國內用戶用 Codex 時，最常見的問題其實不是安裝，而是接口訪問和模型管理。

如果你有自己的 API 網(wǎng)關，就可以把 Codex 接到自己的接口上。我自己使用的站點是：云AiCode，各位看官按需處理。

后面的配置里我會用 https://cdn.yunaicode.com/v1 做占位，你實際填寫時換成自己的接口地址就行。

第六步：創(chuàng)建 Codex 配置文件

Codex 的配置文件一般放在這里：

這里要特別說明，.開頭的文件夾默認都是隱藏文件夾，mac本身是不會顯示的，所以如果你要通過訪達進入文件夾去手動新建配置文件，你需要進入任意文件夾，然后同時按住:shift+command+句號按鈕(問號旁邊那個) 然后隱藏文件夾就會顯示了。

~/.codex/config.toml

新手不用手動去 Finder 里找，直接用命令創(chuàng)建就行。

在終端輸入：

mkdir -p ~/.codex
vim ~/.codex/config.toml

會進入 vim 編輯界面。

先按 i 進入編輯模式，再把下面這段復制進去：

model = "這里填你能用的模型名"
model_provider = "custom"
[model_providers.custom]
name = "Custom API"
base_url = "https://cdn.yunaicode.com/v1"
env_key = "API_KEY"
wire_api = "responses"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

這里要改兩個地方。

第一個是模型名：

model = "這里填你能用的模型名"

不要自己猜，去你的中轉站模型廣場復制你想用的模型名。

第二個是接口地址：

base_url = "https://cdn.yunaicode.com/v1"

注意最后的 /v1。少了這個，很容易報錯。

保存方式：

1. 按 Esc
2. 輸入 :wq
3. 按回車

注意:我的截圖里面用的我是常用的云AiCode的網(wǎng)關

第七步：設置 API Key

上面的配置里有一行：

env_key = "API_KEY"

意思是 Codex 會去系統(tǒng)環(huán)境變量里找一個叫 API_KEY 的值。

所以我們要把自己的 Key 放進去。

先看一下你用的是 zsh 還是 bash：

echo $SHELL

現(xiàn)在大部分 Mac 默認是 zsh。如果輸出里有 zsh，執(zhí)行：

echo 'export API_KEY="你的 API Key"' >> ~/.zshrc
source ~/.zshrc

這一步是設置你機器的中一個叫:API_KEY 的環(huán)境變量,提供給codex的配置文件使用
比如你的 Key 是 sk-xxxx，就寫成：

echo 'export API_KEY="sk-xxxx"' >> ~/.zshrc
source ~/.zshrc

如果你輸出里是 bash，就執(zhí)行：

echo 'export API_KEY="你的 API Key"' >> ~/.bashrc
source ~/.bashrc

設置完檢查一下：

echo $API_KEY

如果能看到你的 Key，就說明設置成功了。

截圖里面的api_key是我自己的,我已經(jīng)刪除了…就不要想白嫖我的token了…哈哈哈哈

第八步：讓 Codex 用中文回復

我剛開始用的時候，Codex 經(jīng)常中英文混著來。

比較簡單的辦法是在項目目錄里放一個 AGENTS.md。

先進入剛才的測試目錄：

cd ~/code/codex-test

然后創(chuàng)建文件：

vim AGENTS.md

先按 i 進入編輯模式，再復制下面這段進去：

# AGENTS.md

## 回復習慣

- 默認使用簡體中文回復。
- 命令、文件名、函數(shù)名保持原文。
- 解釋代碼時盡量說人話，不要寫成官方文檔。

## 操作規(guī)則

- 修改文件前先說明計劃。
- 不確定的地方先問我。
- 不要改 .env、密鑰文件和生產配置。
- 新增依賴前先說明原因。
- 修改完成后告訴我改了哪些文件，以及怎么驗證。

保存方式還是：

1. 按 Esc
2. 輸入 :wq
3. 按回車

然后啟動 Codex：

codex

第一次可以這樣問它：

請先閱讀 AGENTS.md，后面默認用簡體中文回復。

這樣后面溝通會自然很多。

第九步：第一次怎么問 Codex

不要一上來就說：

幫我把項目改好

它不知道你說的“改好”是什么意思。

我建議按這個順序來。

先讓它看項目：

先不要修改文件，請幫我看一下當前項目結構，告訴我這個項目大概是做什么的。

再讓它判斷怎么啟動：

這個項目應該怎么啟動？先給我步驟，不要直接執(zhí)行命令。

如果你有報錯，就這樣問：

我遇到了下面這個報錯，請先幫我分析原因，不要直接改代碼。

這里粘貼報錯內容

確認之后再讓它改：

請只修改和這個報錯相關的文件，改動盡量小。修改前先告訴我計劃。

這個節(jié)奏比較穩(wěn)。

常見問題

1. npm install 卡住

大概率是網(wǎng)絡問題。

換個網(wǎng)絡環(huán)境，或者稍后再試。

2. command not found: codex

先關閉終端，重新打開。

然后再試：

codex --version

如果還不行，重新執(zhí)行：

npm install -g @openai/codex

3. API Key 設置后沒反應

先檢查：

echo $API_KEY

如果沒有輸出，說明 Key 沒設置成功。

再看你寫的是不是正確的 shell 配置文件。一般 Mac 默認是 ~/.zshrc。

4. model not found

一般是模型名寫錯。

回到 config.toml，檢查：

model = "這里填你能用的模型名"

把它改成你后臺真實可用的模型名。

5. 接口 404

檢查：

base_url = "https://cdn.yunaicode.com/v1"

重點看最后有沒有 /v1。

6. Codex 一直用英文

確認項目目錄里有沒有 AGENTS.md。

啟動后再說一句：

請先閱讀 AGENTS.md，后續(xù)默認用簡體中文回復。

最后說一句

新手第一次用 Codex，不要急著拿公司項目或者正式項目試。

先建一個測試文件夾，跑通安裝、配置、中文回復，再慢慢拿真實項目試。

我自己的感覺是，Codex 好用的地方不是“讓它一次性替你寫完整項目”，而是它能在項目上下文里幫你看代碼、查問題、改小功能。

Mac 這篇先寫到這里。

后面如果繼續(xù)寫，我會再整理一篇 Codex 的常用提問模板。

到此這篇關于Codex在Mac上運行的從零到開始教程的文章就介紹到這了,更多相關Codex Mac教程內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持腳本之家！

最新評論